Angle¶

C++ type: Angle (static utility class)

Description¶

A static utility class providing angle conversion functions between degrees, radians, and Doriax's default unit, which is controlled by Engine::useDegrees.

Because the "default" unit changes depending on the engine configuration, these helpers make it easy to write code that works correctly regardless of how the engine is configured.

Methods¶

Method details¶

radToDefault / degToDefault¶

• static float radToDefault(float radians)
• static float degToDefault(float degrees)

Convert a value in radians or degrees to the engine's current default angle unit. If Engine::useDegrees is true, radToDefault() converts radians → degrees and degToDefault() is a no-op.

// Rotate 45° regardless of engine angle setting
float angle = Angle::degToDefault(45.0f);
obj.setRotation(Quaternion(0, angle, 0));

local angle = Angle.degToDefault(45)
obj:setRotation(Quaternion(0, angle, 0))

defaultToRad / defaultToDeg¶

• static float defaultToRad(float angle)
• static float defaultToDeg(float angle)

Convert from the engine's default unit to radians or degrees.

float deg = Angle::defaultToDeg(obj.getRotation().getYaw());

local deg = Angle.defaultToDeg(obj:getRotation():getYaw())

radToDeg / degToRad¶

• static float radToDeg(float radians)
• static float degToRad(float degrees)

Direct conversion between radians and degrees, independent of the engine's useDegrees setting.

float rad = Angle::degToRad(180.0f);  // π

local rad = Angle.degToRad(180)  -- π