Sprites

Sprites are, within Wonderdraft, sivided into trees, moountains and symbols.

Adding Custom Sprites
Symbols are treated differently from trees and mountains and are also saved differently. Below you can see the general folder structure within the user folder you can open from the Wonderdraft menu +---assets |  \---[Package name] |      +---sprites |      |   +---mountains |      |   |   \---sample_mountains |      |   |           .wonderdraft_symbols |      |   |           mountain_1.png |      |   |           mountain_10.png |      |   |           mountain_11.png |      |   |           mountain_12.png |      |   |           mountain_2.png |      |   |           mountain_3.png |      |   |           mountain_4.png |      |   |           mountain_5.png |      |   |           mountain_6.png |      |   |           mountain_7.png |      |   |           mountain_8.png |      |   |           mountain_9.png |      |   |              |       |   +---symbols |      |   |   \---sample_symbols |      |   |           .wonderdraft_symbols |      |   |           city.png |      |   |           compass_rose_02.png |      |   |              |       |   \---trees |      |       \---sample_trees |      |               .wonderdraft_symbols |      |               tree_01.png |      |               tree_02.png |      |               tree_03.png Through Mythkeeper, the standard to add custom assets is to add a folder with the Package name and the appropriate subfolders to the sprites folder. This facilitates removing the asset packs in case of incompatibility or just plain not liking them.

Metafile
How Wonderdraft handles the sprites is detailed in the .wonderdraft_symbols metadata file, which is formatted in JSON.IF you add a custom sprite within the right folder structure, Wonderdraft will automatically general a metadata file if none is present, this will probably be enough for most intents and purposes. "MyAsset": { "name": "My Asset", "radius": 38, "offset_x": 0, "offset_y": 0, "draw_mode": "normal" }

Metafile properties

 * Rfizeksjzwv11.png: A text description for the image that appears in Wonderdraft when you hover over an symbol in the Symbol Palette.
 * radius: The radius is the collision or exclusion radius around the asset's pivot point. The bigger your symbol, typically, the bigger your radius.
 * offset_x: Offset in the X direction from the CENTER of the image. Positive is to the right and negative is to the left. A value of 0 means the center.
 * offset_y: Offset in the Y direction from the CENTER of the image. Positive is up and negative is down. A value of 0 means the center. See below.
 * draw_mode: One of four values -  normal ,  sample_color ,  custom_colors ,  custom_colors_2 . See below.

draw_modes

 * normal: draws your symbol as is
 * sample_color: adapts your symbol to the ground color
 * custom_colors: uses the RGB channels to colorize your symbol inside Wonderdraft using the currently defined Custom Colors
 * custom_colors_2: uses the RGB channels to colorize your symbol inside Wonderdraft using the currently defined Custom Colors

Offset
The offset allows you to move a symbol's center of gravity/pivot. Useful for tall symbols or asymmetrical ones. The offset is used to help sort the symbols and determine where the collision radius emanates.

The offset also defines the location of selection area when trying to move a symbol or paint those flagged with sample_color.