drive glyphs
drive glyphs provides a way to move any object (a generated glyph, or an object from import cad, read glyph, etc.) along multiple paths to create a “driving” animation. Glyphs can be positioned along the input lines by percentage, by time data on the path, or by data values on the path. The Glyph Position setting selects the method, and the matching Percentage Options, Date Options, or Data Options group controls the position and its animation.
Ports
| Direction | Name | Type | Description |
|---|---|---|---|
| Input | Input Path | Field | The input field containing the lines to drive the glyphs along. |
| Input | Input Glyph | Field | The input field containing the glyph to drive along the input paths. |
| Input | Input Date | Date | Date used for determining glyph position along line. |
| Input | Input Position | Number | The value used for positioning the glyph by percentage. |
| Input | Input Data | Number | The value used for positioning the glyph by data on path. |
| Output | Output Date | Date | Date used for determining glyph position along line. |
| Output | Output Field | Field | The main output field with glyph in the selected position. |
| Output | Output Points | Field | The points used to generate the glyphs in the selected positions. |
| Output | Output Position | Number | The value used for positioning the glyph by percentage. |
| Output | Output Data | Number | The value used for positioning the glyph by data on path. |
| Output | Output Object | Renderable | A renderable object displaying the positioned glyphs. |
Properties
| Property | Type | Description |
|---|---|---|
| Allow Run | Boolean | Determines whether the module is allowed to execute. |
| Execute | Button | Accepts all values and places the glyphs. |
| Map Component | Choice | Selects which nodal data component of the input path to map to the output glyphs. |
| Data Processing | Choice: Nodal Data, Log10(Nodal Data) | Specifies how to process the Map Component for output and sizing. |
| Datamap | Range (Min/Max) | The min and max values used by the datamap. Changing these values can affect both the color range and the glyph size. |
| Glyph Position | Choice: % Along each line, % Along longest line, Sequential Walk, By Time data on path, By Data on path | Determines how the glyphs are placed along the input paths. |
| Number Of Glyphs | Integer | The maximum number of glyphs present along each line. |
| Circulate | Boolean | Used for looping or cycling animations. If a glyph’s position is past the end of the line, it is placed the appropriate distance from the start of the line; if it is before the start, it is placed the appropriate distance from the end. For example, with 3 glyphs on a line (each placed 33% of the line length apart) and the Position at zero, there is one glyph at 0%, another at 66%, and a final glyph at 33% of the distance along the line. |
| Glyph Size | Double | Scales the glyphs in all directions. The default is automatically computed based on your input data. |
| Priority | Choice: Maximum, Minimum | Minimum reverses the scaling so that the smallest sample values have the largest size. |
| Minimum Scale Factor | Double | Scales the sample values with the least priority. |
| Maximum Scale Factor | Double | Scales the sample values with the greatest priority. |
| Use Log Data | Boolean | Bases the size of the glyph on the log10 of the selected data. |
| Size For Vector Data | Choice: Use Vector Magnitude, Use Vector Components | Selects how glyphs are sized when sizing by a vector data component. |
| Magnitude For Zero Length | Double | The vector magnitude at which the glyphs will be zero size. This establishes the minimum level for taking log values, since the log of zero is undefined (minus infinity). |
| Include Center Data | Boolean | Includes the center point of each glyph as a cell data component. This allows you to probe onto the glyph and return its center instead of the position on the outside of the glyph. |
Glyph Settings
| Property | Type | Description |
|---|---|---|
| Glyph Type | Choice: Generated, Input Glyph, Directed Line | The source for the created glyph. Generated and Directed Line glyphs are created internally. Input Glyph requires the Input Glyph port to be connected. |
| Include Input Glyph Data | Boolean | When Glyph Type is Input Glyph, passes data associated with the input glyph through to the output. |
| Generated Glyph | Choice: Sphere, Cube, Cone, Cylinder, Polygon, Disk | The type of glyph that is automatically generated. |
| Sphere Subdivisions | Integer | The number of subdivisions to use for spheres. Larger numbers create more detailed sphere representations. |
| Glyph Resolution | Integer | The resolution for generated cone, polygon, cylinder, and disk glyphs. |
| Primary Axis Factor | Double | The scale factor for the primary axis of the glyph. |
| Secondary Axis Factor | Double | The scale factor for the secondary axis of the glyph. |
| Heading Dip | Heading/Dip | The heading and dip values used to align the glyphs to a constant orientation. |
| Roll | Double | The roll of the glyph along its primary axis. |
Percentage Options
| Property | Type | Description |
|---|---|---|
| Position | Double | The percentage along a line used for glyph positioning. |
| Position Animation | Loop control | Controls the movement (or driving) of the glyphs along the line. |
| Step Size | Double | The increment for advancement when stepping or running. |
Date Options
| Property | Type | Description |
|---|---|---|
| Date Component | Choice | Selects which nodal data component of the input path holds the time data used to position the glyphs. |
| Date | Date | The date used to position the glyphs. |
| Date Loop | Loop control | Steps the Date by the specified increments. |
| Step Time Units | Choice: Seconds, Minutes, Hours, Days, Weeks, Years | The time units of the increment for advancement when stepping or running. |
| Step Size | Double | A factor which, along with the Step Time Units, sets the increment for advancement when stepping or running. |
| Glyph Placement Method | Choice: By Number Of Glyphs, By Offset Time | Selects where additional glyphs are placed along each line. By Number Of Glyphs breaks up the time range by the number of glyphs, placing the first glyph at the Date and each additional glyph a proportional distance behind it. By Offset Time sets the difference in time between all glyphs. |
| Offset Time | Double | When Glyph Placement Method is By Offset Time, the difference in time used to position the remaining glyphs. |
Data Options
| Property | Type | Description |
|---|---|---|
| Data Component | Choice | Selects which nodal data component of the input path is used to position the glyphs. |
| Data Value | Double | The data value of interest, used to position the glyphs. |
| Data Loop | Loop control | Steps the Data Value by the specified increments. |
| Step Size | Double | The increment for advancement when stepping or running. |
| Glyph Placement Method | Choice: By Number Of Glyphs, By Offset Value | Selects where additional glyphs are placed along each line. By Number Of Glyphs breaks up the data range by the number of glyphs, placing the first glyph at the Data Value and each additional glyph a proportional distance behind it. By Offset Value sets the difference in value between all glyphs. |
| Offset Value | Double | When Glyph Placement Method is By Offset Value, the difference in value used to position the remaining glyphs. |