AutoMovie API
    Preparing search index...

    Interface IAutoMovieLoftChain

    Principal layers and explicit source owners of one lofted chain.

    View lofts, fitted sections and continuation operators publish this record for AutoMovieLoftChain and AutoMovieLoftJet. A published chain and its nested arrays/source records must remain unchanged while readers retain it: point and jet caches key preparations by chain identity and physical station. Copies with equal numeric data retain source bindings; changing values requires the owning operator to re-express or remove those bindings. The interface does not freeze or validate storage; construction operators own admission, and readers reject stale explicit owners when reached.

    interface IAutoMovieLoftChain {
        basis?: "spline";
        layers: IAutoMovieLoftChain.ILayer[];
        mirrored?: boolean;
        name: string;
        nativeSource?: IAutoMovieLoftSectionSource.ISource;
        opposite?: {
            end: "bottom" | "top";
            point: [number, number, number];
            source?: IAutoMovieLoftCapSource.ISource;
        };
        order: number;
        orientation?: 1
        | -1;
        phases?: number[];
        pole?: {
            end: "bottom" | "top";
            point: [number, number, number];
            source?: IAutoMovieLoftCapSource.ISource;
        };
        reliefs?: IAutoMovieLoftRelief[];
        rule: IAutoMovieLoftParameter.Rule;
        samples: number;
        sectionSpans?: IAutoMovieLoftSectionConnect.ISpan[];
    }
    Index
    basis?: "spline"

    Section basis. spline: uniform periodic cubic B-spline, see AutoMovieSplineCurve; absent: truncated Fourier series, see AutoMovieHarmonicCurve.

    At least two principal layers in strictly increasing physical station, mm. This is world height only for horizontal unframed sections; construction owns minimum-gap admission.

    mirrored?: boolean

    Whether the chain bounds a hole, such as the pocket under an ear's helix.

    A hole's sections run clockwise (front toward -Z), so its own rings face into the hole, which is outward from the body there. Phases of a hole's sections, in the fitter and for vertices it inherits, are taken from the outline mirrored as (x, z) -> (x, -z), which makes them increase along the clockwise ring order the zipper expects. Absent means an ordinary tube.

    name: string

    Stable chain name used for part ids and diagnostics.

    Original plain scalar field and independent compatibility-row bindings. Present data owns points/phase/jets; stale or broken data throws. Absence retains the legacy basis. Finite values do not imply physical source2 availability.

    opposite?: {
        end: "bottom" | "top";
        point: [number, number, number];
        source?: IAutoMovieLoftCapSource.ISource;
    }

    The pole of the other end of a chain closed at both (a foot from heel to forefoot cap), as pole; the solid tessellation (AutoMovieHumanBodySurfaceSolids) closes both ends, the ring loft only pole's. Absent for a chain open at its other end.

    Type Declaration

    • end: "bottom" | "top"

      The chain's end the pole closes, the other than pole's.

    • point: [number, number, number]

      The collapsed pole [x,y,z] in world millimetres, in the same frame as the chain's placed sections.

    • Optionalsource?: IAutoMovieLoftCapSource.ISource

      Same explicit original-cap ownership as pole.source; removing this end removes its extra domain.

    order: number

    Size of every section's basis: the highest harmonic K, or the number of control points N of a spline chain.

    orientation?: 1 | -1

    Explicit outward sign of S_station x S_phase, when the producer knows the oriented boundary it continues (a join's blend). Absent, a tube's radial direction and mirrored flag decide it. This sign takes precedence over mirrored. Reversing one chart coordinate or reflecting world space reverses it; orientation-preserving rigid motion and translation keep it. The producer still owns regularity of the connected surface: a sign is not a certificate that its chart has no degenerate or folded point.

    phases?: number[]

    The phases of the chain's own rings, radians, strictly increasing within one turn from the first, samples of them, when they are not uniform: a section that turns fast over a few phases, as a sole's edge does, takes its rings' vertices closer there. Absent, the samples uniform phases 2 pi k / samples.

    pole?: {
        end: "bottom" | "top";
        point: [number, number, number];
        source?: IAutoMovieLoftCapSource.ISource;
    }

    Pole of a cap: the point every section shrinks to at the chain's end station on the cap's side (the angle 0 from the pole axis), where the skin closes by a fan from the ring next to it. Absent for a chain without a cap.

    Type Declaration

    • end: "bottom" | "top"

      The chain's end the pole closes.

    • point: [number, number, number]

      The collapsed pole [x,y,z] in world millimetres, in the same frame as the chain's placed sections.

    • Optionalsource?: IAutoMovieLoftCapSource.ISource

      Actual original cap owner, retained only while this end and its adjacent boundary survive unchanged. Values and positive-section physical2 have separate admission; JSON cannot restore its callable axis.

    Features written as heights over this chain's surface (the nose and lips over the face, the breasts over the thorax); see IAutoMovieLoftRelief. Absent means none.

    Phase correspondence rule; see AutoMovieLoftParameter.

    samples: number

    Number of vertices in the chain's own rings, a positive integer chosen by the producer. Without phases the vertices use uniform correspondence angles; with phases this is the required list length. It is separate from the section basis order and does not itself certify a geometric spacing tolerance.

    Complete generating laws on spans changed by continuation; other spans keep their original source. Immutable copies preserve these laws and coefficient rewrites must re-express their bindings.