MusicWheel

MusicWheel is a type of Wheel. Specifically, it deals with Songs and Courses (MusicWheelItems), and can be found in ScreenSelectMusic.

Usage
The MusicWheel has changed a lot between StepMania 3.9 and StepMania 4.

Common
These metrics are shared between StepMania versions:

Colors

 * See also: SongManager

Item Delays
StepMania 3.9 gradually tweens each wheel item in and out.

Transform
These metrics define how the wheel items are positioned.

StepMania 5.0-only

 * StepMania 5 includes sm-ssc and StepMania 4 alpha 5. StepMania 4 uses most of the old 3.9 methods (except using true/false instead of 1/0 for bools, and strings need to be quoted).

Transform
Instead of various metrics, the MusicWheel Transform in StepMania 5 is represented as a Lua function.

An example function (using \ at the end of the line for readability; SM5 can run this code):

is similar to the  metric, while the   command shown here is similar to the   metric. For a linear wheel, you can remove the  line, or modify it to be similar to the   line.

When using the itemIndex and numItems variables in the transform, you may notice that the values they give are not accurate. The reason for this can be found in : It is recommended that you grab the number of items from the metrics, via.

3D Music Wheel Transform
The function included in one of the StepMania 5 alpha themes does not work as intended, due to the use of numItems (as explained above). A working 3D MusicWheel transform would need to read the  metric. The code below should provide a working 3D MusicWheel transform:

If your transform function is a bit complex (such as the above), you may want to consider moving it to a file in the Scripts folder. This brings the downside of the function not being easily reloaded (unless you use Ctrl+F2 in sm-ssc/SM5). If placing the transform function in a Lua script, you will still need to point the  to the function in the script, like so: