PixelToy 2 Reference

Apple Menu
About PixelToy... | Register...
About PixelToy...
Opens a window naming the perpetrator of the colossal timewaster known as PixelToy. Also shows the exact version number in the lower left corner. While this window is open, the main window will not animate. A mouse click just about anywhere in PixelToy will make the About PixelToy window go away.

Register...
Information on how to pay for this program is here, as well as a place to type in your name and registration code when you receive them.

File Menu
Open Image... | Reload last Image | Save Image... | Save Current Sets As... | Create Movie... | Clear Screen | Pause | Close Window | Quit
Open Image...
Open an image to be distorted and drawn upon. All common image formats are supported (PICT, JPEG, GIF, etc.). Images are used as grayscale image when opened, and color information is ignored because PixelToy generates its own color. Normally, PixelToy will resize the window to match the image's resolution, however you can disable this in the Preferences dialog.

Reload last Image
Wow, PixelToy sure destroyed that image quickly! Reload it again automatically with this command. PixelToy will not resize the window to fit the image; if you want it to, reopen the image with Open Image.

Save Image...
Save the window's current contents as a PICT image. The image will be stored as an 8-bit (256 color) image unless you had the High Quality option enabled, in which case the image will be stored in 24-bit (millions of colors).

Save Current Sets As...
Save all sets shown in the Sets menu into a new Sets file. After doing this, any further changes to the Sets will be saved to this file. See About sets.

Create Movie...
Start saving a QuickTime Movie. You'll be asked what frames-per-second you'd like the resulting movie to play at, what compression method to use, etc. The best compression method will depend a lot on what you've got going on in the PixelToy window; QuickTime will automatically recommend one by having it as the default. After starting a movie, you can hold down command-period or select this same menu command (which will be called "Stop Movie") to end movie creation. QuickTime movies created by PixelToy can get huge - PixelToy will automatically stop creating the movie if you're about to run out of disk space. Creation of movies is only possible when running in Thousands or Millions of colors. You can do anything except resize the PixelToy window while making a movie.

Clear Screen
Wipes the PixelToy window clean.

Pause
Halts animation. Select this command again to start the animation again. This command is particularly handy when creating a movie; set all of your options, pause, clear screen, then begin creating the movie. Nothing will be written to the movie until you un-pause the animation.

Close Window
As you might expect, except that if you close the main PixelToy window, the program will completely quit.

Quit
The unspeakable horror!

Options Menu

Pixel Doubling | High-Quality | Full Screen | Dither Updates | Preferences | Apply Filters Last | Image Emboss | Text Options | Particle Options | Misc Options

The first section of the Options menu consists of global settings which persist even when loading sets.
Pixel Doubling
Speeds up animation by lowering the image quality. A must on slower Power Macs. Can't be on at the same time as High-Quality mode.

High-Quality
Slows down animation by increasing the image quality. Slows down animation A LOT. G3-based Macs might perform bearably with this option, but others will probably only want this option on when creating movies. High-Quality mode can only be turned on when displaying Thousands or Millions of colors. Can't be on at the same time as Pixel Doubling.

Full Screen
Toggles between Full Screen and windowed mode. While in Full Screen mode, you can make the menu bar appear by clicking up where it should be; it will become visible.

Dither Updates
Available only when displaying Thousands of colors, this option will mix colors when drawing to avoid the bands of solid color that tend to appear in Thousands of colors otherwise. This option will slow down animation massively.

Preferences
This dialog lets you control many global settings of PixelToy.

Don't Let Images Resize Window keeps the Open Image command from resizing the PixelToy window to the size of the image being opened. Don't Show Splash-Screen keeps the About PixelToy window from appearing when you start PixelToy. Use First Set of Opened Sets enables PixelToy to automatically use the first set in a Sets file when the file is double-clicked or drag-and-dropped on PixelToy. Show Set Comments allows a set to display its comments when it is used. Speed Limit will restrain the animation speed to the number of frames-per-second that you type here. Allow Rough Random Colors permits the Random Palette command to create more rough-edged palettes. Keep Mouse Hidden hides the mouse cursor when it is over the PixelToy window. Note Missing Fonts allows PixelToy to notify you when you load a set that uses fonts not installed on your computer. Auto-Switch Main Display to: will change your display(s) color mode to the selected value when PixelToy is started. Auto-Switch Main Display to Low Res will change your display to 640 x 480 pixels when PixelToy is started. For both of these auto-switch options, the original settings are restored when PixelToy is exited. Window Size allows you to set exact dimensions for the PixelToy window, useful when creating movies.

