96 Chapter 3
•
•
•
•
[opacity=<value 0..255>]
[blend=<blend-type>]
[layers @ <"layer list">] // (PSD files only)
Parameters
adjust - when specified, all the other parameters except color1, color2, gradient,
and reverse (which have their usual meaning) are ignored. The image is then interpreted
as a grayscale image which is then passed through the specified gradient, giving a new
false-color image. This operates the same way as the GradientMap adjustment layer in
Photoshop.
style - specifies a common style for the gradient. The available styles are: Linear, Radial,
Angle, Reflected, and Diamond.
angle - specifies the value of the angle at which the gradient is applied. This value can
range from 0 to 360, to indicate the degree of the angle.
scale - specifies a scale to be applied to the gradient. This value can range from 10 to 150.
reverse - when specified, reverses the direction of the applied gradient.
color1 and color2 - used as an alternative to specifying a common gradient, these
parameters specify a custom gradient created by blending the two specified RGB colors. If
only one of these parameters is specified, a gradient is created that blends between the
specified color and transparent.
gradient - specifies a common color gradient that blend two or three standard colors. The
available gradients are RedGreen, VioletOrange, BlueRedYellow, BlueYellowBlue,
OrangeYellowOrange, VioletGreenOrange, YellowVioletOrangeBlue, Copper, Chrome,
Spectrum.
NOTE: If color1 and/or color2 are specified together with gradient, a parameter clash error occurs.
opacity - specifies opacity of the source image. The default value is 255 (completely
solid).
NOTE: If the source image already has an alpha channel that renders it less than solid, specifying
opacity can only make it less opaque; it cannot override the alpha channel to make it more opaque.
blend - specifies the type of blending used to combine the drawn object with the images.
Blend modes are: “Normal”, “Darken”, “Lighten”, “Hue”, “Saturation”, “Color”,
“Luminosity”, “Multiply”, “Screen”, “Dissolve”, “Overlay,” “HardLight”, “SoftLight”,
“Difference”, “Exclusion”, “Dodge”, “ColorBurn”, “Under”, “Colorize” (causes only the
hue component of the source to be stamped down on the image), and “Prenormal”.
This function supports CMYK for the following blend modes: “Normal”, “Darken”,
“Lighten”, “Screen”, “Multiply”, “Dissolve”, “Overlay”, “HardLight”, “SoftLight”,
“Difference”, “Exclusion”, “Burn”, “Dodge”, “Under”, “Copy”, and “PreNormal”. The
other modes (Hue, Saturation, Color, Luminosity, and Colorize) are not supported for
CMYK. You must first convert to RGB using colorCorrect() and then perform the
composite. Additionally, composite cannot be performed unless both images are either
CMYK or RGB.
layers - for PSD files, specifies the layers to be affected. The layer numbers begin at 0
(background) and go up. For more information see load() on page 101.
