3D_LINE

3D_LINE N,X,Y,Z

CRÉE UNE LIGNE 3D ET LUI DONNE LE NUMÉRO N COMME RÉFÉRENCE, OU AJOUTE UN POINT À UNE LIGNE 3D EXISTANTE

  • Type: Commande
  • Paramètres: 2
  • Groupe: Objets 3D

ACTION

La commande 3D_LINE a 2 actions possibles :

- Si le numéro N n'est pas utilisé, elle crée le premier point d'une nouvelle ligne 3D en (X,Y,Z) et donne le numéro N à cette ligne 3D.

- Si le numéro N est déjà utilisé pour une ligne 3D, elle ajoute le point (X,Y,Z) à la ligne existante pour créer un nouveau segment à la ligne 3D désignée par son numéro N. Le nouveau segment prend la couleur et la largeur de la ligne 3D existante. Le centre de la ligne 3D est placée en (0,0,0) : le centre du monde 3D (SCENE3D).

La couleur de la ligne 3D est noire à la création et peut être modifiée par la commande 3D_COLOR.

La largeur de la ligne 3D est 1 pixel à la création et peut être modifiée par la commande 3D_LINE_WIDTH.

La ligne 3D peut être déplacée, tournée, déformée, colorée, supprimée, cachée, visualisée... avec les commandes appropriées.

Remarque: par défaut, la ligne 3D est créée dans le premier SCENE3D créé, mais un autre SCENE3D peut être utilisé. Pour cela, créer un nouveau SCENE3D et lui envoyer les commandes par 3D_TARGET_IS avant la création de la ligne 3D.

SYNTAXE : 3D_LINE N,X,Y,Z

  • N = numéro d'objet 3D (entier ou réel). Doit être plus grand que 0 et inférieur ou égal au nombre maximum permis d'objets 3D.
  • X = valeur de la composante X (entier ou réel) du point.
  • Y = valeur de la composante Y (entier ou réel) du point.
  • Z = valeur de la composante Z (entier ou réel) du point.

UTILISATION

  • La commande 3D_LINE est utilisée pour créer une ligne ou une poly-ligne dans un SCENE3D.

ERREUR

  • Si le numéro N n'est pas une expression correcte.
  • Si le numéro N excède le nombre maximum permis d'objets 3D.
  • Si le numéro N est inférieur ou égal à 0.
  • Si le numéro N n'est pas le numéro d'un 3D_LINE (dans le cas de l'ajout d'un point).
  • Si X ou Y ou Z n'est pas une expression correcte.
  • Si aucun SCENE3D n'est créé.

EXEMPLE

rem crée un monde 3D

scene3d 1

rem créer le premier point d'une ligne 3D numéro 1

3d_line 1,0,0,0

rem créer le deuxième point de la ligne 3D numéro 1

3d_line 1,1,0,0

EN RAPPORT

3D_COLOR

3D_DELETE

3D_DELETE_ALL

3D_LINE_WIDTH

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