SclGraphicsSetTextPath

Overview

Set the path, using XYZ vector components, that the text is to follow when it is rendered.

Synopsis

SclGraphicsSetTextPath $xpath $ypath $zpath

Description

Unless otherwise specified, when text is inserted into a 3D graphics scene it is drawn horizontally. The orientation of the text can be controlled by defining a vector using X, Y and Z components to define the 3D path that the text must follow. When used in conjunction with the text font setting rotation=follow path the text characters can be drawn perpendicular to the defined path.

Arguments

• xpath, ypath, zpath

Pass by value. The components of the X, Y and Z vectors that define the text path. Permitted values for the path components are any positive or negative value or zero. An easy way to determine suitable values for the text path is to use SINE and COSINE appropriately of the angle of orientation of the baseline along which the text is drawn. A non-zero Z component will cause the text to stick up into the air.

Returns

Nothing.

Examples

SclGraphicsOpen mynode
  SclGraphicsSetTextPath 1.0 0.0 0.0
  SclGraphicsSetTextPath 0.0 1.0 0.0
SclGraphicsClose