From 562158a8835bf3d7bf3d42996e6d8a120aad9f8c Mon Sep 17 00:00:00 2001 From: Joachim Seemer Date: Sun, 5 Jul 2009 18:23:20 +0000 Subject: [PATCH] * Remodeled Ryan's addition to Twitcher into a layout widely used in our guide. Hope you don't mind, Ryan. * Moved Stippi's tip about the context menu in I-O-M into the path section. Hope you don't mind, Stephan. * Linked to the Icon-O-Matic page where icons are discussed. * Changed the index box at the top of I-O-M to use css and added the entries into Haiku-doc.css. I really don't know what I'm doing exactly here. Can someone have a look and improve things? I'd soon like to add such an index box to other long topics. git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@31414 a95241bf-73f2-0310-859d-f6bbb57e9c96 --- .../en/applications/apps-icon-o-matic.html | 19 +++++++++++++------ userguide/en/filetypes.html | 2 +- userguide/en/twitcher.html | 7 ++++++- .../en/workshop-filetypes+attributes.html | 2 +- 4 files changed, 21 insertions(+), 9 deletions(-) diff --git a/userguide/en/applications/apps-icon-o-matic.html b/userguide/en/applications/apps-icon-o-matic.html index e13c8fce..279bfba2 100644 --- a/userguide/en/applications/apps-icon-o-matic.html +++ b/userguide/en/applications/apps-icon-o-matic.html @@ -37,9 +37,9 @@
- - -i-o-m-shape -

When a shape is selected from the list, a rectangle is drawn around it. Depending on where exactly you grab it, the shape is moved, resized or rotated around a point in its center, which itself can be moved. Holding SHIFT will lock direction when moving, limit resizing to 45° angles and restrict the aspect ratio while resizing. The mouse pointer again indicates the current mode:

+

When a shape is selected from the list, a rectangle is drawn around it. Depending on where exactly you grab it, the shape is moved, resized or rotated around a point in its center, which itself can be moved. Holding SHIFT will lock direction when moving, limit resizing to 45° angles and restrict the aspect ratio while resizing. The mouse pointer again indicates the current mode:

Contents
BeOS bitmap vs. Haiku vector icons
+ + +
Index
BeOS bitmap vs. Haiku vector icons
Icons are attributes
Creating icons with Icon-O-Matic
  Path
@@ -60,7 +60,7 @@


-

Before we come to the actual creating of icons in Icon-O-Matic, a few words to Haiku's icons in general.

+

Before we come to the actual creating of icons in Icon-O-Matic, a few words on Haiku's icons in general.

contents @@ -161,6 +161,14 @@ width="16" height="16" />

 Select points
SHIFT
+

You can invoke a context menu by right-clicking a point or a selection of points:

+ + + + + + +
Select allALT ASelects all points of the current path.
TransformTPuts all selected points in a transformation box, so you can move, resize and rotate them together. It works just like with shapes, described a bit further down.
SplitSplits selected points into two, one sitting on top of the other.
FlipRotates selected points by 180°. Only has an effect on Bezier points.
RemoveDELDeletes selected points.

Path Menu

The Path menu offers a few obvious entries to Add Rectangle and Add Circle or to Duplicate or Remove a path. Here are some that may need a bit more explaining:

@@ -184,7 +192,7 @@ width="16" height="16" />
i-o-m- move-shape

You should always try to minimize your use of paths, those are the most expensive, file size wise. Re-use paths wherever possible and work with manipulated shapes and their transformers instead. Smart use of gradients can also save space.

  • Wherever possible, you should activate Snap-to-Grid from the Options menu when editing paths. Path points that align with the 64x64 pixel grid use less storage space. You'll also get the crispest look if points are set on exact pixel borders. For example, it is important to align the most prominent outlines with the 16x16 grid.

  • Check the preview to see if your icon still looks good in 16x16. You may want to use the Level Of Detail settings described in the Shapes section.

    • -

  • It is possible to transform the selected path points by pressing T or invoking the context menu by right-clicking on selected points. From the context menu, you will also have access to a few more helpful path editing features.

  • There's an easy way to produce letters, even if Icon-O-Matic doesn't provide such a tool. Just enter the text in a text editor such as StyledEdit, adjust font type and style, and drag&drop or copy&paste the selected text into Icon-O-Matic. This will create the according paths and shapes.

  • If you assign more than one path to a shape, their overlapping areas will cancel each other out. When one path is completely inside another, it practically creates a hole in the resulting shape.

  • You can zoom in and out of the canvas with the mouse wheel. Panning is done either by click&drag with the middle mouse button or with a normal left-click&drag while holding SPACE.

    • diff --git a/userguide/en/filetypes.html b/userguide/en/filetypes.html index b8e9c263..e3f13547 100644 --- a/userguide/en/filetypes.html +++ b/userguide/en/filetypes.html @@ -55,7 +55,7 @@

    The Default Application is the one that's set globally for that filetype. If you don't find the program you want to associate with this file in the drop-down menu, you'll again find the buttons Select... and Same As... which do the similar thing described under "The File Type" above.

    The Icon

    -

    If you're wondering why the icon well on the top right is empty: Icons are normally inherited from the system default for that filetype. You can open the Filetype Add-On of a file that contains an icon and drag&drop it into your file's icon well. Or you double-click the icon well and create or edit your own icon in Icon-O-Matic.

    +

    If you're wondering why the icon well on the top right is empty: Icons are normally inherited from the system default for that filetype. You can open the Filetype Add-On of a file that contains an icon and drag&drop it into your file's icon well. Or you double-click the icon well and create or edit your own icon. For more info on icons and how to create your own, see topic Icon-O-Matic.

    Special settings for applications

    If you invoke the Filetype Add-On on an executable (here: StyledEdit), you'll get a different dialog:

    diff --git a/userguide/en/twitcher.html b/userguide/en/twitcher.html index a9ff8275..2c0d96b0 100644 --- a/userguide/en/twitcher.html +++ b/userguide/en/twitcher.html @@ -40,7 +40,12 @@ twitcher.png

    Just tap CTRL TAB to switch between the current and the last application/window. Tapping CTRL TAB very quickly will switch between all applications. Or press and hold CTRL TAB to go through all running applications by repeatedly hitting TAB or ←/→. If you need to get to a specific window of a program, move to its icon as described and then go through its open windows with the ↑/↓ keys.

    It's also possible to invoke the Twitcher with CTRL TAB and then use the mouse to choose the application/window you'll jump to when releasing the CTRL key.

    -

    For more advanced users the Twitcher also has other useful keyboard shortcuts. Press ESC to return to the current window. Press Q to quit the selected application. Press H to hide all windows of the selected application.

    +

    The Twitcher also offers a few more advanced keyboard shortcuts:

    + + + + +
    ESCAborts the twitching an returns the formerly active window.
    QQuits the selected application.
    HHides all windows the selected application.