AutoMovie API
    Preparing search index...

    Variable locateAutoMovieSurfaceVerticesConst

    locateAutoMovieSurfaceVertices: (
        props: IAutoMovieLocateSurfaceVertices.IProps,
    ) => IAutoMovieSurfaceLocation[] = ...

    Locate every vertex of a subdivided surface network in the network's own terms, so a field declared over the network, such as a displacement, can be evaluated at each vertex.

    A vertex's cage face and quad-local coordinates give its surface coordinate, the bilinear blend of the face's corner coordinates, the same chart mapAutoMovieSurfaceTier uses, so the coordinate is exact on a grid patch and continuous across faces inside that patch. Different patch charts can assign different addresses to a shared edge; compatible fields must agree there. Each vertex keeps its supplied incident-face address. A sweep or transition patch also gives the sweep's domain point, u and v carried from t and s by the patch's ranges. The locations depend only on the network's layout and the tier, never on a pose, so they are computed once per tier and level and serve every pose.

    Type Declaration

      • (props: IAutoMovieLocateSurfaceVertices.IProps): IAutoMovieSurfaceLocation[]
      • Parameters

        • props: IAutoMovieLocateSurfaceVertices.IProps

          Locate every vertex of a subdivided surface network in the network's own terms, so a field declared over the network, such as a displacement, can be evaluated at each vertex.

          A vertex's cage face and quad-local coordinates give its surface coordinate, the bilinear blend of the face's corner coordinates, the same chart mapAutoMovieSurfaceTier uses, so the coordinate is exact on a grid patch and continuous across faces inside that patch. Different patch charts can assign different addresses to a shared edge; compatible fields must agree there. Each vertex keeps its supplied incident-face address. A sweep or transition patch also gives the sweep's domain point, u and v carried from t and s by the patch's ranges. The locations depend only on the network's layout and the tier, never on a pose, so they are computed once per tier and level and serve every pose.

          • cage: IAutoMovieSurfaceCage

            Borrowed cage containing a patch chart at every quad corner. Its spatial positions play no role in the lookup.

          • network: IAutoMovieSurfaceNetwork

            Source network providing patch names and sweep-domain ranges. Patch count and ordered names must match cage; the locator checks these, not full network identity.

          • parameters: readonly IAutoMovieSubdivisionParameter[]

            One incident cage-face address per requested vertex, in output order. The locator requires an existing face, corner=null and u/v in [0,1]; an empty array produces no locations.

        Returns IAutoMovieSurfaceLocation[]

        One location per vertex, in vertex order.

    Error when the network's patches are not the cage's, a parameter's face is out of range or not a quad, or its coordinates leave 0 to 1.