v1.3.21 - Change rounding to appease editor

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.

v1.3.20 - Random Stacking & Wall Art Reference Image

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.

v1.3.19 - Wall Art Editor

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.

v1.3.17 - Wall Mirroring & Finalize

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 😄 .
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).

v1.3.16 - Text generator and Clipboard preview

Text generator

Generates text based on a "font" and various parameters.
If you make a custom font, please share it here: #2

Clipboard preview

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

v1.3.15 - File Offset

File Offset is now supported

Can be changed via file utils (which will offset all notes so they stay at the correct time), and will be considered when merging

v1.3.14 - Stacking tab & Lights

Lights & Effects

Lights and effects are now supported, and won't get deleted anymore.
They should also work as expected in most operations (including BPM change, time offset, stacking, ...).

Stacking Tab

The little icon squares change to indicate direction (when not 0), and can be clicked to negate

The various "pick" buttons represent what autostack used to accomplish, but more flexible (you can manually adjust the values, or pick some more). If you hover over the pick and reset buttons, you can see what will be changed.
Note that you typically want to delete the second object after picking, such that it doesn't get stacked along.

The "FILL" button is the new "fill selection" mode, which reads the length of the copied area, so you don't need to manually calculate that.

v1.3.13 - Version History & Error reporting

New features:

Error report button (top right)

Creates a file you can send me when something goes wrong.
It contains:

• SMH Version and current time
• The error message and exception data
• Dashboard: The action you attempted and settings
• Dashboard: The content of your clipboard (when the action used it)
  Be sure to check the file with a text editor if you think there may be sensitive information before sending it to me

Version history (new tab)

Opt-In (because I absolutely hate Opt-Out & Dark Patterns), lists the last 10 releases and their new features and shows when you are outdated.
Technical note: This does query the github.com API, but does not allow me to track your usage. There is a

v1.3.12 - Note & Rail stats

New Features:

Expanded the map stats in the "File Utils" tab to show count of notes, rails and even rail nodes and plot their density.

v1.3.11 - Wall spacing & Rail extension

New Features:

GUI Buttons	Name	Description
	Wall spacing	Allows you to design your wall art without caring about spacing, and then compressing/expanding it to even spacing. Works well with the "Remaster Wall density" plot in the "File-Utils" tab from the previous release.
	Rail extension	Extends rails, either level (-), following the current direction (>>) or pointing to the next note/rail (o->)

Note that the GUI is still in beta, so stuff may break and/or change.
Please leave feedback, either in GitHub discussions or via Discord.