AutoMovie API
    Preparing search index...

    Interface IAutoMovieMaterialOverlay

    An ordered colour and optional relief layer over a material, with independently authored image sampling.

    Colour alpha times strength controls colour, optional roughness and replacement-normal coverage. Multiply normals instead add strength-scaled XY to the existing tangent normal and multiply their Z components before normalization; this branch ignores colour alpha and can change an existing normal even at zero strength. glTF has no counterpart. These shader formulas do not prove a physical response or observed appearance.

    interface IAutoMovieMaterialOverlay {
        baseColorTexture: AutoMovieTextureBinding;
        blend: "multiply" | "replace";
        colorFactor?: { b: number; g: number; r: number };
        normalScale?: number;
        normalTexture?: AutoMovieTextureBinding | null;
        roughness?: number;
        strength: number;
    }
    Index
    baseColorTexture: AutoMovieTextureBinding

    The layer's sRGB colour with alpha controlling colour, roughness and replacement-normal coverage; alpha zero does not suppress multiply normals. Filtering blends colour and coverage separately, so edge padding should carry the replacement colour or white tint as appropriate.

    blend: "multiply" | "replace"

    How the layer's colour meets the material's where it covers: multiply tints the base colour by it, replace substitutes it.

    colorFactor?: { b: number; g: number; r: number }

    Linear RGB factors on the colour image's colour, each finite and nonnegative, so one image serves surfaces of different colouring; omitted, one.

    Type Declaration

    • b: number

      Unitless nonnegative factor on the decoded linear blue channel.

    • g: number

      Unitless nonnegative factor on the decoded linear green channel.

    • r: number

      Unitless nonnegative factor on the decoded linear red channel.

    normalScale?: number

    Strength of normalTexture's slopes, a nonnegative finite factor; omitted, one.

    normalTexture?: AutoMovieTextureBinding | null

    Optional tangent-space normal map. Multiply blends scale XY by normalScale * strength, add existing XY and multiply sampled Z, ignoring colour alpha. Replace blends scale XY by normalScale and interpolate normalized directions by coverage. Without an existing normal map, the viewer supplies a conventional flat map as the tangent-frame prerequisite.

    roughness?: number

    Roughness where the layer covers, [0, 1]; omitted, the material's.

    strength: number

    Finite factor in [0, 1] scaling colour/roughness/replacement-normal coverage and multiply-normal XY. At zero, multiply-normal Z can still change an existing tilted normal; this is not a universal disable switch.