Skin Image
To make a skin file you must first create an image file. This must be a PNG file that should have an alpha layer. The alpha layer can give the image partial transparency. This reduces the number of separate images needed and gives a much better looking end result. The skin image will contain all the square images needed to make a complete skin. The images are placed side by side.

The size of each image can be any number of pixels, but a size around 100x100 is reasonable. A larger size gives nicer graphics but larger skin file and a smaller size doesn't look so good when enlarged. You can use any image editor (Photoshop, PaintShop or any other) to create the skin image.


The total number of images needed depends on the following choices: The order of the images is not important. The Classic 2 skin looks like this in the skin tool.



Transparency
The images can be made transparent using an alpha channel, this is especially useful for the package and Sokoban images. When a package or Sokoban passes from floor to goal and is halfway between, it looks much nicer if the image is transparent. Transparency also reduces the number of images needed. If the Sokoban image is transparent, the same image can be used for Sokoban on floor and on goal. Note the checkered background of transparent images.



Wall Top
The Wall Top image is used to cover the hole that appears when four walls are placed in a square. The left image is without Wall Top and the right is with. Wall_Top_X specifies how much to offset the image to the right and the Wall_Top_Y gives the offset downwards.

Background Image
The background is what is shown around and outside the actual level. It can be specified with the Outside parameter which indicates one of the pictures in the Skin image.

A background can also be a separarate image with a different (larger) size than the pictures in the skin image. Use the Assign External Background function to include a background image and the Embed External Background function to make it embedded in the skin file. The background should be a tiling picture.


Skin Tool
The skin file is a text file. It can be created with any text editor, but easiest is to use the Skin Tool. Use New or New from Template to create a new skin file. You can also open an existing skin file and use Save As to give it a new name and then start to modify it. Now, you must assign the image you created. Make sure you saved your image in the same folder as the skin file. Use Assign External Skin to connect the image with the skin file. Please note, that the skin now consists of two files, the skin file and the image file. It is a good idea to have the image external during the design of the skin, this makes it easy to modify the image, save it and immediately run the game and see how the skin looks.

When you are satisfied with the design of your skin you should use Embed External Skin to embed the image within the skin file. Use View Images to see the image. On the image window, you can see the numbers of the individual images. Use these numbers as parameter values. The size and type of image is shown on the top.

The next step is to edit all the parameter values in the skin file. Fill in the Description part with the appropriate values. The skin section contains the values that identifies the individual images. See the Skin Reference for a complete description of all parameters. See also Skin File Format for an example skin. Next use Validate Skin to make sure there are no errors. Run the Sokoban game and select your skin to see the result of your work, just make sure you saved the skin file in the path specified in the game options.