Commands:Positioning commands

From SMTheming Wiki

Positioning commands specify where an Actor is defined in the game 'space'.

A positioning command must be specified in order for an object to appear correctly in the game space. In StepMania 3.9, objects default to the center of the screen, but in later versions, the default position is 0,0, meaning the object will appear in the top left hand corner.

Shared commands

These commands are available in all StepMania versions since StepMania 3.9.

Command	Arguments	Example	Effect
x	Float	x,320	Puts an actor on the exact co-ordinate on the X axis.
y	Float	y,240	Puts an actor on the exact co-ordinate on the Y axis.
z	Float	z,480<code>	Puts an actor on the exact co-ordinate on the Z axis.
<code>addx	Float	addx,320	Adds the value relative to the actor's X position.
addy	Float	addy,240	Adds the value relative to the actor's Y position.
addz	Float	addz,240	Adds the value relative to the actor's Z position.

Commands that affect alignment

These commands allow you to change the positioning alignment an object.

Command	Arguments	Example	Effect
horizalign	String	horizalign,left	Defines which edge will appear at the co-ordinate on the X axis. default is center
vertalign	String	vertalign,top	Defines which edge will appear at the co-ordinate on the Y axis. default is middle

StepMania 4.0 commands

These commands are only available in StepMania 4.0 builds.

Command	Arguments	Example	Effect
halign	Float (-1..1)	halign,1	Defines which edge will appear at the co-ordinate on the X axis, defined by float. 1 is equivalent to horizalign,right.
valign	Float (-1..1)	valign,1	Defines which edge will appear at the co-ordinate on the Y axis, defined by float. 1 is equivalent to horizalign,bottom.