Legacy Video Layer
The Legacy video layer is used to play pre-rendered Quicktime video files.
To see what video file formats support see the Supported file formats page.
To see where to place media files in Windows see the Placing media files for a project page.
Common Layer Properties
Blend Mode
BlendMode controls how the output of the layer is composited with the layers below. Layers are rendered in a bottom-up order: layers at the top can modify the output of the layers below
Changing brightness of a content layer in Designer is actually controlling the value of the alpha of the layer. Even when displaying a HAP video, the software will composite the layer with a controllable layer of alpha - one per layer.
There are two ways of expressing alpha in an image:
Straight alpha is al alpha channel which functions just like RGB. Alpha acts as a fourth channel of information per pixel which is as independent of the other three as R, G and B are of each other. For example, with straight alpha it is possible to have RGB = 255 (white) and alpha = 0 (fully transparent) on the same pixel. Internally generated content, such as gradient layer, are generated with straight alpha. This is the preferable style of alpha and considering the cleaner method of the two.
Premultiplied alpha takes the alpha and applies it to the values of the RGB channels per pixel. The more transparent something gets with premultiplied alpha, the closer it gets to black - as if the content is sitting on a black table. Premultipled is the default output of Adobe Photoshop or AfterEffects. the result is our pixel at 255 RGB (full white) with 0 alpha would be calculated as a black pixel in the final image.
Here are expanations of what each individual blend mode will do.
Over
Makes a layer fully opaque. Premultipies all alpha onto the RGB value of each pixel. Alpha = black, so adjusting the brightness of a layer in Over blend mode makes it darker.
Alpha
Default blend mode. It will apply alpha values as a transparency if the alpha is present. Brightness changes will make the layer more or less transparent.
Add
Adds the value of each RGB pixel together. Always creates a brighter result. Values clamp at 255.
Multiply
Reads the level of each subpixel as a level between 0.0 and 1.0, and multiplies source with blend. The result is always a darker image overall. For example: white x grey = 0.5. White turns transparent, black takes precedence. Alpha is applied in the same fashion as the Over Blend mode.
Mask
Choose mask when you want to multiple out content upwards in the stack of layers, rather than downwards. In order to make this work you have to use the same mapping on the layer set to mask and the layer on top.
Multiply-Fade
The same as Multiply, but will make use of the alpha channel to calculate transparency in the source and blend layers. Since maximum transparency is premultiplied, alpha results in black. This will ignore black created through premultiplying.
Multiply-Alpha
Multiply with straight alpha. This mode assumes that the alpha has not been premultiplied onto the RGB values and will not apply a correction to the semi-transparent pixels.
Premultiply Alpha
Like how Multiply-fade will ignore the darkening caused by premultiplying, this blend mode will do the same with Alpha.
Colour Burn
Blend mode increases the contrast to darken the base colour while reflecting the blend colour. The darker the blend colour, the more intensely the colour will be applied in the base image. White as the blend colour produces no change. Using the colour burn blend mode can produce some harsh results at full opacity. The colour burn blend mode can be used to make tonal and colour adjustments to a layer.
Screen
This blend mode looks at each channels colour information and multiplies the inverse of the blend and base colous. The result is always a lighter colour. Screening with black leaves the colour unchanged. Screening with white produces white. The effect is similar to projecting multiple images on top of each other - where bright white is fully opaque, black is fully transparent and 50% grey is 50% transparent.
Overlay
Multiplies or screens the colours, depending on the base colour. Patterns or colours overlay the existing pixels while preserving the highlights and shadows of the base colour. The base colour is not replaced, but mixed with the blend colour to reflect the lightness or darkness of the original colour.
Hard Light
Multiplies or screens the colours, depending on the blend colour. The effects is similar to shining a harsh spotlight on the image. If the blend colour (light source/top layer) is lighter than 50% grey, the image is lightened as if it were screened. This is useful for adding highlights to an image. If the blend colour is darker than 50% grey, the image is darkened as if it were multiplied. This is useful for adding shadows to an image. Painting with pure black or white results in pure black or white.
Soft Light
Darkens or lightens the colours, depending on the blend colour. The effect is similar to shining a diffused spotlight on the image. If the blend colour (light source/top layer) is lighter than 50% grey, the image is lightened as it if were dodged. If the blend colour is darker than 50% grey, the image is darkened as if it were burned in. Painting with pure black or white produces a distinctly darker or lighter area, but does not result in pure black or white.
Darken
Looks as the colour information in each channel and selects the base or blend colour - whichever is darker - as the result colour. Pixels lighter than the blend colour are replaced and pixels darker than the blend colour do not change.
Lighten
Looks at the colour information in each channel and selects the base or blend colour - whichever is lighter - as the result colour. Pixels darker than the blend colour are replaced and pixels lighter than the blend colour do not change.
Difference
Looks at the colour information in each channel and subtracts either the blend colour from the base colour or the base colour from the blend colour depending on which has the greater brightness value. Blending with white inverts the base colour values and blending with black produces no change.
Exclusion
Creates an effects similar to but lower in contrast than the difference mode. Blending with white inverts the base colour values. Blending with black produces no change.
Colour Dodge
Looks at the colour information in each channel and brightens the base colour to reflect the blend colour by decreasing contrast between the two. Blending with black produces no change.
Hard Mix
Adds the RGB channels of the blend colour to the RGB values of the base colour. If the resulting sum for a channel is 255 or greater, it receives a value of 255; if it is less than 255 it receives a value of 0. Therefore all blended pixels have RGB channels of either 0 or 255. This changes all pixels to primary additive colours (RGB), white or black.
Brightness
This property (which appears as a light bulb icon) controls the brightness of the layer output.
If the layers blend mode is set to Alpha, then reducing the brightness to 0 also reduces the opacity of the layer to 0. This can be useful when you want to dissolve from one layer to the next. In that case, you can place the new layer above the old layer and increase its brightness level.
Mapping
The mapping property controls how the layer output is mapped onto the screen(s) in the Stage level.
For information on mapping, including how to use the different mapping types offered by Designer, please see the chapter CContent Mapping.
Palette
This points to the still image file that defines the bitmap from which the tint colour is taken. The default palette ( HSVPAL ) consists of the complete range of hues and saturations. Selecting this property will open the Texture object library, which shows all of the still image files saved on your local hard-drive in the DxTexture older.
To control the location within the current palette bitmap, and thus control the colour, you have to edit the xCol and yCol values (see the section for xCol, yCol).
To change the current palette bitmap:
- Left-click palette to open the Texture object library.
- Left-click the still image file you want to use for the palette bitmap.
If you want to use a palette bitmap other than the standard still images provided in Designer, you will need to use a custom still image file.
See the Placing media files for a project sub-chapter to understand where to place a custom still image file and how to access it in Designer. Also save the file to a supported file format.
xCol, yCol
These properties control the coordinates within the current palette bitmap where the output colour is sampled from. The default value is 0,0 which points at the color white (if you are using the HSVPAL palette). Multiplying white with the colors of the chosen content simply generates the original content colors. Colour X controls the horizontal position, where 0 is the leftmost edge and 255 is the rightmost edge. Colour Y controls the vertical position, where 0 is the top edge and 255 is the bottom edge.
For example, to saturate the video clip red, change the Colour Y value to 255 and use 0 for the Colour X value. These coordinates refer to the color red in the palette which is being multiplied with the colors of the existing content.
When you are using the default palette HSVPAL , Colour Y controls saturation, and Colour X controls hue.
Colour Shift
The colour shift property allows you to perform a number of colour-correction operations on the output of a layer.
Colour Shift objects can also be attached to individual video files within the Video layer.
Colour Shift property performs colour-corrections on the output of a visual layer
Colour Shift properties are:
Saturation scale
When set to 1, no change is applied to the image. When set to 0, the image is desaturated to black and white. When set higher than 1, the image is hypersaturated.
Saturation scale (from left to right): s=0, s=0.5, s=1, s=2
Hue shift
RGB controlled
This property controls how the min/max levels and gamma corrections are applied. If set to together, then the min, max and gamma values are the same for the red, green and blue channels. If set to separate , the min,max and gamma values can be controlled separately for red, green and blue. The latter setting allows you to apply fine colour balance controls to the image.
Min
This sets the lowest brightness level found in the image. All pixels at this level are scaled down to zero brightness. Increasing this value enforces shadows and dark levels in the image and can be used to reduce low-level compression artifacts in an image or video frame.
Increasing min equally across red, green and blue enforces shadows, whereas increasing min on an individual channel has the effect of shifting the colour balance away from that colour. For example, increasing red min shifts the image towards cyan.
min = 00 (left), min = 96 (right)
red.min = 0 (left), red.min = 96 (right)
Max
This sets the highest brightness level found in the image. All pixels at this level are scaled up to the maximumm level, i.e. 255. Decreasing this value brightens any highlights in the image. This is useful when the source image is too dark.
max = 255 (left), max = 260 (right)
If you set min to 255 and max to 0, the image (or single channel) will be inverted.
Invert all (left), invert red (right)
Gamma
When gamma is set to 1, no change is made to the image. Reducing gamma brightens highlights while increasing gamma darkens lowlights. The maximum and minimum brightness levels remain the same.
Gamma scale (from left to right): g=0.5, g=1, g=1.5
Legacy Video Layer Properties
Media
The Video property points to the still media file that defines the content to be used on the layer. Selecting this property will open the VideoClip object library, which shows all of the still image files saved on your local hard-drive in the VideoFile folder.
To change the current piece of content:
- Left-click Video to open the VideoClip object library.
- Left-click the media file you want to use.
Speed
Selects playback speed. When this is set to 1, the video is played at its normal framerate; when set to 2, the video is played at double speed, and so on.
Playback speed is set at the point where the video keyframe is encountered in the video keyframe editor. Once this is set, the playback speed does not change, even if it varies over time. To change the playback speed, drop a speed keyframe at the point where the video thumbnail appears in the video keyframe editor.
Mode
This specifies the playback mode. There are three modes; each one has a specific behaviour that is useful for a different situation.
Normal
When the play cursor stops, the video will also stop and the frame number will lock to the timeline position. When the cursor continues to play or holds at the end of a section, the video will play continuously. Jumping around the timeline while playing does not affect which frame is being played.
Locked
If the play cursor continues to play or stops at the end of a section, the video frame number locks to the timeline. When the play cursor holds at the end of a section, the video will play continuously.
Freerun
If the play cursor continues to play or stops at the end of a section, the video will play continuously. Jumping around the timeline while the cursor is playing or has stopped does not affect which frame is being played.
At end point
This specifies what happens when playback reaches the end of the video clip. There are three options to choose from:
Loop
When playback reaches the end of the video clip, the clip will loop immediately back to the beginning and will start playing again from there.
Ping-pong
When playback reaches the end of the video clip, the clip will play in reverse back to the beginning.
Pause
When playback reaches the end of the video clip, the clip will pause on the last frame.
Transition time
The transition property specifies the dissolve time, in beats, when switching from one video clip to the next on the timeline. By default, this is set to 0, so the player cuts immediately from one clip to the next. Setting this value to 1 causes the player to dissolve from one clip to the next over 1 beat.
Volume
Some video clips may contain audio. You can fill in any number between 0 (mute) and 255 (full) in the text field to set a constant volume, or open the propertys key-frame editor to fade volume in or out.
Output
If the video has an audio track, this controls which audio output device the audio is played to.
Threshold
The threshold of the keying. Colours closer than (threshold) to the key colour become transparent.
Hardness
The hardness of the keying. Lower numbers produce softer edges and higher numbers produce harder edges between transparent and opaque areas.
Key color RGB
The value of the key colour, 0 255, causing the key colour to become transparent.
Scale
Controls the size of the video.
Aspect
Controls the aspect ration of the video, higher numbers make the frame taller.
Pos x y
Position of the video:
- x = horizontal position
- y = vertical position
- 0 = centre of canvas
- -1 = top edge of canvas
- +1 = bottom edge
Rotation
Rotation (in degrees) of the video.
Crop left, right, top, bottom
Crops the frame from the respective edge. 0 = no crop, 1 = entire frame crop.
Vignette
Adds a vignette effect by softening the edges of the crop.