ImageText

An ImageText node is a 2D node that generates an image overlaid with text.

Connection Type

Connection Name

Function

Input

scenegraph

A 3D scene from which attributes can be referenced in the text parameter of an ImageText node (see below).

 

Control (UI)

Default Value

Function

bounds

[resolution]

Dependent on Project Settings

Select the size of the text frame.

left

0

Lets you offset the text frame by this number of pixels from the left.

bottom

0

Lets you offset the text frame by this number of pixels from the bottom.

width

globals.width

The width of the text frame in pixels.

The default setting, globals.width, resizes the text frame to the width of the resolution indicated on the Project Settings tab.

Note:  You can only edit this field when the initial resolution is modified.

height

globals.height

The height of the text frame in pixels.

The default setting, globals.height, resizes the text frame to the height of the resolution indicated on the Project Settings tab.

Note:  You can only edit this field when the initial resolution is modified.

text

N/A

Enter the text you want to display here.

You can optionally query scene graph values from an incoming 3D scene by:

Connecting a 3D scene as input

Creating a text GroupAttribute at /root, containing the attributes you are interested in using as children.

Reference attrs within the text node using the {attr:ATTRNAME} syntax.

fontSource

Builtin

Select:

Builtin - to use a built-in font (either Arial or Courier) for the text.

File - to use a font from an external font file for the text. Enter the file path to the font or use the file browser to browse to it. Fonts are loaded using FreeType2, which supports TrueType and OpenType fonts among others.

fontSource: Builtin

font

Arial

Lets you select a font for the text when fontSource is set to Builtin: either Arial or Courier.

fontSource: File

fontFile

N/A

Lets you select a font for the text when fontSource is set to File.

parameters continued

size

18.0, size[0]

Sets the pixel size of the font.

Note that because of the way fonts are generated from control splines that vary in size, you rarely get a character that is exactly this size.

No character ever renders larger than this size.

position

getDisplayWindow().width/2,

getDisplayWindow().height/2

The pixel position at which the justified text is placed.

For example, if you set hjustify to Left and vjustify to Top, the left side of the baseline of the first line of text is placed at this location.

If you set hjustify to Center and vjustify to Bottom, the baseline of the last line of text is centered on this position horizontally.

hjustify

Center

Sets how to align the text horizontally:

Left - align the text along the left edge of the text frame, placing the left side of the text block at the location defined by position. This leaves the right edge of the text ragged.

Center - align the text from the center of the text frame, placing the center of the text block at the location defined by position. This leaves both edges of the text ragged.

Right - align the text along the right edge of the text frame, placing the right side of the text block at the location defined by position. This leaves the left edge of the text ragged.

vjustify

Center

Sets how to align the text vertically:

Top - align the text along the top edge of the text frame, placing the top baseline of the text block at the location defined by position.

Center - align the text from the center of the text frame, placing the center baseline of the text block at the location defined by position.

Bottom - align the text along the bottom of the text frame, placing the bottom baseline of the text block at the location defined by position.

The baseline is the imaginary line upon which most letters rest.

lineSpace

0

If you have several lines of text, this adjusts the spacing between each line. By using negative values, you can make the letters overlap.

wrapMode

None

Sets how to wrap long lines of text to fit inside the text frame:

None - long lines are not wrapped to fit inside the text frame. Some parts of the text may fall outside the frame and not be visible.

Word - long lines are split into several lines at word boundaries.

Exact - long lines are split into several lines at the closest point in the text that fits the text frame width, regardless of word boundaries.

wrapMode: Word or Exact

wrapWidth

bounds.width

The width to use when calculating when to wrap the text.

color

color

1.0, 1.0, 1.0, 1.0

The color (RGBA values) of the rendered text. You can also use the below RGB, HSL, or HSV controls to set the color of the text.

For more information, refer to the Color Widget Type in the Common Parameter Widgets.

parameters continued

antiAliasingGamma

2.2

Gamma applied after text rasterization but before applying color. This affects anti-aliasing appearance.

missingAttributes

Ignore

Specifies behavior when missing 3D scene graph attributes are encountered:

Ignore - the missing attributes are ignored.

Error - the missing attributes cause a render error.