Layer Blending

Layer Blending

The Layer Blending window can be opened by clicking on the Layer Blending icon from the toolbar or via the View , Windows menus.

Reset panel when changing effects

This will reset the Layer Setting back to default every time you select or create a new effect. Checked is the recommended setting for most users.

Layer Blending

The Layer blending settings allows the user to dictate how effects on multiple layers will be merged together for a model/group/submodel.

When setting the layer blending modes, the current layer is considered layer 1 and the layer below is considered layer 2.

Click the Question Mark(?) Button for more Information.

Put two effects on a model and step through each of the layering modes to see what they will look like. Experience is much better than reading about it.


This is not to be confused with the Morph Effect. This is a layering option that can be applied to any two effects.

The morph option of layer blending will magically make effect 1 ‘morph’ into effect 2 during the length of the timing cell that the effects are in. You will not see effect 2 at the beginning of the timing cell, and you will not see effect 1 at the end of the timing cell. Somewhere near the middle you will see the effect 1 ‘morph’ into effect 2.

Suppress Effect Until Frame

This will hide the effect for the specified amount of frame and display it when the number of frames is reached. This can be used to "warm up" an effect and hide the undesired beginning frames.

Freeze Effect At Frame

This will pause or stop an effect at the specified frame and hold that frame and display it until the end of the effect.


There are 19 layer blending transition choices. Using the transitions will help you bridge between effects providing a way to smooth out abrupt changes between different effects. A stylistic use would be between sections of a song such as the chorus to verse or verse to verse. Keep in mind that the blending is done within the boundary of the timing mark and does not transition between timing marks.

These transitions are common in the video editing world, and should be visually familiar to anyone who’s used video editing software or anyone who’s watched anything on TV in the past 20 years.

When setting a layer transition, the setting will apply to all future effects placed, so be sure to reset the transition times back to 0 if you do not wish the transition to apply to all future effects.




The Effect with gradually disappear or appear.


A line travelling from one side of the frame to another will cause the effect to disappear. The adjustment slider sets the starting wipe direction. 0 is from the top, 25 from the left, 50 from the bottom, 75 from the right.


This uses a circular motion as the hand of a clock from the center of the model to wipe the effect in or out. The adjustment slider sets the starting position and the reverse checkbox allows for a counter clockwise wipe.

From Middle

This is a curtain type wipe either from the middle or towards the middle depending if the effect is placed on the in transition or the out transition. The reverse makes the effect operate in a “to the middle” mode instead of “from the middle”. The adjustment slider will change the angle of the curtain direction.

Square Explode

This transition will draw the effect starting from the middle of the model and expand outwards with square edges until the model is filled. The reverse button starts drawing the effect from the outer edges and filling in towards the middle.

Circle Explode

Same as square explode, except the shape is circular instead of square.


This transition is analogous to twisting the wand to open vertical blinds. The adjustment slider determines how many blinds are used. The reverse checkbox determines the direction that the effect will fill in from.


This transition effect when used as an “in” transition rapidly fills the model with square chunks until the model is full. Likewise when used as the “out” transition, square chunks of the effect disappear until no pixels are left. The adjustment slider determines the size of the chunks.

Slide Checks

This transition is a checkerboard type transition where the effect starts out with a checkerboard type of mask on the model and then the black portions are filled in either left to right depending on the reverse button selection. The size of the pattern is set via the Adjustment slider.

Slide Bars

This transition is broken up into 1-24 horizontal slices of the model determined by the Adjustment slider value. The effect selected will be filled in from opposite sides of the model interlacing each section until the model is filled.


This transition bends the effect onto itself like a piece of paper.


This transition will cause the effect to appear/disappear by adding/removing random pixels.

Circular Swirl

This transition will cause the effect to appear/disappear by emulating an object's rotation.

Bow Tie

This is a wipe transition using a Bow Tie Shape. The adjustment slider sets the starting location, 50 is the middle. The reverse checkbox will flip the direction.


The effect will start out large and shrink into place.


The Effect will start/end as a small box and increase/decrease size to fill the frame.


This transition will cause the effect to appear/disappear by creating random rounded shapes on the frame.


This transition will cause the effect to appear/disappear using blades like a fan. The adjustment slider sets the number of blades on the pinwheel.


This is a wipe transition using a Star Shape. The adjustment slider sets the number of side of the star. 40 for four sided star, 50 for for five sided star, etc.

If an effect has a transitions applied a green bar will appear for an in transitions and a red bar for an out transitions. If the in and out transitions overlap, the overlap area will appear yellow.

Mix Slider

This slider adjusts the level of each effect in the combined output of the effects. You can use this to just put a hint (or more) of one effect on another.


Canvas Mode is a special render mode that only works with specific effects. The default render mode in xLights will draw the effects on a blank buffer for each layer. Canvas Mode allows an effect to draw on a previous layer without "blanking it" out. This is used by effects like the Warp and Kaleidoscope Effect that manipulate data from the underlying layers.

Canvas Layer

This Dialog allows the user which layers to use when Canvas Mode is Enabled

Last updated