Avec l'étiquette, vous pouvez afficher un texte dans une boîte, reliée par une ligne à un point spécifié. Voici des exemples simples (dans la deuxième instruction sur l'étiquette, notez le schéma standard en Python pour le formatage des valeurs numériques, où 1.5f signifie 1 chiffre avant le point décimal et 5 après):
Il y a plusieurs options supplémentaires pour l'étiquette. Dans le schéma ci-contre, une sphère représentant la Terre (dont le centre est à la position earth.pos) a été associée à un label contenant le texte "Earth" dans sa boîte, reliée à la sphère par une ligne qui s'arrête à la surface de celle-ci:
Une caractéristique unique de l'étiquette est que plusieurs de ses attributs sont donnés en pixels au lieu des coordonnées traditionnelles de "l'espace". Par exemple, la hauteur du texte est donnée en pixels; ce qui permet d'avoir un texte toujours lisible même si la sphère est déplacée loin de l'étiquette. Les autres attributs définis en pixels comprennent xoffset, yoffset, et border. Les attributs de l'étiquette sont:
pos; x,y,z Le point de l'espace qui est étiqueté.
xoffset, yoffset Les coordonnées x et y de l'extrémité de la ligne, en pixels (voir le schéma)
text Le texte à afficher, tel que 'Earth'
(Des retours à la ligne peuvent être rajoutés avec \n, comme dans label.text = "Three\nlines\nof
text")
height Hauteur de la fonte en pixels
color, red, green, blue Couleur du texte
opacity Opacité de l'arrière plan de la boîte,
par défaut 0.66
(0 transparent, 1 opaque, pour les objets derrière la boîte)
border Distance en pixels du texte à la boîte environnante
box 1 si la boîte doit être dessinée (par défaut), 0 sinon
line 1 si la ligne de la boîte à la position pos doit être dessinée (par défaut), 0 sinon
linecolor Couleur de la ligne et de la boîte
space Rayon définissant une sphère environnante de centre pos, sur laquelle la ligne n'est pas tracée.
font Nom optionnel de la fonte, tel que `helvetica'
Copyright © 2006 Guillaume et Yoann Duriaud. Aucune reproduction, même partielle, ne peut être faite de ce site ni de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.