Interface CoordinateSystemParams

Describes the coordinate system, origin, and unit system in which a 3D model was authored. This provides the spatial context necessary to correctly interpret and transform model geometry into a common viewer space.

interface CoordinateSystemParams {
    basis: Vec9Float;
    origin: Vec3;
    scaleToMeters?: number;
    units: "meters" | "millimeters" | "inches" | "feet";
}

Properties

basis: Vec9Float

The basis vectors defining the local coordinate system, stored as a flat 9-element array in column-major format: [ x0, x1, x2, y0, y1, y2, z0, z1, z2 ] Each axis should be a normalized vector.

origin: Vec3

The origin of the coordinate system in global space.

scaleToMeters?: number

Optional: a multiplier to convert units into meters. If not specified, a default will be assumed based on the units field. Example: 0.3048 for feet, 0.001 for millimeters.

units: "meters" | "millimeters" | "inches" | "feet"

The unit of measurement used in coordinates. This is required to interpret distances and scales correctly.