mirror of
https://review.haiku-os.org/userguide
synced 2024-11-23 07:08:25 +01:00
* Thanks to axel, "keymap" can now dump a text file directly.
* New screenshot of Find window with improved(?) numbers style. * Haiku-doc.css: content font-size is now 0.9em * Added documentation for Icon-O-Matic. Comments/Corrections very welcome. git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@31403 a95241bf-73f2-0310-859d-f6bbb57e9c96
This commit is contained in:
Joachim Seemer
parent
178bca81b9
commit
85d906b452
@ -1,61 +1,366 @@
|
||||
<?xml version="1.0" encoding="UTF-8" ?>
|
||||
<?xml version="1.0" encoding="UTF-8" ?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
|
||||
"../../../../html-dtd/xhtml1-strict.dtd">
|
||||
"../../../../html-dtd/xhtml1-strict.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-US">
|
||||
<head>
|
||||
<!--
|
||||
<!--
|
||||
*
|
||||
* Copyright 2008, Haiku. All rights reserved.
|
||||
* Copyright 2009, Haiku. All rights reserved.
|
||||
* Distributed under the terms of the MIT License.
|
||||
*
|
||||
* Authors:
|
||||
* Humdinger <humdingerb@gmail.com>
|
||||
* Humdinger <humdingerb@gmail.com>
|
||||
*
|
||||
-->
|
||||
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
||||
<meta http-equiv="Content-Style-Type" content="text/css" />
|
||||
<meta name="robots" content="all" />
|
||||
<title>Icon-O-Matic</title>
|
||||
<link rel="stylesheet" type="text/css" href="../../../Haiku-doc.css" />
|
||||
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
||||
<meta http-equiv="Content-Style-Type" content="text/css" />
|
||||
<meta name="robots" content="all" />
|
||||
<title>Icon-O-Matic</title>
|
||||
<link rel="stylesheet" type="text/css" href="../../../Haiku-doc.css" />
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div class="logo">
|
||||
<img src="../../images/logo.png" alt="logo" width="372" height="86" />
|
||||
<div class="title">Icon-O-Matic</div>
|
||||
<img src="../../images/logo.png" alt="logo" width="372" height="86" />
|
||||
<div class="title">Icon-O-Matic</div>
|
||||
</div>
|
||||
<div class="topnav">
|
||||
<p>
|
||||
<a href="../applications.html#list-of-apps">Applications</a>
|
||||
   
|
||||
Previous: <a href="apps-expander.html">Expander</a>
|
||||
   
|
||||
Next: <a href="apps-installer.html">Installer</a>
|
||||
</p>
|
||||
<p>
|
||||
<a href="../applications.html#list-of-apps">Applications</a>
|
||||
   
|
||||
Previous: <a href="apps-expander.html">Expander</a>
|
||||
   
|
||||
Next: <a href="apps-installer.html">Installer</a>
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<h1><img src="../../images/apps-images/icon-o-matic-icon_64.png" alt="icon-o-matic-icon_64.png"
|
||||
width="64" height="64" />Icon-O-Matic</h1>
|
||||
|
||||
<table id="contents" name="contents" align="right" summary="contents" cellspacing="2" cellpadding="6" style="font-size:0.8em; margin-left:30px; border-width:1px; border-style:dotted; border-color:#e0e0e0; text-align:justify">
|
||||
<tr align="center" style="background-color:#F0F0F0"><td><b><i>Contents</i></b></td></tr>
|
||||
<tr style="background-color:#F3F3F3"><td><a href="#bitmap-vector">BeOS bitmap vs. Haiku vector icons</a><br />
|
||||
<a href="#icons-attributes">Icons are attributes</a><br />
|
||||
<a href="#i-o-m">Creating icons with Icon-O-Matic</a><br />
|
||||
  <a href="#i-o-m-path">Path</a><br/>
|
||||
  <a href="#i-o-m-shape">Shape</a><br/>
|
||||
  <a href="#i-o-m-style">Style</a><br/>
|
||||
  <a href="#i-o-m-transformer">Transformer</a><br/>
|
||||
  <a href="#i-o-m-save">Saving an icon</a><br/>
|
||||
  <a href="#i-o-m-tips">Tips & Tricks</a></td></tr>
