drive glyphs
The drive glyphs module provides a way to move any object (glyph or object from read dxf, etc.) along multiple paths to create a “driving” animation. Glyphs can be positioned along input lines by percentage, by time data on the path, or by data values on the path.
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 Object | Renderable | A renderable object displaying the positioned glyphs. |
| 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. |
Properties
| Property | Type | Description |
|---|---|---|
| Allow Run | Boolean | Determines whether the module is allowed to execute. |
| Execute | Button | Accept all values and places glyphs. |
| Map Component | Choice | The Map Component allows the user to select which data to map from the input path to the output glyph. |
| Data Processing | Choice: Nodal Data, Log10(Nodal Data) | The Data Processing control allows the user to specify how to process the Map Component for output and size. |
| Datamap | Double | The Datamap refers to the min and max values that are 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 | The Glyph Position allows the user to determine where the glyphs are placed along the input paths. |
| Number Of Glyphs | Integer | Number of glyphs indicates how many glyphs at most will be present along the line. |
| Circulate | Boolean | The Circulate toggle is used for looping or cycling animations. If a glyph’s position is greater than the line length the glyph will be placed the appropriate distance from the start of the line. |
| Glyph Size | Double | The Glyph Size value is used to scale the glyphs in all directions. The default is automatically computed based on your input data. |
| Priority | Choice: Maximum, Minimum | The Priority of the glyph will reverse the scaling so that the smallest sample values have the largest size. |
| Minimum Scale Factor | Double | The Minimum Scale Factor scales the sample values with the least Priority. |
| Maximum Scale Factor | Double | The Maximum Scale Factor scales the sample values with the greatest Priority. |
| Use Log Data | Boolean | The Use Log Data toggle will force the size of the glyph to be based on the log10 of the selected data. |
| Size For Vector Data | Choice: Use Vector Magnitude, Use Vector Components | The Size for Vector Data allows the user to change the method behavior when sizing by a vector data component. |
| Magnitude For Zero Length | Double | Magnitude for Zero Length is 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 | The Include Center Data toggle will tell the module to include the center point of each glyph as a cell data component. This allows the user 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 Glyph Type choice allows the user to select the source for the created glyph. Both the Generated and Directed Line options are created internally. The Input Glyph option requires the Input Glyph port to be connected. |
| Include Input Glyph Data | Boolean | If the Glyph Type is set to Input Glyph this toggle will allow data that is associated with the input glyph to be passed through to the output. |
| Generated Glyph | Choice: Sphere, Cube, Cone, Cylinder, Polygon, Disk | The Generated Glyph choice allows the user to select 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 | Double | The Heading and Dip values are 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 Position slider gives the percentage along a line to use for glyph positioning. |
| Position Animation | String | The Position Animation controls the movement (or driving) of the glyphs along the line. |
| Step Size | Double | The Step Size value specifies a value for the increment for advancement when stepping or running. |
Date Options
| Property | Type | Description |
|---|---|---|
| Date Component | Choice | The Date Component allows the user to select which data to use when positioning the glyph by time data. |
| Date | Date | The Date used to position the glyphs. |
| Date Loop | String | The Date Loop controls setting the Date by specified increments. |
| Step Time Units | Choice: Seconds, Minutes, Hours, Days, Weeks, Years | The Step Time Units specify the increment for advancement when stepping or running. |
| Step Size | Double | The Step Size value specifies a factor, along with the Step Time Units, for the increment for advancement when stepping or running. |
| Glyph Placement Method | Choice: By Number Of Glyphs, By Offset Time | The Glyph Placement Method allows the user to select where to set additional glyphs along each line. By Number of Glyphs breaks up the time range by the number of glyphs. By Offset Time allows the user to set the difference in time for all glyphs. |
| Offset Time | Double | When the By Offset Time option is selected in the Glyph Placement Method this control allows the user to set the difference in time used to set the position of the remaining glyphs. |
Data Options
| Property | Type | Description |
|---|---|---|
| Data Component | Choice | The Data Component allows the user to select which data from the input path should be used to position the glyphs. |
| Data Value | Double | The Data Value of interest. |
| Data Loop | String | The Data Loop controls setting the Data by specified increments. |
| Step Size | Double | The Step Size value specifies the increment for advancement when stepping or running. |
| Glyph Placement Method | Choice: By Number Of Glyphs, By Offset Value | The Glyph Placement Method allows the user to select where to set additional glyphs along each line. By Number of Glyphs breaks up the data range by the number of glyphs. By Offset Value allows the user to set the difference in value for all glyphs. |
| Offset Value | Double | When the By Offset Value option is selected in the Glyph Placement Method this control allows the user to set the difference in value used to set the position of the remaining glyphs. |