Chapter 457: RangeNode

Core Idea

RangeNode generates random instanced attribute data in a defined range. An exemplary use case for this utility node is to generate random per-instance colors:

Key Concepts

maxNode : Node.<any>: A node defining the upper bound of the range.
minNode : Node.<any>: A node defining the lower bound of the range.

Code Examples

const material = new MeshBasicNodeMaterial();
material.colorNode = range( new Color( 0x000000 ), new Color( 0xFFFFFF ) );
const mesh = new InstancedMesh( geometry, material, count );

What it demonstrates: Typical usage of RangeNode.

Reference Tables

Constructor

Signature
`new RangeNode( minNode : Node.<any>, maxNode : Node.<any> )`

Properties

Property	Description
`.maxNode : Node.<any>`	A node defining the upper bound of the range.
`.minNode : Node.<any>`	A node defining the lower bound of the range.

Methods

Method	Description
`.generateNodeType( builder : NodeBuilder ) : string`	This method is overwritten since the node type is inferred from range definition.
`.getConstNode( node : Node ) : Node`	Returns a constant node from the given node by traversing it.
`.getVectorLength( builder : NodeBuilder ) : number`	Returns the vector length which is computed based on the range definition.

Key Takeaways

RangeNode extends: EventDispatcher → Node
Most relevant properties: maxNode, minNode.
Key methods: generateNodeType, getConstNode, getVectorLength.

Connects To

EventDispatcher: parent class
Node: parent class
Source: src/nodes/geometry/RangeNode.js