Adobe Director Basics

ADOBE DIRECTOR BASICS
3D: Controlling action
-- Lingo syntax
member("3D").model("HighImpact").addModifier(#collision)
put member("3D").model("HighImpact").modifier
-- [#collision]
// JavaScript syntax
member("3D").getPropRef("model", 2).addModifier(symbol("collision"));
trace(member("3D").getPropRef("model", 2).modifier)
//
Removing the modifier
You can use the command aModel.removeModifier() to remove the #collision modifier.
-- Lingo syntax
member("3D").model("HighImpact").removeModifier(#collision)
// JavaScript syntax
member("3D").getPropRef("model", 2).removeModifier(symbol("collision"));
Collision properties
Adding the collision modifier to a model gives you access to four properties:
model.collision.enabled: TRUE or FALSE (TRUE by default). If TRUE, then collisions between this model and other
models will trigger a collision event.
model.collision.mode: #sphere, #box or #mesh. Determines what form of simplified geometry is used for collision
detection. The default #sphere mode is the fastest and #mesh the slowest.
model.collision.resolve: TRUE or FALSE (TRUE by default). If TRUE and you attempt to move this model to a position
where a collision is detected with another model, then this model will be moved back in a straight line along its
trajectory to a position where no collision is detected.
model.collision.immovable:TRUE or FALSE (FALSE by default). Setting this property to TRUE will not prevent you
from moving the model. It simply tells the collision modifier that any movement of this model is to be ignored. To
improve performance, the collision modifier will not check whether any immovable models are in collision with
each other.
Collision events
You can generate a callback when a collision occurs using any of the following methods:
model.collision.setCollisionCallBack()
model.registerScript()
member3D.registerForEvent()
The setCollisionCallBack(aHandler, aCodeObject) method is a shortcut for
model.registerScript(#collideWith,aHandler, aCodeObject). You can use
registerForEvent(#collideAny, aHandler, aCodeObject) to generate a callback whenever any collision is
detected between any two models with the collision.modifier.
collisionData
When a collision is detected, the collision modifier will call any handler that is registered for collision events and send
a collisionData object as a parameter to the call. The collisionData object has four properties.
collisionData.modelA is one of the models involved in the collision.
Last updated 8/26/2011
281