The 'ppeffectlist' property is a camera property. Each individual camera can have its own 'ppeffectlist'. Note that overlays of the camera will not be considered for Post-processing effects.
myppeffectlist = sprite(1).camera(1).ppeffectlist
The Post-processing effects make use of the following common variables:
- Texture List: You can specify the list of textures that are used by certain Post-processing effects.
- Operation List: You can specify the operations to be performed on the textures specified in the Texture List. The list of supported operations are:
- Additive blending specified using “add”.
- Multiplicative blending specified using “multiply”.
- Subtractive blending specified using “subtract”.
- Type: Returns the type symbol of the Post-processing effect.
Adobe Director 12 provides the following new post-processing effects:
This function is used to create a new Post-Processing Effect Object. The type of Post-Processing effect returned is determined by the parameter 'ppEffectSymbol'.
ppEffectObjRef = newppeffect(ppEffectSymbol)
ppColor = newppeffect(#ppadjustcolor) ppColor.adjustcolormatrix= myMatrix ee = sprite(me.spriteNum).camera(1).ppeffectlist ee.append(ppColor)
You can use Convolution filter to apply a wide range of imaging transformations, such as blurring, edge detection, sharpening, embossing, and beveling.
The values for achieving these transformations must be specified using a three by three matrix as follows:
- Gaussian Blur
myList = [1.0/16, 2.0/16, 1.0/16, 2.0/16, 4.0/16, 2.0/16, 1.0/16, 2.0/16, 1.0/16] - Sharpness
myList = [-1, -1,-1, -1, 9, -1, -1, -1, -1] - Edge-detection
myList = [0, 1, 0, 1, -4, 1, 0, 1, 0] - Emboss
myList = [2, 0, 0,0, -1, 0, 0, 0, -1] - Mean
myList = [1.0/9, 1.0/9, 1.0/9,1.0/9, 1.0/9, 1.0/9, 1.0/9, 1.0/9, 1.0/9]
myList = [0, 1, 0, 1, -4, 1, 0, 1, 0] myMatrix = newMatrix(3,3,myList) pp = newppeffect(#ppconvolution) pp.convolutionmatrix = myMatrix ee = sprite(me.spriteNum).camera(1).ppeffectlist ee.append(pp)
ppColor = newppeffect(#ppadjustcolor) ppColor.adjustcolormatrix= myMatrix ee = sprite(me.spriteNum).camera(1).ppeffectlist ee.append(ppColor)
You can use the Adjust color filter to edit a scene’s brightness, contrast, saturation, and hue. The Adjust-Color Filter effect lets you apply a 3 x 4 matrix transformation on the RGB color of every pixel in the input image to produce a result with a new set of RGB color.
Here are the matrix values you can use for different colors:
- Red Channel
myLists = [1,0,0,0, 0,0,0,0, 0,0,0,0] - Green Channel
myLists = [ 0,0,0,0, 0,1,0,0, 0,0,0,0] - Blue Channel
myLists = [ 0,0,0,0, 0,0,0,0, 0,0,1,0] - Black & White
myLists = [0.3,0.3,0.3,0, 0.3,0.3,0.3,0, 0.3,0.3,0.3,0] - Contrast
myLists = [2,0,0,0, 0,2,0,0, 0,0,2,0] - Saturation
myLists = [2,1,0,0, -1,2,0,0, 0,-1,2,0] - Hue
myLists = [0,1,0,0, 0,0,1,0, 1,0,0,0] - Normal
myLists = [1,0,0,0, 0,1,0,0, 0,0,1,0] - Invert (Negative)
myLists = [ -1,0,0,1, 0,-1,0,1, 0,0,-1,1]
myList = [ 0,0,0,0, 0,1,0,0, 0,0,0,0] myMatrix = newMatrix(3,4,myList) pp = newppeffect(#ppadjustcolor) pp.adjustcolormatrix= myMatrix ee = sprite(me.spriteNum).camera(1).ppeffectlist ee.append(pp)
Blur motion effect causes blurring of objects in motion. Blurring is dependent on the velocity of the object.
You can apply blur motion effect to:
- A camera: Blur motion effect is applied to all the models that are rendered by the camera.
Property:
3Dmember.camera(1).blurmotion = true
- A Model: Blur motion effect is applied only to the specific model.
Property:
pSphere.blurmotion = true
By default, blur motion effect is disabled for all models and cameras. Blur motion effect applied to a camera overrides the effect applied to a model.
pp = newppeffect(#ppblurmotion) pp.blurconst = 0.08 ee = sprite(me.spriteNum).camera(1).ppeffectlist ee.append( pp ) pSphere.blurmotion = true -- enable Blur-Motion in Sphere p3Dmember.camera(1).blurmotion = true --enable Blur-Motion on Camera
The Bloom Post-processing Effect is used to bloom the screen. This effect makes bright areas appear brighter.
pp = newppeffect (#ppbloom) pp.bloomthreshold = 0.1 pp.baseintensity = 1 pp.bloomintensity = 2 pp.basesaturation = 1 pp.bloomsaturation = 1 pp.blurX = 5 pp.blurY = 1 ee = sprite(me.spriteNum).camera(1).ppeffectlist ee.append(pp)
- BloomThreshold: Controls the minimum intensity in the original image that will be bloomed. Only those pixels that are brighter than this value will be bloomed.
- BaseIntensity/BloomIntensity: When the bloomed image is combined with the original image, these values determine the intensity (brightness) of the respective images.
- BaseSaturation/BloomSaturation: When the bloomed image is combined with the original image, these values determine the saturation of the respective images.
- BlurX/BlurY: Controls the blurriness of the bloomed image in X or Y axis.
You can specify up to seven input textures and corresponding operations to blend them at run-time on the scene and create different effects.
pp = newppeffect(#ppblendtextures) pp.texturelist = mytexturelist –- supports upto 7 textures mytexturelist.append(tex1) mytexturelist.append(tex2) mytexturelist.append(tex3) pp.oplist = myoperationlist –- supports upto 7 operations myoperationlist.append(“add”) myoperationlist.append(“subtract) myoperationlist.append(“multiply”) ee = sprite(me.spriteNum).camera(1).ppeffectlist ee.append( pp )
- Texture List: The Blend Textures effect supports upto 7 textures.
- Operations List: The Blend Textures effect supports up to 7 operations based on the number of textures in the Texture List.
Depth of Field is the distance between the nearest and farthest objects in a scene that appear acceptably sharp in an image (from Wikipedia).
You can use depth of field to emphasize a specific object or a model while blurring or de-emphasizing other objects in the foreground and background.
pp = newppeffect(#ppdepthoffield) pp.depthstart = 20 pp.depthrange = 20 pp.blurconst=5 ee = sprite(me.spriteNum).camera(1).ppeffectlist ee.append(pp)
- DepthStart: Distance from the camera to the point up to which all the objects will appear sharp.
- DepthRange: All the objects between ‘DepthStart’ & ‘DepthStart + DepthRange’ blur gradually. Beyond ‘DepthStart + DepthRange’ objects appear completely blurred.
- BlurConst: Controls the blurriness of the scene that is not in focus
The Night Vision filter helps you to replicate a night vision goggles scene by specifying brightness, red/blue/green coloring in the scene. You can also use two textures for adding shadows and noise to the scene.
pp = newppeffect(#ppnightvision) pp.brightness = 1.3 pp.greenBias = 0.7 pp.texturelist = [shadow,noise] –- supports two textures --By default, opacity of both set to 1 ee = sprite(me.spriteNum).camera(1).ppeffectlist ee.append(pp)
- Brightness: Indicates the multiplication factor for brightness in the scene. Value of 1 keeps the brightness unchanged, while 0 makes the scene black. Values greater than 1 brighten the scene.
- RedBias/GreenBias/BlueBias: Indicates the respective coloring to be given to the scene. Values range from 0 (no color) to 1 (full intensity of color)
- NoiseOpacity: Denotes the opacity of the ‘noise’ additive texture (texturelist[2])
- ShadowOpacity: Denotes the opacity of the ‘shadow’ multiplicative texture (texturelist[1]). This is used to get the vignetting effect (edges are darkened)
- Texture List: The Night Vision effect supports two textures. The first layer is multiplicative blending, while second is additive blending. These are controlled by parameters NoiseOpacity and ShadowOpacity properties described above.
- NightVisionMatrix: This is intended for advanced users. It allows greater control over the exact look of the effect. NightVisionMatrix works just like the Adjust Color Matrix.
- LineWidth: Denotes width in pixels of the alternating white lines that are displayed when using the Night Vision Effect.
- LineOpacity: Denotes opacity of the alternating white lines that are displayed when using the Night Vision Effect. Values range from 0 to 1.
Twitter™ and Facebook posts are not covered under the terms of Creative Commons.