Synth-mapping-helper

Undo/Redo for Wall-Art Editor
All you need to know. CTRL-Z/Y as usual.
Let me know if something doesn't properly undo/redo

The _Blender_
Allows you to blend between wall patterns with matching type and timing

`sine_rail.py` [Example Script](https://github.com/adosikas/synth_mapping_helper/tree/main/example_scripts)
Makes zigzag-rails with amplitude according to sine-wave

As the "alpha editor" (if you don't know what that refers to, see the rant below) now complains about "ILLEGAL" notes when they are not aligned to 1/64 or 1/48, the output is now always rounded to that. This affects everything, from notes and rails, to walls and effects.
If there are multiple objects "competing" for the same time slot, the later one takes precedence.

\<rant\>
I was going to wait changing the rounding until the current "alpha" version gets at least promoted to "beta", but it does not appear likely the editor will ever again get updated and the devs will just create more "hidden" branches that new mappers need to be informed about by the community ...
So, if you are of the people that don't know about the alpha editor, thanks for proving my point. You can switch to it by going to the steam properties for the edtior, into the "betas" tab, and selecting the "public.alpha.a2 ALPHA Public Alpha" branch. (That one is only 4 *months* old, not 4 *years*, or 2 years for the "beta" branch)
\</rant\>

This release also adds a bunch more example scripts based on ideas and requests from the community. Feel free to adapt them, and let me know if you have something that could be useful for everyone.

Wall Art Reference Image
You can now select a reference image for the Wall art editor.
A low time scale can be used for "flat" patterns, but you should consider the actual perspective in the game.


Random Stacking
Random ranges for stacking can now be configured in the GUI as well, which is nice to randomly distribute wall art.


Wall Art Editor
There is a whole lot of keyboard shortcuts, just press the keyboard button to show them.
Some feature are *just* accessible via keyboard, like rotation and mirror.

**Note: This adds a lot of new code and countless combinations, so there may be bugs (and frequent, small updates). Let me know if you run into one.**


Wall Mirror
This updates the mirror functionality (or scaling with negative values in general) to mirror walls as expected instead of just their position

Free Mirror axis
You can now to a mirror in any direction. The icon rotates to illustrate.
The mirror axis passes though center, pivot or object, depending on coordinate mode.
The "Stack" amount lets you not just mirror, but keep the original as well, for quickly making symmetrical wall art.
Finalize Walls
The finalize button finally makes it to the GUI. Just load up your map, toggle and and the output will have the walls shifted so they render in the game like they do in the editor.
I recommend working on the "unfinalized" map without worrying about the offset, and using "finalize" to "export" the map for playtesting or release.
Technical changes (for advanced users)
I did some housekeeping on the package itself. This opens the door to later packaging this up as runnable file.
Windows Helpers
These files now have a custom extension (`.smh`), so you can configure Windows to open them with `smh.bat` automatically (instead of drag and drop). But you really should switch to the GUI by now :smile: .
Also I fixed "export walls" and "export walls undo" being mixed up.
Entry points
You can now start GUI, CLI and Companion via just `smh-gui`, `smh-cli` or `smh-companion`, assuming your `PATH` environment variable includes the directory where python installs these shortcuts.
The old `python3 -m synth_mapping_helper.gui` etc will still work.
Dependency pinning
I now pin the required version of libraries to avoid problems should you have installed smh a long time ago (python does not update them automatically).

Text generator
Generates text based on a "font" and various parameters.
If you make a custom font, please share it here: https://github.com/adosikas/synth_mapping_helper/discussions/2

Clipboard preview
This is located on the stacking page, because there it is probably the most useful