Adobe 65036570 - Director - PC, Руководство пользователя

Страница: 392 / 498

ADOBE DIRECTOR 11.0
User Guide
381
Selecting models
Selecting models ( picking ) refers to clicking on models in a 3D cast member. Because models are objects that exist
within a 3D cast member and a 3D sprite, they are not normally sensitive to mouse clicks. Normally, only the entire
sprite is sensitive to mouse clicks.
You can use scripts to determine specifically which models have been clicked within a 3D sprite. In practice, this
allows for changing model positions to make it appear that an action such as a button being pushed or a door being
opened has taken place, or to allow the user to select or drag an object. Picking can be accomplished by using cast
member or camera methods.
Camera methods
The following camera methods let you determine which models have been clicked within a 3D sprite. You can also
translate coordinates in 3D space to coordinates in 2D sprite space and vice versa.
Method Description Returns
worldSpaceTo
SpriteSpace
( vector )
Returns the 2D sprite-space coordinates of a point from a 3D world
vector. A point.
spriteSpaceTo
WorldSpace
( point )
The opposite of the
worldSpaceToSpriteSpace
( vector )
, this method returns a world-space vector on the
camera’s projection plane from a sprite-space point.
Multiple world-space positions can map to the same sprite-space
point. A round-trip
y=worldSpaceToSpriteSpace(x)
z=worldSpaceToSpriteSpace(y)
won’t necessarily result in
x=z
.
A vector.
modelUnder
Loc( point )
Returns the first model intersected by a ray from a location
point
within the
rect
of the sprite using this camera. The location
point
is relative to the upper-left corner of the sprite, in pixels. The ray is
cast forward in the direction the camera is looking.
This method is useful for picking in conjunction with an
onMouseDown
handler. For accuracy, be sure to subtract the upper-
left corner of the sprite’s
loc
from the
mouseLoc
.
The first model inter-
sected by the ray.
A value of
void
means
there is no model under
the ray.
modelsUnder
Loc( point,
optionalMax
NumberOf
Models )
Returns a list of all models intersected by a ray from a location
point
within the
rect
of the sprite using this camera. The location
point
is relative to the upper-left corner of the sprite, in pixels. The
ray is cast forward in the direction the camera is looking.
This method is useful for picking in conjunction with an
onMouseDown
handler. For accuracy, be sure to subtract the upper-
left corner of the sprite’s
loc
from the
mouseLoc
.
The first model inter-
sected by the ray or a list
of up to the specified
maximum.
If no maximum is speci-
fied, the method
returns all models under
the ray.
A value of
void
means
there is no model under
the ray.