AutoMovie API
    Preparing search index...

    Function sectionAutoMovieDrawingSpaces

    • Section every included logical space's convex cells on a cut view's plane.

      Each cell the plane passes through becomes one region with its page polygon on the grid, its area and its finish, sorted by space and cell. A space's finish is the one surface material every element realizing a boundary of that space agrees on, or null when they disagree or name none, because a finish plan that picked one wall's material would read as a specification.

      What cannot be sectioned is counted for the caller's gaps instead of drawn: a space stated as a closed shell (shelled, since only half-space cells are cut), a cell its half-spaces leave unbounded (unbounded), and the ids of included spaces declaring a faceted volume (faceted, sorted), whose regions are drawn but stand for a curved region.

      Parameters

      • props: IAutoMovieSectionDrawingSpaces.IProps

        Borrowed validated design and resolved page frame for sectioning selected logical spaces.

        deriveAutoMovieDrawing calls this only for cutting projections, after validateBuiltEnvironment and autoMovieDrawingFrame. The lower-level sectioner assumes that referenced boundary elements exist, that the design index matches the environment, and that the frame is usable; it does not revalidate or mutate the authored design.

        • design: IAutoMovieDrawingDesignIndex

          Lookup index of the same environment snapshot, used to resolve boundary elements and their environment-owned model parts.

        • environment: IAutoMovieBuiltEnvironment

          Environment admitted by validateBuiltEnvironment; space cells and boundary-material relations are read from this snapshot.

        • frame: IAutoMovieDrawingFrame

          Unrounded orthonormal page basis, with origin and normal defining the world cut plane; page lengths are metres.

        • spaces: ReadonlySet<string> | null

          Included space ids, or null for all. An empty set selects none; unknown ids match nothing and are not diagnosed here.

      Returns IAutoMovieSectionDrawingSpaces.IResult

      The regions and the counts and ids behind the section gaps.