Text

Method #

This node generates and renders a 3D mesh from the text that has been generated according to various attributes using a supplied font. The font must be in TrueType or OpenType format and loaded as a Font resource. Text must be entered via the Text String parameter, or connected with a Text String Node. Some nodes such as the OSC Text String and RSS Text nodes can be updated via external sources, enabling live updating text. JavaScript scripts may modify the Text String parameter of a text node in order to control text from a script.

As well as being rendered directly, Text nodes may also be used as an input for various other nodes, including Particle Mesh Emitters, Field Mesh Emitter, Mesh Cloner, Volume Cloner and numerous others.

As Point Size gets smaller, less path data is used, lowering the resolution of the of the output text. We strongly recommend using Size Scale when resizing a font, unless you need to add more or less resolution to your text.

When using monospace fonts, ensure that Letter Space Scaling is always set to zero and scale your Word Spacing to ensure you match your space distance to the letter size.

Parameters

Transform

Parameter	Details
Position X	The objects position along the local x-axis.
Position Y	The objects position along the local y-axis.
Position Z	The objects position along the local z-axis.
Rotation Heading	The objects rotation around the local y-axis.
Rotation Pitch	The objects rotation around the local x-axis.
Rotation Bank	The objects rotation around the local z-axis.
Scale X	The objects scale along the local x-axis.
Scale Y	The objects scale along the local y-axis.
Scale Z	The objects scale along the local z-axis.

Parent Transform

Control the inheritance of the transforms from the parent.

Parameter	Details
Position	Toggle inheritance of the Position from the parent.
Rotation	Toggle inheritance of the Rotation from the parent.
Scale	Toggle inheritance of the Scale from the parent.
World Position Only	Inherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties.
Inherit Time	Toggle inheritance of time from the parent.

Pivot Point

These properties control the pivot position the object, the point at which the transforms will be applied around.

Parameter	Details
Pivot Mode	Control where the pivot point is generated for the object.
Pivot Point Selection	In custom mode, filter the points shown on the bounding box for placing the pivot.
Pivot Position X	In custom mode, directly edit the x position of the pivot.
Pivot Position Y	In custom mode, directly edit the y position of the pivot.
Pivot Position Z	In custom mode, directly edit the z position of the pivot.
Edit Pivot	TODO
Dynamic Update	Control whether the changes to the pivot dynamically update the object.

Attributes

These properties control the core behaviours of the node.

Parameter	Details
Isolate In Viewport	When enabled, all other objects in the scene will be hidden and only this node will be rendered.
Font	Select a font to be used.
Visible	Control whether the node is visible or not to the scene.
Seen By Rays	Allow the mesh to be seen by the raytracer. When set to 0, the mesh will still render in camera but will be ignored by any raytracing nodes.
Per Object Composite Alpha	Overwrites the alpha channel beneath the object, giving simple effect of transparency. best used when the mesh won’t overlap with other objects, as other meshes will not be seen through the mesh.
Render Z Only	When enabled, the 3D object is only rendered to the depth buffer in the main camera render. No colour data is rendered.
Render To Shadows Only	When enabled, this object isn’t rendered to the camera but will render shadows still.
Text String	A string of text to be displayed.
Geometry Type	How the text is generated to the screen. Polygons : Text is generated into a 3d mesh, with the extrude property defining the thickness of the text. Lines : Text is generated as 3d lines around the outline of the text, with the line width property defining the thickness of the lines. Bitmaps : Text is generated into a bitmap image on a 3d plane.
Words To Clones	Split the text into clones.
Word Separator String	The character used to split the text string into clones. defaults to space.
Kerning	Control the kerning on the text. will use a kerning table supplied by the font if applicable, otherwise will default to optical proximity checks between characters.
Letter Spacing Scale	Scale the spacing between each letter.
Letter Gap	Scale the spacing between each letter.
Word Spacing	Control the spacing between words.
Line Spacing	Control the spacing between each new line.
Point Size	Changes the point size of the font.
Right To Left Text	Control the direction of the text. useful for languages that are written right to left.
Write On Off Mode	Choose how the text is animated onto the screen.
Write Off Function	Choose how the text is animated off the screen.
Write On Time	Control the time it takes for the text to appear on the screen.
Write Off Time	Control the time it takes for the text to disappear on the screen.
Write Off Time Offset	Control the time between the write on time finishing and the write off time beginning.
Write On Space Duration	How long it takes for a space character to be “written” on.
Write On/Off Fade Time	Fades the alpha of text as it’s written on and off. only functions in bitmap mode.
Justification	Choose how the text is justified in reference to the gizmo.
Kerning Mode	Choose whether kerning is done optically or through a kerning table.
Axis	Choose which axis the text is generated on.
Size Scale	Scale the size of the text.
Lines Width	Control how wide the lines are when using “Lines” “Geometry Type”.
Extrude	Control the depth of the generated text.
Extrude Amount	Extrude the text, so it is 3d.
Bevel	bevel the text along the extruded edges.
Bevel Subdivisions	Number of subdivisions used to form the bevel.
Bevel Width	Control the wdith of the bevel generated.
Bevel Depth	Control how far the bevel is offset back into the text.
Bevel Shape	The profile of the bevel applied to the edges of the text: Linear, Rounded or inverted-rounded. Linear : Rounded : Inv-Rounded :
Circular	Generates the text into a circle format
Circular Radius	The size of the circle for the text to be fixed around
Deformer Chunks Mode	How connected deformers in chunks vertex source mode will affect the text. Letters : Each letter will be treated as a chunk. Words : Each word will be treated as a chunk.
Text Vertex Count	Shows how many vertices are required to generate the text.
Text Polygon Count	Shows the polygon count required to generate the text.
Post-Deformer Vertex Count	Shows the current vertex count of the Text after all the deformers have been applied.
Post-Deformer Polygon Count	Shows the current polygon count of the Text after all the deformers have been applied.

