Skinning How To/Skin the viewer

Intro

Creating a new skin for the viewer typically involves two steps:

1. Recoloring the texture files (buttons, icons, toolbar, etc).
2. Recoloring the viewer elements set in colors.xml (text color, window color, etc).
3. (Optional): Editing any other xml files than colors.xml (in other words making layout changes, etc).

This is a basic guide.

Recoloring stuff

Texture files

• The viewer's texture files are located in \SecondLifeReleaseCandidate\skins\textures in Release Candidates and \SecondLife\skins\textures in the current release viewer.

Almost all the files you need to edit are in the Targa (.tga) format and must be opened with an image editor to be changed. These are named after their functions:

• icn_* files are icons.
• ff_* files related to the friends list.
• inv_folder* files are inventory folders.
• inv_item* files are inventory items.

Etc.

• NOTE: This folder also contains files in the Jpeg2000 (.j2c) format. These are the OI HUD and miscellaneous viewer files. You will never need to edit them, except if you want to change the login screen (startup_logo.j2c). To do so, you need to have a program that can save Jpeg2000 Codestream files (any program that can write .j2c or .j2k files; the two extensions are interchangeable).

To recolor an image:

1. Open it in your image editor.
2. Apply a color mask.
3. Save it, overwriting the original image.

This process is unique to the program you're using, but Yukiko Omegamu has provided a video tutorial for Photoshop.

• NOTE: Not every file in the \textures\ folder is used, like icn_media-stop_enabled.tga. For a full list, see Legacy files.

colors.xml

• colors.xml is located in \SecondLifeReleaseCandidate\app_settings in Release Candidates and \SecondLife\app_settings in the current release viewer.

Colors are set using the following format:

value="[RED],[GREEN],[BUE],[OPACITY]"

...where R,G,B,Opacity are each in the range 0-255. For opacity, 128 is half opacity (ergo, half transparent).

(Note: Opacity is also sometimes called the Alpha value. See this tutorial for a more detailed explanation of RGB).

• You can use the website http://www.colorschemer.com/online.html to quickly generate RGB values.

editing colors.xml

There are two ways to edit colors.xml:

1. Copy the entries you want to edit from colors_base.xml into colors.xml, then change them there.

For example:

<!-- CHAT AND IM HISTORY TEXTBOX COLORS -->
<ChatHistoryBgColor value="0, 30, 80, 200" />
<ChatHistoryTextColor value="255, 255, 255, 255" />
<IMHistoryBgColor value="0, 30, 80, 128" />
<IMHistoryTextColor value="255, 255, 255, 255" />

1. Use the fully commented colors.xml file on the wiki.

Editing other stuff

• Read Skinning_HowTo/Basics