AutoMovie API
    Preparing search index...

    Interface IAutoMovieBuiltConnector

    A navigable relation between logical spaces, and the shape it has.

    The record is the traversal geometry a later analysis reads, not a verdict about that analysis: whether a person can pass, how they would route, and how a building evacuates are separate work. It states where the route runs, which way each station faces, how wide and how clear it is there, how steeply it climbs, what one step is, which further spaces it stops at, and where its car stands, so later work reads exact values instead of re-deriving them from modelled geometry.

    interface IAutoMovieBuiltConnector {
        bidirectional: boolean;
        clearHeight?: number;
        elements: string[];
        from: string;
        id: string;
        kind:
            | "passage"
            | "stair"
            | "ramp"
            | "lift"
            | "escalator"
            | "moving-walk"
            | "ladder"
            | "bridge"
            | "other";
        landings?: IAutoMovieConnectorLanding[];
        operation?: IAutoMovieConnectorOperation;
        orientations?: IAutoMovieQuaternion[];
        route: IAutoMovieVector3[];
        sections?: IAutoMovieConnectorSection[];
        slope?: number;
        steps?: IAutoMovieConnectorSteps;
        to: string;
        width?: number;
    }
    Index
    bidirectional: boolean

    Whether traversal is permitted in both directions.

    It also orders what the run reaches: a one-way run reaches from each stop only the stops after it, and it may not declare a state driven in reverse.

    clearHeight?: number

    Constant vertical clearance in metres; see width for the rule.

    elements: string[]

    Visible elements realizing the connector, such as steps or a lift car; each resolves and is listed once, and the list may not be empty when an operation is stated.

    from: string

    Logical space at the start of the route.

    id: string

    Stable connector identity.

    kind:
        | "passage"
        | "stair"
        | "ramp"
        | "lift"
        | "escalator"
        | "moving-walk"
        | "ladder"
        | "bridge"
        | "other"

    Computational traversal family.

    escalator and moving-walk are named because a powered run has a direction of drive and a running state a stair does not have, and operation is where it states them. A family the set does not cover is other plus the visible elements, never a mislabelled neighbour.

    Further spaces this one run serves between its two endpoints.

    A lift passing five floors is one shaft, not five relations, and a stair with a half-landing stops somewhere its two ends do not name. Adjacency and connector queries answer with these stops, so the floors a run reaches stay in the space graph.

    Absent, the run serves only its two endpoints. Each landing names a resolving space other than either endpoint, appears once, and lies at a route fraction within (0, 1), strictly increasing in IAutoMovieConnectorLanding.at.

    Travelling cars and the named states they stand in, or absent for a run that never moves.

    A stair is the whole of itself at all times; a lift, escalator, moving walk, or turning gate is not. Absent, the connector is static and lowers with no carriage or state.

    orientations?: IAutoMovieQuaternion[]

    Per-station facing, one unit quaternion per route point.

    Absent, the route is a bare position polyline. A spiral stair needs it: its centre route is nearly a vertical line, so consecutive treads differ only by the turn between them. The facing is a full quaternion rather than a heading because a tread is also pitched and a helical ramp is also banked.

    World-space center route, including both endpoints: at least two finite points, consecutive ones more than 1e-9 metres apart.

    Usable section sampled along the route, for a passage that changes shape.

    At least two entries ordered by strictly increasing IAutoMovieConnectorSection.at, the first at 0 and the last at 1, so every point of the route has a section on both sides of it.

    slope?: number

    Slope of the travelled surface in radians, measured from horizontal.

    It is the climb taken against the horizontal length of the route, not of the straight line between its endpoints, so a switchback's slope is the gradient actually walked.

    The route already implies it, so a stated slope is a claim the engine checks: the implied value is atan2(|last.y - first.y|, horizontal route length), the net climb averaged over the whole route rather than its steepest segment, and a stated slope must lie within [0, PI / 2] and agree with it to 1e-6 radians. Absent, nothing is checked.

    The repeated step of a stepped run, or absent for a smooth one. Step count times rise must match the route's net climb, and count times run its horizontal length, each within one millimetre.

    to: string

    Logical space at the end of the route; never the same as from.

    width?: number

    Constant usable width in metres.

    State the constant pair (width and clearHeight, both positive) or the varying sections, never both and never neither, as IAutoMovieSurface refuses a height rule stated twice.