Subscribe to download
Stormworks_image_converter [PC to LUA]

Converting Images and GIFs to Microcontrollers
The program can convert images and GIFs. It automatically determines whether it is an image or a GIF, and you only need to:

1. Launch the program downloaded from the GitHub repository[github.com].

2. Select the file by clicking the Select Image button.
3. Enter the compression level (the lower the number, the less loss, but the higher the load on the controller).
4. Enter the image size (1 block equals 32 pixels, for example, for a 5x3 block screen you need to specify 160x96 pixels).
5. Choose the controller name that will be saved in .xml format in the game's save files. If such a file exists, the program will suggest replacing it. The program will automatically create the controller and place it in the appropriate folder, no further action is needed.
6. Attention! When entering the game, do not open the controller with the select tool, as the game will crash due to the large amount of text recorded. You can open the controller by going to the microcontroller editor mode and loading it there.

The controller will contain property texts and a Lua block with the image or GIF renderer.

7. To render the image, simply place the controller and connect its video output to the screen input.

8. For GIFs, the game's TPS will temporarily drop at first, and a loading screen will be displayed. After completion, TPS will stabilize and the looped GIF will be displayed on the screen.

---

Sprite Image Mode

In the GitHub repository[github.com], there is a file called , which contains two functions:
* takes information from property texts (for each sprite you need to pass all parts of the text at once) and returns a list of lines and their colors.
* takes coordinates that will be the top left corner of the image, and as the third argument, the array obtained from the first function.

To create a sprite, you need to press the Sprite Mode button in the program. The properties of this function are as follows:
* It preserves the original file size without trying to stretch it to the specified size and does not support GIFs.
* The sprite always contains a header indicating the size, so you cannot use images transferred without sprite mode for this purpose.
* The created controller contains only property texts without the renderer. This controller also cannot be opened with the select tool. To transfer to your project, you should load sprites through the microcontroller editor. Your project should not be edited with the select tool, but loaded in the microcontroller editor. When updating, you should remove the old controller and place the updated one without opening it.

Beware! Opening the controller with the select tool can cause the game to crash!!

This mode is designed for developers and is a bit more complex:
But mastering this technology, you can create things like these:
code lock

checkers

PEPE RUN

(To create a moving background like this, you need to use a specially modified renderer function. The compression program remains unchanged. If you understand the principle of GIF operation, it becomes clear that they work similarly but the camera moves by the height of one frame each time. You can implement any of your ideas by rewriting only the sprite renderer.)

---

To use the program, you can either download the repository and run the main file after installing Python and the Pillow module.
Or if you are not familiar with Python and just want to run it, you can use the compiled exe file:

GitHub Repository[github.com]
It is completely safe.

---