Text : Shape

text - superclass: shape; super-superclass:node - classID: #(6547, 0)

Constructor

text ...

Properties

Parameters Rollout

<text>.font    String default: "Arial"

Choose from a list of all fonts available to 3ds Max.

<text>.italic    Boolean default: false

Turn on/off italicized text.

<text>.underline    Boolean default: false

Turn on/off underlined text.

<text>.alignment     Integer  default: 1

Sets the alignment of text:

1- Align Left (Aligns text to the left side of its bounding box.)

2- Center (Aligns text to the center of its bounding box.)

3- Align Right (Aligns text to the right side of its bounding box.)

4- Justify (Spaces all lines of text to fill the extents of the bounding box.)

<text>.size    Float default: 100.0 -- animatable

Te text height where the height measuring method is defined by the active font.

<text>.kerning    Float default: 0.0 -- animatable

The kerning (the distance between letters).

<text>.leading    Float default: 0.0 -- animatable

The leading (the distance between lines).

<text>.text    String default: "3ds Max Text"

The text displayed in the viewport.

Interpolation Rollout

<text>.steps     Integer default: 6

The number of divisions between each vertex.

<text>.optimize     Boolean default: true

When on, removes unneeded steps from straight segments in the spline.

<text>.adaptive     Boolean default: false

When on, adaptive sets the number of steps for each spline to produce a smooth curve. Straight segments always receive 0 steps.

Rendering Rollout

<text>.render_renderable BooleanClass default: false -- boolean; renderable

Toggles the "Enable in Renderer" checkbox on and off. Available in 3ds Max 8 and higher.

deleted_feature.gifReplaces the previously available .renderable property which used to collide with the node-level .renderable property. While the alias is still available for compatibility reasons, it is advisable to use the new name in new scripts.

<text>.render_displayRenderMesh BooleanClass default: false -- boolean; displayRenderMesh

Toggles the "Enable In Viewport" checkbox on and off. When set to true, the mesh will be displayed in the viewports. Available in 3ds Max 8 and higher.

deleted_feature.gifReplaces the previously available .displayRenderMesh property, provides an alias for backwards compatibility.

<text>.render_useViewportSettings BooleanClass default: false -- boolean; useViewportSettings

Toggles the "Use Viewport Settings" checkbox on and off. When set to true, the mesh displayed in the viewport will use the Viewport settings. When false, the Renderer settings will be used for the viewport mesh, too. Available in 3ds Max 8 and higher.

deleted_feature.gifReplaces the previously available .useViewportSettings property, provides an alias for backwards compatibility.

<text>.render_mapcoords BooleanClass default: false -- boolean; mapcoords

Toggles mapping coordinates generation on and off. The U coordinate wraps once around the thickness of the spline; the V coordinate is mapped once along the length of the spline. Available in 3ds Max 8 and higher.

deleted_feature.gifReplaces the previously available .mapcoords property, provides an alias for backwards compatibility.

<text>.realWorldMapSize BooleanClass default: false -- boolean

Toggles the real-world map size option on and off. Available in 3ds Max 8 and higher.

<text>.render_displayRenderSettings BooleanClass default: true -- boolean; displayRenderSettings

Toggles the state of the Viewport/Renderer radio buttons. When set to true, the Renderer settings will be displayed in the rollout. When false, the Viewport settings will be shown instead. Available in 3ds Max 8 and higher.

deleted_feature.gifReplaces the previously available .displayRenderSettings property, provides an alias for backwards compatibility.

<text>.render_rectangular BooleanClass default: false -- boolean

When set to true, enables the Rectangular cross-section mode to be used in the renderer. When false (default), enables the Radial cross-section mode. Corresponds to the Radial/Rectangular radio buttons in the UI in Renderer mode. Available in 3ds Max 8 and higher.

<text>.render_viewport_rectangular BooleanClass default: false -- boolean

When set to true, enables the Rectangular cross-section mode to be used in the viewports. When false (default), enables the Radial cross-section mode. Corresponds to the Radial/Rectangular radio buttons in the UI in Viewport mode. Available in 3ds Max 8 and higher.

Renderer - Radial Cross-Section

