272
Chapter 12: Methods
To see an example of quad used in a completed movie, see the Quad movie in the Learning/Lingo
folder inside the Director application folder.
Parameters
sourceImgObj
Required. A reference to the source image object from which pixels are copied.
destRectOrQuad
Required if copying pixels into a screen coordinate rectangle or a floating point
quad. The rectangle or quad into which pixels are copied.
sourceRect
Required. The source rectangle from which pixels are copied.
paramList
Optional. A parameter list that can be used to manipulate the copied pixels before
they are placed into
destRect
or
destQuad
. The property list may contain any or all of the
following parameters.
Example
This statement copies the entire image of member Happy into the rectangle of member flower. If
the members are different sizes, the image of member Happy will be resized to fit the rectangle of
member flower.
Property
Use and Effect
#color
The foreground color to apply for colorization effects. The default color is black.
#bgColor
The background color to apply for colorization effects or background transparency.
The default color is white.
#ink
The type of ink to apply to the copied pixels. This can be an ink symbol or the
corresponding numeric ink value. The default ink is
#copy
.
#blendLevel
The degree of blend (transparency) to apply to the copied pixels. The range of
values is from 0 to 255. The default value is 255 (opaque). Using a value less than
255 forces the
#ink
setting to be
#blend
, or
#blendTransparent
if it was originally
#backgroundTransparent
. #blendLevel could also be replaced with
#blend
; if so, use
use a value range of 0 to 100.
#dither
A
TRUE
or
FALSE
value that determines whether the copied pixels will be dithered
when placed into the
destRect
in 8- and 16-bit images. The default value is
FALSE
,
which maps the copied pixels directly into the
imageObjRef
’s color palette.
#useFastQuads
A
TRUE
or
FALSE
value that determines whether quad calculations are made using the
faster but less precise method available in Director when copying pixels into
destQuad
. Set to
TRUE
to use quads for simple rotation and skew operations. Set to
FALSE
for arbitrary quads, such as those used for perspective transformations. The
default value is
FALSE
.
#maskImage
Specifies a mask or matte object, created with the
creatMask()
or
createMatte()
s,
that will be used as a mask for the pixels being copied. This enables the effects of
mask and matte sprite inks to be duplicated. If the source image has an alpha
channel and its
useAlpha
property is
TRUE
, the alpha channel is used and the
specified mask or matte is ignored. The default is no mask.
#maskOffset
A point indicating the amount of x and y offset to apply to the mask specified by
#maskImage
. The offset is relative to the upper left corner of the source image. The
default offset is (0, 0).
Summary of Contents for DIRECTOR MX 2004-DIRECTOR SCRIPTING
Page 1: ...DIRECTOR MX 2004 Director Scripting Reference...
Page 48: ...48 Chapter 2 Director Scripting Essentials...
Page 100: ...100 Chapter 4 Debugging Scripts in Director...
Page 118: ...118 Chapter 5 Director Core Objects...
Page 594: ...594 Chapter 12 Methods...
Page 684: ...684 Chapter 14 Properties See also DVD...
Page 702: ...702 Chapter 14 Properties See also face vertices vertices flat...
Page 856: ...856 Chapter 14 Properties JavaScript syntax sprite 15 member member 3 4...
Page 1102: ...1102 Chapter 14 Properties...