3D_PLANE

3D_PLANE N

CREATES A PLANE 3D OBJECT AND GIVES IT THE NUMBER N AS REFERENCE

  • Type: Command
  • Parameter: 1
  • Group: 3D Objects

ACTION

The command 3D_PLANE creates a plane 3D object, and gives it a number N.

The number N is used to designate the 3D object.

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

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

Its dimensions are 10 x 10 and it is made with 4 tiles (2 x 2). The command 3D_LOAD_TEXTURE loads a tile. The tile number can be set by the commands: 3D_U_TILE et 3D_V_TILE.

The 3D object can be moved, rotated, scaled, colored, textured, deleted, hidden, showed... with the appropriated commands.

Remark: by default, the 3D object 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 3D object.

SYNTAX: 3D_PLANE N

  • 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.

USE

  • The command 3D_PLANE is used to create a plane object in a SCENE3D.

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 no SCENE3D is created.

EXAMPLE

rem create a 3D world

scene3d 1

rem move the camera

cam_z_position 10

rem create the 3D plane number 1

3d_plane 1

rem load a texture

3d_load_texture 1,"picture.bmp"

rem move the object

3d_z_position 1,-5

rem change the tile number

3d_u_tile 1,10

3d_v_tile 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

3D_U_TILE

3D_V_TILE