Node: Proximity

From Waltz
Jump to navigation Jump to search

The Proximity node allows you to place a circle/sphere in 2D/3D space, and determine if objects are within that circle/sphere, as well as how close to the center the objects are, and see a list of objects that are within the sphere.


Expected Type Details Default
input Point, Touch, or List<Point or Touch> The value, or list of values, that will be checked for proximity to the point.
point Point A Point representing the center of the area of interest for the measurement of proximity. Point(256, 128)
range Number The distance from the provided point from which an object from the input should be considered in range. 48


Type Details
itemsInRange List<Any> Note: The parameter is read-only. The values from input that are within the given range of point.
triggeredAmount Number A value between 0.0 and 1.0 that represents how close the closest item from input is to the point, scaled within the given range. If the given range is 32 and the closest value to point is 16 away, this value will be 0.5. If no value is in range, this value will be 0.0. If an object is exactly on the point, this value will be 1.0.
triggered Boolean true if a value from input is within range of point, otherwise false.


This node provides no additional functions.

Example Usage

No examples provided.

Devices ArtNet Input · ArtNet Output · Interactive LED Processor · NDI™ Input · NDI™ Output · OSC Input · OSC Output · Projector · SensorLink · TCP · TUIO Output · UDP Input · UDP Output · Watchout Media Server
Objects LED Tile Layout · List · Map · Random Number · Simulated Touch · Timer · Value · Wave
Operators Blend · Change · Clip · Cluster Tracker · DMX Multiverse Merge · Ease · Filter · Hold · JSON Mapper · JSON Stringify · Logic · Math · Proximity · Range · Rotate · Scale · Shear · Smooth · Touch Mapper · Translate
Scenes External Scene · Material Scene
Materials Graph · Touch Material
Scripting Script Function · Script
Comments Comment