The second section of the Options menu consists of local settings that are stored in sets.
Apply Filters Last
Apply Filters Last makes PixelToy apply the Filters after the Actions, instead of the normal behavior of applying the Filters before the Actions. This is particularly useful when using the Kaleidoscope filter.

Image Emboss
This option applies a graphic filter that makes the normal display appear as protrusions and indentations in a surface. Embossing usually looks best with a continuously shaded color palette such as Greyscale; if you generate a random color palette while Image Emboss is enabled, the created palette will be continuously shaded.

Text Options
You can edit all aspects of text in PixelToy within this window. Create up to 16 different text objects, each with its own font, action, brightness, and size.

List order: Text is drawn from the top of the list down; therefore, if you have overlapping text objects, the lower item in the list appears on top of a higher item. You can use the Move to Back and Move to Front buttons to shuffle your text objects around to your liking.

Actions: Stationary merely stays where you put it. Jitter causes the text to vibrate like it's fulla caffeine. Bouncing (Zero G) makes the text bounce off the four walls like a ball in Pong. Bouncing (Gravity) will make the text bounce like a ball trapped in a box, until it slows down, at which point it is given a kick to get moving again. Wandering text objects bumble around at random. Finally, Mouse simply makes the text appear where the mouse cursor is. This last one is best accompanied by activating the 'Keep Mouse Hidden' option in the Preferences window.

Brightness: Fixed allows you to specify a brightness level with the slider control. Pulsing makes the text brightness go from 0% to 100% and back to 0% continuously. Based on Sound makes the brightness of the text depend on the sound volume of the currently selected sound input device.

Size: Text size is expressed as a percentage of the window height; values anywhere from 0% to 400% are allowed. Based on Sound makes the text size change based on the sound volume of the currently selected sound input device.

Particle Options
All particle controls are located on this window. You can have up to 16 different particle generators defined, listed on the left.

Name: This is for your organization only; the name isn't displayed anywhere else in PixelToy.

Particle Type: Water is the default type. Bugs bumble around, and if solid, will periodically land on bright objects. Snow falls from the top of the screen and (once again, if solid) will collect on bright surfaces. Repulsion particles avoid bright objects and each other.

Action: Stationary generators stay still. Follow Mouse aims the generator in the general direction of the mouse cursor. You may want to activate the 'Keep Mouse Hidden' option in the Preferences window along with this. Random makes the generator act like a Wild Water Weasel. React To Sound makes the Flow Rate and speed of the generator based on the sound volume of the currently selected sound input device.

Other Controls: Flow Rate adjusts the amount of particles which come out of the generator. Gravity controls the force pulling the particles to the bottom of the window. Particle Size controls the size of the individual particles; to ensure that the particles look the same with and without Pixel Doubling enabled, set the size to at least 10%. Spout Width and Spout Height control the size of the area from which the particles are emitted. Spray controls how much particles can randomly vary from the direction and speed you have defined in the preview window. Bounce off walls & ceiling allows you to only let the particles out through the bottom of the window. Solid particles are affected by other objects (including each other). Be careful; if your flow is high and your spout is small, solid particles will bunch up and 'clog up' the particle generator. Repulsion particles are always solid.

Misc Options
Actions other than the Particle Generator and Text are customized here. Control the number, size, and other features for each action individually.

Actions Menu

Bouncing Lines | Wander Balls | Insect Swarm | Raindrops | Sound Wave | Doodle | Text | Particles
Bouncing Lines
Lines that arc and bounce across the screen. You can use the Misc Options dialog to control how many lines exist, line thickness, and whether or not they change size based on sound input.

Wander Balls
Circles that wander aimlessly around the screen. You can use the Misc Options dialog to control how many dots exist, ball size, and whether or not they change size based on sound input.

Insect Swarm
A swarm of bees tries to catch the queen bee, while the queen bee chases after a point that changes every time it catches it. You can use the Misc Options dialog to make the queen bee chase the mouse cursor, hide the queen been, define how many bees exist, control how quickly the 'drones' react to the queen, and specify whether or not they change size based on sound input.

