10.5 The label module

label([mode])

Creates a new label. mode is an optional integer denoting whether the label is editable by the user, moveable by the user, or both. In the first case mode has to be set to the integer constant EDITABLE, in the second case to the integer constant MOVEABLE, and in the last case to EDITABLE | MOVEABLE. The integer constants are defined in the label module. The default mode is editable and moveable.

translate(x, y, z)

Sets the postion of a label. x, y, and z are integers specifying the coordinates of the label in pixels. The z coordinate has no effect.

text([text])

Sets or returns the text of an label. If present text has to be a string. The maximum number of characters for a label is limited to 255.

setColor(red, green, blue, alpha)

Sets the red, green, blue, and alpha components of a label's color. red, green, blue, and alpha have to be floats between 0.0 and 1.0. The default color for a label is black.

delete()

Deletes a label.