Text Box

Parameter	Details
Fit To Box	Enable text to be clamped to fit inside of a defined box.
Box X0	Text boxes bottom left x position.
Box Y0	Text boxes bottom left y position.
Box X1	Text boxes top right x position.
Box Y1	Text boxes top right y position.

Lines

These properties add options for drawing all the edges of the mesh as lines. Useful for rendering wireframe effects.

Parameter	Details
Lines Visible	Control whether lines are rendered to the scene from the geometry.
Lines Alpha	Change the alpha transparency value of the lines, making them appear see-through.
Colour	Change the colour value of the lines.
Use Vertex Colours	Colour lines based on the vertex colours of the geometry.
Blend Mode	How the object lines blends with the rest of the content in a 3d scene. See Blend Modes for details. Solid : The line rendering is treated as a solid object, and does not blend with anything behind it. Blend : The line rendering is blended with the rest of the content in the scene, with a subtle gradient over the line edges. Additive : The line rendering adds onto the rest of the content in the scene. Subtractive : The line rendering subtracts from the rest of the content in the scene. Multiply : The line rendering multiplies with the rest of the content in the scene. Max : The max value between the lines and the content behind it is used. Min : The min value between the lines and the content behind it is used. Light : The line rendering is blended using the light blend mode with the rest of the content in the scene. Screen : The line rendering is blended using the screen blend mode with the rest of the content in the scene. Pre-Mul Blend : The line rendering mis premultiplied before blending with the rest of the content in the scene.
Thick Lines	Allow the lines to rendered with thickness, for line effects which can be accurately anti-aliased.
Thick Line Width	Control the thickness of all the lines. Only functions with Thick Lines enabled.
Hide Back Face Lines	Hide the lines generated from polygon faces facing away from the camera, where only the back faces of geometry can be seen.
Lock Width	Lock the line width to be a consistent width regardless of distance from the camera. Only functions with Thick Lines enabled.
Show Silhouette Lines	Draws lines along the edges of the object relative to the camera.
Show Normal Difference Lines	Draw a line along the edges of the mesh, depending on the angle difference between their mutual faces.
Show Unshared Lines	Draw lines along all edges of the shape.
Show Other Lines	Show all the lines for each edge of the mesh.
Unshared Lines Weight	Control the strength of the unshared lines.
Silhouette Lines Weight	Control the strength of the silhouette lines.
Normal Difference Lines Weight	Control the strength of the lines generated along the normal angles.
Other Lines Weight	Control the strength of the lines for each edge in the mesh.
Line Normal Difference Angle	Change the threshold angle between two face normals that will generate a line along their common edge. Only functions with Show Normal Lines enabled.
Line Normal Fade Sharpness	How much the drawn normal lines will fade away the closer the edge angle is to the Line Normal Difference Angle.
Line Depth Bias	Exaggerate the width of the lines based on the distance to the camera. not functional with Lock Width enabled.
Line Silhouette Fade Sharpness	How much the drawn silhouette lines will fade away based on the size of the edge angle to the camera.

