A newer version of Max is available. Click here to access the latest version of the documentation

jit.gl.text Reference

Render text in a GL context

jit.gl.text

Description

Draws text in the named drawing context. The text is drawn as 2D, 3D, or outline, depending on the mode attribute. The text can be sent as a symbol, a list of symbols, or as a jit.matrix containing char data. When a jit.matrix is used, each row of the matrix is interpreted as one line of text.

Attributes

align [int]

Text alignment mode (default = 0 (left))

Possible values:

0 = 'left'
1 = 'center'
2 = 'right'
3 = 'justify'

depth [float]

The depth (z extent) of the 3D geometry relative to the height of the font (default = 0.) If a depth of 0 is used, no extruded character sides are generated, which will draw much faster. Only valid if mode is 3d.

floatchomp [int]

Toggles floating-point precision rounding.

floatplaces [int]

When float point precision rounding is enabled set via the floatchomp attribute, this value sets the precision of the number.

fontname [symbol]

Set the name of the font type used.

fontsize [int]

Set the font size in pixels (default = 9). Only valid if mode is 2d.

leadscale [float]

The leading between multiple rows of text as a multiple of the standard leading. (default = 1.)

line_length [float]

The line length specified in gl-units for mode 3d and outline, and in pixels for 2d. Lines of text extending beyond this value will wrap to the next line. The default value of -1 specifies no line length, and therefore no wrapping.

mode [symbol]

Defines how the rendered text is drawn (default = 2d).

Possible values:

'2d'
'3d'
'outline'

plane [int]

The plane of a multi-plane char input matrix which will be interpreted as text. (default = 0)

precision [float]

Sets the precision of the quadratic curve calculation [0 ->inf], The default is 1.0

screenmode [int]

If screenmode = 1, some 3D transformations are skipped so that pixel-accurate text can be drawn. The origin of the text on screen is determined by the usual projection of the object's position, but the text remains the same size. Rotation is only applied around the z axis. Screenmode is useful for making fixed-size labels which follow objects in space. With screenmode off, the text is transformed in space in the usual way for an OB3D-group object. (default = 1) Only valid if mode is 2d.

slant [int]

Text slant (default = normal)

Possible values:

0 = 'normal'
1 = 'italic'

tracking [float]

The tracking (intra-character spacing) as a multiple of the standard tracking for the face. (default = 1.)

weight [int]

Text weight (default = normal)

Possible values:

0 = 'normal'
1 = 'bold'

Common Box Attributes

OB3D Attributes

Messages

append

Arguments

text-to-append [list]
Appends the specified symbol or list to the stored text string.

face

Arguments

face-variant [list]
Specifies the face variant of the current font. One or more face variants may be specified. The Supported font faces are normal, bold, italic.

font

Arguments

fontname [symbol]
size [int]
Specifies the font in which to draw.

size

Set the font size in points

style

Equivalent to face.

text

Arguments

text [list]
Replace the current text string with a symbol or list of symbols.

OB3D Messages

See Also

Name Description
Working with OpenGL Working with OpenGL
jit.gl.graph
jit.gl.gridshape
jit.gl.handle
jit.gl.isosurf
jit.gl.mesh
jit.gl.isosurf
jit.gl.mesh
jit.gl.model
jit.gl.nurbs
jit.gl.plato
jit.gl.render
jit.gl.shader
jit.gl.sketch
jit.gl.slab
jit.gl.texture
jit.gl.videoplane
jit.gl.volume
Tutorial 30: Drawing 3D text Tutorial 30: Drawing 3D text