With the label object you can display text in a box. Here are simple examples (in the second label statement, note the standard Python scheme for formatting numerical values, where 1.5f means 1 figure before the decimal point and 5 after):
There are many additional
label options. In the accompanying diagram, a sphere representing the Earth
(whose center is at earth.pos) has an associated
label carrying the text "Earth" in a box, connected to the sphere
by a line which stops at the surface of the sphere:
A unique feature of the label object is that several attributes are given in terms of screen pixels instead of the usual "world-space" coordinates. For example, the height of the text is given in pixels, with the result that the text remains readable even when the sphere object is moved far away. Other pixel-oriented attributes include xoffset, yoffset, and border. Here are the label attributes:
pos; x,y,z The point in world space being labeled
xoffset, yoffset The x and y components of the line, in pixels (see diagram)
text The text to be
displayed, such as 'Earth'
(Line breaks can be included as \n, as in label.text = "Three\nlines\nof
text")
font Name of the desired font (for example, 'times', or 'system', or 'symbol')
height Height of the font in pixels
color, red, green, blue Color of the text
opacity Opacity of the
background of the box, default 0.66
(0 transparent, 1 opaque, for objects behind the box)
border Distance in pixels from the text to the surrounding box
box 1 if the box should be drawn (default), else 0
line 1 if the line from the box to pos should be drawn (default), else 0
linecolor Color of the line and box
space World-space radius
of a sphere surrounding pos,
into which the connecting line does not go
font Optional name of the font, such as `helvetica'