Customizing Stage Graphics
The stage graphic layout is specified a file called
stage.ini. The
stage is composed from a number of layers which are drawn on top of each
other. Each layer can have zero or more animation effects attached to it.
Specifying layers
Each layer is specified in a section called
layerN, where
N
is an ascending number that specifies at which point the layer is drawn. The
first layer is called
layer1. Each layer section can have the following
settings (default value in parenthesis):
| Setting |
Effect |
| xres |
Power-of-two width of the layer texture. This setting is limited by the screen resolution (256) |
| yres |
Power-of-two height of the layer texture. This setting is limited by the screen resolution (256) |
| xscale |
X scale factor (1) |
| yscale |
Y scale factor (1) |
| texture |
Texture file name, i.e. SVG file name. Reuse the same texture multiple times if possible to conserve memory. |
| angle |
Layer angle in degrees (0) |
| src_blending |
Source blending factor, one of zero, one, dst_color, one_minus_dst_color, src_alpha, one_minus_src_alpha, dst_alpha, one_minus_dst_alpha, src_alpha_saturate (src_alpha) |
| dst_blending |
Destination blending factor, one of zero, one, dst_color, one_minus_dst_color, src_alpha, one_minus_src_alpha, dst_alpha, one_minus_dst_alpha, src_alpha_saturate (one_minus_src_alpha) |
| color_r |
Red color component (1) |
| color_g |
Green color component (1) |
| color_b |
Blue color component (1) |
| color_a |
Alpha color component (1) |
| foreground |
If 1, the layer is drawn on top of other game graphics such as the fretboard (0) |
Specifying layer effects
A layer effect controls the size, position or color of a layer during gameplay.
Each layer can have multiple effecst, which get applied in order. An effect is
specified in a section called
layerN:fxM, where
N is the
number of the layer that the effect is attached to and
M is the effect
number, starting from one. An effect can have the following settings:
| Setting |
Effect |
| type |
Effect type, one of light, rotate, wiggle, scale |
| intensity |
Effect intensity or weight (1) |
| trigger |
What event triggers the effect, one of none, beat, quarterbeat, pick, miss (none) |
| period |
Effect period in milliseconds. An effect triggered by the beat or quarterbeat will have the corresponding period set automatically (500) |
| delay |
Trigger delay in periods (0) |
| profile |
Trigger profile, one of step, linstep, smoothstep, sinstep (linstep) |
The various types of effects have the following extra parameters:
Light effect
| Setting |
Effect |
| light_number |
Light ordinal number, controls color change delay (0) |
| ambient |
Ambient light level (0.5) |
| contrast |
Light contrast (0.5) |
Scale effect
| Setting |
Effect |
| xmagnitude |
Horizontal scaling magnitude (0.1) |
| ymagnitude |
Vertical scaling magnitude (0.1) |
Wiggle effect
| Setting |
Effect |
| frequency |
Wiggling frequency multiplier (6) |
| xmagnitude |
Horizontal wiggling magnitude (0.1) |
| ymagnitude |
Vertical wiggling magnitude (0.1) |
Rotate effect
| Setting |
Effect |
| angle |
Extreme angle of rotation in degrees (45) |