Documentation
    Preparing search index...

    Interface GltfMaterialRecord

    One glTF material at §59's metallic-roughness tier.

    Factors carry glTF's own defaults (metalness and roughness default to 1, unlike StandardMaterial's constructor defaults) so the record means what the file meant; instantiation passes every value explicitly.

    interface GltfMaterialRecord {
        baseColor: readonly [number, number, number, number];
        baseColorTexture: number | null;
        doubleSided: boolean;
        emissive: readonly [number, number, number];
        emissiveTexture: number | null;
        extras?: JsonValue;
        ignoredTextures: readonly string[];
        metallicRoughnessTexture: number | null;
        metalness: number;
        name: string;
        normalScale: number;
        normalTexture: number | null;
        occlusionStrength: number;
        occlusionTexture: number | null;
        roughness: number;
        transparent: boolean;
    }
    Index
    baseColor baseColorTexture doubleSided emissive emissiveTexture extras? ignoredTextures metallicRoughnessTexture metalness name normalScale normalTexture occlusionStrength occlusionTexture roughness transparent
    baseColor: readonly [number, number, number, number]

    Base colour factor, straight RGBA, finite.

    baseColorTexture: number | null

    Index into GltfAsset.textures, or null for no base map.

    doubleSided: boolean

    Whether the file declared the material double-sided. Recorded only: the WebGL tier draws with face culling disabled, so single-sided intent is a documented divergence, not a switch.

    emissive: readonly [number, number, number]

    Emissive factor, RGB, finite.

    emissiveTexture: number | null

    Emissive map index, or null. Decoded sRGB.

    extras?: JsonValue

    §78 user metadata (extras).

    ignoredTextures: readonly string[]

    Texture slots the file carries but this tier cannot sample for future extensions. All five core metallic-roughness texture slots are decoded; rendering support remains backend-dependent.

    metallicRoughnessTexture: number | null

    Packed metallic-roughness map index, or null. Decoded linear.

    metalness: number

    Metallic factor; glTF's default is 1.

    name: string

    The material's authored name, or "".

    normalScale: number
    normalTexture: number | null

    Linear normal map index.

    occlusionStrength: number
    occlusionTexture: number | null

    Linear ambient occlusion map index.

    roughness: number

    Roughness factor; glTF's default is 1.

    transparent: boolean

    Whether alphaMode was "BLEND".

    Settings
    Member Visibility

    On This Page
    Properties