StepMania 3.9

©2001-2004, StepMania team, All rights reserved.
http://www.stepmania.com

1. Looks for a movie with file name = "bg name" in the song folder. You must include the file extension in "bg name". e.g. "60=falling.avi,80=flower.mpg".
2. Looks for a BGAnimation folder with the name "bg name" in the song folder.
3. Looks for a movie with file name "bg name" in the RandomMovies folder. You must include the file extension in "bg name". e.g. "60=falling.avi,80=flower.mpg".
4. Looks for a BGAnimation with file name "bg name" in the BGAnimations folder.
5. Looks for a Visualization with the file name "bg name" in the Visualizations folder. For example, if you have a song B4U and special B4U-specific BGAnimations called "robot" and "electric". First, move the robot and electric BGAnimation folders into the B4U song folder (e.g. "Songs\4th Mix\B4U\robot" and "Songs\4th Mix\B4U\electric"). Then, using the editor, insert a new background change at each point in the song where you to switch to a new BGAnimation.

In the old paradigm, you would define the position of an Actor with two different metrics - one for the X position, and one for the Y. For example:
ObjectX=100
ObjectY=220

This system is being replaced by more powerful "commands strings". A command string can set positions, colors, effects, and also script animations over time. Positioning an Actor with command string would look like this:
ObjectOnCommand=x,100;y,220

A command string contains one or more commands separated by semicolons. This command string contains two commands: "x,100" and "y,220". A command is made up of a command name and a list of parameters. The command name and any parameters are separated by commas. In the example above, both the commands "x" and "y" both take exactly one parameter. Other commands like "diffuse" take 4 parameters (R, G, B, and A). For example, the command "diffuse,1,0,1,1" would turn an Actor's color to opaque purple.

Typically, the metrics file will have two commands per Actor - the "OnCommand" (which is where you command an Actor to tween onto the screen), and the "OffCommand" (for tweening the Actor off the screen).

Below is a list of actor commands and their C++ equivalents. I'll have an explanation of animations and more examples in the full documentation.


sleep BeginTweening( fParam(0), TWEEN_LINEAR );
linear BeginTweening( fParam(0), TWEEN_LINEAR );
accelerate BeginTweening( fParam(0), TWEEN_ACCELERATE );
decelerate BeginTweening( fParam(0), TWEEN_DECELERATE );
bouncebegin BeginTweening( fParam(0), TWEEN_BOUNCE_BEGIN );
bounceend BeginTweening( fParam(0), TWEEN_BOUNCE_END );
spring BeginTweening( fParam(0), TWEEN_SPRING );
stoptweening { StopTweening(); BeginTweening( 0.0001f, TWEEN_LINEAR ); }
x SetX( fParam(0) );
y SetY( fParam(0) );
xoffset SetX( GetX()+fParam(0) );
yoffset SetY( GetY()+fParam(0) );
zoom SetZoom( fParam(0) );
zoomx SetZoomY( fParam(0) );
zoomy SetZoomY( fParam(0) );
diffuse SetDiffuse( RageColor(fParam(0),fParam(1),fParam(2),fParam(3)) );
glow SetGlow( RageColor(fParam(0),fParam(1),fParam(2),fParam(3)) );
rotationx SetRotationX( fParam(0) );
rotationy SetRotationY( fParam(0) );
rotationz SetRotationZ( fParam(0) );
shadowlength SetShadowLength( fParam(0) );
horizalign SetHorizAlign( sParam(0) );
vertalign SetVertAlign( sParam(0) );
diffuseblink SetEffectDiffuseBlink();
diffuseshift SetEffectDiffuseShift();
glowblink SetEffectGlowBlink();
glowshift SetEffectGlowShift();
wag SetEffectWag();
bounce SetEffectBounce();
bob SetEffectBob();
spin SetEffectSpin();
vibrate SetEffectVibrate();
stopeffect SetEffectNone();
effectcolor1 SetEffectColor1( RageColor(fParam(0),fParam(1),fParam(2),fParam(3)) );
effectcolor2 SetEffectColor2( RageColor(fParam(0),fParam(1),fParam(2),fParam(3)) );
effectperiod SetEffectPeriod( fParam(0) );
effectmagnitude SetEffectMagnitude( RageVector3(fParam(0),fParam(1),fParam(2)) );
additiveblend EnableAdditiveBlend( iParam(0)!=0 );


 

ScreenSelect is a type of screen that presents the user with a list of choices. The choices shown on these screens can be Styles, Difficulties, PlayModes, or any combination thereof. Each ScreenSelect screen has two metrics that define what choices are shown (examples below). Currently, there are only two different screens that support the ScreenSelect framework.
- ScreenSelectMaxType1
- ScreenSelectMaxType2
- (more will be converted over in the next couple days)


// Example 1: Show all Styles for the current game type the DDR MAX Select Style template

[ScreenSelectMaxType1]
ChoicesType=0 // 0=styles, 1=difficulties, 2=modes, 3=games
Choices=


// Example 2: Show specific Difficulty and PlayMode choices using a DDR MAX Select Difficulty template

[ScreenSelectMaxType2]
ChoicesType=1 // 0=styles, 1=difficulties, 2=modes, 3=games
Choices=Beginner,Easy,Medium,Hard,Nonstop,Oni,Endless


// Example 3: Show specific Style-PlayMode-Difficulty combinations using a DDR MAX Select Style template

ChoicesType=2 // 0=styles, 1=difficulties, 2=modes, 3=games
Choices=versus-arcade-medium,couple-arcade-medium,double-arcade-medium,single-arcade-medium,single-battle-medium,double-battle-medium,couple-battle-medium,versus-battle-medium