Tagger

To be used in the game pictures should be tagged, ie renamed according to their content. It could be done manually, but it's much faster and easier to do with the help of out tagger. Base game had a few characters packs if you don't understand the idea.

Unique characters are in game/content/chars Random characters are in game/content/rchars

For more information about tags see this.

To download the tagger, use these links: Win 32 bit, Win 64 bit

Optional ini file Should be in the same folder.

About The Tagger

The tagger has two versions, 32 and 64 bit. It works on vista and newer windows os (yeah, xp is not supported). No idea about Linux, we never had a chance to test it. It also has an optional ini file that contains some basic settings, but without it the tagger works as usual using default settings.

How to use it

• Almost all interface elements have tooltips if you don't understand something.
• For a start you should open a folder with pictures using Open button. It will open default windows explorer dialog where you can select folders.
• After opening you will see the list of pictures in the file list. It only can see jpg/jpeg and png formats. But it cannot filter out animated jpgs and pngs, and does not support them, just like the game. If you try to select one, the tagger will throw an error (nothing bad will happen though).
• Before beginning to tag, you need to rename all pictures. The name of a tagged picture starts with a unique hexadecimal index. The tagger does it automatically with Purge and Normalize buttons. Purge renames ALL pictures in the folder. Normalize renames only untagged files analyzing the structure of files names, but it works a bit slower.

Use Purge when you are going to tag pictures from the scratch, ie none of the pictures in the folder were tagged already. Use Normalize when you for example want to add new pictures to already existing, tagged pack.

• After pictures were renamed (it might take a few seconds depending on number of the pictures and your hardware) you can begin tagging. In order to do it you need to select a picture in the file list (the tagger will show it on the right), select suitable tags and press Save button. After that the tagger will rename the picture, saving selected tags in the file name. After you press Save button, the file list gets focus, meaning you can use arrows on keyboard to quickly select next picture.
• When you select an already tagged picture, the tagger reads tags from its name and shows them by checking appropriate checkboxes.
• Delete button will delete the currently selected file, for example if it's not good enough for your pack.
• Reset Tags button resets all tags checkboxes in the tagger gui (only gui, not file name). Use it if you selected a wrong tag by accident.
• Refresh button refreshes the file list. Use it if you added or removed pictures in the currently opened folder.
• Up and Down buttons serve to select previous or next pictures in the file list. You can do it in the file list directly, but some people prefer buttons.
• Types option allows to sort images by extension. The last option, "Mask", uses the mask field next to it in order to show specific files when you need it. Generate Mask button next to it generates mask depending on currently selected tags, allowing you quickly find needed pictures.

An example: if you want to see all SFW Profile pictures in a tagged pack, you should select SFW and Profile flags, press generate mask button and select Mask option. The tagger will show you all files with those tags. Of course you can manually edit mask filed too if needed.

• Show File button opens windows explorer and shows you the currently selected picture. This is useful when you want to edit it for example.
• The tagger will reload the picture if you click on the image on the right. Useful if you just edited it in editor and want to check how it looks.
• Text field above buttons shows file name without extension. It's read only, so you can use it only to copy the file name to clipboard if you need it for some reason.

Ini File

The ini file is an optional thing that allows you to change some default settings. It should be called settings.ini, and should be in the same folder as the tagger. It works with both 32 and 64 bit versions alike. You can edit it using any text editor (I recommend notepad++).

• Path means the path that opens when you try to open a folder in the tagger. By default it uses the folder where the tagger is located, but if you keep all your pictures in one folder, it will be wise to set it there for convenience.
• Height and width are sizes of the tagger window when you open it. Cannot be less than 690x1250.
• Color options allow to freely select a color for most elements of gui and text fields using RGB format (google it if you don't know how it works, it's very simple).

Additional Notes

• It might be not safe to use Normalize option, especially on a fresh, untagged pack. If you are unlucky, there could be files that have correct format like "XXXX-YY-YY-YY-...-YY.extension", where XXXX is a hex number and YY are tags letters divided by "-". But such files unlikely will have correct tags, of course.
• You can resize the window with mouse using bottom right corner, and both picture area and file list will become larger too. You still cannot make it smaller than 690x1250, because then there will be not enough space for all elements.
• After you open a folder with images and select a picture, you can see in the window title how many pictures remain in the file list below the selected one. This way you can see how many pictures left when you tag them.
• You can't change buttons color via settings.ini because default Delphi buttons are a wrapper around Windows buttons. And in Windows you need to change Personalization settings in order to make buttons different. It's possible to write your own component instead of default buttons, but it's very far from our main priorities.
• Every picture must have a hex index. Meaning that a character cannot have more than 65536 jpgs and 65536 pngs images. That should be more than enough though.