AutoMovie API
    Preparing search index...

    Variable compileAutoMovieSweepConst

    compileAutoMovieSweep: (sweep: IAutoMovieSweep) => IAutoMovieSweepSurface = ...

    Compile a sweep into an evaluable surface.

    Under direction correspondence, the default, each station's section is sampled at 512 directions by sampleAutoMovieSweepSection. For each direction the radii of the stations form a profile along u, interpolated by interpolateAutoMovieSpline, a C2 spline under tension, so curvature is continuous at interior stations, with its sampled overshoot policy; queried non-positive radii are refused. Before the first or after the last station it holds that station's radius.

    Under parameter correspondence each loop of each station, the section and then its holes, is sampled at the same parameters of parameterizeAutoMovieSweepSection: a polygon at its corners, any other curve at 512 even parameters. Each sample's two coordinates are interpolated along u by the same spline and joined linearly round the loop, so corner k of every station meets corner k of the next, as a loft between corresponding polygons blends them. Guides and features read radii by direction and are refused here; the scale profile applies to every loop.

    Guides make the radius field a Gordon surface (Gordon 1969, "Spline-blended surface interpolation through curve networks", J. Math. Mech. 18(10)): the Boolean sum P + G - T of the profile interpolant P (the stations, along u), the guide interpolant G (the guides, round the turn) and their tensor interpolant T (the profile interpolant read at the guide directions, round the turn). Both directions use the spline, round the turn its periodic form over the guide directions. At a guide's direction G - T is the guide's radius less the profile's, so the surface passes through every guide at every u on the sampled angular grid; non-grid guide directions are reconstructed linearly from that grid. Where a guide disagrees with a station at the station's u, the network is incompatible and the guide wins, so the station's section is moved by the guides' disagreement interpolated round the turn; a single guide moves the whole section by its one difference. Rows are cached by u.

    Features next: each feature curve is the smooth curve through its points that compileAutoMovieSweepFeature builds, and at a query point the radius moves by the feature's residual at the course point found by its dense-seeded local search in the cylindrical metric approximation, the declared radius less the guided radius there or the declared offset, times (1 - (d / width)^2)^3 within width. The surface therefore follows each feature curve to the search's accuracy where no other feature's band overlaps it, and the band has no crease along it.

    A scale profile, where the sweep gives one, multiplies the result last, features included, so it resizes the section as shaped; profile reads the radius before it and scale the profile's factor. Posing relies on this order: it changes only the scale, so the shape before it is pose-invariant.

    The section plane at u is the spine's rotation-minimizing frame, or under the fixed orientation the start frame's axes at the spine point (a translational sweep), turned by the stations' rotations: each station's rotation relative to that frame at its at is interpolated by normalized linear quaternion interpolation between stations, as sweep-based deformation interpolates key-ellipse orientations (Hyun et al. 2005, The Visual Computer 21(8-10):542-550), and held beyond the end stations; loadAutoMovieSweepSpine and orientAutoMovieSweep compute both.

    Type Declaration

    Error when the spine is refused by frameAutoMovieSweepSpine, a section by sampleAutoMovieSweepSection, a station, guide or feature is out of range, unordered or not finite, or two guides share a direction; and, when a row is first evaluated, when a profile, guide, feature or scale query is non-positive or not finite.