Paint Wizard

Paint Wizard

The Paint Wizard can be used to paint any Shergood Aviation aircraft, and securely package paints from it for resale. The Paint Wizard kit includes the Paint Wizard itself, and a V3.0 Shergood Paint Bucket. Unlike the 2.0 paint kit system, no notecards or drop-in textures are used to configure it. It is programmed only from the Paint Wizard. Paints may be applied to an aircraft directly from the Paint Wizard, or through paint cans programmed by it.

1 Basic Operation

1.1 Selecting a Configuration

When you first rez the Paint Wizard, no active configuration is selected. The text "select configuration..." will be shown on the display bar. Click the display bar, to get a menu of possible configurations. A configuration is a combination of an aircraft, and a specific paint for that aircraft. The Paint Wizard comes with configurations for all SA aircraft at the time the kit was published. In addition, you may also add your own configurations. This will be described in Adding Configurations.

Use the "NEXT>>" and "<<PREV" buttons to page through the selections. Once you select a configuration, the Paint Wizard will load the configuration, and configure the wizard for editing that paint. Selecting the ":RESET:" option will reset the scripts and load any newly added configurations.

Once a configuration is loaded, information about the loaded configuration will be displayed on the display bar. The top line will show the aircraft id and the name of the paint. The bottom line will show the name of the paint creator.

You can exit a configuration and select a new one by clicking the base of the Wizard then selecting ":RESET:" from the main menu. This will purge the current paint, and bring up the menu of paint configurations to select from.

1.2 Editing a Paint

Figure 1: Paint Tile

Once a configuration has been loaded, the backboard of the Wizard will be populated with tiles, one tile for each texture used in the paint (see Figure 2). Each tile has the following parts:

• Label - The name of the texture is shown in blue at the top of the tile.
• Texture Box - A large box using most of the tile space below the label shows the texture that is assigned to that name.
• Material Selector - A selector on the right side of the tile with settings DIFF, NORM and SPEC lets you select whether to view the diffuse layer, the normal layer or specular layer for a texture.
• Specular Parameters - Two numbers labeled GLOSS and ENV let you select the Glossiness and Environment values for the specular layer.

To edit a texture, simply edit the texture applied to the Texture Box with the normal SL edit tools. You can also select "blank" or "none" as a texture by clicking on the texture box and selecting the texture from the menu. The "none" texture will display as a large "X" in the box, and will result in no texture being applied for that material layer in that texture.

To select the material layer, click on DIFF, NORM or SPEC to select the layer.

A box at the bottom labeled "n-color" can be used to set the color applied to n-numbers on the aircraft.

1.3 Saving/Adding Configurations

Configurations are saved in notecards in the contents of the Paint Wizard. There are two types of notecards, paint configurations and aircraft configurations. Aircraft configurations describe the names of the textures that are part of a paint for that aircraft type, while the paint configurations describe a specific paint for an aircraft. Typically, only paint configurations will ever need to be managed by end-users.

1.3.1 Paint Configurations

A paint configuration notecard starts with the "*config:" and has the name of the paint configuration appended to it. By convention, the configuration name should include the code for the aircraft type, a dash, and the paint name. For example paint called "marine" for the "s58" would use a configuration notecard named "*config:s58-marine".

Each line in the notecard consists of a key and a value, separated by a "=". Keys without a "@" at the beginning are "kit tags" that get special handling by the paint kit. Keys that begin with "@" are "paint tags" that are part of the visual appearance of a paint.

The following special keys must be defined in any configuration notecard:

Name	Description
name	The name of the paint. This is used in hover text over any paint cans, and in the menu when choosing a paint to apply from the end-user's aircraft paint menu.
creator	The creator of the paint. This text is shown in hover text over paint cans. While the creator may simply be an avi name, it can also be a brand name.
aircraft	The aircraft for which this paint is designed. This will control which tiles are displayed in the wizard, and what aircraft can load the paint. It must be a valid aircraft type.
n-color	The color to apply to the tail number on the aircraft. It should consist of three comma-separated values between angle brackets for the red, green and blue values for the color. The values should be between 0 and 1.

The following is an example of a minimum paint configuration:

name=Marines
creator=Shergood Aviation
aircraft=s58
n-color=<1,1,1>

Most paint tags begin with "@" followed by the name of the texture in that paint. A suffix beginning with "_" is applied to specify different material components of that texture. In additional, the special paint tag "@font" can be used to specify a "font" texture used to draw the numbers in the tail number.

If you have manually edited the NC for the current paint and you wish to reload it, click on the base of the Wizard and select "Reload" from the menu. This will reread the NC of the current paint, and apply it to the tiles in the Wizard.

1.3.1.1 Saving a Configuration

If you have made edits to a configuration through the Wizard, you can create a save of that configuration in a notecard by clicking the base and selecting "Dump NC". This will dump the current configuration, including any textures you have applied through the tiles, to local chat. Cut and paste the contents of chat between the line labeled "---copy lines below this point" and the line labeled "---copy lines above this point" into a new notecard, or into the notecard in the Wizard you wish to update. Delete any lines containing "-DELETE-THIS-LINE-".

1.3.2 Aircraft Configurations

Aircraft configuration notecards are named with the code for the aircraft preceded by a "_". The code must correspond to a specific Shergood aircraft. Aircraft configurations also consist of key=value pairs, but the only supported tag is "textures". The value of this tag is a space-separated list of texture names that are part of the paint for that aircraft.

For example, the s58 aircraft paint configuration is:

textures=s58-main s58-nose s58-tail s58-winch s58-text

The names on this line must correspond to names understood by the aircraft, though the names on the line may be reordered. The order on the line will control the order in which tiles appear in the Wizard.

1.4 Applying to Aircraft

You can apply a paint to an aircraft directly from the Wizard by rezing the aircraft and Wizard within 10m of each other. You then apply the paint in the same way as you would a paint can.

1. Ensure no avi are sitting in the aircraft.
2. Click the front window on the aircraft to bring up the main menu.
3. Select "@Admin".
4. Select "@Paint".
5. Select "*Custom".
6. Select the name of the paint currently loaded in the Wizard.

1.5 Programming a Paint Kit

Figure 2: V3.0 Paint Can