Material Preview

Preview the objects material in the viewport.

Parameter	Details
Preview in Viewport	Toggle a preview of the Material on a sphere in the Viewport.

Material

These properties control how the surface of the generated mesh reacts to light in the scene. See Materials for a breakdown of all these properties individually.

BSDF

Parameter	Details
Colour	The colour of the material.
Brightness	The brightness of the material.
Specular Intensity	The intensity of the specular reflection.
Specular Colour	The colour of the specular reflection.
Colour Map -> Specular Colour	Use the input colour map as the specular reflection colour.
Specular Anisotropy	Controls the anisotropy of the specular reflection.
Specular Falloff	Controls the falloff of the specular reflection.
Diffuse Fresnel	Controls the fresnel effect on the diffuse reflection.
Metallicness	Controls the metallicness of the material.
Roughness	Controls the roughness of the material.
Normal Map Mode	Changes the format of the input normal map. Off : Tangent Space : Object Space :
Normal Map Intensity	TODO
Invert Normals	Flip the normals of each face, so the lighting is tested against the inside face.
Emissiveness	How much of a glow is emitted around the object.
Emissive Scattering	Controls how much Emissive lighting is scattered in the scene.
Emissive Lights Scene	Controls how much Emissive lighting contributes to lighting the scene.
Use Displacement	Enables the use of displacement mapping for the material. Requires an input displacement map. Off :* On :
Displacement	How much the deformer displaces the original mesh.
Displacement Offset	Adds an initial offset to the displacement.
Displacement - Use Polygon UVs	TODO
Opacity Mode	Controls the opacity mode of the material, and how it blends with the scene. Solid : Blend : Clip :
Alpha	Set the alpha amount of the material
Blend Mode	Change how the material once added to an object blends with the scene. Only functions with Alpha Mode for details. Solid : Linear : Additive : Subtractive : Multiply : Max : Min : Screen : Light : Pre-Mul Blend :
Alpha Sort Bias	Biases the alpha sort in order to make it render in front or behind other transparent objects.
Output Alpha In GBuffer Composite	Sends the alpha to the gbuffer composite pass.
Translucency	Controls the translucency mode of the material. Off : Refraction : Subsurface Scattering : Single Sided SSS :
Refraction IOR	TODO
Aberration	TODO
Absorption	How much light is absorbed by the material as light passes through it.
Absorption Colour	Colour to use for absorption.
Subsurface Weight	Weight of the subsurface scattering effect.
Subsurface Scatter Radius	Radius of the subsurface scattering effect.
Diffuse Coat	TODO
Diffuse Lightmap	Enables an input diffuse lightmap for the material. Off : On :
Baked Diffuse Intensity	TODO
Ambient Occlusion	Enables the input ambient occlusion map of the material. Off : On :

Textures

Parameter	Details
Colour Texture	Defines the base color of the material’s surface. It represents the surface color under neutral, uniform lighting.
Diffuse Map	Specifies the color of light that scatters off the surface in all directions. It is functionally similar to the Colour Texture and is a core component of a material’s appearance.
Specular Map	Controls the color and intensity of shiny reflections (specular highlights). Brighter areas on the map indicate a more reflective and shinier surface.
Emissiveness Map	Determines which parts of a material appear to glow or emit their own light. Brighter values cause the surface to act as a light source.
Metallicness Map	A grayscale map to define how ‘metal-like’ a surface is. White values represent pure metal, while black values represent non-metals.
Roughness Map	A grayscale map that controls the roughness of the surface. Black represents a smooth, mirror-like surface with sharp reflections, while white represents a rough surface with blurry, diffuse reflections.
Normal Map	Adds surface detail like bumps and scratches without adding more polygons to the model. It simulates how light would interact with a more complex surface, creating the illusion of depth.
Displacement Map	Physically displaces the vertices of the model’s geometry based on the map’s values. Unlike a Normal Map, this creates real geometric detail that affects the model’s silhouette.
Alpha Map	A grayscale map that controls the transparency of the material. Black areas are fully transparent, white areas are fully opaque, and gray values create semi-transparency.
Ambient Occlusion Map	Adds subtle, soft shadows to areas that are occluded from ambient light, such as creases and crevices. This enhances realism and adds perceived depth to the model.
Subsurface Colour Map	Defines the color of light after it has scattered beneath the surface of a translucent material, such as skin, wax, or marble.
Subsurface Weight Map	Controls the intensity of the subsurface scattering effect across the material, defining how much light penetrates and scatters within the surface.
UV Texture Filter Mode	Determines the algorithm used for sampling texture pixels when viewed at different angles and distances. Point : Bilinear : Anisotropic : Bicubic : Oversampling :
Diffuse Map -> AO	A setting to use the Diffuse or Colour map to contribute to the Ambient Occlusion calculation, often darkening areas based on the base color.
Texture Mip Bias	An offset that adjusts which mipmap level is used for a texture. Negative values can sharpen distant textures, while positive values can blur them.

