Backgrounds
The Backgrounds editor is used to edit the background elements of current project.
See Backgrounds menu for more details.
Controls
All controls available to the backgrounds editor are listed below:
Background selection scroll bar
Defines the current background element to work on.
Name field
Defines the name of the current background element.
Type
Defines the type of the current background element. Available options are:
Null: null background.
Normal: single sprite background.
Animation: animated background.
Parallax: animated or single sprite background to be perspective projected or pre-projected. Besides perspective projection, this has the effect of the bottom moving faster than the top, or the opposite, as the camera moves.
Dummy: non graphical background. Can be used in combination with Ground link to move players Ground level.
Sprite Group field
Defines the group number of the sprite to be used in the current background element. Note: only valid for Normal or Parallax.
Sprite Index field
Defines the index number of the sprite to be used in the current background element. Note: only valid for Normal or Parallax.
Animation field
Defines the animation number to be used in the current background element. Note: only valid for Animation or Parallax (M.U.G.E.N. 1.1 only).
Masked
Enable alpha channel, otherwise sprite will be rendered fully opaque. Note: Animated backgrounds always have this enabled.
Start X field
Defines the starting position of the background element in the x axis.
Start Y field
Defines the starting position of the background element in the y axis.
Delta X field
Defines how much the background element will move to follow the camera movement in the x axis.
Delta Y field
Defines how much the background element will move to follow the camera movement in the y axis.
Velocity X field
Defines the lifetime velocity of the background element in the x axis. Note: this can't be changed using VelSet or VelAdd controllers (they stack on top of this).
Velocity Y field
Defines the lifetime velocity of the background element in the y axis. Note: this can't be changed using VelSet or VelAdd controllers (they stack on top of this).
ID field
Defines the ID of the background element. This will be used to make controllers of the same ID affects this element.
Layer field
Defines the rendering layer of the background element. For Stages and Storyboard there's only 0 (background) and 1 (foreground). Motifs have also 2 (On top of foreground).
Link to previous
Make the position of this background element as an offset to the previous element.
Tile X field
Defines the number of times this background element will be repeated in the x axis. 0 = one time, 1 or negative = infinite, 2 or more makes it repeats this number of times forward.
Tile Y field
Defines the number of times this background element will be repeated in the y axis. 0 = one time, 1 or negative = infinite, 2 or more makes it repeats this number of times forward.
Tile Spacing X field
Defines the space between each tile in the x axis.
Tile Spacing Y field
Defines the space between each tile in the y axis.
Transparency
Defines how this background element will blended to the framebuffer color. Available options are:
None: no blending, the sprite fully raplaces previous color.
Default: inherits the blending mode of the animation, or none if isn't an animated type.
Addition: additive blending. Source and Dest defines the intensity of the effect.
Addition 50%: additive blending on a 50% darkened destination. Source and Dest are set to 256, 128 respectively. This is a shortcut to these Source and Dest settings on M.U.G.E.N. 1.x. Previous versions doesn't support arbitrary source/dest, so this is the only option besides full additive blending.
Subtraction: reverse subtraction blending. This has a similar effect to color inversion.
Sounce field
Defines the transparency of the sprite. 0 means fully transparent, 256 fully visible.Note: unavailable on M.U.G.E.N. versions older than 1.x.
Dest field
Defines how much dark the destination color will be before additive blending. 0 means black, 256 original color.Note: unavailable on M.U.G.E.N. versions older than 1.x. Setting this to 0 and Source to 256 is the same as no blending, but loosing performance, so avoid this.
Parallax mode
Defines the mode of the parallax effect to be applied. Options are:
Width (centered): applies perspective projection to the sprite, based on the specified width for top and bottom of the sprite. The x axis is changed to half width, so centered.
Width (x axis aligned): applies perspective projection to the sprite, based on the specified width for top and bottom of the sprite. The x axis remains intact.
X Scale (pre-projected): Intended for already perspective projected sprites, so only the top/bottom movement is applied.Note: Animated Parallax doesn't support X Scale mode.
Top width field
Defines the top width of the sprite. Mismatching top and bottom widths creates a perspective effect on the sprite.Note: only available for Width parallax modes.
Bottom width field
Defines the bottom width of the sprite. Mismatching top and bottom widths creates a perspective effect on the sprite.Note: only available for Width parallax modes.
Scale start X field
Defines the starting scale of the background element on the x axis.Note: only available on M.U.G.E.N. 1.1.
Scale start Y field
Defines the starting scale of the background element on the y axis.Note: only available on M.U.G.E.N. 1.1.
Scale delta X field
Defines how much the scale changes as camera moves on the x axis.Note: only available on M.U.G.E.N. 1.1.
Scale delta Y field
Defines how much the scale changes as camera moves on the y axis.Note: only available on M.U.G.E.N. 1.1.
Scale start Y field
Defines the starting scale of the background element on the y axis, in percentage, so 100 = 1X = original size.Note: on M.U.G.E.N. 1.1 this functionality is superseded by scale start/delta parameters.
Scale delta Y field
Defines how much the scale changes as camera moves on the y axis.Note: on M.U.G.E.N. 1.1 this functionality is superseded by scale start/delta parameters.
Window delta X field
Defines how much the clipping window moves to follow the camera movement on the x axis.
Window delta Y field
Defines how much the clipping window moves to follow the camera movement on the y axis.
Window mode
Defines the mode of the clipping window (this is the maximum area the sprite will be drawed into). Options are:
Full screen (disabled): sprite is rendered without any restriction.
Top left (normal): the area coordinates are relative to the top-left corner of the screen.
Top center (mask): the area coordinates are relative to the top-center of the screen.Note: only available on M.U.G.E.N. 1.1.
Window left field
Defines the left bounds of window clipping area.
Window top field
Defines the top bounds of window clipping area.
Window right field
Defines the right bounds of window clipping area.
Window bottom field
Defines the bottom bounds of window clipping area.
Sine (x/y axis)
Creates a sine-wave effect on the background element position, in their respective axis. It's calculated as follows: Sin((Period + Offset) / CurrentPeriod * PI * 2) * Amplitude
Sine amplitude field
Defines the amplitude of the sine effect.
Sine period field
Defines the period of the sine effect.
Sine offset field
Defines the offset of the sine effect.
Controls (Controllers panel)
All controls available to the background controllers editor are listed below:
Controller definition selection scroll bar
Defines the current background controller definition to work on.
Controller definition Name field
Defines the name of the current controller definition.
Controller definition Loop time field
Defines when the controller's internal time will be reset. Use a negative number to never loop.
Controller definition ID fields
Defines up to 10 background element IDs that will be affected by this controller definition. You must start from the first field. As you change from -1 (invalid) the next ones will be enabled for use.
Controller selection scroll bar
Defines the current background controller to work on.
Controller Name field
Defines the name of the current controller.
Controller Type
Defines the type of the current background element. Available options are:
Null: does nothing.
Enable: defines if the affected background elements are enabled or disabled. Use the Enabled checkbox to set this. An enabled background element is rendered and its animation updated.
Visible: defines if the affected background elements are visible or hidden. Use the Enabled checkbox to set this. A visible background element is rendered and its animation updated even while hidden.
Animation: changes the animation of the affected background elements.
Set position: resets the position of the affected background elements to this values (X/Y). Note: This doesn't change start position neither affects the position incremented by background's lifetime velocity.
Add position: increments the position of the affected background elements by these values (X/Y).
Set velocity: resets the additional velocity of the affected background elements to this values (X/Y). Note: This doesn't affects the background's lifetime velocity.
Add velocity: imcrements the additional velocity of the affected background elements by these values (X/Y). Note: This doesn't affects the background's lifetime velocity.
Sine (x axis): changes the sine effect of the affected background elements on the x axis. Use Amplitude, Period and Offset fields to define the new values.
Sine (y axis): changes the sine effect of the affected background elements on the y axis. Use Amplitude, Period and Offset fields to define the new values.
Enabled checkbox
Used by the Enabled and Visible controllers. This turn on or off the effects of that controllers.
Animation field
Defines the animation to be set by the Animation controller.
X field
Defines the x value to be used by Set position, Add position, Set velocity and Add velocity controllers. The checkbox next to it turns on or off the use of this value.
Y field
Defines the y value to be used by Set position, Add position, Set velocity and Add velocity controllers. The checkbox next to it turns on or off the use of this value.
Amplitude field
Defines the amplitude of the sine effect to be set by the Sine controllers.
Period field
Defines the period of the sine effect to be set by the Sine controllers.
Offset field
Defines the offset of the sine effect to be set by the Sine controllers.
Time Start field
Defines the starting time this controller starts being executed.
Time End field
Defines the last time this controller is executed (stops on next game tick).Note: this defaults to the start time.
Time Loop field
Defines when the controller's internal time will be reset. Use a negative number to never loop.Note: This defaults to the controller definition loop time.
Controls (Stage panel)
All controls available to the stage editor are listed below:
Bounds left field
Defines the left limit of camera movement.
Bounds top field
Defines the top limit of camera movement.
Bounds right field
Defines the right limit of camera movement.
Bounds bottom field
Defines the bottom limit of camera movement.
Start X field
Defines the starting position of the camera in the x axis, relative to the center of the screen.
Start Y field
Defines the starting position of the camera in the y axis, relative to the top of the screen.
Cut low field
Defines the maximum amount of pixels that can be cut at the top to fit the stage on taller aspect ratios. Note: M.U.G.E.N. 1.x only.
Cut high field
Defines the maximum amount of pixels that can be cut at the bottom to fit the stage on taller aspect ratios. Note: M.U.G.E.N. 1.x only.
Side tension field
Defines the horizontal distance a player can get from the left and right edges before the camera starts to follow.
Floor tension field
Defines the the minimum vertical distance the highest player has to be from the floor (given as a positive value), before the camera starts to move up to follow him. This parameter is used only with the Vertical Follow camera scrolling mode. This parameter is ignored if High Tension and Low Tension are used.
Low tension field
Defines the vertical distance a player can get from the bottom edge before the camera starts to follow. Note: M.U.G.E.N. 1.1 only. If used, Vertical Follow and Floor Tension will be ignored.
High tension field
Defines the vertical distance a player can get from the top edge before the camera starts to follow. Note: M.U.G.E.N. 1.1 only. If used, Vertical Follow and Floor Tension will be ignored.
Overdraw left field
Defines the number of pixels beyond the left of the screen that may be drawn. Overdraw specifies the how much can be seen during an EnvShake. Overdraw pixels will also be used when the screen aspect is taller than the stage aspect.. Note: M.U.G.E.N. 1.x only.
Overdraw right field
Defines the number of pixels beyond the right of the screen that may be drawn. Overdraw specifies the how much can be seen during an EnvShake. Overdraw pixels will also be used when the screen aspect is taller than the stage aspect. Note: M.U.G.E.N. 1.x only.
Overdraw top field
Defines the number of pixels beyond the bottom of the screen that may be drawn. Overdraw specifies the how much can be seen during an EnvShake. Overdraw pixels will also be used when the screen aspect is taller than the stage aspect. Note: M.U.G.E.N. 1.x only.
Overdraw bottom field
Defines the number of pixels beyond the top of the screen that may be drawn. Overdraw specifies the how much can be seen during an EnvShake. Overdraw pixels will also be used when the screen aspect is taller than the stage aspect. Note: M.U.G.E.N. 1.x only.
Vertical follow field
This value affects the vertical movement of the camera to follow the highest player. It should be set between 0 and 1. A value of 0 means the camera does not move up at all. A higher value makes the camera track the higher player closer. A value of 1 makes the camera track the player as close as possible.
P1 Facing field
Defines the facing direction of Player 1. 1 means right, -1 left.
P1 Start X field
Defines the starting position of the Player 1 in the x axis, relative to the center of the screen.
P1 Start Y field
Defines the starting position of the Player 1 in the y axis, relative to the Ground position.
P2 Facing field
Defines the facing direction of Player 2. 1 means right, -1 left.
P2 Start X field
Defines the starting position of the Player 2 in the x axis, relative to the center of the screen.
P2 Start Y field
Defines the starting position of the Player 2 in the y axis, relative to the Ground position.
Zoom Start field
Defines the starting zoom level. Note: M.U.G.E.N. 1.1 only.
Zoom In field
Defines the maximum zoom level. Note: M.U.G.E.N. 1.1 only.
Zoom Out field
Defines the minimum zoom level. Note: M.U.G.E.N. 1.1 only.
Bound Left field
Sets the minimum allowable distance between players and the left edge of the screen. Must be positive.
Bound Right field
Sets the minimum allowable distance between players and the right edge of the screen. Must be positive.
Local coord Width field
Defines the width of the coordinate space of the stage. Defaults to 320. Note: M.U.G.E.N. 1.x only.
Local coord Height field
Defines the height of the coordinate space of the stage. Defaults to 320. Note: M.U.G.E.N. 1.x only.
Scale X field
Defines the horizontal scale of the stage. Note: M.U.G.E.N. 1.x only.
Scale Y field
Defines the vertical scale of the stage. Note: M.U.G.E.N. 1.x only.
High resolution
Sets the stage scale to 0.5 on both axis. Note: Use scale instead on M.U.G.E.N. 1.x.
Auto turn
Enable this to make characters automatically turn to face each other.
Reset BG
Enable this to reset background elements between rounds.
Ground position field
Defines the vertical distance of the ground level from the top of the screen, given in pixels.
Ground link field
Links the Ground position value to the y-position of a background element with the specified ID number.
Workspace
The Backgrounds editor is used to manipulate the background elements of the project. The graphic workspace contains the timeline, rulers, guide lines, screen size delimiter, all background elements at same time and two crosshairs (on Stages only, to show P1/P2 starting position). Some of these can be enabled/disabled in the View menu.
You can change the starting position of the background by dragging it to the desirable position. The guide lines can be placed in the same way. All other points will move the entire screen (or if you hold the Ctrl key).
The timeline can be used to manually set the current time and see how background elements are changing/moving based on their properties and the execution of background controllers.
In stopped state, there's a screen size delimiter and no content is clipped to the screen size, so you can freely position elements outside of the screen area. Otherwise, the screen is clipped just like in-engine for final simulation and you can move the camera limited to stage bounds. Use arrow keys to move, Hold Shift to move 2px and Alt to move 10px..
The zoom can be changed using the mouse wheel.