Adobe Director Basics

ADOBE DIRECTOR BASICS
3D: Controlling appearance
To access a particular group, you can use its name (Lingo only) or its index number.
-- Lingo
put member("3D").group[1]
-- group("World")
put member("3D").group(1)
-- group("World")
put member("3D").group("hug")
-- group("Hug")
// JavaScript
trace(member("3D").getPropRef("group", 1));
//
If a group with the given name or index number does not exist, Director will return VOID (Lingo) or undefined
(JavaScript); no error occurs.
Creating a group
Use the member3D.newGroup() function to create a new group with a given unique name.
-- Lingo syntax
vGroup = member("3D").newGroup("Musicians")
put vGroup
-- group("Musicians")
// JavaScript
vGroup = member("3D").newGroup("Musicians");
Ensure that the name is unique, which means that the name is not already used by any other node (model, light, group
or camera). If you try to create a new group with the same name as an existing node, a script error occurs: “Object with
duplicate name already exists”.
See “3D namespace” on page 85 for more details and a script that ensures that you have a unique name for the group
that you are about to create.
Deleting a group
To delete a group, use the member3D.deleteGroup() function. You can identify the group either by its name or its
index number. Deleting a group may change the index number of other groups. If you attempt to delete a non-existent
group, no error occurs.
-- Lingo syntax
put member("3D").deleteGroup("Disbanded")
-- 1
put member("3D").deleteGroup("Disbanded")
-- 0
put member("3D").deleteGroup(2)
-- 1
// JavaScript syntax
trace(member("3D").deleteGroup("Disbanded"));
// 1
member("3D").deleteGroup("Disbanded");
0
member("3D").deleteGroup(2);
1
Last updated 8/26/2011
89