Adobe Director Basics

ADOBE DIRECTOR BASICS
3D: Controlling action
#timeMS: Register a handler for the #timeMSevent to trigger that handler at a given interval a given number of
times.
Ways to register
Use the following methods to register a callback handler:
Use member3D.registerForEvent() to register a handler to be called whenever the given event is triggered by any
model.
Use node.registerScript() to register a handler to be called only when the given event is triggered by a particular node
Use model.collision.setCollisionCallback(...) as a shortcut for model.registerScript(#collideWith, ...)
For example, if you want information about all collisions in the member “3D” to be channeled to the on
CollisionDetected() handler in a Movie Script, use the following commands:
-- Lingo syntax
member("3D").registerForEvent(#CollideAny, #CollisionDetected, 0)
// JavaScript syntax
member("3D").registerForEvent(symbol("CollideAny"), symbol("CollisionDetected"), 0);
If you want information about collisions with model 1 (named “Dark”) in the member “3D” to be channeled to the on
DarkImpact() handler of an instance of the script “Dark Events”, use the following commands:
-- Lingo syntax
vInstance = new script("Dark Events")
member("3D").model("Dark").collision.setCollisionCallback(#DarkImpact, vInstance)
// JavaScript syntax
vInstance = new script("Dark Events");
member("3D").getPropRef("model", 1).getPropRef("collision",
1).setCollisionCallback(symbol("DarkImpact"), vInstance);
To send information on all animations that start playing in member “3D” to an on ShowMotionDetails() handler
in a behavior on sprite 2, use the following code:
-- Lingo syntax
member("3D").RegisterForEvent(#animationStarted, #ShowMotionDetails, sprite 2)
// JavaScript syntax
member("3D").RegisterForEvent(symbol("animationStarted"), symbol("ShowMotionDetails"),
sprite(2));
To call the on SecondThoughts() handler in a behavior in the script “MetroGnome” every 1000 milliseconds exactly
60 times, starting 42 milliseconds from now, use the following code:
-- Lingo syntax
member("3D").RegisterForEvent(#timeMS, #SecondThoughts, script "MetroGnome", 42, 1000, 60)
// JavaScript syntax
member("3D").RegisterForEvent(symbol("timeMS"), symbol("SecondThoughts"), script
"MetroGnome", 42, 1000, 60);
Stopping callbacks
You can use member3D.unregisterAllEvents() to stop all callbacks to all handlers in all scripts for all events.
Note: In Director 11.5, there is no way to unregister just one handler for one event. Design your scripts so that this
functionality is not required.
Last updated 8/26/2011
357