Notch Notch Manual 0.9.23
 Light | Dark
Mouse Point Array

Mouse Point Array

Generate an Array using the mouse cursor as a source.

Method #

This node takes the position and state of the mouse cursor and converts it into an array. When the left mouse button is pressed a new point is created at the cursor location; that point will be moved to follow the cursor until the button is released. As such, if easing is used, it is possible to have multiple points visible at once.

The cursor’s viewport position is mapped to the node’s bounding rectangle, as defined by the Bounds properties, in 3D space: if the cursor is in the top left of the viewport it will map to the top left of the bounding rectangle, and so on. If the goal is to have points appear in screen space exactly where the mouse cursor is located, the node’s bounding rectangle should be mapped to fill the screen for the appropriate camera view.

Transform manipulators are disabled for this node as they conflict with using the mouse in the viewport to generate points.

Whilst in Builder, the Mouse Point Array node must be selected in the nodegraph for mouse points to be recognised.
This node will not function in a media server, as the media server captures all mouse inputs.

See the Array Sources node to see how this node is used in the nodegraph to multi-instance child nodes.

The output transform array may be used directly with a Clone To Transform Array, or to clone other nodes within a Field System or Particle System.

Parameters

These properties control the 3D transforms of the node. Transforms will generally be inherited by child nodes, although they can be ignored through the Inherit Transform Channels attributes.

ParameterDetails
Position XMove along the local x-axis.
Position YMove along the local y-axis.
Position ZMove along the local z-axis.
Rotation HeadingRotate around the local y-axis.
Rotation PitchRotate around the local x-axis.
Rotation BankRotate around the local z-axis.
Scale XScale along the local x-axis.
Scale YScale along the local y-axis.
Scale ZScale along the local z-axis.

Toggle which transform channels should be inherited from the parent node. By default, all transforms will be inherited.

ParameterDetails
Position XToggle inheritance of the X Position from the parent.
Position YToggle inheritance of the Y Position from the parent.
Position ZToggle inheritance of the Z Position from the parent.
Rotation HeadingToggle inheritance of the Rotation Heading from the parent.
Rotation PitchToggle inheritance of the Rotation Pitch from the parent.
Rotation BankToggle inheritance of the Rotation Bank from the parent.
Scale XToggle inheritance of the X Scale from the parent.
Scale YToggle inheritance of the Y Scale from the parent.
Scale ZToggle inheritance of the Z Scale from the parent.
World Position OnlyInherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties.
Inherit TimeToggle inheritance of time from the parent.

These properties control the core behaviours of the node.

ParameterDetails
AxisSelect which axis the touch array should appear along
Flip X AxisFlip the X axis of the incoming Windows Touch data.
Flip Y AxisFlip the Y axis of the incoming Windows Touch data.
Apply Node Transforms To Array Elements OnlyWhen Enabled, transform changes applied to this nodes transform properties will also be applied to the array elements, and carried onto any nodes this data is used.

These properties control how an element is eased into an array.

ParameterDetails
Ease Points OnEnable Point Easing in, so new points don’t immediately appear.
Ease Points On Mode

Edit the easing curve for how the new points will appear.

  • Linear,
  • Pow2,
  • Pow4,
Ease Points On DurationHow long the points should take to fully appear.
Ease Points OffEnable Point Easing out, so removed points don’t immediately disappear.
Ease Points Off Mode

Edit the easing curve for how the removed points will disappear.

  • Linear,
  • Pow2,
  • Pow4,
Ease Points Off DurationHow long the points should take to fully disappear.
Easing Points Affects Point ScalesAllow the points to scale in size while easing.
Easing Points Affects Point OpacitiesAllow the points to fade the opacity of objects while easing.

Set the bounding dimensions of the incoming data, and the area within which points will be generated.

Inputs

NameDescriptionTypical Input
2D Bounds SourceSets the 2D area the point will appear within.Region Camera
Transform ModifiersApply the transforms of another node to this node.Null
Target NodeModifiy the rotations of the node to always direct the z axis towards the input.Null
Local Transform OverrideApply the transforms of another node to this node, relative to its parent.Null