130 Chapter 3
•
•
•
•
This function can be used in conjunction with the following functions: adjustHsb(),
adjustRgb(), blur(), blurBlur(), blurGaussianBlur(), blurMoreBlur(), blurMotionBlur(),
colorize(), composite(), equalize(), noiseAddNoise(), otherHighPass(), otherMaximum(),
otherMinimum(), pixellateMosaic(), pixellateFragment(), sharpenSharpen(),
sharpenSharpenMore(), sharpenUnsharpMask(), stylizeDiffuse(), stylizeEmboss(),
stylizeFindEdges(), and stylizeTraceContour().
Syntax
selection(
[Source @ <user-defined Media object name>]
[Fill @ <value 0..255)]
[X @ <pixel>]
[Y @ <pixel]
[BackColor @ <true, false>]
[Color @ <color in hexadecimal or rgb>]
[Index @ <value 0..16777215>]
[ColorType @ <"Cyans", "Magentas", "Yellows", "Reds",
"Greens", "Blues", "Hilites", "Midtones", "Shadows">]
[Invert @ <true, false>]
[Remove @ <true, false>]
[Opacity @ <value 0..255>]
[Radius @ <value 1..600>]
[layers @ <"layer list">] // (PSD files only)
);
Parameters
You specify the area of selection using one of two sets of parameters:
1 Using
Source
- When you use Source, the system interprets the image as a grayscale (if it is
not one). Loading a selection replaces one that is already active.
NOTE: The Name parameter has been deprecated.
•
Before creating a new selection, you must load() the image. Then, use the Source
parameter to refer to that image by its user-defined Media object name.
•
If the source and target images are of different size, use the Fill parameter to specify
what value pixels have in the selection mask that fall outside the size of the selection
image. The default is 0.
•
The X parameter determines at what horizontal position the top-left corner of the source
image is placed on the target image. If the X parameter is not specified, the selection
image will be centered over the target image horizontally.
•
The Y parameter determines at what vertical position the top-left corner of the source
image is placed on the target image. If the Y parameter is not specified, the selection
image will be centered over the target image vertically.
•
Using Backcolor, Color, Index, or ColorType- Use one of these parameters to create a
selection from an image that includes all pixels that match the specified color or color
type.