|
||||
</table>
|
||||
|
||||
<h1><img src="../../images/apps-images/icon-o-matic-icon_64.png" alt="icon-o-matic-icon_64.png" width="64" height="64" />Icon-O-Matic</h1>
|
||||
|
||||
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
|
||||
<tr><td>Deskbar:</td><td style="width:15px;"></td><td><span class="menu">Applications</span></td></tr>
|
||||
<tr><td>Location:</td><td></td><td><span class="path">/boot/system/apps/Icon-O-Matic</span></td></tr>
|
||||
<tr><td>Settings:</td><td></td><td><span class="path">~/config/settings/Icon-O-Matic</span></td></tr>
|
||||
</table>
|
||||
<p>Documentation is still missing. If you want to work on it, please announce it on the <a href="http://www.freelists.org/list/haiku-doc">Documentation mailing list</a> to avoid duplication.</p>
|
||||
|
||||
<p><br/></p>
|
||||
|
||||
<p>Before we come to the actual creating of icons in Icon-O-Matic, a few words to Haiku's icons in general.</p>
|
||||
|
||||
<h1>
|
||||
<a href="#contents"><img src="../../images/up.png" align="right" alt="contents" border="0" width="16" height="16" /></a>
|
||||
<a id="bitmap-vector" name="bitmap-vector">BeOS bitmap vs. Haiku vector icons</a></h1>
|
||||
<p>Contrary to the BeOS, Haiku uses vector icons instead of bitmap icons. A special Haiku Vector Icon Format (HVIF) was developed that is highly optimized for small file sizes and fast rendering. That's why our icons are for the most part <i>much</i> smaller than either a bitmap or the widely used SVG format. Also, unlike BeOS' bitmap icons, Haiku isn't limited to an 8bit palette (256 colors).<br />
|
||||
Take this icon of the Terminal, for example:</p>
|
||||
<table border="0" cellpadding="10">
|
||||
<tr align="center"><td><b>Bitmap</b></td><td><b>SVG</b></td><td><b>HVIF</b></td></tr>
|
||||
<tr align="center"><td><img src="../../images/apps-images/i-o-m-terminal-bitmap32.png" alt="i-o-m-terminal-bitmap32"
|
||||
width="32" height="32" /> <img src="../../images/apps-images/i-o-m-terminal-bitmap16.png" alt="i-o-m-terminal-bitmap16"
|
||||
width="16" height="16" /></td><td width="100"><img src="../../images/apps-images/terminal-icon_32.png" alt="terminal-icon_32"
|
||||
width="32" height="32" /></td><td><img src="../../images/apps-images/terminal-icon_32.png" alt="terminal-icon_32"
|
||||
width="32" height="32" /></td></tr>
|
||||
<tr align="center"><td>1,024 byte<br />+ 256 byte</td><td> 7,192 byte </td><td> 768 byte </td></tr>
|
||||
</table>
|
||||
<p>Note that the BeOS used two versions of an icon, one 16x16 and 32x32, to achieve good visuals in List and Icon View mode.</p>
|
||||
<p>This trick isn't needed with vector icons. Besides only taking up a few hundred bytes in a file, vector icons also scale much better than bitmaps. (Note: BeOS offered only a 16x16 and 32x32 display.)</p>
|
||||
<table border="0" cellpadding="10">
|
||||
<tr align="center"><td> </td><td><b>16x16</b></td><td><b>32x32</b></td><td><b>64x64</b></td><td><b>128x128</b></td></tr>
|
||||
<tr align="center"><td><b>Bitmap</b></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-bitmap16.png" alt="i-o-m-bitmap16"
|
||||
width="16" height="16" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-bitmap32.png" alt="i-o-m-bitmap32"
|
||||
width="32" height="32" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-bitmap64.png" alt="i-o-m-bitmap64"
|
||||
width="64" height="64" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-bitmap128.png" alt="i-o-m-bitmap128"
|
||||
width="128" height="128" /></td>
|
||||
<tr align="center"><td><b>Vector</b></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-vector16.png" alt="i-o-m-vector16"
|
||||
width="16" height="16" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-vector32.png" alt="i-o-m-vector32"
|
||||
width="32" height="32" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-vector64.png" alt="i-o-m-vector64"
|
||||
width="64" height="64" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-vector128.png" alt="i-o-m-vector128"
|
||||
width="128" height="128" /></td>
|
||||
|
||||
</table>
|
||||
|
||||
<h1>
|
||||
<a href="#contents"><img src="../../images/up.png" align="right" alt="contents" border="0" width="16" height="16" /></a>
|
||||
<a id="icons-attributes" name="icons-attributes">Icons are attributes</a></h1>
|
||||
<p>Icons are stored as an attribute with their file. However, that doesn't mean that every file has to have this attribute to appear with an icon in a Tracker window: data files inherit their icon from their filetype. To globally change the filetype's icon you use the <span class="app">FileTypes</span> preferences. If you only want to add a special icon to an individual file, you use the <span class="app">FileType Add-On</span> on it instead. See topic <a href="../filetypes.html">Filetypes</a> for more information.</p>
|
||||
<div class="box-info">Being an attribute, it follows that only filesystems supporting metadata can retain a file's individual icon. So, if you move files off your BFS volume, consider zipping them up so you don't lose icons or other attributes.</div>
|
||||
|
||||
<h1>
|
||||
<a href="#contents"><img src="../../images/up.png" align="right" alt="contents" border="0" width="16" height="16" /></a>
|
||||
<a id="i-o-m" name="i-o-m">Creating icons with Icon-O-Matic</a></h1>
|
||||
<p>Icon-O-Matic is Haiku's icon editor that can save your work as HVIF, SVG or PNG. The icon can also be directly attached as attribute to an existing file or exported as a resource or source file used by developers. Since the application was tailored to the optimized HVIF format, its usage reflects the inner workings of this format.</p>
|
||||
<p>Other than your normal vector graphics software, you don't deal with separate objects that each include all their specific properties like path, stroke width, stroke and fill color etc. Rather, you assemble your objects ("shapes") from shared paths and colors ("styles") and set certain properties. This re-using of elements is one secret of HVIF's efficiency. Although that imposes some constraints on the icon designer, there are a few advantages, too.<br />
|
||||
For example, by re-using a path, several objects can be modified together by manipulating this one path. Think of an object and its shadow. Modifying their shared path will change the object itself and automatically its (maybe slightly distorted/translated) shadow.</p>
|
||||
|
||||
<p>Here's a quick overview of Icon-O-Matic's window:</p>
|
||||
<img src="../../images/apps-images/i-o-m-overview.png" alt="i-o-m-overview.png" width="610" height="379" />
|
||||
|
||||
<p>To create any visible object on the canvas, you need a shape with a path and a style. Conveniently, you can create one, two or all three of those together from the <span class="menu">Shape</span> menu. Every kind of object (Paths, Shapes, Transformers, and Styles) has a menu above its list of elements, offering various commands. Every element has certain options that are set in the <span class="menu">Property</span> view.</p>
|
||||
|
||||
|
||||
<h2>
|
||||
<a href="#contents"><img src="../../images/up.png" align="right" alt="contents" border="0" width="16" height="16" /></a>
|
||||
<a id="i-o-m-path" name="i-o-m-path">Path</a></h2>
|
||||
<p>A path consists of several points which are connected with lines or Bezier curves. To add or change points, make sure, the path is selected in the path list.</p>
|
||||
|
||||
<p>Simply clicking in the canvas will set the first point. While setting a point, you decide if the resulting line will be straight or curved: a simple click and release produces a straight line, holding down the mouse button and moving the mouse will drag out the handles for a Bezier curve. Of course, you can also change it all later on.</p>
|
||||
|
||||
<img src="../../images/apps-images/i-o-m-path-ab.png" alt="i-o-m-path-ab" width="400" height="129" />
|
||||
|
||||
<p>To get from "A" to "B", you have to transform some points from corner-points to curve-points. That's done by holding <span class="key">ALT</span> while clicking on a point and dragging out the handles. This results in a symmetrical Bezier: the second handle follows the movement of the other. If you need to move the handles independently, again click&drag on a Bezier handle while holding <span class="key">ALT</span>.<br />
|
||||
Vice versa, to go from Bezier to a corner-point, hold <span class="key">ALT</span> and click on a point.</p>
|
||||
|
||||
<p>To move a point, simply click&drag it. To select more than one point, hold down <span class="key">SHIFT</span> and draw a selection rectangle. Selected points are marked with a red border instead of the usual black.<br />
|
||||
To insert a point into a path you click on the connecting line between two points.<br />
|
||||
Selected points are deleted by pressing <span class="key">DEL</span> or by clicking on any point while holding <span class="key">CTRL</span>.</p>
|
||||
|
||||
<p>The mouse pointer indicates the current mode:</p>
|
||||
<table summary="Mouse pointer states, Path" border="0" cellpadding="10">
|
||||
<tr align="center">
|
||||
<td><img src="../../images/apps-images/i-o-m-pointer-move-path.png" alt="i-o-m-pointer-move-path"
|
||||
width="16" height="16" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-pointer-insert.png" alt="i-o-m-pointer-insert"
|
||||
width="16" height="16" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-pointer-add.png" alt="i-o-m-pointer-add"
|
||||
width="16" height="16" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-pointer-delete.png" alt="i-o-m-pointer-delete"
|
||||
width="16" height="16" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-pointer-bezier.png" alt="i-o-m-pointer-bezier"
|
||||
width="16" height="16" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-pointer-select.png" alt="i-o-m-pointer-select"
|
||||
width="16" height="16" /></td>
|
||||
</tr>
|
||||
<tr align="center">
|
||||
<td>Move point(s)</td>
|
||||
<td>Insert point</td>
|
||||
<td>Add point</td>
|
||||
<td>Delete point<br /><span class="key">CTRL</span></td>
|
||||
<td>Corner↔Bezier<br /><span class="key">ALT</span></td>
|
||||
<td>Select points<br /><span class="key">SHIFT</span></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h3><a id="i-o-m-path-menu" name="i-o-m-path-menu">Path Menu</a></h3>
|
||||
<p>The <span class="menu">Path</span> menu offers a few obvious entries to <span class="menu">Add Rectangle</span> and <span class="menu">Add Circle</span> or to <span class="menu">Duplicate</span> or <span class="menu">Remove</span> a path. Here are some that may need a bit more explaining:</p>
|
||||
|
||||
<table summary="Path menu" border="0" cellspacing="0" cellpadding="2">
|
||||
<tr><td><span class="menu">Reverse</span></td><td style="width:15px;"></td><td>If your path isn't "closed" (see Path Properties below), a click into the canvas always creates a new point, connecting it with the last one. "Reverse" will reverse this order and your new point will connect to original start point instead.</td></tr>
|
||||
<tr><td><span class="menu">Clean Up</span></td><td></td><td>Most useful with imported SVGs, this function will remove redundant points.</td></tr>
|
||||
<tr><td class="onelinetop"><span class="menu">Rotate Indices</span></td><td></td><td>not yet implemented.</td></tr>
|
||||
</table>
|
||||
|
||||
<h3><a id="i-o-m-path-properties" name="i-o-m-path-properties">Path Properties</a></h3>
|
||||
<p>The <span class="menu">Property</span> at the bottom left of the window offers all available settings of the currently selected object. A path only has two: a <span class="menu">Name</span> and if it's <span class="menu">Closed</span> or not.</p>
|
||||
|
||||
|
||||
<h2>
|
||||
<a href="#contents"><img src="../../images/up.png" align="right" alt="contents" border="0" width="16" height="16" /></a>
|
||||
<a id="i-o-m-shape" name="i-o-m-shape">Shape</a></h2>
|
||||
<p>A shape groups together one or more paths with a style. Practically, it's the object that you'll actually see on the canvas. The grouping is done with the checkboxes in front of the paths and styles: Just select your shape and tick off the desired path(s) and a style.</p>
|
||||
<p>A shape defines how a path and style is applied, e.g. if the object is filled or only stroked (which is done by using Transformers on the shape, we'll get to that later). Also, a shape can be moved, rotated or resized without touching the used path. That way, you can re-use a single path and get different, but related, shapes.</p>
|
||||
|
||||
<img src="../../images/apps-images/i-o-m-shape.png" alt="i-o-m-shape"
|
||||
width="177" height="145" />
|
||||
|
||||
<p>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 <span class="key">SHIFT</span> 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:</p>
|
||||
<table summary="Mouse pointer states, Shape" border="0" cellpadding="10">
|
||||
<tr align="center">
|
||||
<td><img src="../../images/apps-images/i-o-m-pointer-move-shape.png" alt="i-o-m- move-shape"
|
||||
width="16" height="16" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-pointer-resize.png" alt="i-o-m-pointer-resize"
|
||||
width="16" height="16" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-pointer-rotate.png" alt="i-o-m-pointer-rotate"
|
||||
width="16" height="16" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-pointer-move-path.png" alt="i-o-m-pointer-move-rotation"
|
||||
width="16" height="16" /></td>
|
||||
</tr>
|
||||
<tr align="center">
|
||||
<td>Move</td>
|
||||
<td>Resize</td>
|
||||
<td>Rotate</td>
|
||||
<td>Move<br />rotation point</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<p>Shapes lie on top of each other, each is on its own layer, if you will. To reorder them you drag&drop their entry to a different position in the list.</p>
|
||||
|
||||
<h3><a id="i-o-m-shape-menu" name="i-o-m-path-menu">Shape Menu</a></h3>
|
||||
<p>The <span class="menu">Shape</span> menu offers the before mentioned possibility to <span class="menu">Add Empty, With Path/Style/Path&Style</span> and to <span class="menu">Duplicate</span> or <span class="menu">Remove</span> a shape. Then, there is:</p>
|
||||
<table summary="Shape menu" border="0" cellspacing="0" cellpadding="2">
|
||||
<tr><td><span class="menu">Reset Transformation</span></td><td style="width:15px;"></td><td>Reverts all the move, resize and rotate transformations you have applied to the shape.</td></tr>
|
||||
<tr><td class="onelinetop"><span class="menu">Freeze Transformation</span></td><td></td><td>When you transform a shape, its assigned path(s) stay in their original position. This may be intended; maybe more than one shape is using that path, maybe you intentionally used <span class="menu">Options | Snap to Grid</span> to set the points at precise pixel borders.<br />
|
||||
If not, "Freeze Transformation" will apply the current shape transformation to the assigned path(s). A future "Reset Transformation" will then return to this new state.</td></tr>
|
||||
</table>
|
||||
|
||||
<h3><a id="i-o-m-shape-properties" name="i-o-m-shape-properties">Shape Properties</a></h3>
|
||||
<p>Besides a <span class="menu">Name</span>, the <span class="menu">Property</span> view for a shape has these options:</p>
|
||||
|
||||
<table summary="Shape properties" border="0" cellspacing="0" cellpadding="2">
|
||||
<tr><td><span class="menu">Rounding</span></td><td style="width:15px;"></td><td><i>Unfinished feature</i>. Once working correctly, it will do a kind of "hinting" for vector paths, rounding their coordinates to the next full pixel, giving it a crisper look.</td></tr>
|
||||
<tr><td><span class="menu">Min LOD</span></td><td></td><td>Minimum Level of Detail</td></tr>
|
||||
<tr><td><span class="menu">Max LOD</span></td><td></td><td>Maximum Level of Detail</td></tr>
|
||||
</table>
|
||||
|
||||
<h4><a id="i-o-m-shape-lod" name="i-o-m-shape-lod">Level of Detail (LOD)</a></h4>
|
||||
<table summary="LOD example" border="0" cellpadding="10">
|
||||
<tr align="center"><td><b>16x16</b></td><td><b>32x32</b></td><td><b>64x64</b></td></td></tr>
|
||||
<tr align="center">
|
||||
<td><img src="../../images/apps-images/i-o-m-lod-icon_16.png" alt="i-o-m-lod-icon_16"
|
||||
width="16" height="16" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-lod-icon_32.png" alt="i-o-m-lod-icon_32"
|
||||
width="32" height="32" /></td>
|
||||
<td><img src="../../images/apps-images/i-o-m-lod-icon_64.png" alt="i-o-m-lod-icon_64"
|
||||
width="64" height="64" /></td></tr>
|
||||
</table>
|
||||
<p>See how there are no numbers in the 16px version of the BeVexed icon? That's done with the "Level of Detail" setting of their shapes.<br />
|
||||
With the LOD you control the visibility of a shape depending on its size. That way, you can leave away details of an icon that looks good on a bigger icon, but maybe not so much on its smaller version.</p>
|
||||
<p>This is how it works: A LOD of 1.0 is defined as a 64px icon size. So, to get the LOD of a particular icon size you simply divide it by 64, e.g. a 16px icon has a LOD of 16/64 = 0,25. A shape won't be visible below its <span class="menu">Min LOD</span> and above its <span class="menu">Max LOD</span>.</p>
|
||||
<p>So, if you set a shape's <span class="menu">Min LOD</span> to 0.0 and the <span class="menu">Max LOD</span> to 0.5, this means that the shape will only be visible for icon sizes smaller or <i>equal</i> to 32px. If you wanted to exclude the 32px icon size, you'd have to stay below 0.5, say 0.49.</p>
|
||||
<p>The LOD is not only for leaving out detailing shapes, you can also use it to e.g. change the stroke width at different sizes, if you feel that's needed. Simply duplicate a shape, make your changes and set both of their LOD settings to show either one or the other. Here lies the only source of potential confusion, when you're unwittingly overlap LODs of shapes, and wonder why at some size both are visible...<br />
|
||||
For example, if Shape 1 were to be shown below 48px and Shape 2 from 48px upward (LOD: 48/64 = 0.75):</p>
|
||||
|
||||
<table summary="LOD values example" border="0" cellpadding="5">
|
||||
<tr align="center"><td></td><td colspan="2"><b>OK</b></td><td width="25" rowspan="6"></td><td colspan="2"><b>Not OK!</b></td></tr>
|
||||
<tr style="background-color:#F1F1F1"><td rowspan="2" style="vertical-align:middle ; background-color:#FFFFFF"><b>Shape 1</b></td><td>Min LOD</td><td>0.00</td><td>Min LOD</td><td>0.00</td></tr>
|
||||
<tr style="background-color:#F1F1F1"><td>Max LOD</td><td><span style="background-color:#33FF33">0.74</span></td><td>Max LOD</td><td><span style="background-color:#FF9977">0.75</span></td></tr>
|
||||
<tr><td colspan="6"></td></tr>
|
||||
<tr style="background-color:#F8F8F8"><td rowspan="2" style="vertical-align:middle ; background-color:#FFFFFF"><b>Shape 2</b></td><td>Min LOD</td><td>0.75</td><td>Min LOD</td><td>0.75</td></tr>
|
||||
<tr style="background-color:#F8F8F8"><td>Max LOD</td><td>4.00</td><td>Max LOD</td><td>4.00</td></tr>
|
||||
</table>
|
||||
|
||||
|
||||
<h2>
|
||||
<a href="#contents"><img src="../../images/up.png" align="right" alt="contents" border="0" width="16" height="16" /></a>
|
||||
<a id="i-o-m-style" name="i-o-m-style">Style</a></h2>
|
||||
<p>A style can either be a solid color or some type of gradient.<br />
|
||||
Besides the predefined colors under <span class="menu">Swatches</span>, you can mix your own by clicking on the current color. Also, note the slider under the color spectrum which sets the alpha-channel (transparency).</p>
|
||||
<img src="../../images/apps-images/i-o-m-gradients.png" alt="i-o-m-gradients"
|
||||
width="654" height="127" />
|
||||
<p>You quickly create a new style by mixing your color and simply drag&dropping it into the list of styles.</p>
|
||||
<p>If you go for a gradient, you set the type (<span class="menu">Linear</span>, <span class="menu">Radial</span>, <span class="menu">Diamond</span>, <span class="menu">Cone</span>) and then define the start and end colors. This is done with a drag&drop from a color bucket into the respective color indicator under the gradient.<br />
|
||||
Of course you can move these indicators to change the gradient to your liking. You can also insert more indicators to add more colors by clicking into the gradient. Pressing <span class="key">DEL</span> removes the selected indicator.</p>
|
||||
<p>You can move, resize and rotate the representing box of a gradient on the canvas until it fits your needs. This works just like with shapes.</p>
|
||||
|
||||
<h3><a id="i-o-m-style-menu" name="i-o-m-style-menu">Style Menu</a></h3>
|
||||
<p>The <span class="menu">Style</span> menu offers the usual entries to <span class="menu">Add</span>, <span class="menu">Duplicate</span> or <span class="menu">Remove</span> a style and to <span class="menu">Reset Transformation</span>.</p>
|
||||
|
||||
<h3><a id="i-o-m-style-properties" name="i-o-m-style-properties">Style Properties</a></h3>
|
||||
<p>The <span class="menu">Name</span> is the only <span class="menu">Property</span> of a style.</p>
|
||||
|
||||
|
||||
<h2>
|
||||
<a href="#contents"><img src="../../images/up.png" align="right" alt="contents" border="0" width="16" height="16" /></a>
|
||||
<a id="i-o-m-transformer" name="i-o-m-transformer">Transformer</a></h2>
|
||||
<p>A shape can have Transformers which change its appearance. The effects, however, are more subtle than a truck turning into a battle robot...</p>
|
||||
|
||||
<h3><a id="i-o-m-transformer-menu" name="i-o-m-transformer-menu">Transformer Add Menu</a></h3>
|
||||
<table summary=" Transformer Add menu" border="0" cellspacing="0" cellpadding="2">
|
||||
<tr><td><span class="menu">Transformation</span></td><td style="width:15px;"></td><td>Offers the same move/resize/rotate options you have by manipulating a shape with your mouse directly.</td></tr>
|
||||
<tr><td><span class="menu">Perspective</span></td><td></td><td>not yet implemented</td></tr>
|
||||
<tr><td><span class="menu">Contour</span></td><td></td><td>Adds an outline to a shape.</td></tr>
|
||||
<tr><td><span class="menu">Stroke</span></td><td></td><td>Strokes the path of a shape instead of filling it with a style.</td></tr>
|
||||
</table>
|
||||
|
||||
<p>Depending on the kind of Transformer, you'll get a different set of properties.</p>
|
||||
|
||||
<h3><a id="i-o-m-transformer-properties" name="i-o-m-transformer-properties">Transformer Properties</a></h3>
|
||||
<p>Besides a <span class="menu">Name</span> and the actual <span class="menu">Width</span> for the transformer, the <span class="menu">Property</span> view has these (depending on its type slightly differing) options:</p>
|
||||
<table summary="Transformer properties" border="0" cellspacing="0" cellpadding="2">
|
||||
<tr><td><span class="menu">Caps</span></td><td style="width:15px;"></td><td><i>Stroke only</i>. Defines the end caps of a line: <span class="menu">Butt</span>, <span class="menu">Square</span> or <span class="menu">Round</span>.</td></tr>
|
||||
<tr><td><span class="menu">Detect Orient.</span></td><td></td><td><i>Contour only</i>. Makes sure the contour always extends outwards when you have self-intesecting paths.</td></tr>
|
||||
<tr><td><span class="menu">Joins</span></td><td></td><td>Defines how lines are joint at a point: <span class="menu">Miter</span>, <span class="menu">Round</span> or <span class="menu">Bevel</span>.</td></tr>
|
||||
<tr><td><span class="menu">Miter Limit</span></td><td></td><td>Only when the above <span class="menu">Joins</span> is set to "Miter" this setting influences the looks of the miter joint. </td></tr>
|
||||
</table>
|
||||
|
||||
|
||||
<h2>
|
||||
<a href="#contents"><img src="../../images/up.png" align="right" alt="contents" border="0" width="16" height="16" /></a>
|
||||
<a id="i-o-m-save" name="i-o-m-save">Saving an icon</a></h2>
|
||||
<p>There's your usual menu bar at the top, <span class="menu">File</span>, <span class="menu">Edit</span>, <span class="menu">Options</span>. The usage is pretty much self-explaining, so we'll only look at how to save your work.</p>
|
||||
<p><span class="menu">File | Save As...</span> will save in a special Icon-O-Matic format that retains additional information like the names of paths, shapes and styles. These will be stripped from the actual icon once you export it to save space. It's a good idea to back-up your work like this, because without named objects everything's named "<path>/<shape>/<style>" which makes specific changes tedious.</p>
|
||||
|
||||
<p><span class="menu">File | Export As...</span> opens a familiar save panel with a file format dropdown menu at the bottom, offering these choices:</p>
|
||||
<table summary="file formats" border="0" cellspacing="0" cellpadding="2">
|
||||
<tr><td>HVIF</td><td style="width:15px;"></td><td>Haiku Vector Icon Format</td></tr>
|
||||
<tr><td>HVIF RDef</td><td></td><td>Saves as resource used by programmers</td></tr>
|
||||
<tr><td>HVIF Source Code</td><td></td><td>Saves as source code used by programmers</td></tr>
|
||||
<tr><td>SVG</td><td></td><td>Saves as SVG</td></tr>
|
||||
<tr><td>PNG</td><td></td><td>Saves as a 64px sized PNG</td></tr>
|
||||
<tr><td>PNG Set</td><td></td><td>Saves as 16, 32 and 64px sized PNGs</td></tr>
|
||||
<tr><td>BEOS:ICON Attribute</td><td></td><td>Choose a file and set its icon attribute directly</td></tr>
|
||||
<tr><td>META:ICON Attribute</td><td></td><td>Choose a file and attach the icon as mere meta data</td></tr>
|
||||
</table>
|
||||
|
||||
|
||||
<h2>
|
||||
<a href="#contents"><img src="../../images/up.png" align="right" alt="contents" border="0" width="16" height="16" /></a>
|
||||
<a id="i-o-m-tips" name="i-o-m-tips">Tips & Tricks</a></h2>
|
||||
<p>A few things you should keep in mind when working with Icon-O-Matic and some general tips for its usage:</p>
|
||||
<ul>
|
||||
<li><p>Read the <a href="http://factory.haiku-os.org/documentation/icon_guidelines/">Icon Guidelines</a> to learn about important characteristics of Haiku icons, e.g. perspective, colors and shadows.</p></li>
|
||||
<li><p>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.</p></li>
|
||||
<li><p>Wherever possible, you should activate the lowest possible Snap-to-Grid resolution from the <span class="menu">Options</span> menu, i.e. 16x16 saves the most in file size. You'll also get the crispest look if points are set on exact pixel borders.</p></li>
|
||||
<li><p>Check the preview to see if your icon still looks good in 16x16. You may want to use the <a href="#i-o-m-shape-lod">Level Of Detail</a> settings described in the Shapes section.</p></li>
|
||||
<li><p>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, adjust font type and style, and drag&drop the selected text into Icon-O-Matic. This will create the according paths and shapes.</p></li>
|
||||
<li><p>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.</p></li>
|
||||
<li><p>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 <span class="key">SPACE</span>.</p></li>
|
||||
</ul>
|
||||
|
||||
|
||||
<!--
|
||||
<h2>
|
||||
<a href="#contents"><img src="../../images/up.png" align="right" alt="contents" border="0" width="16" height="16" /></a>
|
||||
<a id="i-o-m-workshops" name="i-o-m-workshops">Workshops</a></h2>
|
||||
<p>The above is of course quite theoretical. The best way to learn using Icon-O-Matic is by experimenting. To get you started and once more show the basics, have a look at these short clips:</p>
|
||||
<ul>
|
||||
<li><a href="">Paths</a></li>
|
||||
<li><a href="">Shapes</a></li>
|
||||
<li><a href="">Styles</a></li>
|
||||
<li><a href="">Transformers</a></li>
|
||||
<li><a href="">Optimizing icons</a></li>
|
||||
<li><a href=""></a></li>
|
||||
</ul>
|
||||
-->
|
||||
|
||||
|
||||
|
||||
</div>
|
||||
<!--
|
||||
|
||||
<div class="bottomnav">
|
||||
<p>
|
||||
<a href="../applications.html#list-of-apps">Applications</a>
|
||||
   
|
||||
Previous: <a href="apps-expander.html">Expander</a>
|
||||
   
|
||||
Next: <a href="apps-installer.html">Installer</a>
|
||||
</p>
|
||||
<p>
|
||||
<a href="../applications.html#list-of-apps">Applications</a>
|
||||
   
|
||||
Previous: <a href="apps-expander.html">Expander</a>
|
||||
   
|
||||
Next: <a href="apps-installer.html">Installer</a>
|
||||
</p>
|
||||
</div>
|
||||
-->
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@ -63,11 +63,11 @@ When you're done you can save the result from the menu <span class="menu">File |
|
||||
<h1><a id="advanced-keymapping" name="advanced-keymapping">Advanced keymap manipulation</a></h1>
|
||||
<p>There's another method to customize your keymap besides the Keymap preference panel. It involves editing a text file containing loads of hex values, which may appear daunting on first sight, but isn't really that impossible to grasp.</p>
|
||||
<p>You can dump the current keymap with a command in Terminal:<p>
|
||||
<pre class="terminal">keymap -d > MyKeymap</pre>
|
||||
<pre class="terminal">keymap -d MyKeymap</pre>
|
||||
<p>The generated text file can then be opened in a text editor. Make sure to use a fixed font in that editor or you'll never grok that file...<br />
|
||||
At the beginning of that file, you'll find a legend of a stylized keyboard with the hex value corresponding to each key. Below that are the actual assignments of every value. You can do all the customizing that's also available from the Keymap preference panel, and then some. If you happen to have some special keys on your keyboard, you may be able to activate them. That is, use them as ordinary keys or like an option or control key. You won't be able to, for example, have your multimedia keys de/increase the volume or start some application. For this you can use e.g. <a href="http://www.haikuware.com/directory/view-details/utilities/desktop-accessories/spicykeys" class="noprinturl">SpicyKeys</a>.</p>
|
||||
<p>When you're finished, you'll save the file and have your system use the modified keymap with this command:</p>
|
||||
<pre class="terminal">keymap -l < MyKeymap</pre>
|
||||
<p>When you're finished, you'll save the file and have your system load the modified keymap with this command:</p>
|
||||
<pre class="terminal">keymap -l MyKeymap</pre>
|
||||
<p>This is the dumped file (the rightmost keys of the stylized keyboard are cut-off for a nicer display on this page):</p>
|
||||
|
||||
<pre>#!/bin/keymap -l
|
||||
|
||||
@ -40,7 +40,7 @@
|
||||
|
||||
<h1><a id="find-window" name="find-window">The Find window</a></h1>
|
||||
<p>You start a query by invoking the <span class="menu">Find...</span> menu either from the Deskbar menu or any Tracker window or the Desktop (which is actually a fullscreen Tracker window). The shortcut is <span class="key">ALT</span> <span class="key">F</span>. You're presented with the Find window:</p>
|
||||
<img src="../images/queries-images/basic-query.png" alt="basic-query.png" width="517" height="292" />
|
||||
<img src="../images/queries-images/basic-query.png" alt="basic-query.png" width="460" height="206" />
|
||||
<ol>
|
||||
<li><p>Select previous or saved queries or save the current query.</p></li>
|
||||
<li><p>Narrow down your search from "All files and folders" to specific file
|
||||
|
||||
BIN
userguide/images/apps-images/i-o-m-bitmap128.png
Normal file
BIN
userguide/images/apps-images/i-o-m-bitmap128.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 14 KiB |
BIN
userguide/images/apps-images/i-o-m-bitmap16.png
Normal file
BIN
userguide/images/apps-images/i-o-m-bitmap16.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 461 B |
BIN
userguide/images/apps-images/i-o-m-bitmap32.png
Normal file
BIN
userguide/images/apps-images/i-o-m-bitmap32.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 699 B |
BIN
userguide/images/apps-images/i-o-m-bitmap64.png
Normal file
BIN
userguide/images/apps-images/i-o-m-bitmap64.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 4.6 KiB |
BIN
userguide/images/apps-images/i-o-m-gradients.png
Normal file
BIN
userguide/images/apps-images/i-o-m-gradients.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 11 KiB |
BIN
userguide/images/apps-images/i-o-m-lod-icon_16.png
Normal file
BIN
userguide/images/apps-images/i-o-m-lod-icon_16.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 656 B |
BIN
userguide/images/apps-images/i-o-m-lod-icon_32.png
Normal file
BIN
userguide/images/apps-images/i-o-m-lod-icon_32.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.8 KiB |
BIN
userguide/images/apps-images/i-o-m-lod-icon_64.png
Normal file
BIN
userguide/images/apps-images/i-o-m-lod-icon_64.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 4.5 KiB |
BIN
userguide/images/apps-images/i-o-m-overview.png
Normal file
BIN
userguide/images/apps-images/i-o-m-overview.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 114 KiB |
BIN
userguide/images/apps-images/i-o-m-path-ab.png
Normal file
BIN
userguide/images/apps-images/i-o-m-path-ab.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 7.8 KiB |
BIN
userguide/images/apps-images/i-o-m-pointer-add.png
Normal file
BIN
userguide/images/apps-images/i-o-m-pointer-add.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 183 B |
BIN
userguide/images/apps-images/i-o-m-pointer-bezier.png
Normal file
BIN
userguide/images/apps-images/i-o-m-pointer-bezier.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 194 B |
BIN
userguide/images/apps-images/i-o-m-pointer-delete.png
Normal file
BIN
userguide/images/apps-images/i-o-m-pointer-delete.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 166 B |
BIN
userguide/images/apps-images/i-o-m-pointer-insert.png
Normal file
BIN
userguide/images/apps-images/i-o-m-pointer-insert.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 188 B |
BIN
userguide/images/apps-images/i-o-m-pointer-move-path.png
Normal file
BIN
userguide/images/apps-images/i-o-m-pointer-move-path.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 242 B |
BIN
userguide/images/apps-images/i-o-m-pointer-move-shape.png
Normal file
BIN
userguide/images/apps-images/i-o-m-pointer-move-shape.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 209 B |
BIN
userguide/images/apps-images/i-o-m-pointer-resize.png
Normal file
BIN
userguide/images/apps-images/i-o-m-pointer-resize.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 179 B |
BIN
userguide/images/apps-images/i-o-m-pointer-rotate.png
Normal file
BIN
userguide/images/apps-images/i-o-m-pointer-rotate.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 193 B |
BIN
userguide/images/apps-images/i-o-m-pointer-select.png
Normal file
BIN
userguide/images/apps-images/i-o-m-pointer-select.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 165 B |
BIN
userguide/images/apps-images/i-o-m-shape.png
Normal file
BIN
userguide/images/apps-images/i-o-m-shape.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 2.1 KiB |
BIN
userguide/images/apps-images/i-o-m-terminal-bitmap16.png
Normal file
BIN
userguide/images/apps-images/i-o-m-terminal-bitmap16.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 374 B |
BIN
userguide/images/apps-images/i-o-m-terminal-bitmap32.png
Normal file
BIN
userguide/images/apps-images/i-o-m-terminal-bitmap32.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 659 B |
BIN
userguide/images/apps-images/i-o-m-vector128.png
Normal file
BIN
userguide/images/apps-images/i-o-m-vector128.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 15 KiB |
BIN
userguide/images/apps-images/i-o-m-vector16.png
Normal file
BIN
userguide/images/apps-images/i-o-m-vector16.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 747 B |
BIN
userguide/images/apps-images/i-o-m-vector32.png
Normal file
BIN
userguide/images/apps-images/i-o-m-vector32.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 2.1 KiB |
BIN
userguide/images/apps-images/i-o-m-vector64.png
Normal file
BIN
userguide/images/apps-images/i-o-m-vector64.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 5.6 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 25 KiB After Width: | Height: | Size: 24 KiB |
BIN
userguide/images/up.png
Normal file
BIN
userguide/images/up.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 416 B |
Loading…
Reference in New Issue
Block a user