AutoMovie API
    Preparing search index...

    Variable locateAutoMovieSurfaceCoordinateConst

    locateAutoMovieSurfaceCoordinate: (
        props: IAutoMovieLocateSurfaceCoordinate.IProps,
    ) => IAutoMovieSubdivisionParameter = ...

    Find the cage face and local coordinates of a surface coordinate on one sampled tier.

    A patch's grid is even in (s, t), so the face holding a coordinate is column floor(s * columns) and row floor(t * rows), the last column or row taking s or t equal to 1, and the local coordinates are the fractional parts. On a patch whose faces are no grid, a transition band, the face is the first whose bilinear map of its corner coordinates reaches the coordinate, inverted by Newton's method, and the local coordinates are that map's parameters. They follow IAutoMovieSubdivisionParameter's quad convention: (0, 0) at corner 0, u toward corner 1 along s, v toward corner 3 along t, so the result addresses subdivideAutoMovieSurface's output of this cage directly.

    Type Declaration

      • (
            props: IAutoMovieLocateSurfaceCoordinate.IProps,
        ): IAutoMovieSubdivisionParameter
      • Parameters

        • props: IAutoMovieLocateSurfaceCoordinate.IProps

          Find the cage face and local coordinates of a surface coordinate on one sampled tier.

          A patch's grid is even in (s, t), so the face holding a coordinate is column floor(s * columns) and row floor(t * rows), the last column or row taking s or t equal to 1, and the local coordinates are the fractional parts. On a patch whose faces are no grid, a transition band, the face is the first whose bilinear map of its corner coordinates reaches the coordinate, inverted by Newton's method, and the local coordinates are that map's parameters. They follow IAutoMovieSubdivisionParameter's quad convention: (0, 0) at corner 0, u toward corner 1 along s, v toward corner 3 along t, so the result addresses subdivideAutoMovieSurface's output of this cage directly.

          • cage: IAutoMovieSurfaceCage

            Borrowed sampled tier whose patch grids and face-corner charts define the lookup. Cage geometry is not projected or read; callers must preserve the chart topology.

          • coordinate: IAutoMovieSurfaceCoordinate

            Patch index plus dimensionless s/t in [0,1]. The locator rejects a missing patch or out-of-range coordinates; a non-grid patch throws if no face accepts the inverted bilinear coordinates.

        Returns IAutoMovieSubdivisionParameter

        The face's parameter, with corner null because every face is a quad.

    Error when the patch index is out of range or s or t lies outside 0 to 1, or a coordinate of a non-grid patch lies on none of its faces.