Post

IntegerSequencer

Overview

IntegerSequencer generates periodic discrete integer values. Authors can ROUTE value_changed output events to other SFInt32 attributes (for example, useful when animating whichChoice in a Switch node).

The IntegerSequencer node belongs to the EventUtilities component and requires at least level 1, its default container field is children. It is available from X3D version 3.0 or higher.

Hierarchy

1
2
3
4
+ X3DNode
  + X3DChildNode
    + X3DSequencerNode
      + IntegerSequencer

Fields

SFNode [in, out] metadata NULL [X3DMetadataObject]

Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.

Hint

SFFloat [in] set_fraction (-∞,∞)

set_fraction selects input key for corresponding keyValue output.

Hint

  • set_fraction values are typically in same range interval as values in the key array. Response to an input set_fraction value less than minimum is equivalent to minimum key, and response to an input set_fraction value greater than maximum is equivalent to maximum key.

Warning

  • It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.

SFBool [in] previous

Send previous output value in keyValue array, and reset internal fraction field to match corresponding value in key array.

Hint

  • This input event will “wrap around” boundary of keyValue array, i.e. continue from first to last if necessary.

Warning

  • It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.

SFBool [in] next

Send next output value in keyValue array, and reset internal fraction field to match corresponding value in key array.

Hint

  • This input event will “wrap around” boundary of keyValue array, i.e. continue from last to first if necessary.

Warning

  • It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.

MFFloat [in, out] key [ ] (-∞,∞)

Definition values for linear-interpolation function input intervals, listed in non-decreasing order and corresponding to a value in the keyValue array.

Hint

  • Typical interval for values in key array is within range of 0 to 1, but larger intervals can be defined with arbitrary bounds.

Warnings

  • Number of keys must match number of keyValues!
  • Values in key array shall be monotonically non-decreasing, meaning that each value is greater than or equal to the preceding value.

MFInt32 [in, out] keyValue [ ] (-∞,∞)

Output values for linear sequencing, each corresponding to an input-fraction value in the key array.

Warning

  • Number of keys must match number of keyValues!

SFInt32 [out] value_changed

Single intermittent output value determined by current key time and corresponding keyValue entry.

Warning

  • It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.

Advice

Hints

Example

View Source in Playground

See Also

This post is licensed under CC BY 4.0 by the author.