UVs

Parameter	Details
Colour Texture UV	Select the UV for the Colour Texture. UV 1 : UV 2 : UV 3 : UV 4 :
Diffuse Map UV	Select the UV for the Diffuse Map Texture. UV 1 : UV 2 : UV 3 : UV 4 :
Specular Map UV	Select the UV for the Specular Map Texture. UV 1 : UV 2 : UV 3 : UV 4 :
Emissiveness Map UV	Select the UV for the Emissiveness Map Texture. UV 1 : UV 2 : UV 3 : UV 4 :
Metallicness Map UV	Select the UV for the Metallicness Map Texture. UV 1 : UV 2 : UV 3 : UV 4 :
Roughness Map UV	Select the UV for the Roughness Map Texture. UV 1 : UV 2 : UV 3 : UV 4 :
Normal Map UV	Select the UV for the CoNormal Map Texture. UV 1 : UV 2 : UV 3 : UV 4 :
Displacement Map UV	Select the UV for the Displacement Map Texture. UV 1 : UV 2 : UV 3 : UV 4 :
Alpha Map UV	Select the UV for the Alpha Map Texture. UV 1 : UV 2 : UV 3 : UV 4 :
Ambient Occlusion Map UV	Select the UV for the Ambient Occlusion Map Texture. UV 1 : UV 2 : UV 3 : UV 4 :
Subsurface Colour Map UV	Select the UV for the Subsurface Colour Texture. UV 1 : UV 2 : UV 3 : UV 4 :
Subsurface Weight Map UV	Select the UV for the Subsurface Weight Texture. UV 1 : UV 2 : UV 3 : UV 4 :
UV Scale X	Scale the UV texture along the X axis.
UV Scale Y	Scale the UV texture along the Y axis.
UV Offset X	Offset the UV texture along the X axis.
UV Offset Y	Offset the UV texture along the Y axis.
Diffuse UV Scale X	Scale the Diffuse UV texture along the X axis.
Diffuse UV Scale Y	Scale the Diffuse UV texture along the Y axis.
Diffuse UV Offset X	Offset the Diffuse UV texture along the X axis.
Diffuse UV Offset Y	Offset the Diffuse UV texture along the Y axis.
Texture Wrap Mode U	Controls how textures used by the material are wrapped when the U value range exceeds 0 to 1. Repeat : Clamp : Border With Black : Mirror :
Texture Wrap Mode V	Controls how textures used by the material are wrapped when the V value range exceeds 0 to 1. Repeat : Clamp : Border With Black : Mirror :
Diffuse Texture Filter Mode	Controls how textures used by the material are filtered. Point : Bilinear : Anisotropic : Bicubic : Oversampling :
Diffuse Texture Wrap Mode U	Controls how textures used by the material are wrapped when the U value range exceeds 0 to 1. Repeat : Clamp : Border With Black : Mirror :
Diffuse Texture Wrap Mode V	Controls how textures used by the material are wrapped when the V value range exceeds 0 to 1. Repeat : Clamp : Border With Black : Mirror :
UV Remap Filtering	Enables filtering for remapping UV’s. Only functions with eligible textures.

Lighting