Raindrops
Random circles splat all over the screen like fat raindrops. Use the Misc Options dialog to control rain rate, size and sound reaction.

Sound Wave
Draws a sound waveform based on the device defined as your sound input. In the Misc Options dialog you can set a horizontal waveform and/or a vertical waveform, along with their thicknesses. You can select your input device in the Monitors & Sound control panel or (more quickly) from the Control Strip. Using the microphone is fun, but using the CD as sound input while playing your favorite CD is just too cool.

Doodle
With this option turned on, you can click and drag in the PixelToy window to draw. You can control line thickness in the Misc Options dialog.

Text
Enables any text objects to be drawn; see the Text Options command for information on creating text objects.

Particles
Enables any particle generators to be drawn; see the Particle Options command for information on creating particle generators.

Filters Menu
About Filters
Selecting these menu items adds the filter you selected; you can have any number of filters turned on, though the more filters you have on, the slower animation will be. You can activate a filter by itself by pressing the letter key preceding its name; all other filters are turned off automatically. If you want to add a filter via the keyboard, hold down the shift key when typing the letter.

Edit Custom Filter
All of the preset filters are fast because they are optimized specifically for what they do. If none of the presets do what you want, you may be able to achieve the desired effect via the Custom Filter. Every pixel that is filtered through the custom filter uses this table of numbers to determine the filter behavior. The center cell represents the pixel you are generating, all others represent neighboring pixels. A number represents the weight, or importance of a pixel. In this example, the original pixel is worth 40, the pixel directly below is worth 32, and so on. All of the pixel values are added up based on these weights, and divided based on the target value. Normally you want your total and target equal (100%), but interesting effects can be generated by setting a lower or higher target. Numbers used here are arbitrary and are only important in their values relative to one another. The percentage shown next to the total is the only absolute number used in this dialog. You can load and save custom filter settings -- the quickest way to learn how the custom filter works is to load some of the included filters and observe the resulting effect. Note that because of its user-defined nature, the Custom Filter is not optimized and can be several times slower than the preset filters.

Colors Menu
Random | Add this Palette... | Delete a Palette... | Show Color Editor | Previous | Next
About Color Palettes
Random
Generates a new palette randomly. They can't all be gems - luckily the random palette generator is instantaneous. If you have the Image Emboss option turned on, the palettes generated will be of only one hue, in a smooth gradient. Activating the 'Allow Rough Random Colors' option in the Preferences dialog will make the generated palettes more rough-edged.

Add this Palette...
Allows you to add the current color palette to PixelToy's Colors menu. After adding a color palette, you can always return to it by selecting it from menu. Technical Note: Color Palettes are stored within the PixelToy application itself as 'clut' resources.

Delete a Palette...
Here you can remove that truly awful color palette you created earlier. You can delete any palette stored in PixelToy, including the ones PixelToy came with. However, you can't delete the 'Grey' palette.

Show Color Editor
This command opens or closes the 'Color Palette Editor' window. Colors are shown in the same order as English text - left to right, top to bottom. You can click on a color to change it, or click and drag from one color entry to another to blend from the beginning color to the end color.

Previous
Activate the previous color palette listed in the Colors menu.

Next
Activate the next color palette listed in the Colors menu.

Sets Menu
Add this set | Delete a set | Rename a set | Edit set comments | Timed Set Cycle | Previous | Next
About Sets
Add this set...
This command allows you to take a 'snapshot' of all of the current settings and save them under a single name. You can then later select this name from the Sets menu to restore these settings all at once.

Delete a set...
Allows you to delete a set from the Sets menu. If you want to remove them all, just delete the current Sets file while PixelToy isn't running.

Rename a set...
Since Sets are always listed in alphabetic order, this is a handy way to arrange your sets in the order you want them.

Edit set comments...
Edit the comment for an existing set. If the Show Set Comments option in Preferences is on, the comment is displayed when the set is used.

Timed Set Cycle...
After selecting this option, you can specify how many seconds you wish to elapse between set changes. This effectively selects the Next set command for you every X seconds. Select this command again to stop set cycling.

Previous
Activate the previous set defined in the Sets menu.

Next
Activate the next set defined in the Sets menu.

Return to PixelToy Manual