Generator Parameters
The following sections describe common parameters and details of each generator.
Parameters Common to All Generators
All generators have a reset button and Width, Height, and Pixel Aspect Ratio controls, located in the Generator Inspector. The controls specific to each type of generator are discussed later in this chapter.
Reset: A button you can click to reset the generator to its default settings.
Width: A slider that sets the width of the generator, in pixels. Values range from 1 to the width of your project.
Height: A slider that sets the height of the generator, in pixels. Values range from 1 to the height of your project.
Pixel Aspect Ratio: A pop-up menu that sets the aspect ratio of the pixels drawn by the generator. Values can be selected from the following menu options: Square, NTSC D1/DV, NTSC D1/DV Anamorphic, PAL D1/DV, PAL D1/DV Anamorphic, Anamorphic 2:1, D4/D16, D4/D16 Anamorphic, HD (960 x 720, 1440 x 1080), HD (1280 x 1080), or Custom. When a value other than Custom is selected, the Pixel Aspect Ratio of that selection appears in a value field next to the pop-up menu. Enter values from 0 to 10000 in the value field. If the value does not correspond to a preset value (for example, 2 for Anamorphic 2:1), Custom appears in the pop-up menu.
HUD Controls
In general, Generator HUDs contain a subset of the larger group of controls located in the Generator Inspector. Additionally, the HUDs contain the Opacity and Blend Mode parameters.
Important: The Opacity parameter in the HUD is identical to the Opacity control located in the Properties Inspector. This slider sets the transparency of the generator as a whole. Several generators contain a separate opacity control in the Generator Inspector, which is independent of the like-named control in the Properties Inspector.
Caustics
The Caustics generator creates an animated, simulated water surface. The size, speed, refraction, brightness, and color of the Caustics pattern can be modified and animated. You can use the Caustics generator to add light patterns to a project, or as the source object for an image map.
Parameters in the Inspector
Size: Sets the size of the shapes and spaces in the pattern.
Speed: Sets the speed of movement of the light patterns.
Refraction: Sets the refraction of the light shapes.
Brightness: Sets the brightness of the light shapes.
Color: Picks the color of the light shapes. For more precise color selection, click the disclosure triangle to display Red, Green, and Blue sliders.
HUD Controls
The HUD contains the following controls: Size, Speed, Refraction, Brightness, and Color.
Cellular
The Cellular generator creates an animated pattern that looks like cells moving under a microscope. You can change the color, size, and speed of the cells.
Parameters in the Inspector
Size: Sets the size of cells in the pattern. Values range from 3 to 64.
Speed: Sets the speed of movement of cells. Values range from 0 to 2.
Gradient: Sets the color gradient used for cells. For information on using gradients, see Gradient Controls.
HUD Controls
The HUD contains the following controls: Size, Speed, and Gradient.
Checkerboard
The Checkerboard generator creates a static checkerboard pattern. The contrast, color, size, and position of checkerboard squares can be edited and keyframed.
Parameters in the Inspector
Color 1: Picks the first color in the checkerboard. For more precise color selection, click the disclosure triangle to display Red, Green, Blue, and Opacity sliders.
Color 2: Picks the second color in the checkerboard. For more precise color selection, click the disclosure triangle to display Red, Green, Blue, and Opacity sliders.
Size: Sets the size of the squares in the checkerboard. Values range from 0 to 800.
Contrast: Sets the sharpness of the division between squares. Values range from 0 to 1.
Publish OSC: Selecting this checkbox ensures that if this generator is sent to Final Cut Pro X as part of a template, the onscreen controls are accessible in Final Cut Pro. For more about publishing onscreen controls and other parameters see Creating Templates for Final Cut Pro X.
HUD Controls
The HUD contains the following controls: Color 1, Color 2, Size, and Contrast.
Clouds
The Clouds generator creates an animated cloud pattern. You can modify or animate the color, scale, speed, and strength of the cloud layers.
Parameters in the Inspector
Horizontal Scale: Gives the appearance of zooming in or out of the simulation by horizontally scaling the generator. Larger numbers indicate a higher level of zoom.
Vertical Scale: Gives the appearance of zooming in or out of the simulation by vertically scaling the generator. Larger numbers indicate a higher level of zoom.
Speed: Sets the speed of movement of the clouds. Values range from 0 to 2.
Gradient: Sets the color gradient used for the clouds. For information on using gradients, see Gradient Controls. Offset: Sets the coordinates of the center of the clouds. Coordinates are calculated from the center of your object, which is the coordinate origin.
You can also use the Adjust Item tool to adjust this parameter using onscreen controls. For more information, see Editing Generators Using Onscreen Controls.
1st Layer Strength: Sets the strength of the first layer of clouds. Values range from 0 to 1.
2nd Layer Strength: Sets the strength of the second layer of clouds. Values range from 0 to 1.
3rd Layer Strength: Sets the strength of the third layer of clouds. Values range from 0 to 1.
4th Layer Strength: Sets the strength of the fourth layer of clouds. Values range from 0 to 1.
HUD Controls
The HUD contains the following controls: Horizontal Scale, Vertical Scale, Speed, Gradient, Method, 1st Layer Strength, 2nd Layer Strength, 3rd Layer Strength, and 4th Layer Strength.
Color Solid
The Color Solid generator creates a single-colored object. You can adjust the color of the solid, as well as keyframe the color to create an animated texture of changing colors.
Note: To create and animate a small, color-filled box or shape, use the Shape tools to draw a vector-based shape rather than creating and masking a Color Solid generator. This is more efficient in terms of processor performance and workflow.
Parameters in the Inspector
Color: Sets the color. For more precise color selection, click the disclosure triangle to display Red, Green, and Blue sliders.
HUD Controls
The HUD contains the following control: Color.
Concentric Shapes
The Concentric Shapes generator creates a repeating pattern of shapes.
Parameters in the Inspector
Number of Sides: Available when Polygons is selected from the Shape pop-up menu, determines the number of sides on the polygonal shape. A polygon must have at least three sides.
Rotation: Available when Polygons is selected from the Shape pop-up menu, determines the orientation of the polygonal shapes.
Center: Sets the center point of the generator in the Canvas. The left value slider represents X; the right value slider represents Y. To access individual X and Y controls, click the disclosure triangle.
Inner Cutoff: Defines a center stopping area for the generator. A value greater than 0 creates a hole in the middle of the generator; the greater the value, the larger the hole. Objects composited below the generator in the project appear in the cutoff areas.
Outer Cutoff: Defines an outer stopping area for the generator. The lower the value, the more the outer edges of the generator are cut off. Objects composited below the generator in the project appear in the cutoff areas.
Color 1: Available when 2 Color is selected from the Color Type pop-up menu, sets the first color in the generator. Using the default settings, this color appears in the center of the concentric shapes.
Color 2: Available when 2 Color is selected from the Color Type pop-up menu, sets the second color in the generator.
Width: Sets the width of the concentric shapes.
Contrast: Available when 2 Color is chosen from the Color Type pop-up menu, controls the transition between the two colors. A value of 1 creates the highest contrast between the colors; lower values create less contrast, softening the shapes.
Phase: Cycles through the colors or gradient.
Tip: Animate the Phase parameter to create a hypnotic effect.
Publish OSC: Selecting this checkbox ensures that if this generator is sent to Final Cut Pro X as part of a template, the onscreen controls are accessible in Final Cut Pro. For more about publishing onscreen controls and other parameters see Creating Templates for Final Cut Pro X.
HUD Controls
The HUD contains the following controls: Shape, Number of Sides, Rotation, Inner Cutoff, Outer Cutoff, Color Type, Color 1, Color 2, Width, Contrast, and Phase.
Gradient
The Gradient generator initially creates a linear gradient. You can change the gradient type from linear to radial, add and remove colors in the gradient, and change the gradient start and end points. You can save a modified gradient to the Gradient category in the Library and apply it to shapes, text objects, or particle cells. Additionally, gradient controls can be keyframed to create a moving, color-changing gradient.
Parameters in the Inspector
Gradient: Sets the color gradient. For information on using gradients, see Gradient Controls. Start: Sets the starting point for the gradient.
End: Sets the ending point for the gradient.
HUD Controls
The HUD contains the following controls: Gradient, Type, Start, End, and End Condition.
Grid
The Grid generator creates a grid pattern made of two colored lines. By default they are white lines on a black background. Using the controls in the Inspector, you can customize the colors and line widths of the grid, and add graph paper lines.
Parameters in the Inspector
Offset: Sets the coordinates of the center of the grid. Coordinates are calculated from the center of your object, which is the coordinate origin.
You can also use the Adjust Item tool to modify this parameter with onscreen controls. For more information, see Editing Generators Using Onscreen Controls.
Line Color: Sets the color of grid lines.
BG Color: Sets the color of the grid background.
BG Opacity: Sets the opacity of the background. Values range from 0 to 1.
Feather: Sets the feathering or sharpness of grid lines. Values range from 0 to 1.
Line Width: Sets the width of grid lines.
Autofit: Rounds grid background width and height values to ensure that there aren’t partial columns or rows at the edge of the grid.
BG Width: Sets the width of the background or space between lines.
BG Height: Sets the height of the background or space between lines.
Graph Paper Lines: Adds a grid pattern on top of the existing grid. With this option selected, the Graph Line Color and Graph Line Frequency controls become available.
Graph Line Color: Available when the Graph Paper Lines checkbox is selected, defines the color of the “graph paper” lines.
Graph Line Frequency: Available when the Graph Paper Lines checkbox is selected, sets how frequently a grid line is also a graph line.
Publish OSC: Selecting this checkbox ensures that if this generator is sent to Final Cut Pro X as part of a template, the onscreen controls are accessible in Final Cut Pro.
HUD Controls
The HUD contains the following controls: Line Color, BG Color, BG Opacity, Feather, Line Width, Autofit, BG Width, BG Height, Graph Paper Lines, Graph Line Color, and Graph Line Frequency.
Lens Flare
Lens flares result from a bright light source pointed right at a lens, refracting off multiple elements in the lens assembly of a camera. This filter allows you to add a simulated lens flare to an object.
This filter can be used to simulate a bright light source in the picture.
Parameters in the Inspector
Center: Sets the position of the center of the lens flare.
You can also use the Adjust Item tool to modify this parameter with onscreen controls. For more information, see Editing Generators Using Onscreen Controls.
Size: Sets the radius of the ring of the lens flare.
Intensity: Sets the intensity of the lens flare. Values range from 0 to 4.
Falloff: Sets how fast the lens flare falls off. Values range from 0 to 10.
Color: Picks the color of the lens flare. Click the disclosure triangle to display Red, Green, and Blue sliders for more precise color selection.
Outer Color: Picks the outer color of the lens flare.
Ring Color: Picks the color of the ring of the lens flare.
Streak Color: Picks the color of the streaks in the lens flare.
Streak Intensity: Sets the intensity of the streaks. Values range from 0 to 1.
Streak Count: Sets the number of streaks in the lens flare. Values range from 1 to 100.
Streak Noise Frequency: Sets the frequency of the noise in the streaks. Values range from 1 to 100.
Streak Noise Level: Sets the level of noise in the streaks of the lens flare. Values range from 0 to 20.
Ring Radius: Sets the radius of the ring of the lens flare. Values range from 0 to 1.
Ring Width: Sets the ring’s width. Values range from 0 to 1.
Glow Falloff: Sets how fast the glow falls off of the lens flare. Values range from 0 to 20.
Streak Map: An image well that displays a thumbnail of the map chosen for the streaks of the lens flare.
For information on using image wells, see Source Well.
Publish OSC: Selecting this checkbox ensures that if this generator is sent to Final Cut Pro X as part of a template, the onscreen controls are accessible in Final Cut Pro. For more about publishing onscreen controls and other parameters see Creating Templates for Final Cut Pro X.
HUD Controls
The HUD contains the following controls: Size, Intensity, Falloff, Color, Outer Color, Ring Color, Streak Color, Streak Intensity, Streak Count, Streak Noise Frequency, Streak Noise Level, Ring Radius, Ring Width, Glow Falloff, and Streak Map.
Membrane
The Membrane generator creates a sheer, animated sheet that appears to move gracefully about in 3D space. The speed, start and end points, offset, brightness, and color can be modified and animated. To expand the animation beyond the Canvas borders, increase the Width and Height parameters in the Inspector.
Parameters in the Inspector
Speed: Sets the speed of movement of the sheet.
Start 1–4: Sets the starting point for the sheet wave. Experiment with these controls to find wave shapes.
End 1–4: Sets the ending point for the sheet wave. Experiment with these controls to find wave shapes.
Offset: Sets the coordinates of the center of the sheet. Coordinates are calculated from the center of your object, which is the coordinate origin.
Brightness: Sets the brightness of the sheet.
Color: Picks the color of the membrane. Click the disclosure triangle to display Red, Green, and Blue sliders for more precise color selection.
HUD Controls
The HUD contains the following controls: Speed, Start 1–4, End 1–4, Offset, Brightness, and Color.
Noise
The Noise generator creates a random, colored static pattern. To make animated noise, you can keyframe the Random Seed parameter in the Noise HUD or Inspector. When filters are applied to an animated Noise generator, you can create unique textures. In the second image below, the Stripes distortion filter is applied to an animated Noise generator to create a vibrant, electric light-type texture.
Parameters in the Inspector
Random Seed: Because each seed value creates a different noise image, modifying this value over time yields a constantly changing noise pattern. The easiest way to see and use the Random Seed parameter is to add a Ramp behavior to it (in the Parameter behavior category), then ramp from a very small random seed value to a very large random seed value over time.
HUD Controls
The HUD contains the following control: Random Seed.
One Color Ray
The One Color Ray generator creates a ray pattern based on variations of a color. You can select the color, the degree of variance, the number of divisions represented, and the rotation of the pattern.
Parameters in the Inspector
Offset: Sets the coordinates of the ray pattern’s center. Coordinates are calculated from the center of your object, which is the coordinate origin.
You can also use the Adjust Item tool to modify this parameter with onscreen controls. For more information, see Editing Generators Using Onscreen Controls.
Color: Picks the base color.
Color Variance: Sets how much the colors differ from each other.
Divisions: Sets the number of divisions in the ray pattern.
Rotation: Sets the rotation of the whole pattern from the center point.
Sharpness: Defines the hardness of the edges of the rays. Values ranges from .25 to 1.
Waviness: Positive or negative values create waves in the rays. Values range from –10 to 10.
Frequency: When Waviness is set to any value other than 0, determines the number of waves in the rays.
Phase: When Waviness is set to any value other than 0, defines the offset of the waves from the start and end of the rays. (Animate this value to create interesting effects.)
Inner Cutoff: Defines a center stopping area for the generator. A value greater than 0 creates a hole in the middle of the generator; the greater the value, the larger the hole. Objects composited below the generator in the project appear in the cutoff areas.
Outer Cutoff: Defines an outer stopping area for the generator. The lower the value, the more the outer edges of the generator are cut off. Objects composited below the generator in the project appear in the cutoff areas
Publish OSC: Selecting this checkbox ensures that if this generator is sent to Final Cut Pro X as part of a template, the onscreen controls are accessible in Final Cut Pro. For more about publishing onscreen controls and other parameters see Creating Templates for Final Cut Pro X.
HUD Controls
The HUD contains the following controls: Color, Color Variance, Divisions, Sharpness, Waviness, Frequency, Phase, Inner Cutoff, and Outer Cutoff.
Op Art 1
There are three Op Art generators to help confuse your background-foreground senses. The Op Art generators create mathematically oriented patterns using a repetition of simple shapes. Although some static patterns create a visual illusion of movement, you can keyframe Op Art parameters to create moving moiré patterns.
Parameters in the Inspector
Line Thickness: Sets the thickness of the lines in the pattern.
Color 1: Sets the first color of the pattern. Click the disclosure triangle to display Red, Green, Blue, and Opacity sliders for more precise color selection.
Color 2: Sets the second color of the pattern. Click the disclosure triangle to display Red, Green, Blue, and Opacity sliders for more precise color selection.
Contrast: Sets how sharp or blurred the division is between the lines and the background.
Wavelength 1: Sets the frequency of the wave up and down.
Wavelength 2: Sets the frequency of the wave from left to right.
Amplitude: Sets the amplitude of the waves.
Roundness: Sets the shape of the waves.
HUD Controls
The HUD contains the following controls: Line Thickness, Color 1, Color 2, Contrast, Wavelength 1, Wavelength 2, Amplitude, and Roundness.
Op Art 2
This generator creates mathematically oriented patterns using a repetition of simple shapes. Although some static patterns create a visual illusion of movement, you can keyframe Op Art parameters to create moving moiré patterns.
Parameters in the Inspector
Scale: Sets how close or far away the dots appear.
Angle: Sets the angle of the dot rows.
Dot Color: Sets the color of the dots.
Background Color: Sets the color of the background.
For more information on using the color controls, see Color Controls.
Contrast: Sets how sharp or blurred the division is between the dots and the background.
Dot Size: Sets the dot size.
Compression: Sets how shallow or deep the fold in the imaginary paper appears.
HUD Controls
The HUD contains the following controls: Scale, Angle, Dot Color, Background Color, Contrast, Dot Size, and Compression.
Op Art 3
This generator creates mathematically oriented patterns using a repetition of simple shapes. Although some static patterns create a visual illusion of movement, you can keyframe Op Art parameters to create moving moiré patterns.
Parameters in the Inspector
Line Thickness: Sets the thickness of the lines in the pattern.
Color 1: Sets the first color of the generator. Click the disclosure triangle to display Red, Green, Blue, and Opacity sliders for more precise color selection.
Color 2: Sets the second color of the generator. Click the disclosure triangle to display Red, Green, Blue, and Opacity sliders for more precise color selection.
For more information on using the color controls, see Color Controls.
Contrast: Sets how sharp or blurred the division is between the lines and the background.
Wavelength: Sets the frequency of the wave.
Amplitude: Sets the height of the wave.
Skew: Sets rotation of the wave pattern.
Roundness: Sets the shape of the wave.
HUD Controls
The HUD contains the following controls: Line Thickness, Color 1, Color 2, Contrast, Wavelength, Amplitude, Skew, and Roundness.
Soft Gradient
The Soft Gradient generator creates a soft-edged, radial gradient. The gradient contains an alpha channel so you can place the generator over another image in the project. You can change and keyframe the color, size, and position of the Soft Gradient.
Parameters in the Inspector
Center: Sets the position of the center of the gradient.
You can also use the Adjust Item tool to modify this parameter with onscreen controls. For more information, see Editing Generators Using Onscreen Controls.
Color: Picks the color of the gradient. Click the disclosure triangle to display Red, Green, and Blue sliders for more precise color selection.
Radius: Sets the radius of the gradient circle. Values range from 0 to 1000.
Publish OSC: Selecting this checkbox ensures that if this generator is sent to Final Cut Pro X as part of a template, the onscreen controls are accessible in Final Cut Pro. For more about publishing onscreen controls and other parameters see Creating Templates for Final Cut Pro X.
HUD Controls
The HUD contains the following controls: Color and Radius.
Spirals
This generator creates a repeating circular spiral pattern.
Parameters in the Inspector
Center: Sets the center point of the generator in the Canvas. The left value slider represents X; the right value slider represents Y. To access individual X and Y controls, click the disclosure triangle.
You can also use the Adjust Item tool to modify this parameter with onscreen controls. For more information, see Editing Generators Using Onscreen Controls.
Color 1: Available when 2 Color is selected from the Color Type pop-up menu, sets the first color of the spiral.
Color 2: Available when 2 Color is selected from the Color Type pop-up menu, sets the second color of the spiral.
Scale: Available when Modern is selected from the Type pop-up menu, determines the size of the spiral arms.
Tightness: Available when Classic is selected from the Type pop-up menu, determines the curl of the spiral. The lower the Tightness value, the looser the spiral.
Contrast: Controls the transition between the two colors. A value of 1 creates the highest contrast between colors; lower values create less contrast, softening the spiral. The Contrast parameter is not available when Gradient is chosen from the Color Type pop-up menu.
Rotation: Rotates the spiral around its center. (Animate the Rotation parameter to create a hypnotic effect.)
Publish OSC: Selecting this checkbox ensures that if this generator is sent to Final Cut Pro X as part of a template, the onscreen controls are accessible in Final Cut Pro. For more about publishing onscreen controls and other parameters see Creating Templates for Final Cut Pro X.
HUD Controls
The HUD contains the following controls: Type, Color Type, Color 1, Color 2, Gradient, Scale, Tightness, Contrast, and Rotation.
Star
The Star generator creates a glowing star shape that contains an alpha channel. The scale, width, angle, epsilon (which fine-tunes the size of the star spikes), and opacity of the spikes can be modified and keyframed, as well as the position, color, and radius of the star.
Parameters in the Inspector
Color: Picks the halo around the star. Click the disclosure triangle to display Red, Green, Blue, and Opacity sliders for more precise color selection.
Radius: Sets the radius of the circle at the center of the star. Values range from 0 to 300.
Spike Scale: Sets the size of the star spikes. Values range from 0 to 100.
Spike Angle: Sets the angles of the star spikes.
Spike Opacity: Sets the opacity of the star spikes. Values range from –8 to 0.
Spike Width: Sets the width of the star spikes. Values range from 0 to 50.
Epsilon: Fine-tunes the strength of the star spikes. Values ranges from –2 to 0.
Publish OSC: Selecting this checkbox ensures that if this generator is sent to Final Cut Pro X as part of a template, the onscreen controls are accessible in Final Cut Pro. For more about publishing onscreen controls and other parameters see Creating Templates for Final Cut Pro X.
HUD Controls
The HUD contains the following controls: Color, Radius, Spike Scale, Spike Angle, Spike Opacity, Spike Width, and Epsilon.
Stripes
The Stripes generator creates a default image with vertical bands of two alternating colors. You can change and keyframe the position, colors, size, and contrast of the stripes. Animate the Center parameter to make the stripes move continuously across the screen.
Parameters in the Inspector
Center: Sets the position of the center of the stripe pattern.
You can also use the Adjust Item tool to modify this parameter with onscreen controls. For more information, see Editing Generators Using Onscreen Controls.
Color 1: Picks the color of the first stripe. For more precise color selection, click the disclosure triangle to display Red, Green, Blue, and Opacity sliders.
Color 2: Picks the color of the second stripe. For more precise color selection, click the disclosure triangle to display Red, Green, Blue, and Opacity sliders.
Contrast: Sets the sharpness or blurriness of the edge between stripes. Values range from 0 to 1.
Publish OSC: Selecting this checkbox ensures that if this generator is sent to Final Cut Pro X as part of a template, the onscreen controls are accessible in Final Cut Pro. For more about publishing onscreen controls and other parameters see Creating Templates for Final Cut Pro X.
HUD Controls
The HUD contains the following controls: Color 1, Color 2, Size, and Contrast.
Two Color Ray
The Two Color Ray generator creates a ray pattern alternating between two colors. You can select the colors, the number of divisions represented, and rotation of the pattern.
Parameters in the Inspector
Offset: Sets the coordinates of the center of the ray pattern. Coordinates are calculated from the center of the object, which is the coordinate origin.
You can also use the Adjust Item tool to modify this parameter with onscreen controls. For more information, see Editing Generators Using Onscreen Controls.
Color 1: Picks the base color for the two-color ray.
Color 2: Picks the alternating color for the two-color ray.
Divisions: Sets the number of divisions in the ray pattern.
Rotation: Sets the rotation of the whole pattern from the center point.
Contrast: Sets the sharpness or softness of the division between rays.
Waviness: Positive or negative values create waves in the rays. Values range from –10 to 10.
Frequency: When Waviness is set to a value other than 0, determines the number of waves in the rays.
Phase: When Waviness is set to a value other than 0, defines the offset of the waves from the start and end of the rays.
Inner Cutoff: Defines a center stopping area for the generator. A value greater than 0 creates a hole in the middle of the generator; the greater the value, the larger the hole. Objects composited below the generator in the project appear in the cutoff areas.
Outer Cutoff: Defines an outer stopping area for the generator. The lower the value, the more the outer edges of the generator are cut off. Objects composited below the generator in the project appear in the cutoff areas.
Publish OSC: Selecting this checkbox ensures that if this generator is sent to Final Cut Pro X as part of a template, the onscreen controls are accessible in Final Cut Pro. For more about publishing onscreen controls and other parameters see Creating Templates for Final Cut Pro X.
HUD Controls
The HUD contains the following controls: Color 1, Color 2, Divisions, Rotation, Contrast, Waviness, Frequency, Phase, Inner Cutoff, and Outer Cutoff.