AutoMovie API
    Preparing search index...

    Function physicalHullMass

    • The volume, centroid and principal inertia of the uniform solid convex hull of a point set.

      Each face is fanned into triangles and each triangle joined to the hull's mean vertex, so the solid is a sum of tetrahedra. A tetrahedron's volume and centroid are closed forms, and its second moments are exact under the quadrature that weighs each vertex by a twentieth of the volume and the centroid by four fifths. The summed second moments move to the centroid by the parallel-axis theorem and are diagonalized by physicalPrincipalAxes.

      Parameters

      • points: readonly IAutoMovieVector3[]

        Shape-local points, metres, spanning a volume.

      Returns IAutoMoviePhysicalHullMass.IResult

      The volume in cubic metres, the centroid in the points' frame, and the principal moments per unit mass (square metres, ascending) with the rotation from the principal frame to the points' frame.

      When the points span no volume.