<text>.render_thickness Float default: 1.0 -- animatable; thickness

Get/Set the diameter of the Radial renderable spline mesh. Available in 3ds Max 8 and higher.

deleted_feature.gifReplaces the previously available .thickness property, provides an alias for backwards compatibility.

<text>.render_sides Integer default: 12 -- animatable; sides

Get/Set the number of sides for the spline mesh in the renderer. A value of 4 will give you a square cross section, for example. Available in 3ds Max 8 and higher.

deleted_feature.gifReplaces the previously available .sides property, provides an alias for backwards compatibility.

<text>.render_angle Float default: 0.0 -- animatable; angle

Get/Set the rotational position of the Radial cross-section in the renderer. Available in 3ds Max 8 and higher.

deleted_feature.gifReplaces the previously available .angle property, provides an alias for backwards compatibility.

Renderer - Rectangular Cross-Section

<text>.render_length Float default: 6.0 -- animatable

Get/Set the length of the Rectangular renderable spline mesh. Available in 3ds Max 8 and higher.

<text>.render_width Float default: 2.0 -- animatable

Get/Set the width of the Rectangular renderable spline mesh. Available in 3ds Max 8 and higher.

<text>.render_angle2 Float default: 0.0 -- animatable

Get/Set rotational position of the Radial cross-section in the renderer. Available in 3ds Max 8 and higher.

<text>.render_aspect_locked BooleanClass default: false -- boolean

Controls the state of the Aspect Lock checkbutton. When set to true, changing the Width will affect the Height and vice-versa, preserving the aspect at the time the lock was engaged. Available in 3ds Max 8 and higher.

Viewport - Radial Cross-Section

<text>.render_viewport_thickness Float default: 1.0 -- float; viewport_thickness

Get/Set the diameter of the Radial renderable spline mesh in the viewport. Available in 3ds Max 8 and higher.

deleted_feature.gifReplaces the previously available .viewport_thickness property, provides an alias for backwards compatibility.

<text>.render_viewport_sides Integer default: 12 -- integer; viewport_sides

Gets/Sets the number of sides for the Radial spline mesh in the viewports. A value of 4 will give you a square cross section, for example. Available in 3ds Max 8 and higher.

deleted_feature.gifReplaces the previously available .viewport_sides property, provides an alias for backwards compatibility.

<text>.render_viewport_angle Float default: 0.0 -- float; viewport_angle

Gets/Sets the rotational position of the cross-section in the viewports. Available in 3ds Max 8 and higher.

deleted_feature.gifReplaces the previously available .viewport_angle property, provides an alias for backwards compatibility.

Viewport - Rectangular Cross-Section

<text>.render_viewport_length Float default: 6.0 -- float

Get/Set the length of the Rectangular spline mesh in the viewports. Available in 3ds Max 8 and higher.

<text>.render_viewport_width Float default: 2.0 -- float

Get/Set the width of the Rectangular spline mesh in the viewports. Available in 3ds Max 8 and higher.

<text>.render_viewport_angle2 Float default: 0.0 -- float

Get/Set rotational position of the Rectangular cross-section in the viewports. Available in 3ds Max 8 and higher.

<text>.render_viewport_aspect_locked BooleanClass default: false -- boolean

Controls the state of the Aspect Lock checkbutton. When set to true, changing the Width will affect the Height and vice-versa, preserving the aspect at the time the lock was engaged. Available in 3ds Max 8 and higher.

Auto Smooth

<text>.render_auto_smooth BooleanClass default: true -- boolean

Controls the state of the Auto Smooth checkbox. When set to true, auto smoothing will be enabled. Available in 3ds Max 8 and higher.

<text>.render_threshold Float default: 40.0 -- animatable;

Get/set the Auto Smooth Threshold value. Available in 3ds Max 8 and higher.

 

Notes

The Manual Update property is not accessible to MAXScript in 3ds Max.

In Autodesk VIZ, the default value for property .text is "VIZ Text"

See also

Spline Shape Common Properties, Operators, and Methods

Shape Common Properties, Operators, and Methods

Node Common Properties, Operators, and Methods

MAXWrapper Common Properties, Operators, and Methods

Value Common Properties, Operators, and Methods