Nodes ▸ Functions ▸ Mesh Filters ▸ Queries

Ray Trace

Casts a ray from each point of a mesh in a chosen direction and returns where each ray hits a surface. The direction can come from a connected array or be typed in the local spherical basis.

Inputs

Port	Accepts	Required	Description
`x`	dataset	required	The mesh (or any dataset, promoted) to filter
`surface`	dataset	required	The surface to ray-trace against

Parameter ports

Added from the Parameters pane (⊕). While connected, each drives its parameter.

Port	Accepts	Mode	Description
`directions` Directions	primitive(array)	opt-in	Explicit Cartesian (x, y, z) ray directions, shape (3,) or (k, 3); overrides direction while connected
`length`	primitive(number)	opt-in drives `length`	Drives the Length parameter while connected

Outputs

dataset(stack)

Parameters

The Parameters pane shows only the parameters relevant to the current settings.

Parameter	Kind	Default	Choices / range	Notes
Direction frame `direction_frame`	choice	`cartesian`	cartesian \| spherical
Direction `direction`	vector	`(1, 0, 0)`
Direction `direction_sph`	vector	`(1, 0, 0)`
Length `length`	float	none	0 to	⇄ port
First Hit `first_hit`	bool	`true`

Used by

No stock template or group uses this node.