Random Quaternion

Overview

• Node Name: Random Quaternion
• Category: repeat_instant
• File: extensions/flowgraph/nodes/util/randomQuaternion.lua

Generates a random quaternion rotation by interpolating between min/max Euler angles on each axis. Outputs a new random rotation every frame.

Pin Schema

Input Pins

Output Pins

Internals

Key Methods

Quaternion Construction

1. For each axis, lerp interpolates between min and max radian values using math.random().
2. Builds the quaternion by sequential multiplication: quatFromEuler(x,0,0) * quatFromEuler(0,y,0) * quatFromEuler(0,0,z).
3. Outputs the result as a table via q:toTable().

How It Works

1. Each frame, random angles are picked within the min/max range for X, Y, and Z.
2. Angles are converted from degrees to radians using math.rad().
3. Three axis-aligned quaternions are multiplied together to form the final rotation.
4. Default setup (only Z: 0–360°) produces random yaw rotations with no pitch or roll.

Usage Example

-- Random yaw only (default):
-- zMinAngle = 0, zMaxAngle = 360
-- All other angles = 0
-- Output: random rotation around Z axis

-- Full random orientation:
-- xMinAngle = 0, xMaxAngle = 360
-- yMinAngle = 0, yMaxAngle = 360
-- zMinAngle = 0, zMaxAngle = 360

-- Limited tilt (±15° pitch, random yaw):
-- xMinAngle = -15, xMaxAngle = 15
-- yMinAngle = 0, yMaxAngle = 0
-- zMinAngle = 0, zMaxAngle = 360

Key Dependencies

• quatFromEuler() - creates a quaternion from Euler angles
• lerp() - linear interpolation helper

See Also

• Route Distance (Flowgraph Node) - Related reference
• Closest Road (Flowgraph Node) - Related reference
• Custom Lua (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide