iconStiX Readme

Welcome to iconStiX

an easy-to-use icon tool to combine & attach image as custom icon

Quick Start

A standard document like the picture below opens when the program starts up for the first time.

1. Drag and drop any item from the desktrop to iconStiX and confirm to replace the placeholder.
2. Drag and drop a folder to the "Attach" drop box.

Combine & Attach

Image as Color (new in v.1.7)

Photo in Shape (new in v.2.0)

Main Features

Document

You can open a new empty or standard document (see the "File" menu).
Save (⌘S) a document to keep your modifications.
From the next time, the document used last time opens at start-up.

Objects Table

Objects (image and text) displayed in the preview are listed in the table below the preview.

The object listed at the bottom is drawn first; the one at the top, last.
The column and/or row order can be changed with drag & drop.
You can change the row order also with an up or down arrow key while the shift-key pressed down (without the shift-key selection is changed).
To change the row height, move the vertical slider next to the table.
To increase the table height, enlarge the window (drag the window's right-bottom corner).

Separate 16x16

Icons displayed in the smallest size of "16x16" may not be distinct enough if they are automatically scaled down from maximum 512x512. In such a case, you can use a separate image. Click the button "Add separate 16x16" and select a file whose image contents or whose icon image you want to use. Afterwards, you can replace images by dropping another file on the small area showing the 16x16 image. It is removable by clicking the same button.

Preview

You can preview the icon image in different sizes (between 16 and 512) by click the "Preview" button.
In the preview mode click the "Animate" button to see the image resizing automatically or move the slider manually.
CLick "Edit" to go back to the edit mode.

Attach and Remove Custom Icon

To attach the current image shown in the preview as a custom icon, drop a desktop item (folder, file or volume) in the "Attach" box.
To remove a custom icon, drop a desktop item in the "Remove" box.
Alternatively, right-click or ctrl-click on a desktop item to open the contextual menu and select "Attach Custom Icon" and "Remove Custom Icon" respectively.

Save as Image (Export)

Select "Export" under the "File" menu to save the current preview image in the icns, png or tiff format. To add custom icon, select the respective option. Note: "icns" files look the same on the desktop with or without custom icons. However, without custom icons, their generic icons appear on copy & paste.
Tip: on the navigation panel you can select an already existing document to copy its name to be modified.

Favorites

Click the "Show Favorites" button to open the favorites panel, where you can collect your favorite icon images.

• Drop a desktop item to the collection view to add a favorite image.

Tip: Bring the item close enough to an existing image to see it slide aside before dropping.

• Alternatively, you can copy image to the clipboard and then paste it to the collection view (⌘V).

Tip: Ctrl-click or right-click on a desktop item and select "Copy Icon" from the contextual menu.

• Drag a favorite image to a row of the objects table to replace images.

Tip: Keep mouse down on a favorite to see it duplicate before start dragging.

• Drag & drop image within the collection view to reorder.

• Press the backward delete key (←) to remove the selected favorite image.

Editing:

• Select Object

Click an object in the preview or click a row of the objects table.
The latter is required to select an object smaller than the currently selected one.
To select more than one, click while holding the shift-key.

• Add / Replace Image

Drag & drop a desktop item, whose icon or image contents (if any) should be used, to the preview.

You can also drag & drop image from the favorites panel.

Image in the clipboard, if any, can be pasted with ⌘V (you can copy the preview image to the clipboard with ⌘C).

When there is no current selection, the new image object is added. Otherwise, you are asked if you like to replace or add.

Table rows of image objects also accept image drag-and-drop.

• Add / Modify Shape

Click the "+ Shape" button.

Click "Frames" to open the option panel, where you can select a different form and modify a few properties such as stroke color, thickness and style.

• Add / Modify Text

Click the "+ Text" button.

To edit contents, double-click a relevant row on the objects table and overwrite the text. Use alt+return to write multiple lines.
While editing, a contextual menu is available with right-click (or ctrl-click).

To change fonts, finish editing contents and click the "Show Fonts" button.

• Remove Object

Select an object and press the backward delete key (←).

• Move

Drag the selected object in the preview or use the X and Y sliders.

Use the arrow keys to nudge the selected object.

Click the "Center X" and/or "Center Y" button to locate the object at the middle of the preview.

Note: if multiple objects are selected, use the sliders to apply the same value to all the objects.
To move the objects relatively to their current location, locate the mouse around the middle of the four corner knobs and drag.
You can also use the arrow keys.

• Resize

Drag a corner knob of the selected object or use the Width and Height sliders.

To resize pixel by pixel, use the arrow keys with the shift (or alt) key.

Select or deselect the "Scale proportionally" option depending on if you like to keep the image's current width-height ratio (Note: text objects are scaled proportionally).

Click the "Original Ratio" button to get back the image's original ratio.

Note: if multiple objects are selected, use the sliders to apply the same value to all the objects.
To resize the objects relatively to their current size, drag a corner knob in the preview or use an arrow key with the shift-key.

• Rotate

Use the circular slider to rotate the selected object. Select the "Rotate by 45°" option, if you like to stop only at o, 45, 90… degrees.

• Skew

Use one of the four sliders to transform the selected object to a shape illustrated at each end of the sliders.

• Color

To change color of the selected object as a whole, click the color well and select color on the color panel.
Drop a file with image contents to the box on the color panel or to the color well directly to use picture as texture (valid for image or shape objects).

Click "Reset" to use the default colors (transparent for image, dark gray for text).

• Fonts

Select a text object and click "Show Fonts" to open the font panel. Then you can not only change font but also add stroke and aqua-like effect.

• Shadow

Drag the cross in the shadow view to add shadow to the selected object.

To remove, drag back to the center position or enter 0 to the offset text field.

Further, you can change the following options by opening the Preferences (⌘,) :

∙ whether to terminate the program after the last document window is closed.

∙ whether to keep iconStiX open after it started for services.

✓ iconStiX offers 4 services if you ctrl-click or right-click an item in the Finder:

- Open with iconStiX: open iconStix using the image of the selected item.
- Copy Icon: copy the icon image of the selected item to the clipboard.
- Attach Custom Icon:
   (a) add the preview image to the selected item if iconStiX is running;
   (b) add image in the clipboard to the selected item if it is not running;
   (c) if there is no image available, you can choose to open the iconStiX document lately used or cancel.
- Remove Custom Icon: remove a custom icon if the selected item has any.

✓ As usual with other Finder services, you can disable one or more services by opening "System Preferences" (select the menu item under the Finder/Services or click the button "Open Services Preferences Now" on the iconStiX preferences panel.

∙ whether to confirm when an item is dropped in the "Remove" box.

∙ whether to warn when an item which already has a custom icon is dropped in the "Attach" box.

∙ whether to replace, add, or ask what to do when an image is dragged to a document window's preview area or to the application icon while there is an image object already selected.

✓ If you select "replace without asking", make sure which object is selected before saving a document. When you start the program next time with any image source, the object selected last time becomes the replacement target.

You can read most of the above main features by clicking info button on a document window or on the Favorites & Preferences panel.
Also please refer to "How to select or deselect iconStiX services" if you require more details on services.

Hope you enjoy iconStiX

Disclaimer

The software iconStiX and its documentation are provided on an 'as is' basis without any other warranties or conditions, express or implied, including, but not limited to, warranties of quality, correctness, accuracy, and reliability, or otherwise. The entire risk as to the results and performance of the software is assumed by you (the user). Trollin (the author) shall have no liability to you for any indirect, incidental, special, or consequential damages whatsoever, including, but not limited to, loss of data or profits arising in any way out of the use of the software, even if the author has been advised of the possibility of such damages or they are foreseeable.