drive glyphs

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

DirectionNameTypeDescription
InputInput PathFieldThe input field containing the lines to drive the glyphs along.
InputInput GlyphFieldThe input field containing the glyph to drive along the input paths.
InputInput DateDateDate used for determining glyph position along line.
InputInput PositionNumberThe value used for positioning the glyph by percentage.
InputInput DataNumberThe value used for positioning the glyph by data on path.
OutputOutput DateDateDate used for determining glyph position along line.
OutputOutput FieldFieldThe main output field with glyph in the selected position.
OutputOutput PointsFieldThe points used to generate the glyphs in the selected positions.
OutputOutput PositionNumberThe value used for positioning the glyph by percentage.
OutputOutput DataNumberThe value used for positioning the glyph by data on path.
OutputOutput ObjectRenderableA renderable object displaying the positioned glyphs.

Properties

PropertyTypeDescription
Allow RunBooleanDetermines whether the module is allowed to execute.
ExecuteButtonAccepts all values and places the glyphs.
Map ComponentChoiceSelects which nodal data component of the input path to map to the output glyphs.
Data ProcessingChoice: Nodal Data, Log10(Nodal Data)Specifies how to process the Map Component for output and sizing.
DatamapRange (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 PositionChoice: % Along each line, % Along longest line, Sequential Walk, By Time data on path, By Data on pathDetermines how the glyphs are placed along the input paths.
Number Of GlyphsIntegerThe maximum number of glyphs present along each line.
CirculateBooleanUsed 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 SizeDoubleScales the glyphs in all directions. The default is automatically computed based on your input data.
PriorityChoice: Maximum, MinimumMinimum reverses the scaling so that the smallest sample values have the largest size.
Minimum Scale FactorDoubleScales the sample values with the least priority.
Maximum Scale FactorDoubleScales the sample values with the greatest priority.
Use Log DataBooleanBases the size of the glyph on the log10 of the selected data.
Size For Vector DataChoice: Use Vector Magnitude, Use Vector ComponentsSelects how glyphs are sized when sizing by a vector data component.
Magnitude For Zero LengthDoubleThe 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 DataBooleanIncludes 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

PropertyTypeDescription
Glyph TypeChoice: Generated, Input Glyph, Directed LineThe 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 DataBooleanWhen Glyph Type is Input Glyph, passes data associated with the input glyph through to the output.
Generated GlyphChoice: Sphere, Cube, Cone, Cylinder, Polygon, DiskThe type of glyph that is automatically generated.
Sphere SubdivisionsIntegerThe number of subdivisions to use for spheres. Larger numbers create more detailed sphere representations.
Glyph ResolutionIntegerThe resolution for generated cone, polygon, cylinder, and disk glyphs.
Primary Axis FactorDoubleThe scale factor for the primary axis of the glyph.
Secondary Axis FactorDoubleThe scale factor for the secondary axis of the glyph.
Heading DipHeading/DipThe heading and dip values used to align the glyphs to a constant orientation.
RollDoubleThe roll of the glyph along its primary axis.

Percentage Options

PropertyTypeDescription
PositionDoubleThe percentage along a line used for glyph positioning.
Position AnimationLoop controlControls the movement (or driving) of the glyphs along the line.
Step SizeDoubleThe increment for advancement when stepping or running.

Date Options

PropertyTypeDescription
Date ComponentChoiceSelects which nodal data component of the input path holds the time data used to position the glyphs.
DateDateThe date used to position the glyphs.
Date LoopLoop controlSteps the Date by the specified increments.
Step Time UnitsChoice: Seconds, Minutes, Hours, Days, Weeks, YearsThe time units of the increment for advancement when stepping or running.
Step SizeDoubleA factor which, along with the Step Time Units, sets the increment for advancement when stepping or running.
Glyph Placement MethodChoice: By Number Of Glyphs, By Offset TimeSelects 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 TimeDoubleWhen Glyph Placement Method is By Offset Time, the difference in time used to position the remaining glyphs.

Data Options

PropertyTypeDescription
Data ComponentChoiceSelects which nodal data component of the input path is used to position the glyphs.
Data ValueDoubleThe data value of interest, used to position the glyphs.
Data LoopLoop controlSteps the Data Value by the specified increments.
Step SizeDoubleThe increment for advancement when stepping or running.
Glyph Placement MethodChoice: By Number Of Glyphs, By Offset ValueSelects 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 ValueDoubleWhen Glyph Placement Method is By Offset Value, the difference in value used to position the remaining glyphs.