Generation Methods - Silverfeelin/Starbound-DrawablesGenerator GitHub Wiki

Generation Methods

• Item Descriptor
• Spawn Command
• Inventory Icon
• Single Texture Directives

Item Descriptor

Creates and positions drawables for your selected image, and applies the drawables to the selected active item Template.
The output is a valid item descriptor. For the three basic templates, only with the necessary data present in it to get the item to show up.

Both formatted and unformatted, this output is compatible with starcheat, a Starbound inventory editor.

Example:

{
  "name": "commonshortsword",
  "count": 1,
  "parameters": {
    ...
  }
}

Spawn Command

Creates and positions drawables for your selected image, and applies the drawables to the selected active item Template.

The output is displayed as a valid /spawnitem command, which can be pasted in game to spawn the item. This requires admininstrative permissions (/admin), which means you might have to enter singleplayer to use the command.

Example:
/spawnitem commonshortsword 1 '{...}'

Note that pasting a long command in chat might lower the performance on your game. The game will stabilize once you spawn the item.

Inventory Icon

Creates old-style drawables, that are still used for inventory icons.

Example:

[
  {
    "image": "...",
    "position": [0, 0]
  },
  {
    "image": "...",
    "position": [0, 8]
  }
]

Single Texture Directives

Creates a directives string which can be applied to a single texture (that supports directives), to form the selected image.

For proper results, you must define the Source Image Size. This value depends on the dimensions of the image you will be applying the output to.
For example, if you're creating directives to apply to a 32x64 image, the Source Image Size should be set to 32; the smallest value.

Options

The single texture directives method has three generation options. You can access the options under the button.

• No options selected. The drawable is generated using a sequence of signplaceholders. This is the most basic option but does produce the bulkiest directives string.
• Fade method. This method shortens the directives string by applying a small fade between signplaceholders. The resulting colors may be off by a value of 1, which makes applying directives on top of the drawable unreliable.
• Scale method. This method uses scaling to create a 256x256 placeholder. This method shortens the directives string and the resulting colors are the same as those on the image. This method does not work for images wider or higher than 256 pixels.

Special thanks to Nettle Boy for help with some of the generation methods.

Example:

?setcolor=fff?replace;fff0=fff?scalenearest=3?crop=0;0;32;16?blendmult=/objects/outpost/customsign/signplaceholder.png;0;0?replace;01000101=ff0000ff

---

Output

After generating code, you will be presented with an output window. Here, you have a couple of things you can do with the output.

• Save output to a file on your computer using the Save button.
• Copy the text to your clipboard using the Copy button.
• Remove formatting from formatted output using the Format button (minifies the code).

Sample output for the Spawn Command generation method