place text
The place text module provides a means to interactively place 2D and 3D renderable text strings or to read a .PT file (or legacy .EMT file) to place the text. Text can be positioned interactively by probing in the viewer, or imported from a file.
Ports
| Direction | Name | Type | Description |
|---|---|---|---|
| Input | Input Explode | Number | The value used to determine whether the model has been exploded. |
| Input | Input Z Scale | Number | The factor for vertical scaling. |
| Input | Subsetting Feature | Field | A field containing a line for subsetting. |
| Output | Output Explode | Number | The value used to determine whether the model has been exploded. |
| Output | Output Z Scale | Number | The factor for vertical scaling. |
| Output | Output Object | Renderable | A renderable object displaying the placed text. |
Properties
| Property | Type | Description |
|---|---|---|
| Import File | File | Import existing text from a .pt (place text) file. |
| Reload Import File | Button | The Reload Import File button forces the module to reload the Import File. |
| Visible | Visibility | Controls the visibility of the object. Excluded prevents inclusion in supported exports. Locked makes the object always visible in supported exports. |
| Z Scale | Double | The Z Scale is required to assure that text is matched to scaled input. |
| Explode | Double | The explode factor to apply to each text string based on its Explode ID. |
| Export File | File | Export current text to a .pt (place text) file. |
Text Settings
| Property | Type | Description |
|---|---|---|
| Probe Action | Choice: None, Reset Position, Add Text | Allows for the changing of the text center or for adding a new string at the probed location. Only available when the viewer is connected. |
| Forward Facing Style | Forward Facing | Forward Facing Style allows the user to align the labels to an appropriate view and to alter the basic layout of the font. These values are module wide so apply to all Forward Facing selected fonts. |
| Trim White Space | Boolean | The Trim White Space control when selected will remove leading and trailing spaces from all text. |
| Texts | Text Editor | The text entries to place in the scene. |
Projection Options
| Property | Type | Description |
|---|---|---|
| Subset Region | Choice: Within Line Distance, Outside Line Distance | The Subset Region allows the user to either keep the text within Distance to Line or to keep only the text outside that distance. |
| Distance To Line | Double | The Distance To Line value is used to subset the text to within a distance from the line passed into the Subsetting Feature port. |
| Straighten To 2D | Boolean | The Straighten to 2D toggle is used to project the position of 3D text to a 2D representation, where each text x coordinate value becomes the distance to the line passed into the Subsetting Feature port. |
| Straightened Plane | Choice: Export in XZ, Export in XY | The Straightened Plane allows the user to set the plane the straightened text are in. This requires a line passed into the Subsetting Feature, and text that has been Straightened to 2D. |