AutoMovie API
    Preparing search index...

    Function draftAutoMovieDrawingLines

    • Draft every line one view draws of one validated design, classified by its relation to the cut plane, deduplicated and in canonical order.

      Drawables are the elements with an environment-owned model and the boundaries that carry a face and are realized by no element, each kept only when drawn accepts its kind and space; a boundary is accepted through any space it separates and carries its first space, so a party wall reads the same on both rooms' sheets. An element citing a builder-owned runtime model cannot be drawn and is counted in unresolvedModels for the caller's gap.

      Each drawable is classified by its nearest and deepest corner: wholly on the viewer's side of a cut it is overhead while within view.overhead and omitted beyond it; wholly deeper than view.depth it is hidden; otherwise a cut view drafts its section as cut and the silhouette of what stands beyond the plane as projected. Silhouettes lying in the cut plane are dropped because the cut already draws them. Points are rounded onto the grid, zero-length strokes are dropped, each stroke runs from its smaller point, identical strokes are merged, and the result is sorted by role order, layer, owner and points.

      Parameters

      • props: IAutoMovieDraftDrawingLines.IProps

        Validated design, resolved view frame and selection predicate used to derive linework.

        Drawables are the elements with an environment-owned model and the boundaries that carry a face and are realized by no element, each kept only when drawn accepts its kind and space; a boundary is accepted through any space it separates and carries its first space, so a party wall reads the same on both rooms' sheets. An element citing a builder-owned runtime model cannot be drawn and is counted in unresolvedModels for the caller's gap.

        Each drawable is classified by its nearest and deepest corner: wholly on the viewer's side of a cut it is overhead while within view.overhead and omitted beyond it; wholly deeper than view.depth it is hidden; otherwise a cut view drafts its section as cut and the silhouette of what stands beyond the plane as projected. Silhouettes lying in the cut plane are dropped because the cut already draws them. Points are rounded onto the grid, zero-length strokes are dropped, each stroke runs from its smaller point, identical strokes are merged, and the result is sorted by role order, layer, owner and points.

        The function reads the design synchronously; its index can populate tessellation caches. Keep the environment, view and indexed geometry stable for the call. deriveAutoMovieDrawing validates the environment and resolves the frame before supplying these inputs; the lower-level drafter does not repeat those checks.

        • cut: boolean

          Whether the view projection cuts geometry; must agree with the view's projection as resolved by autoMovieDrawingHasCut.

        • design: IAutoMovieDrawingDesignIndex

          Index of this same environment snapshot, including world matrices and mutable per-derivation tessellation caches.

        • drawn: (kind: string, space: string | null) => boolean

          Synchronous inclusion predicate, called for each element and for boundary spaces until one passes. Null space denotes an unassigned element. Must keep inputs stable; exceptions propagate and the callback is not retained. The caller implements kind/space selection; draftAutoMovieDrawingLines invokes it synchronously for elements and candidate boundary spaces without retaining it.

        • environment: IAutoMovieBuiltEnvironment

          Environment already accepted by validateBuiltEnvironment, borrowed without editing its authored records.

        • frame: IAutoMovieDrawingFrame

          Resolved unrounded world-to-page frame for this view; page coordinates remain metres before sheet scaling.

        • view: IAutoMovieDrawingView

          Matching view with metre-valued depth/overhead bands; null depth has no far band, and null overhead omits wholly viewer-side geometry in a cut view.

      Returns IAutoMovieDraftDrawingLines.IResult

      The sorted lines and the count of undrawable elements.