3D_TORUS

3D_TORUS N,OR,IR

CREATES A TORUS WITH OUTER AND INNER RADIUS, AND GIVES IT THE NUMBER N AS REFERENCE

  • Type: Command
  • Parameters: 3
  • Group: 3D Objects

ACTION

The command 3D_TORUS creates a torus with the specified values of outer radius OR and inner radius IR and gives it a number N.

The number N is used to designate the torus.

The center of the torus is placed in (0,0,0) : the center of the 3D world (SCENE3D).

The color of the torus is gray at creation and can be modified by the command 3D_COLOR.

The torus can be moved, rotated, scaled, colored, textured, deleted, hidden, showed... with appropriated commands.

Remark: by default, the torus is created in the first created SCENE3D, but another SCENE3D can be used. For that, create a new SCENE3D, and send it all the commands by 3D_TARGET_IS before creating the torus.

SYNTAX: 3D_TORUS N,OR,IR

  • N = 3D object number (integer or real). Must be greater than 0 and less than or equal to the allowed maximum number of 3D objects.
  • OR = outer radius value (integer or real). Must be greater than 0.
  • IR = inner radius value (integer or real). Must be greater than 0.

USE

  • The command 3D_TORUS is used to create a torus in a SCENE3D, which can be handled with appropriated commands.

ERROR

  • If number N is not a correct expression.
  • If number N exceeds the allowed maximum number of 3D objects.
  • If number N is less than or equal to 0.
  • If number N is already used for another 3D object.
  • If outer radius OR or inner radius IR is not a correct expression.
  • If outer radius OR or inner radius IR is less than or equal to 0.
  • If no SCENE3D is created.

EXAMPLE

rem create a 3D world

scene3d 1

rem create a torus number 1

3d_torus 1,2,1.5

SEE ALSO

3D_COLOR

3D_DELETE

3D_DELETE_ALL

3D_LOAD_TEXTURE

3D_HIDE

3D_SHOW

3D_TARGET_IS

3D_X_POSITION

3D_Y_POSITION

3D_Z_POSITION

3D_X_ROTATE

3D_Y_ROTATE

3D_Z_ROTATE

3D_X_SCALE

3D_Y_SCALE

3D_Z_SCALE