User Guide

Chapter 19518
Camera commands
Use these commands to work with cameras:
Command Description Returns
addChild(aNode,
preserveWorld)
Adds aNode to this camera’s list of children. An equivalent
operation is to set
aNode.parent to equal thisCamera.
The
preserveWorld argument is optional.I t can have two
values:
#preserveWorld or #preserveParent. If the
value is
#preserveWorld, the world transform of the child
being added remains intact. If
#preserveParent, the child’s
transform is interpreted as remaining parent-relative.
Nothing
child[index] Returns the child at the specified position in the index. Lingo camera object
child(name) Returns the child named name. Lingo camera object
clone(name) Clones a camera named name, adds it to the cameras’s parent’s
child list, and adds it to the world.
All children of the camera are automatically cloned.This can be
avoided by removing the children, performing the cloning
operation, and then adding the children back.
If the name is omitted or is
"", the clone isn’t added to the
camera palette, has no parent, and has no children. This option
lets you quickly create temporary camera instances.
Lingo camera object
cloneDeep(name) Clones both the camera and all resources used by the camera’s
children.
Lingo camera object
addtoWorld() Adds a camera to the currently active 3D world, setting its
parent as
"world"
Equivalent to camera.parent=member
("scene").camera("world").
All newly created cameras are added to the world by default,
without it being necessary to use this command.
Nothing
getWorld
Transform()
Calculates and returns a transform that converts object-relative
positions for this light into world-relative positions.
A transform object
removeFrom
World()
For cameras whose parent hierarchy terminates in the world,
this sets their parent to
void and removes them from the world.
Otherwise it does nothing.
Nothing
isInWorld() For cameras whose parent hierarchy terminates in the world, the
value is
TRUE (1).
TRUE (1) or
FALSE (0)
registerScript
(
eventName,
handlerName,
scriptInstance)
Registers a handler named handlerName that is called in the
script
scriptInstance when the event eventName
occurs.
If
scriptInstance is 0, a movie script handler called
eventName is called.
The user defines what
eventName is.
TRUE (1) or
FALSE (0), with
TRUE (1)
indicating that the
event happened and
FALSE (0) that it
did not