3D_TARGET_IS

3D_TARGET_IS N

DESIGNATES THE SCENE3D OBJECT NUMBER N AS RECEIVER OF "3D" COMMANDS

  • Type: Command
  • Parameter: 1
  • Group: System

ACTION

The command 3D_TARGET_IS N designates the SCENE3D object number N which will receive the next "3D" commands : creation of 3D objects, positionning of the 3D camera, of the point aimed by the 3D camera, of the 3D light. The SCENE3D becomes the "3D target" object.

By default, the "3D target" object is the first created SCENE3D if there are several SCENE3D. If there is only 1 SCENE3D, it is the "3D target" object.

SYNTAX: 3D_TARGET_IS N

  • N = system object number (integer or real). Must be greater than 0 and less than or equal to the allowed maximum number of system objects.

USE

  • The command 3D_TARGET_IS is used to perform 3D commands on several SCENE3D.

ERROR

  • If number N is not a correct expression.
  • If number N exceeds the allowed maximum number of system objects.
  • If number N is less than or equal to 0.
  • If the system object number N does not exist.
  • If number N is not the number of a SCENE3D.

EXAMPLE

rem create 2 SCENE3D

scene3d 1

scene3d 2

rem move scene3d number 2 on Y axis

left 2,200

rem designate the object number 2 as 3D target

3d_target_is 2

rem create a sphere on the SCENE3D number 2

3d_sphere 1,1.2

rem wait for 1 second

wait 1000

rem designate the object number 1 as 3D target

3d_target_is 1

rem create a sphere on the SCENE3D number 1

3d_sphere 2,1.2

SEE ALSO

SCENE3D

NUMBER_3D_TARGET