Usage

name name

Description

The name command assigns a name to an object so that it may be referenced by an action on another object. This allows the implementation of multi-object behaviors, such as the where the clicking of one object causes another object to appear or disappear.

The name command has no effect by itself. It must be used in conjunction with actions on other objects in order to implement behaviors.

The following commands can reference objects other than the one they are placed through the use of the name command on the objects to be effected and the name parameter of the command on the controlling object:

• Animate - runs an animation on the object
• Astart - starts a stopped animation
• Astop - stops a running animation
• Color - assigns a new color to the object
• Corona - places a corona over an object
• Frame - changes the current animation frame
• Light - causes an object to emit light into the surrounding scene
• Move - causes an object to move smoothly from one location to another
• Picture - displays a picture (JPEG) on the object
• Rotate - causes an object to rotate continuously around one or more axes
• Sign - places visible text on the object
• Solid - makes the object either solid or unsolid
• Sound - attaches a background sound to an object
• Texture - paints a new texture onto the surface of an object
• Visible - makes the object either visible or invisible

Multiple objects may have the same name. In this case, any actions applied to a given name will affect all objects in the scene with that name assigned to them by the same citizen. Note that an object does not have to be showing on your screen to be in the current 3D scene. The Active Worlds browser loads objects into the scene when they fall within your visibility range.

Named objects built and owned by one citizen cannot be referenced by actions on objects owned by another citizen. For example, if citizen #1 owns an object with the action "create name rock", citizen #2 cannot make the object disappear by placing another object nearby with the action "activate visible rock off". For multi-object behaviors, all objects involved must be owned by the same citizen.

Example

create name door

This creates an object with the name "door". Other nearby objects can now refer to this object using the name "door". For example, when bumped another object could make the door invisible and unsolid using the action:

bump visible door off, solid door off