AutoMovie API
    Preparing search index...

    Interface IAutoMovieTextureReference

    One renderer-resolved texture and its deterministic sampling intent.

    interface IAutoMovieTextureReference {
        asset: string;
        colorSpace: "linear" | "srgb";
        coordinateSource?: AutoMovieTextureCoordinateSource;
        sampler?: {
            magFilter: "linear" | "nearest";
            minFilter:
                | "linear"
                | "nearest"
                | "nearestMipmapLinear"
                | "linearMipmapLinear";
            wrapS: "clamp"
            | "repeat"
            | "mirror";
            wrapT: "clamp" | "repeat" | "mirror";
        };
        texCoord: number;
        transform?: {
            offset: { x: number; y: number };
            rotationDeg: number;
            scale: { x: number; y: number };
        };
    }
    Index
    asset: string

    Project asset id.

    colorSpace: "linear" | "srgb"

    How stored texels must be decoded before shading.

    What one unit of the addressed UV set means. Omission preserves legacy raw UV sampling without making a new claim about the set's unit or extent.

    Declare "surface-metres" for an atlas-bearing procedural surface, which is what the geometry kernel emits and what most generated members carry; omitting the field there leaves the unit unstated rather than defaulted. Declare "normalized" for a lattice surface, a module prototype, or an imported set whose selected UV layout is known to span [0, 1]. Declare "source-uv" when an imported set keeps its arbitrary authored layout; importing a mesh does not normalize that layout by itself. transform.scale is read against whichever source this names, and the three cannot be told apart from the material record without it.

    sampler?: {
        magFilter: "linear" | "nearest";
        minFilter:
            | "linear"
            | "nearest"
            | "nearestMipmapLinear"
            | "linearMipmapLinear";
        wrapS: "clamp"
        | "repeat"
        | "mirror";
        wrapT: "clamp" | "repeat" | "mirror";
    }

    Optional texture filtering and wrap policy.

    Type Declaration

    • magFilter: "linear" | "nearest"

      Filtering when source texels are enlarged.

    • minFilter: "linear" | "nearest" | "nearestMipmapLinear" | "linearMipmapLinear"

      Filtering when the image occupies fewer pixels than its source.

    • wrapS: "clamp" | "repeat" | "mirror"

      Addressing beyond the horizontal unit interval.

    • wrapT: "clamp" | "repeat" | "mirror"

      Addressing beyond the vertical unit interval.

    texCoord: number

    UV set index. Generated automovie meshes that emit texture coordinates provide set zero and no other.

    The supported mesh representation carries UV0 only; a second coordinate set is not inherently a packed atlas. Packed-atlas authoring and multiple UV sets remain excluded by this contract. Reopening requires an authorable layout rule and a supported artifact/consumer path for that layout, rather than selecting an unavailable channel here.

    The current runtime admits only zero, including imported appearances.

    transform?: {
        offset: { x: number; y: number };
        rotationDeg: number;
        scale: { x: number; y: number };
    }

    Optional UV transform applied around the origin, in texture turns.

    scale is turns of the image per unit of the addressed coordinate source, so it is 1 / tile against "surface-metres" and extent / tile against "normalized". A "source-uv" set has no general physical-scale formula; read its source layout or adoption receipt. Read coordinateSource before authoring it.

    Type Declaration

    • offset: { x: number; y: number }

      Finite image-turn offset applied after rotation and scale.

      • x: number

        Horizontal image-turn translation after scale and rotation.

      • y: number

        Vertical image-turn translation after scale and rotation.

    • rotationDeg: number

      Finite counterclockwise rotation in degrees about the UV origin.

    • scale: { x: number; y: number }

      Finite nonzero image turns per coordinate unit; negative mirrors.

      • x: number

        Horizontal image turns per source U unit; negative mirrors U.

      • y: number

        Vertical image turns per source V unit; negative mirrors V.