Parameter	Details
Lit	Determines if the material is affected by lights in the scene. When disabled, the material appears fully lit by its own colour and texture, regardless of scene lighting.
Reflections Mode	Controls how the material generates reflections from its surroundings. Full Reflections : Env Map : Off :
Shadows	Defines how the object interacts with shadows in the scene. Cast + Receive : Cast : Receive : Off :
Shadow Catcher Colour	Set the colour of the material when “Shadows” is set to “Shadow Catcher”.
Render Visibility	Controls the object’s visibility to different types of rays in the renderer, which is useful for advanced effects. Full : Unseen by Rays : Unseen by Camera :
Raytracing Settings	Determines whether the material uses the scene’s global raytracing depth settings or custom values. Use Global Settings : Override :
Max. Diffuse Depth	Limits the number of times a ray can bounce off diffuse surfaces, affecting indirect lighting quality.
Max. Glossy Depth	Limits the number of times a ray can reflect off glossy or specular surfaces.
Max. Refraction Depth	Limits the number of times a ray can pass through refractive (transparent) surfaces.

Geometry

Parameter	Details
Polygon Sidedness	The orientation of the polygon’s faces. Front : Back : Double Sided :
Flip Polygons	Flips the orientation of the polygon’s faces.
Smoothing Angle	The angle difference used to determine a hard edge or a soft curve.
Wireframe	Displays the material’s geometry as a wireframe.

FX

Parameter	Details
Rim Lighting	Simulates Rim Lighting on the material with respect to the camera. Off : Rim Lighting :
Rim Lighting Use Material Colour	TODO
Rim Lighting Colour	TODO
Rim Lighting Intensity	TODO
Rim Lighting Falloff	TODO
Glow	Controls the glow of the Rim Lighting.

Vertex Colours

Parameter	Details
Vertex Colours - Apply To Colour	Set how the vertex colours apply to the colour of the mesh. No : Multiply by RGB : Multiply by Red : Multiply by Green : Multiply by Blue : Multiply by Alpha : Multiply by Inv Red : Multiply by Inv Green : Multiply by Inv Blue : Multiply by Inv Alpha :
Vertex Colours - Apply To Alpha	Set how the vertex colours apply to the alpha of the mesh. No : Multiply by Red : Multiply by Green : Multiply by Blue : Multiply by Alpha : Multiply by Inv Red : Multiply by Inv Green : Multiply by Inv Blue : Multiply by Inv Alpha :
Vertex Colours - Apply To Roughness	Set how the vertex colours apply to the roughness of the mesh. No : Multiply by Red : Multiply by Green : Multiply by Blue : Multiply by Alpha : Multiply by Inv Red : Multiply by Inv Green : Multiply by Inv Blue : Multiply by Inv Alpha :
Vertex Colours - Apply To Metallicness	Set how the vertex colours apply to the metallicness of the mesh. No : Multiply by Red : Multiply by Green : Multiply by Blue : Multiply by Alpha : Multiply by Inv Red : Multiply by Inv Green : Multiply by Inv Blue : Multiply by Inv Alpha :
Vertex Colours - Apply To Emissiveness	Set how the vertex colours apply to the emissiveness of the mesh. No : Multiply by Red : Multiply by Green : Multiply by Blue : Multiply by Alpha : Multiply by Inv Red : Multiply by Inv Green : Multiply by Inv Blue : Multiply by Inv Alpha :

Time

The properties control the time at which the node is active. See Timeline for editing time segments.

Parameter	Details
Duration	Control the duration of the node’s time segment. Composition Duration : Use the length of the composition for the node’s time segment duration. Custom : Set a custom duration for the node’s time segment.
Node Time	The custom start and end time for the node.
Duration (Timecode)	The length of the node’s time segment (in time).
Duration (Frames)	The length of the node’s time segment (in frames).
Time Segment Enabled	Set whether the node’s time segment is enabled or not in the Timeline.

Inputs

Name	Description	Typical Input
Effectors	Use Cloner Effectors to transform the words or letters.	Plain Effector
Material	Override the default material with a material node.	Materials
Extruded Material	Select the Material to be applied to the extruded section of the mesh.	Materials
Text String Nodes	Override the text string from in the node.	Text String
Transform Modifiers	Apply the transforms of another node to this node.	Null
Target Node	Modifiy the rotations of the node to always direct the z axis towards the input.	Null
Local Transform Override	Apply the transforms of another node to this node, relative to its parent.	Null
Parameter Value Array	Used to set the parameters of the node using an array.	Parameter Array