AutoMovie API
    Preparing search index...

    Function createAutoMovieMeshDeformer

    • Compile compact deformation fields into an operation that deforms a mesh.

      Each field moves points inside its axis-aligned ellipsoid by its displacement plus its stretch times the offset from its centre, weighted by (1 - r^2)^3 of the normalized radius r and zero outside. Every vertex uses the same summed map, and normals are transported by its analytic cofactor (inverse-transpose) matrix, so splitting one skin into material regions cannot open a lighting seam. UVs, triangle identities and skin bindings are kept; physical source correspondence is copied and checked before and after, so a vertex-specific influence cannot separate declared aliases, while a mesh without it keeps welding by current position. Fields are copied at compile time; meshes and influences are only read, and each call returns a new mesh.

      An optional influence supplies, per vertex, a mask weight f in [0, 1] and its gradient in inverse metres. For displacement d the composed map is p + f d with Jacobian I + f (J - I) + outer(d, grad f). Apply an attachment mask here, before the orientation checks, rather than scaling the returned displacement afterwards and invalidating the checked geometry. The caller owns the samples' provenance and their behaviour between vertices.

      Compilation throws on a non-finite field vector or a nonpositive radius. A call throws on a malformed index buffer, a non-finite position or normal, a normal buffer not aligned to the positions, a wrong influence count or an influence outside its domain, a Jacobian that reverses orientation at a vertex, a non-finite result, and, through assertAutoMovieDeformedTriangles, an emitted triangle that collapses or disagrees with its source orientation transported by its three vertex Jacobians. That is a tessellation check, not a global self-intersection test or a proof of the field between vertices.

      Parameters

      Returns (
          mesh: IAutoMovieMesh,
          influence?: readonly IAutoMovieMeshDeformationInfluence[],
      ) => IAutoMovieMesh

      The deformation operation.