@automovie/engine 0.0.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
- package/lib/analysis/index.d.ts +5 -0
- package/lib/analysis/index.js +5 -0
- package/lib/analysis/index.js.map +1 -1
- package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
- package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
- package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
- package/lib/anthropometry/index.d.ts +1 -0
- package/lib/anthropometry/index.js +18 -0
- package/lib/anthropometry/index.js.map +1 -0
- package/lib/architecture/appendBuiltRegionDefects.d.ts +1 -1
- package/lib/architecture/appendBuiltRegionDefects.js +3 -3
- package/lib/architecture/appendBuiltRegionDefects.js.map +1 -1
- package/lib/architecture/builtOutlineIsClosed.d.ts +1 -1
- package/lib/architecture/builtOutlineIsClosed.js +3 -3
- package/lib/architecture/builtOutlineIsClosed.js.map +1 -1
- package/{src/architecture/constants/PLANAR_EPSILON.ts → lib/architecture/constants/BUILT_PLANAR_EPSILON.d.ts} +1 -1
- package/lib/architecture/constants/{PLANAR_EPSILON.js → BUILT_PLANAR_EPSILON.js} +3 -3
- package/lib/architecture/constants/BUILT_PLANAR_EPSILON.js.map +1 -0
- package/lib/architecture/constants/index.d.ts +1 -1
- package/lib/architecture/constants/index.js +1 -1
- package/lib/architecture/constants/index.js.map +1 -1
- package/lib/architecture/index.d.ts +157 -117
- package/lib/architecture/index.js +171 -158
- package/lib/architecture/index.js.map +1 -1
- package/lib/cache/index.d.ts +9 -0
- package/lib/cache/index.js +26 -0
- package/lib/cache/index.js.map +1 -0
- package/lib/composition/AutoMovieComposition.d.ts +25 -6
- package/lib/composition/AutoMovieComposition.js +4 -3
- package/lib/composition/AutoMovieComposition.js.map +1 -1
- package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
- package/lib/composition/AutoMovieScheduleCut.js +99 -0
- package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
- package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
- package/lib/composition/AutoMovieScheduleError.js +51 -0
- package/lib/composition/AutoMovieScheduleError.js.map +1 -0
- package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
- package/lib/composition/AutoMovieSchedulePlace.js +185 -0
- package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
- package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
- package/lib/composition/AutoMovieScheduleWalk.js +161 -0
- package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
- package/lib/composition/IAutoMovieIntent.d.ts +9 -6
- package/lib/composition/index.d.ts +12 -7
- package/lib/composition/index.js +12 -2
- package/lib/composition/index.js.map +1 -1
- package/lib/composition/markAutoMovieContacts.d.ts +29 -0
- package/lib/composition/markAutoMovieContacts.js +69 -0
- package/lib/composition/markAutoMovieContacts.js.map +1 -0
- package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
- package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
- package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
- package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
- package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
- package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
- package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
- package/lib/composition/resolveAutoMovieSchedule.js +32 -103
- package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
- package/lib/constants/index.d.ts +2 -0
- package/lib/constants/index.js +2 -0
- package/lib/constants/index.js.map +1 -1
- package/lib/createAutoMovieGeometryActorReader.js +2 -1
- package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
- package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
- package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
- package/lib/drawing/index.d.ts +12 -0
- package/lib/drawing/index.js +12 -0
- package/lib/drawing/index.js.map +1 -1
- package/lib/effectRuntime/index.d.ts +7 -0
- package/lib/effectRuntime/index.js +7 -0
- package/lib/effectRuntime/index.js.map +1 -1
- package/lib/film/compileAttach.js +2 -5
- package/lib/film/compileAttach.js.map +1 -1
- package/lib/film/compileLaunch.d.ts +2 -2
- package/lib/film/compileLaunch.js +4 -3
- package/lib/film/compileLaunch.js.map +1 -1
- package/lib/film/constants/index.d.ts +3 -0
- package/lib/film/constants/index.js +3 -0
- package/lib/film/constants/index.js.map +1 -1
- package/lib/film/index.d.ts +61 -6
- package/lib/film/index.js +61 -12
- package/lib/film/index.js.map +1 -1
- package/lib/film/propAnchorFrame.js +6 -9
- package/lib/film/propAnchorFrame.js.map +1 -1
- package/lib/film/stageScene.js +3 -10
- package/lib/film/stageScene.js.map +1 -1
- package/lib/film/staging/index.d.ts +11 -0
- package/lib/film/staging/index.js +28 -0
- package/lib/film/staging/index.js.map +1 -0
- package/lib/film/staging/lowerLightPlacement.js +4 -7
- package/lib/film/staging/lowerLightPlacement.js.map +1 -1
- package/lib/formationSlotPosition.d.ts +6 -1
- package/lib/formationSlotPosition.js +38 -3
- package/lib/formationSlotPosition.js.map +1 -1
- package/lib/geometry/IAutoMovieMark.d.ts +99 -0
- package/lib/geometry/IAutoMovieMark.js +3 -0
- package/lib/geometry/IAutoMovieMark.js.map +1 -0
- package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
- package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
- package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
- package/lib/geometry/constants/index.d.ts +2 -0
- package/lib/geometry/constants/index.js +2 -0
- package/lib/geometry/constants/index.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
- package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
- package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
- package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
- package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
- package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
- package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
- package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
- package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
- package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
- package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
- package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
- package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
- package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
- package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
- package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
- package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
- package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
- package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
- package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
- package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
- package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
- package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
- package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
- package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
- package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
- package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
- package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
- package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
- package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
- package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
- package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
- package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
- package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
- package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
- package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
- package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
- package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
- package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
- package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
- package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
- package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
- package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
- package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
- package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
- package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
- package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
- package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
- package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
- package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
- package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
- package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
- package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
- package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
- package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
- package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
- package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
- package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
- package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
- package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
- package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
- package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
- package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
- package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
- package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
- package/lib/geometry/construction/index.d.ts +82 -2
- package/lib/geometry/construction/index.js +82 -2
- package/lib/geometry/construction/index.js.map +1 -1
- package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
- package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
- package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
- package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
- package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
- package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
- package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
- package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
- package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
- package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
- package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
- package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
- package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
- package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
- package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
- package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
- package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
- package/lib/geometry/curve/index.d.ts +48 -25
- package/lib/geometry/curve/index.js +48 -25
- package/lib/geometry/curve/index.js.map +1 -1
- package/lib/geometry/extract/index.d.ts +0 -1
- package/lib/geometry/extract/index.js +0 -1
- package/lib/geometry/extract/index.js.map +1 -1
- package/lib/geometry/index.d.ts +87 -53
- package/lib/geometry/index.js +87 -50
- package/lib/geometry/index.js.map +1 -1
- package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
- package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
- package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
- package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
- package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
- package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
- package/lib/geometry/sweep/index.d.ts +54 -15
- package/lib/geometry/sweep/index.js +54 -1
- package/lib/geometry/sweep/index.js.map +1 -1
- package/lib/index.d.ts +41 -450
- package/lib/index.js +41 -660
- package/lib/index.js.map +1 -1
- package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
- package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
- package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
- package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
- package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
- package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
- package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
- package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
- package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
- package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
- package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
- package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
- package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
- package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
- package/lib/kinematics/alternateRigJointAngles.js +34 -0
- package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
- package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
- package/lib/kinematics/boxExcludedSwivels.js +187 -0
- package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
- package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
- package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
- package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
- package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
- package/lib/kinematics/curlChainUntilContact.js +45 -5
- package/lib/kinematics/curlChainUntilContact.js.map +1 -1
- package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
- package/lib/kinematics/decomposeJointRotation.js +10 -131
- package/lib/kinematics/decomposeJointRotation.js.map +1 -1
- package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
- package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
- package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
- package/lib/kinematics/fitDigitDescent.d.ts +66 -0
- package/lib/kinematics/fitDigitDescent.js +142 -0
- package/lib/kinematics/fitDigitDescent.js.map +1 -0
- package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
- package/lib/kinematics/fitDigitToTarget.js +251 -0
- package/lib/kinematics/fitDigitToTarget.js.map +1 -0
- package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
- package/lib/kinematics/hingedArmArticulation.js +273 -84
- package/lib/kinematics/hingedArmArticulation.js.map +1 -1
- package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
- package/lib/kinematics/hingedArmSwivel.js +196 -0
- package/lib/kinematics/hingedArmSwivel.js.map +1 -0
- package/lib/kinematics/index.d.ts +30 -7
- package/lib/kinematics/index.js +30 -5
- package/lib/kinematics/index.js.map +1 -1
- package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
- package/lib/kinematics/jointRomOvershoot.js +21 -17
- package/lib/kinematics/jointRomOvershoot.js.map +1 -1
- package/lib/kinematics/jointToQuaternion.d.ts +2 -2
- package/lib/kinematics/jointToQuaternion.js +4 -19
- package/lib/kinematics/jointToQuaternion.js.map +1 -1
- package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
- package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
- package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
- package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
- package/lib/kinematics/markAutoMovieBalance.js +65 -0
- package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
- package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
- package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
- package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
- package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
- package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
- package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
- package/lib/kinematics/normalizeJointAxes.js +52 -12
- package/lib/kinematics/normalizeJointAxes.js.map +1 -1
- package/lib/kinematics/poseJointCodec.d.ts +71 -0
- package/lib/kinematics/poseJointCodec.js +70 -0
- package/lib/kinematics/poseJointCodec.js.map +1 -0
- package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
- package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
- package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
- package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
- package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
- package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
- package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
- package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
- package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
- package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
- package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
- package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
- package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
- package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
- package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
- package/lib/kinematics/swingTwistBasis.d.ts +108 -0
- package/lib/kinematics/swingTwistBasis.js +116 -0
- package/lib/kinematics/swingTwistBasis.js.map +1 -0
- package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
- package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
- package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
- package/lib/kinematics/swingTwistRange.d.ts +246 -0
- package/lib/kinematics/swingTwistRange.js +322 -0
- package/lib/kinematics/swingTwistRange.js.map +1 -0
- package/lib/kinematics/swingTwistRegion.d.ts +50 -0
- package/lib/kinematics/swingTwistRegion.js +212 -0
- package/lib/kinematics/swingTwistRegion.js.map +1 -0
- package/lib/kinematics/swivelArcs.d.ts +166 -0
- package/lib/kinematics/swivelArcs.js +200 -0
- package/lib/kinematics/swivelArcs.js.map +1 -0
- package/lib/math/Quaternion.d.ts +29 -2
- package/lib/math/Quaternion.js +33 -2
- package/lib/math/Quaternion.js.map +1 -1
- package/lib/math/Transform.d.ts +50 -0
- package/lib/math/Transform.js +58 -0
- package/lib/math/Transform.js.map +1 -0
- package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
- package/lib/math/assignAutoMovieMinimumCost.js +86 -0
- package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
- package/lib/math/bracketedBisection.d.ts +33 -0
- package/lib/math/bracketedBisection.js +52 -0
- package/lib/math/bracketedBisection.js.map +1 -0
- package/lib/math/bracketedRoot.d.ts +32 -0
- package/lib/math/bracketedRoot.js +76 -0
- package/lib/math/bracketedRoot.js.map +1 -0
- package/lib/math/constants/index.d.ts +1 -0
- package/lib/math/constants/index.js +18 -0
- package/lib/math/constants/index.js.map +1 -0
- package/lib/math/index.d.ts +64 -5
- package/lib/math/index.js +64 -5
- package/lib/math/index.js.map +1 -1
- package/lib/math/nearestAngleAlias.d.ts +27 -0
- package/lib/math/nearestAngleAlias.js +44 -0
- package/lib/math/nearestAngleAlias.js.map +1 -0
- package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
- package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
- package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
- package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
- package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
- package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
- package/lib/measureAutoMovieGeometryReach.js +2 -4
- package/lib/measureAutoMovieGeometryReach.js.map +1 -1
- package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
- package/lib/motion/AirborneTakeoffLinear.js +58 -0
- package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
- package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
- package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
- package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
- package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
- package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
- package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
- package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
- package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
- package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
- package/lib/motion/MotionTrajectoryStepper.js +357 -0
- package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
- package/lib/motion/basisOf.d.ts +18 -0
- package/lib/motion/basisOf.js +25 -0
- package/lib/motion/basisOf.js.map +1 -0
- package/lib/motion/carriedAcceleration.d.ts +43 -0
- package/lib/motion/carriedAcceleration.js +55 -0
- package/lib/motion/carriedAcceleration.js.map +1 -0
- package/lib/motion/carriedRate.d.ts +48 -0
- package/lib/motion/carriedRate.js +60 -0
- package/lib/motion/carriedRate.js.map +1 -0
- package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
- package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
- package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
- package/lib/motion/constants/index.d.ts +1 -0
- package/lib/motion/constants/index.js +1 -0
- package/lib/motion/constants/index.js.map +1 -1
- package/lib/motion/fitChainBend.d.ts +23 -0
- package/lib/motion/fitChainBend.js +293 -0
- package/lib/motion/fitChainBend.js.map +1 -0
- package/lib/motion/fitChainToTarget.d.ts +11 -13
- package/lib/motion/fitChainToTarget.js +12 -283
- package/lib/motion/fitChainToTarget.js.map +1 -1
- package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
- package/lib/motion/fitHingedChainCandidate.js +186 -76
- package/lib/motion/fitHingedChainCandidate.js.map +1 -1
- package/lib/motion/fitHingedRotationError.d.ts +31 -0
- package/lib/motion/fitHingedRotationError.js +107 -0
- package/lib/motion/fitHingedRotationError.js.map +1 -0
- package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
- package/lib/motion/fitSeededChainToTarget.js +32 -0
- package/lib/motion/fitSeededChainToTarget.js.map +1 -0
- package/lib/motion/gaitMotion.js +7 -13
- package/lib/motion/gaitMotion.js.map +1 -1
- package/lib/motion/gestureMotion.js +2 -5
- package/lib/motion/gestureMotion.js.map +1 -1
- package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
- package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
- package/lib/motion/index.d.ts +40 -9
- package/lib/motion/index.js +40 -12
- package/lib/motion/index.js.map +1 -1
- package/lib/motion/inertializeOffset.d.ts +15 -2
- package/lib/motion/inertializeOffset.js +16 -3
- package/lib/motion/inertializeOffset.js.map +1 -1
- package/lib/motion/inertializePose.d.ts +36 -13
- package/lib/motion/inertializePose.js +122 -43
- package/lib/motion/inertializePose.js.map +1 -1
- package/lib/motion/integrateAirborneRotation.d.ts +151 -0
- package/lib/motion/integrateAirborneRotation.js +204 -0
- package/lib/motion/integrateAirborneRotation.js.map +1 -0
- package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
- package/lib/motion/integrateMotionTrajectory.js +156 -0
- package/lib/motion/integrateMotionTrajectory.js.map +1 -0
- package/lib/motion/orientChainEffector.d.ts +1 -1
- package/lib/motion/orientChainEffector.js +15 -7
- package/lib/motion/orientChainEffector.js.map +1 -1
- package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
- package/lib/motion/resolveHydrodynamicForce.js +100 -0
- package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
- package/lib/motion/sampleMotion.js +2 -5
- package/lib/motion/sampleMotion.js.map +1 -1
- package/lib/motion/samplePoseVelocity.d.ts +76 -13
- package/lib/motion/samplePoseVelocity.js +126 -38
- package/lib/motion/samplePoseVelocity.js.map +1 -1
- package/lib/motion/smoothMinimum.d.ts +29 -0
- package/lib/motion/smoothMinimum.js +40 -0
- package/lib/motion/smoothMinimum.js.map +1 -0
- package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
- package/lib/motion/solveAirborneTakeoff.js +324 -0
- package/lib/motion/solveAirborneTakeoff.js.map +1 -0
- package/lib/motion/solveDistalTwist.d.ts +62 -0
- package/lib/motion/solveDistalTwist.js +152 -0
- package/lib/motion/solveDistalTwist.js.map +1 -0
- package/lib/motion/speedProfile.d.ts +175 -0
- package/lib/motion/speedProfile.js +261 -0
- package/lib/motion/speedProfile.js.map +1 -0
- package/lib/motion/splitDistalTwist.d.ts +12 -17
- package/lib/motion/splitDistalTwist.js +37 -40
- package/lib/motion/splitDistalTwist.js.map +1 -1
- package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
- package/lib/motion/steerAutoMovieCrowd.js +249 -0
- package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
- package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
- package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
- package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
- package/lib/perform/index.d.ts +10 -0
- package/lib/perform/index.js +10 -0
- package/lib/perform/index.js.map +1 -1
- package/lib/physics/AutoMovieAir.d.ts +21 -0
- package/lib/physics/AutoMovieAir.js +26 -0
- package/lib/physics/AutoMovieAir.js.map +1 -0
- package/lib/physics/AutoMovieGravity.d.ts +22 -0
- package/lib/physics/AutoMovieGravity.js +30 -0
- package/lib/physics/AutoMovieGravity.js.map +1 -0
- package/lib/physics/IAutoMovieHit.d.ts +11 -7
- package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
- package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
- package/lib/physics/admitMotionGeometry.js +12 -0
- package/lib/physics/admitMotionGeometry.js.map +1 -1
- package/lib/physics/bindPhysicalWorld.js +16 -4
- package/lib/physics/bindPhysicalWorld.js.map +1 -1
- package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
- package/lib/physics/combinePhysicalMassProperties.js +8 -90
- package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
- package/lib/physics/deriveCenterOfMass.js +2 -5
- package/lib/physics/deriveCenterOfMass.js.map +1 -1
- package/lib/physics/derivePhysicalProfile.js +7 -5
- package/lib/physics/derivePhysicalProfile.js.map +1 -1
- package/lib/physics/index.d.ts +155 -2
- package/lib/physics/index.js +155 -2
- package/lib/physics/index.js.map +1 -1
- package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
- package/lib/physics/markAutoMovieSkeleton.js +62 -0
- package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
- package/lib/physics/physicalHullErode.d.ts +25 -0
- package/lib/physics/physicalHullErode.js +54 -0
- package/lib/physics/physicalHullErode.js.map +1 -0
- package/lib/physics/physicalHullFaces.d.ts +56 -0
- package/lib/physics/physicalHullFaces.js +151 -0
- package/lib/physics/physicalHullFaces.js.map +1 -0
- package/lib/physics/physicalHullMass.d.ts +32 -0
- package/lib/physics/physicalHullMass.js +80 -0
- package/lib/physics/physicalHullMass.js.map +1 -0
- package/lib/physics/physicalHullNearest.d.ts +37 -0
- package/lib/physics/physicalHullNearest.js +178 -0
- package/lib/physics/physicalHullNearest.js.map +1 -0
- package/lib/physics/physicalHullSegment.d.ts +34 -0
- package/lib/physics/physicalHullSegment.js +276 -0
- package/lib/physics/physicalHullSegment.js.map +1 -0
- package/lib/physics/physicalInertiaTensor.d.ts +28 -0
- package/lib/physics/physicalInertiaTensor.js +58 -0
- package/lib/physics/physicalInertiaTensor.js.map +1 -0
- package/lib/physics/physicalNativeShape.d.ts +1 -1
- package/lib/physics/physicalNativeShape.js +15 -4
- package/lib/physics/physicalNativeShape.js.map +1 -1
- package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
- package/lib/physics/physicalPrincipalAxes.js +96 -0
- package/lib/physics/physicalPrincipalAxes.js.map +1 -0
- package/lib/physics/physicalShapeBounds.d.ts +2 -1
- package/lib/physics/physicalShapeBounds.js +26 -2
- package/lib/physics/physicalShapeBounds.js.map +1 -1
- package/lib/physics/physicalShapeNearest.d.ts +70 -0
- package/lib/physics/physicalShapeNearest.js +201 -0
- package/lib/physics/physicalShapeNearest.js.map +1 -0
- package/lib/physics/physicalShapeNormal.d.ts +26 -0
- package/lib/physics/physicalShapeNormal.js +70 -0
- package/lib/physics/physicalShapeNormal.js.map +1 -0
- package/lib/physics/physicalShapePairDistance.d.ts +32 -0
- package/lib/physics/physicalShapePairDistance.js +124 -0
- package/lib/physics/physicalShapePairDistance.js.map +1 -0
- package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
- package/lib/physics/physicalShapeSegmentDistance.js +18 -70
- package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
- package/lib/physics/physicalShapeSpan.d.ts +21 -0
- package/lib/physics/physicalShapeSpan.js +55 -0
- package/lib/physics/physicalShapeSpan.js.map +1 -0
- package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
- package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
- package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
- package/lib/physics/projectileAt.d.ts +14 -12
- package/lib/physics/projectileAt.js +46 -16
- package/lib/physics/projectileAt.js.map +1 -1
- package/lib/physics/projectileContinue.d.ts +114 -0
- package/lib/physics/projectileContinue.js +189 -0
- package/lib/physics/projectileContinue.js.map +1 -0
- package/lib/physics/projectileDragFlight.d.ts +72 -0
- package/lib/physics/projectileDragFlight.js +166 -0
- package/lib/physics/projectileDragFlight.js.map +1 -0
- package/lib/physics/projectileFirstContact.d.ts +105 -0
- package/lib/physics/projectileFirstContact.js +174 -0
- package/lib/physics/projectileFirstContact.js.map +1 -0
- package/lib/physics/projectileTrajectory.js +3 -2
- package/lib/physics/projectileTrajectory.js.map +1 -1
- package/lib/physics/solveBallisticLaunch.js +2 -1
- package/lib/physics/solveBallisticLaunch.js.map +1 -1
- package/lib/physics/solveMovingLaunch.js +2 -1
- package/lib/physics/solveMovingLaunch.js.map +1 -1
- package/lib/physics/validatePhysicalProfile.js +18 -1
- package/lib/physics/validatePhysicalProfile.js.map +1 -1
- package/lib/populationRuntime/index.d.ts +6 -0
- package/lib/populationRuntime/index.js +6 -0
- package/lib/populationRuntime/index.js.map +1 -1
- package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
- package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
- package/lib/random/index.d.ts +1 -1
- package/lib/random/index.js +1 -0
- package/lib/random/index.js.map +1 -1
- package/lib/render/index.d.ts +20 -11
- package/lib/render/index.js +20 -11
- package/lib/render/index.js.map +1 -1
- package/lib/resolve/index.d.ts +7 -2
- package/lib/resolve/index.js +7 -5
- package/lib/resolve/index.js.map +1 -1
- package/lib/resolve/lowerSkeletonNodes.js +3 -10
- package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
- package/lib/rom/clampJointRom.d.ts +11 -3
- package/lib/rom/clampJointRom.js +43 -3
- package/lib/rom/clampJointRom.js.map +1 -1
- package/lib/rom/clampJointToSkeleton.d.ts +25 -2
- package/lib/rom/clampJointToSkeleton.js +39 -8
- package/lib/rom/clampJointToSkeleton.js.map +1 -1
- package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
- package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
- package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
- package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
- package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
- package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
- package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
- package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
- package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
- package/lib/rom/constants/index.d.ts +2 -0
- package/lib/rom/constants/index.js +2 -0
- package/lib/rom/constants/index.js.map +1 -1
- package/lib/rom/index.d.ts +1 -0
- package/lib/rom/index.js +1 -0
- package/lib/rom/index.js.map +1 -1
- package/lib/rom/scanJointRom.d.ts +62 -0
- package/lib/rom/scanJointRom.js +117 -0
- package/lib/rom/scanJointRom.js.map +1 -0
- package/lib/rom/validateJointRom.d.ts +4 -2
- package/lib/rom/validateJointRom.js +23 -45
- package/lib/rom/validateJointRom.js.map +1 -1
- package/lib/service/index.d.ts +9 -0
- package/lib/service/index.js +9 -0
- package/lib/service/index.js.map +1 -1
- package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
- package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
- package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
- package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
- package/lib/soft/applySoftBodyFriction.d.ts +34 -0
- package/lib/soft/applySoftBodyFriction.js +52 -0
- package/lib/soft/applySoftBodyFriction.js.map +1 -0
- package/lib/soft/index.d.ts +22 -0
- package/lib/soft/index.js +22 -0
- package/lib/soft/index.js.map +1 -1
- package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
- package/lib/soft/projectSoftCordSelfContact.js +172 -0
- package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
- package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
- package/lib/soft/simulateSoftBodyCore.js +108 -16
- package/lib/soft/simulateSoftBodyCore.js.map +1 -1
- package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
- package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
- package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
- package/lib/soft/softBodyBudget.js +7 -0
- package/lib/soft/softBodyBudget.js.map +1 -1
- package/lib/soft/softBodyHeldLoads.d.ts +34 -0
- package/lib/soft/softBodyHeldLoads.js +69 -0
- package/lib/soft/softBodyHeldLoads.js.map +1 -0
- package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
- package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
- package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
- package/lib/soft/validateSoftAnchors.d.ts +24 -0
- package/lib/soft/validateSoftAnchors.js +74 -0
- package/lib/soft/validateSoftAnchors.js.map +1 -0
- package/lib/soft/validateSoftBodyDomain.js +6 -48
- package/lib/soft/validateSoftBodyDomain.js.map +1 -1
- package/lib/soft/validateSoftBounded.d.ts +20 -0
- package/lib/soft/validateSoftBounded.js +27 -0
- package/lib/soft/validateSoftBounded.js.map +1 -0
- package/lib/soft/validateSoftCompliance.d.ts +30 -0
- package/lib/soft/validateSoftCompliance.js +54 -0
- package/lib/soft/validateSoftCompliance.js.map +1 -0
- package/lib/sound/index.d.ts +2 -0
- package/lib/sound/index.js +2 -0
- package/lib/sound/index.js.map +1 -1
- package/lib/text/index.d.ts +1 -0
- package/lib/text/index.js +1 -0
- package/lib/text/index.js.map +1 -1
- package/lib/validation/AffordanceArticulation.d.ts +69 -0
- package/lib/validation/AffordanceArticulation.js +142 -0
- package/lib/validation/AffordanceArticulation.js.map +1 -0
- package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
- package/lib/validation/affordanceFollowedTravel.js +43 -0
- package/lib/validation/affordanceFollowedTravel.js.map +1 -0
- package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
- package/lib/validation/affordanceLeadingTravel.js +99 -0
- package/lib/validation/affordanceLeadingTravel.js.map +1 -0
- package/lib/validation/affordanceTravelRange.d.ts +21 -0
- package/lib/validation/affordanceTravelRange.js +39 -0
- package/lib/validation/affordanceTravelRange.js.map +1 -0
- package/lib/validation/appendShotEventsArtifact.js +12 -0
- package/lib/validation/appendShotEventsArtifact.js.map +1 -1
- package/lib/validation/constants/index.d.ts +3 -3
- package/lib/validation/constants/index.js +3 -3
- package/lib/validation/constants/index.js.map +1 -1
- package/lib/validation/detectFreeFall.js +2 -1
- package/lib/validation/detectFreeFall.js.map +1 -1
- package/lib/validation/index.d.ts +52 -4
- package/lib/validation/index.js +52 -6
- package/lib/validation/index.js.map +1 -1
- package/lib/validation/markAutoMovieSlip.d.ts +26 -0
- package/lib/validation/markAutoMovieSlip.js +52 -0
- package/lib/validation/markAutoMovieSlip.js.map +1 -0
- package/lib/validation/validateAffordance.d.ts +3 -3
- package/lib/validation/validateAffordance.js +21 -3
- package/lib/validation/validateAffordance.js.map +1 -1
- package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
- package/lib/validation/validateAffordanceArticulation.js +183 -0
- package/lib/validation/validateAffordanceArticulation.js.map +1 -0
- package/lib/validation/validateBalanceSupport.d.ts +1 -2
- package/lib/validation/validateBalanceSupport.js.map +1 -1
- package/lib/validation/validateBody.d.ts +2 -2
- package/lib/validation/validateBody.js +27 -3
- package/lib/validation/validateBody.js.map +1 -1
- package/lib/validation/validateFootSkate.d.ts +1 -2
- package/lib/validation/validateFootSkate.js.map +1 -1
- package/lib/validation/validateGroundContact.d.ts +1 -2
- package/lib/validation/validateGroundContact.js.map +1 -1
- package/lib/validation/validateJointConstraint.d.ts +1 -1
- package/lib/validation/validateJointConstraint.js +9 -1
- package/lib/validation/validateJointConstraint.js.map +1 -1
- package/lib/validation/validateModel.js +2 -0
- package/lib/validation/validateModel.js.map +1 -1
- package/lib/validation/validateSelfIntersection.d.ts +1 -2
- package/lib/validation/validateSelfIntersection.js.map +1 -1
- package/lib/worldBlock.js +6 -9
- package/lib/worldBlock.js.map +1 -1
- package/package.json +6 -6
- package/src/IAutoMovieFormationPlacement.ts +4 -3
- package/src/analysis/index.ts +5 -0
- package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
- package/src/anthropometry/index.ts +1 -0
- package/src/architecture/appendBuiltRegionDefects.ts +3 -3
- package/src/architecture/builtOutlineIsClosed.ts +3 -3
- package/{lib/architecture/constants/PLANAR_EPSILON.d.ts → src/architecture/constants/BUILT_PLANAR_EPSILON.ts} +1 -1
- package/src/architecture/constants/index.ts +1 -1
- package/src/architecture/index.ts +157 -117
- package/src/cache/index.ts +9 -0
- package/src/composition/AutoMovieComposition.ts +34 -7
- package/src/composition/AutoMovieScheduleCut.ts +141 -0
- package/src/composition/AutoMovieScheduleError.ts +108 -0
- package/src/composition/AutoMovieSchedulePlace.ts +253 -0
- package/src/composition/AutoMovieScheduleWalk.ts +215 -0
- package/src/composition/IAutoMovieIntent.ts +9 -7
- package/src/composition/index.ts +12 -7
- package/src/composition/markAutoMovieContacts.ts +79 -0
- package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
- package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
- package/src/composition/resolveAutoMovieSchedule.ts +106 -145
- package/src/constants/index.ts +2 -0
- package/src/createAutoMovieGeometryActorReader.ts +2 -1
- package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
- package/src/drawing/index.ts +12 -0
- package/src/effectRuntime/index.ts +7 -0
- package/src/film/compileAttach.ts +2 -5
- package/src/film/compileLaunch.ts +5 -4
- package/src/film/constants/index.ts +3 -0
- package/src/film/index.ts +61 -6
- package/src/film/propAnchorFrame.ts +3 -6
- package/src/film/stageScene.ts +3 -10
- package/src/film/staging/index.ts +11 -0
- package/src/film/staging/lowerLightPlacement.ts +3 -7
- package/src/formationSlotPosition.ts +54 -7
- package/src/geometry/IAutoMovieMark.ts +115 -0
- package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
- package/src/geometry/constants/index.ts +2 -0
- package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
- package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
- package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
- package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
- package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
- package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
- package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
- package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
- package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
- package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
- package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
- package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
- package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
- package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
- package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
- package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
- package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
- package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
- package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
- package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
- package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
- package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
- package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
- package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
- package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
- package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
- package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
- package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
- package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
- package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
- package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
- package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
- package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
- package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
- package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
- package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
- package/src/geometry/construction/index.ts +82 -2
- package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
- package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
- package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
- package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
- package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
- package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
- package/src/geometry/curve/index.ts +48 -25
- package/src/geometry/extract/index.ts +0 -1
- package/src/geometry/index.ts +87 -53
- package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
- package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
- package/src/geometry/sweep/index.ts +54 -15
- package/src/index.ts +41 -450
- package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
- package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
- package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
- package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
- package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
- package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
- package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
- package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
- package/src/kinematics/alternateRigJointAngles.ts +41 -0
- package/src/kinematics/boxExcludedSwivels.ts +260 -0
- package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
- package/src/kinematics/curlChainUntilContact.ts +35 -8
- package/src/kinematics/decomposeJointRotation.ts +15 -178
- package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
- package/src/kinematics/fitDigitDescent.ts +253 -0
- package/src/kinematics/fitDigitToTarget.ts +425 -0
- package/src/kinematics/hingedArmArticulation.ts +402 -116
- package/src/kinematics/hingedArmSwivel.ts +295 -0
- package/src/kinematics/index.ts +30 -12
- package/src/kinematics/jointRomOvershoot.ts +30 -19
- package/src/kinematics/jointToQuaternion.ts +8 -43
- package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
- package/src/kinematics/markAutoMovieBalance.ts +75 -0
- package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
- package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
- package/src/kinematics/normalizeJointAxes.ts +66 -12
- package/src/kinematics/poseJointCodec.ts +148 -0
- package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
- package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
- package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
- package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
- package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
- package/src/kinematics/swingTwistBasis.ts +162 -0
- package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
- package/src/kinematics/swingTwistRange.ts +460 -0
- package/src/kinematics/swingTwistRegion.ts +298 -0
- package/src/kinematics/swivelArcs.ts +245 -0
- package/src/math/Quaternion.ts +42 -2
- package/src/math/Transform.ts +65 -0
- package/src/math/assignAutoMovieMinimumCost.ts +86 -0
- package/src/math/bracketedBisection.ts +51 -0
- package/src/math/bracketedRoot.ts +72 -0
- package/src/math/constants/index.ts +1 -0
- package/src/math/index.ts +64 -5
- package/src/math/nearestAngleAlias.ts +43 -0
- package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
- package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
- package/src/measureAutoMovieGeometryReach.ts +2 -4
- package/src/motion/AirborneTakeoffLinear.ts +70 -0
- package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
- package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
- package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
- package/src/motion/IFitChainToTargetProps.ts +67 -0
- package/src/motion/MotionTrajectoryStepper.ts +478 -0
- package/src/motion/basisOf.ts +29 -0
- package/src/motion/carriedAcceleration.ts +56 -0
- package/src/motion/carriedRate.ts +61 -0
- package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
- package/src/motion/constants/index.ts +1 -0
- package/src/motion/fitChainBend.ts +491 -0
- package/src/motion/fitChainToTarget.ts +13 -485
- package/src/motion/fitHingedChainCandidate.ts +281 -148
- package/src/motion/fitHingedRotationError.ts +164 -0
- package/src/motion/fitSeededChainToTarget.ts +34 -0
- package/src/motion/gaitMotion.ts +6 -10
- package/src/motion/gestureMotion.ts +2 -5
- package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
- package/src/motion/index.ts +40 -9
- package/src/motion/inertializeOffset.ts +16 -2
- package/src/motion/inertializePose.ts +158 -53
- package/src/motion/integrateAirborneRotation.ts +334 -0
- package/src/motion/integrateMotionTrajectory.ts +309 -0
- package/src/motion/orientChainEffector.ts +19 -13
- package/src/motion/resolveHydrodynamicForce.ts +143 -0
- package/src/motion/sampleMotion.ts +2 -5
- package/src/motion/samplePoseVelocity.ts +168 -41
- package/src/motion/smoothMinimum.ts +36 -0
- package/src/motion/solveAirborneTakeoff.ts +471 -0
- package/src/motion/solveDistalTwist.ts +256 -0
- package/src/motion/speedProfile.ts +470 -0
- package/src/motion/splitDistalTwist.ts +55 -64
- package/src/motion/steerAutoMovieCrowd.ts +381 -0
- package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
- package/src/perform/index.ts +10 -0
- package/src/physics/AutoMovieAir.ts +22 -0
- package/src/physics/AutoMovieGravity.ts +28 -0
- package/src/physics/IAutoMovieHit.ts +13 -7
- package/src/physics/IAutoMovieProjectile.ts +82 -6
- package/src/physics/IAutoMovieProjectileState.ts +10 -4
- package/src/physics/admitMotionGeometry.ts +16 -0
- package/src/physics/bindPhysicalWorld.ts +22 -11
- package/src/physics/combinePhysicalMassProperties.ts +9 -117
- package/src/physics/deriveCenterOfMass.ts +2 -5
- package/src/physics/derivePhysicalProfile.ts +3 -1
- package/src/physics/index.ts +155 -2
- package/src/physics/markAutoMovieSkeleton.ts +69 -0
- package/src/physics/physicalHullErode.ts +72 -0
- package/src/physics/physicalHullFaces.ts +215 -0
- package/src/physics/physicalHullMass.ts +99 -0
- package/src/physics/physicalHullNearest.ts +210 -0
- package/src/physics/physicalHullSegment.ts +338 -0
- package/src/physics/physicalInertiaTensor.ts +75 -0
- package/src/physics/physicalNativeShape.ts +31 -9
- package/src/physics/physicalPrincipalAxes.ts +114 -0
- package/src/physics/physicalShapeBounds.ts +24 -2
- package/src/physics/physicalShapeNearest.ts +287 -0
- package/src/physics/physicalShapeNormal.ts +105 -0
- package/src/physics/physicalShapePairDistance.ts +153 -0
- package/src/physics/physicalShapeSegmentDistance.ts +18 -92
- package/src/physics/physicalShapeSpan.ts +75 -0
- package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
- package/src/physics/projectileAt.ts +61 -20
- package/src/physics/projectileContinue.ts +287 -0
- package/src/physics/projectileDragFlight.ts +208 -0
- package/src/physics/projectileFirstContact.ts +286 -0
- package/src/physics/projectileTrajectory.ts +6 -5
- package/src/physics/solveBallisticLaunch.ts +2 -1
- package/src/physics/solveMovingLaunch.ts +2 -1
- package/src/physics/validatePhysicalProfile.ts +20 -1
- package/src/populationRuntime/index.ts +6 -0
- package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
- package/src/random/index.ts +1 -1
- package/src/render/index.ts +20 -11
- package/src/resolve/index.ts +7 -2
- package/src/resolve/lowerSkeletonNodes.ts +3 -10
- package/src/rom/clampJointRom.ts +59 -2
- package/src/rom/clampJointToSkeleton.ts +52 -15
- package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
- package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
- package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
- package/src/rom/constants/index.ts +2 -0
- package/src/rom/index.ts +1 -0
- package/src/rom/scanJointRom.ts +169 -0
- package/src/rom/validateJointRom.ts +69 -74
- package/src/service/index.ts +9 -0
- package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
- package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
- package/src/soft/applySoftBodyFriction.ts +65 -0
- package/src/soft/index.ts +22 -0
- package/src/soft/projectSoftCordSelfContact.ts +239 -0
- package/src/soft/simulateSoftBodyCore.ts +127 -15
- package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
- package/src/soft/softBodyBudget.ts +11 -0
- package/src/soft/softBodyHeldLoads.ts +85 -0
- package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
- package/src/soft/validateSoftAnchors.ts +143 -0
- package/src/soft/validateSoftBodyDomain.ts +5 -124
- package/src/soft/validateSoftBounded.ts +42 -0
- package/src/soft/validateSoftCompliance.ts +102 -0
- package/src/sound/index.ts +2 -0
- package/src/text/index.ts +1 -0
- package/src/validation/AffordanceArticulation.ts +173 -0
- package/src/validation/affordanceFollowedTravel.ts +40 -0
- package/src/validation/affordanceLeadingTravel.ts +108 -0
- package/src/validation/affordanceTravelRange.ts +42 -0
- package/src/validation/appendShotEventsArtifact.ts +26 -0
- package/src/validation/constants/index.ts +3 -3
- package/src/validation/detectFreeFall.ts +3 -2
- package/src/validation/index.ts +52 -4
- package/src/validation/markAutoMovieSlip.ts +65 -0
- package/src/validation/validateAffordance.ts +38 -3
- package/src/validation/validateAffordanceArticulation.ts +311 -0
- package/src/validation/validateBalanceSupport.ts +2 -5
- package/src/validation/validateBody.ts +80 -3
- package/src/validation/validateFootSkate.ts +1 -1
- package/src/validation/validateGroundContact.ts +2 -5
- package/src/validation/validateJointConstraint.ts +19 -1
- package/src/validation/validateModel.ts +7 -0
- package/src/validation/validateSelfIntersection.ts +2 -5
- package/src/worldBlock.ts +3 -6
- package/lib/architecture/constants/PLANAR_EPSILON.js.map +0 -1
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import type { IAutoMoviePhysicalProfile } from "@automovie/interface";
|
|
2
|
+
|
|
3
|
+
import type { IAutoMovieMark } from "../geometry/IAutoMovieMark";
|
|
4
|
+
import type { AutoMoviePhysicsCache } from "./AutoMoviePhysicsCache";
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Turn articulated bodies at one cached instant into inspection marks: one bone segment per joint, from the parent segment's position to the child's, and one joint point per segment.
|
|
8
|
+
*
|
|
9
|
+
* It works on any body a physical profile describes, whatever its rig. A bone mark has kind `bone`, label `bone`, colour ochre `c8a24a` and path `<body>/<child>/bone`; a joint mark has kind `joint`, label `joint`, colour pink `ff7eb6` and path `<body>/<bone>/joint`, so a pattern naming a body or one of its bones selects its marks. Both are in world metres and unanchored, because the cached positions are world positions.
|
|
10
|
+
*
|
|
11
|
+
* It throws naming the body and bone when the frame lacks a segment the profile names.
|
|
12
|
+
*
|
|
13
|
+
* ```ts
|
|
14
|
+
* const marks = markAutoMovieSkeleton({ bodies, frame: cache.at(seconds) });
|
|
15
|
+
* ```
|
|
16
|
+
*
|
|
17
|
+
* @param props.bodies Scene body ids with their profiles, whose joints and segments are drawn.
|
|
18
|
+
* @param props.frame The cached state at the drawn second.
|
|
19
|
+
* @returns Every body's bone marks in joint order, then its joint marks in segment order, body by body.
|
|
20
|
+
*
|
|
21
|
+
* @evidence contracts/development/common.md#meaningful-documentation States what is drawn and from which data, the kinds, labels, colours, paths and frame of both mark kinds, the refusal, and shows the call.
|
|
22
|
+
* @evidence contracts/development/implementation.md#principled-implementation A profile joint connects a parent segment to a child segment, so its bone is the line between the two segments' cached world positions, and each segment's position is where its joint sits; nothing is inferred from a rig's bone names.
|
|
23
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure One pass over each body's joints, one over its segments.
|
|
24
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A missing segment is refused instead of drawn at the origin, and no body or bone is treated specially; the two colours are a drawing convention chosen apart from every other kind's.
|
|
25
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Linear in the joints and segments of the bodies.
|
|
26
|
+
* @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure conversion of one instant.
|
|
27
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Returns fresh marks and keeps nothing.
|
|
28
|
+
*/
|
|
29
|
+
export function markAutoMovieSkeleton(props: {
|
|
30
|
+
bodies: readonly { id: string; profile: IAutoMoviePhysicalProfile }[];
|
|
31
|
+
frame: AutoMoviePhysicsCache.IFrame;
|
|
32
|
+
}): IAutoMovieMark[] {
|
|
33
|
+
const marks: IAutoMovieMark[] = [];
|
|
34
|
+
for (const body of props.bodies) {
|
|
35
|
+
const at: (bone: string) => number[] = (bone: string): number[] => {
|
|
36
|
+
const state: AutoMoviePhysicsCache.ISegment | undefined =
|
|
37
|
+
props.frame.bodies[body.id]?.[bone];
|
|
38
|
+
if (state === undefined)
|
|
39
|
+
throw new Error(
|
|
40
|
+
`markAutoMovieSkeleton: the frame has no segment ${body.id}/${bone}`,
|
|
41
|
+
);
|
|
42
|
+
return [state.position.x, state.position.y, state.position.z];
|
|
43
|
+
};
|
|
44
|
+
for (const joint of body.profile.joints)
|
|
45
|
+
marks.push({
|
|
46
|
+
path: `${body.id}/${joint.child}/bone`,
|
|
47
|
+
kind: "bone",
|
|
48
|
+
label: "bone",
|
|
49
|
+
color: 0xc8a24a,
|
|
50
|
+
shape: {
|
|
51
|
+
type: "segments",
|
|
52
|
+
points: [...at(joint.parent), ...at(joint.child)],
|
|
53
|
+
},
|
|
54
|
+
flagged: false,
|
|
55
|
+
anchor: null,
|
|
56
|
+
});
|
|
57
|
+
for (const segment of body.profile.segments)
|
|
58
|
+
marks.push({
|
|
59
|
+
path: `${body.id}/${segment.bone}/joint`,
|
|
60
|
+
kind: "joint",
|
|
61
|
+
label: "joint",
|
|
62
|
+
color: 0xff7eb6,
|
|
63
|
+
shape: { type: "points", points: at(segment.bone) },
|
|
64
|
+
flagged: false,
|
|
65
|
+
anchor: null,
|
|
66
|
+
});
|
|
67
|
+
}
|
|
68
|
+
return marks;
|
|
69
|
+
}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import type { IAutoMovieVector3 } from "@automovie/interface";
|
|
2
|
+
|
|
3
|
+
import { Vector3 } from "../math/Vector3";
|
|
4
|
+
import { physicalHullFaces } from "./physicalHullFaces";
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* The vertices of a convex hull shrunk inward by a depth: every face plane
|
|
8
|
+
* moves inward by `depth`, and the eroded solid is what remains behind all
|
|
9
|
+
* of them.
|
|
10
|
+
*
|
|
11
|
+
* A vertex of the eroded solid is the meeting point of three moved planes
|
|
12
|
+
* that lies behind every other moved plane, so each triple of faces is
|
|
13
|
+
* solved by Cramer's rule and kept when it does.
|
|
14
|
+
*
|
|
15
|
+
* @param points The hull's shape-local points, metres, spanning a volume.
|
|
16
|
+
* @param depth The inward offset, metres; below the hull's `depth` about its
|
|
17
|
+
* centre, so the eroded solid keeps a volume.
|
|
18
|
+
* @returns The eroded solid's vertices in the points' frame.
|
|
19
|
+
* @throws {Error} When the depth leaves no volume.
|
|
20
|
+
*
|
|
21
|
+
* @evidence contracts/development/common.md#meaningful-documentation States the erosion as moved half-spaces, how vertices are found, the premise on the depth and the frame.
|
|
22
|
+
* @evidence contracts/development/implementation.md#principled-implementation Erosion of a convex polytope by a ball is the intersection of its half-spaces moved inward by the radius; vertex enumeration of that intersection takes each plane triple's unique point and keeps the feasible ones.
|
|
23
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure Owns only the erosion: faces come from `physicalHullFaces`, and the result is a point set any hull consumer reads, so a compliant shape's rigid core is one more hull.
|
|
24
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Parallel triples are refused by a determinant below 1e-12, dimensionless because the normals are units; feasibility uses the hull's own coplanarity tolerance. The non-null assertions index the face list by bounded indices.
|
|
25
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Quartic in the face count, a few dozen faces, once per compliant hull when a world is bound.
|
|
26
|
+
* @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Called once per compliant hull collider at binding; nothing repeats it.
|
|
27
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps nothing between calls; its temporaries die with the call.
|
|
28
|
+
*/
|
|
29
|
+
export function physicalHullErode(
|
|
30
|
+
points: readonly IAutoMovieVector3[],
|
|
31
|
+
depth: number,
|
|
32
|
+
): IAutoMovieVector3[] {
|
|
33
|
+
const hull: physicalHullFaces.IHull = physicalHullFaces(points);
|
|
34
|
+
if (!(depth < hull.depth))
|
|
35
|
+
throw new Error("A hull's erosion must leave a volume");
|
|
36
|
+
const faces: physicalHullFaces.IFace[] = hull.faces;
|
|
37
|
+
const out: IAutoMovieVector3[] = [];
|
|
38
|
+
for (let i: number = 0; i < faces.length; i++)
|
|
39
|
+
for (let j: number = i + 1; j < faces.length; j++)
|
|
40
|
+
for (let k: number = j + 1; k < faces.length; k++) {
|
|
41
|
+
const a: IAutoMovieVector3 = faces[i]!.normal;
|
|
42
|
+
const b: IAutoMovieVector3 = faces[j]!.normal;
|
|
43
|
+
const c: IAutoMovieVector3 = faces[k]!.normal;
|
|
44
|
+
const bc: IAutoMovieVector3 = Vector3.cross(b, c);
|
|
45
|
+
const determinant: number = Vector3.dot(a, bc);
|
|
46
|
+
if (Math.abs(determinant) < 1e-12) continue;
|
|
47
|
+
// Cramer's rule for the point on all three moved planes.
|
|
48
|
+
const point: IAutoMovieVector3 = Vector3.scale(
|
|
49
|
+
Vector3.add(
|
|
50
|
+
Vector3.add(
|
|
51
|
+
Vector3.scale(bc, faces[i]!.offset - depth),
|
|
52
|
+
Vector3.scale(Vector3.cross(c, a), faces[j]!.offset - depth),
|
|
53
|
+
),
|
|
54
|
+
Vector3.scale(Vector3.cross(a, b), faces[k]!.offset - depth),
|
|
55
|
+
),
|
|
56
|
+
1 / determinant,
|
|
57
|
+
);
|
|
58
|
+
if (
|
|
59
|
+
faces.every(
|
|
60
|
+
(face: physicalHullFaces.IFace): boolean =>
|
|
61
|
+
Vector3.dot(face.normal, point) - (face.offset - depth) <=
|
|
62
|
+
hull.tolerance,
|
|
63
|
+
) &&
|
|
64
|
+
!out.some(
|
|
65
|
+
(seen: IAutoMovieVector3): boolean =>
|
|
66
|
+
Vector3.length(Vector3.subtract(seen, point)) <= hull.tolerance,
|
|
67
|
+
)
|
|
68
|
+
)
|
|
69
|
+
out.push(point);
|
|
70
|
+
}
|
|
71
|
+
return out;
|
|
72
|
+
}
|
|
@@ -0,0 +1,215 @@
|
|
|
1
|
+
import type { IAutoMovieVector3 } from "@automovie/interface";
|
|
2
|
+
|
|
3
|
+
import { Vector3 } from "../math/Vector3";
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* The faces of the convex hull of a point set: each face's outward unit
|
|
7
|
+
* normal, its plane offset along that normal and its vertex loop, counter
|
|
8
|
+
* clockwise seen from outside.
|
|
9
|
+
*
|
|
10
|
+
* A plane through three points is a face when no point lies in front of it;
|
|
11
|
+
* every point on that plane then belongs to the face, and their planar convex
|
|
12
|
+
* hull (Andrew's monotone chain) orders the loop. Points within `tolerance`
|
|
13
|
+
* of a plane count as on it, so a flat ring of many points yields one face
|
|
14
|
+
* rather than a fan of slivers. A point set that spans no volume has no face.
|
|
15
|
+
*
|
|
16
|
+
* The result is remembered per `points` array, so a profile's shape pays the
|
|
17
|
+
* search once however many queries read it; the array must not be mutated
|
|
18
|
+
* after its first use.
|
|
19
|
+
*
|
|
20
|
+
* @param points Shape-local points, metres.
|
|
21
|
+
* @returns The hull's faces, its vertices, the mean of its vertices, the
|
|
22
|
+
* radii about that mean of a sphere containing the hull and of one inside
|
|
23
|
+
* it, and how deep any input point lies below the surface.
|
|
24
|
+
*
|
|
25
|
+
* @evidence contracts/development/common.md#meaningful-documentation States what a face is, how coplanar points are gathered, the loop order, the degenerate case and the per-array memo with its no-mutation premise.
|
|
26
|
+
* @evidence contracts/development/implementation.md#principled-implementation The definition of a hull face applied directly: a supporting plane through three non-collinear points with every other point behind it (de Berg et al., Computational Geometry, chapter 11), and Andrew's monotone chain for the loop of each face.
|
|
27
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure The single owner of hull topology: the nearest-point query, bounds, mass, erosion, validation and the native mapping all read these faces instead of deriving their own.
|
|
28
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The tolerance is 1e-9 of the point set's extent, a relative floor above double rounding of the plane products and far below any modelled dimension; the non-null assertions index arrays by indices the loops themselves bound.
|
|
29
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Triples of points against all points is cubic to quartic in the point count, taken once per array for the few dozen points of a body module; triples already covered by a found face are skipped, and every later call is a map lookup.
|
|
30
|
+
* @evidence contracts/development/implementation.md#reuse-equivalent-work The faces of one `points` array are computed once and shared by every consumer through the module's `WeakMap`.
|
|
31
|
+
* @evidence contracts/development/implementation.md#bound-retention-and-release-resources The `WeakMap` holds one result per live `points` array and releases it when the array is collected, so retention is bounded by the shapes the caller still holds.
|
|
32
|
+
*/
|
|
33
|
+
export function physicalHullFaces(
|
|
34
|
+
points: readonly IAutoMovieVector3[],
|
|
35
|
+
): physicalHullFaces.IHull {
|
|
36
|
+
const cached: physicalHullFaces.IHull | undefined = HULLS.get(points);
|
|
37
|
+
if (cached !== undefined) return cached;
|
|
38
|
+
const count: number = points.length;
|
|
39
|
+
let extent: number = 0;
|
|
40
|
+
for (const p of points)
|
|
41
|
+
for (const q of points)
|
|
42
|
+
extent = Math.max(extent, Vector3.length(Vector3.subtract(p, q)));
|
|
43
|
+
const tolerance: number = 1e-9 * extent;
|
|
44
|
+
const faces: physicalHullFaces.IFace[] = [];
|
|
45
|
+
const members: boolean[][] = [];
|
|
46
|
+
const used: boolean[] = points.map((): boolean => false);
|
|
47
|
+
for (let i: number = 0; i < count; i++)
|
|
48
|
+
for (let j: number = i + 1; j < count; j++)
|
|
49
|
+
for (let k: number = j + 1; k < count; k++) {
|
|
50
|
+
if (
|
|
51
|
+
members.some(
|
|
52
|
+
(member: boolean[]): boolean =>
|
|
53
|
+
member[i]! && member[j]! && member[k]!,
|
|
54
|
+
)
|
|
55
|
+
)
|
|
56
|
+
continue;
|
|
57
|
+
const raw: IAutoMovieVector3 = Vector3.cross(
|
|
58
|
+
Vector3.subtract(points[j]!, points[i]!),
|
|
59
|
+
Vector3.subtract(points[k]!, points[i]!),
|
|
60
|
+
);
|
|
61
|
+
const area: number = Vector3.length(raw);
|
|
62
|
+
// Collinear or coincident triples span no plane.
|
|
63
|
+
if (!(area > tolerance * extent)) continue;
|
|
64
|
+
let normal: IAutoMovieVector3 = Vector3.scale(raw, 1 / area);
|
|
65
|
+
let offset: number = Vector3.dot(normal, points[i]!);
|
|
66
|
+
let front: boolean = false;
|
|
67
|
+
let back: boolean = false;
|
|
68
|
+
for (const p of points) {
|
|
69
|
+
const d: number = Vector3.dot(normal, p) - offset;
|
|
70
|
+
if (d > tolerance) front = true;
|
|
71
|
+
else if (d < -tolerance) back = true;
|
|
72
|
+
}
|
|
73
|
+
// Points on both sides: an interior plane. Points on neither: the
|
|
74
|
+
// whole set is flat and encloses no volume.
|
|
75
|
+
if (front === back) continue;
|
|
76
|
+
if (front) {
|
|
77
|
+
normal = Vector3.scale(normal, -1);
|
|
78
|
+
offset = -offset;
|
|
79
|
+
}
|
|
80
|
+
const member: boolean[] = points.map(
|
|
81
|
+
(p: IAutoMovieVector3): boolean =>
|
|
82
|
+
Vector3.dot(normal, p) - offset >= -tolerance,
|
|
83
|
+
);
|
|
84
|
+
const loop: number[] = planarLoop(points, member, normal);
|
|
85
|
+
for (const index of loop) used[index] = true;
|
|
86
|
+
members.push(member);
|
|
87
|
+
faces.push({
|
|
88
|
+
normal,
|
|
89
|
+
offset,
|
|
90
|
+
loop: loop.map((index: number): IAutoMovieVector3 => points[index]!),
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
const vertices: IAutoMovieVector3[] = points.filter(
|
|
94
|
+
(_: IAutoMovieVector3, index: number): boolean => used[index]!,
|
|
95
|
+
);
|
|
96
|
+
let centre: IAutoMovieVector3 = { x: 0, y: 0, z: 0 };
|
|
97
|
+
for (const vertex of vertices)
|
|
98
|
+
centre = Vector3.add(centre, Vector3.scale(vertex, 1 / vertices.length));
|
|
99
|
+
let radius: number = 0;
|
|
100
|
+
for (const vertex of vertices)
|
|
101
|
+
radius = Math.max(radius, Vector3.length(Vector3.subtract(vertex, centre)));
|
|
102
|
+
let depth: number = faces.length ? Infinity : 0;
|
|
103
|
+
for (const face of faces)
|
|
104
|
+
depth = Math.min(depth, face.offset - Vector3.dot(face.normal, centre));
|
|
105
|
+
let buried: number = 0;
|
|
106
|
+
if (faces.length)
|
|
107
|
+
for (const p of points) {
|
|
108
|
+
let outermost: number = -Infinity;
|
|
109
|
+
for (const face of faces)
|
|
110
|
+
outermost = Math.max(
|
|
111
|
+
outermost,
|
|
112
|
+
Vector3.dot(face.normal, p) - face.offset,
|
|
113
|
+
);
|
|
114
|
+
buried = Math.max(buried, -outermost);
|
|
115
|
+
}
|
|
116
|
+
const hull: physicalHullFaces.IHull = {
|
|
117
|
+
faces,
|
|
118
|
+
vertices,
|
|
119
|
+
centre,
|
|
120
|
+
radius,
|
|
121
|
+
depth,
|
|
122
|
+
buried,
|
|
123
|
+
tolerance,
|
|
124
|
+
};
|
|
125
|
+
HULLS.set(points, hull);
|
|
126
|
+
return hull;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/** One hull per live points array, released with the array. */
|
|
130
|
+
const HULLS: WeakMap<
|
|
131
|
+
readonly IAutoMovieVector3[],
|
|
132
|
+
physicalHullFaces.IHull
|
|
133
|
+
> = new WeakMap();
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* The indices of the member points on a face's boundary, counter clockwise
|
|
137
|
+
* about the face normal, by Andrew's monotone chain in the face plane.
|
|
138
|
+
*/
|
|
139
|
+
const planarLoop = (
|
|
140
|
+
points: readonly IAutoMovieVector3[],
|
|
141
|
+
member: readonly boolean[],
|
|
142
|
+
normal: IAutoMovieVector3,
|
|
143
|
+
): number[] => {
|
|
144
|
+
const seed: IAutoMovieVector3 =
|
|
145
|
+
Math.abs(normal.x) <= Math.abs(normal.y) &&
|
|
146
|
+
Math.abs(normal.x) <= Math.abs(normal.z)
|
|
147
|
+
? { x: 1, y: 0, z: 0 }
|
|
148
|
+
: Math.abs(normal.y) <= Math.abs(normal.z)
|
|
149
|
+
? { x: 0, y: 1, z: 0 }
|
|
150
|
+
: { x: 0, y: 0, z: 1 };
|
|
151
|
+
const u: IAutoMovieVector3 = Vector3.normalize(Vector3.cross(normal, seed));
|
|
152
|
+
const v: IAutoMovieVector3 = Vector3.cross(normal, u);
|
|
153
|
+
const flat: { index: number; x: number; y: number }[] = [];
|
|
154
|
+
points.forEach((p: IAutoMovieVector3, index: number): void => {
|
|
155
|
+
if (member[index]!)
|
|
156
|
+
flat.push({ index, x: Vector3.dot(p, u), y: Vector3.dot(p, v) });
|
|
157
|
+
});
|
|
158
|
+
flat.sort(
|
|
159
|
+
(
|
|
160
|
+
a: { index: number; x: number; y: number },
|
|
161
|
+
b: { index: number; x: number; y: number },
|
|
162
|
+
): number => a.x - b.x || a.y - b.y,
|
|
163
|
+
);
|
|
164
|
+
const turn = (
|
|
165
|
+
o: { x: number; y: number },
|
|
166
|
+
a: { x: number; y: number },
|
|
167
|
+
b: { x: number; y: number },
|
|
168
|
+
): number => (a.x - o.x) * (b.y - o.y) - (a.y - o.y) * (b.x - o.x);
|
|
169
|
+
const chain = (
|
|
170
|
+
ordered: { index: number; x: number; y: number }[],
|
|
171
|
+
): { index: number; x: number; y: number }[] => {
|
|
172
|
+
const out: { index: number; x: number; y: number }[] = [];
|
|
173
|
+
for (const p of ordered) {
|
|
174
|
+
while (
|
|
175
|
+
out.length >= 2 &&
|
|
176
|
+
turn(out[out.length - 2]!, out[out.length - 1]!, p) <= 0
|
|
177
|
+
)
|
|
178
|
+
out.pop();
|
|
179
|
+
out.push(p);
|
|
180
|
+
}
|
|
181
|
+
out.pop();
|
|
182
|
+
return out;
|
|
183
|
+
};
|
|
184
|
+
return [...chain(flat), ...chain([...flat].reverse())].map(
|
|
185
|
+
(p: { index: number; x: number; y: number }): number => p.index,
|
|
186
|
+
);
|
|
187
|
+
};
|
|
188
|
+
|
|
189
|
+
/**
|
|
190
|
+
* The hull record and its face.
|
|
191
|
+
*
|
|
192
|
+
* @evidence contracts/development/common.md#meaningful-documentation Names the two records the hull owner returns; each member states its frame, unit and orientation.
|
|
193
|
+
* @evidence contracts/development/design.md#principled-representation A convex polytope as its supporting half-spaces with their boundary loops, the form every distance, clipping and integration consumer needs; no optional member.
|
|
194
|
+
* @evidence contracts/development/design.md#minimal-and-owned-surface Owned by `physicalHullFaces`; each member is read by a hull consumer in this package (nearest query, bounds, mass, erosion, validation).
|
|
195
|
+
* @evidence contracts/development/design.md#prohibited-design-shortcuts No `any`, `unknown`, index signature or cast; it repeats no type another owner declares.
|
|
196
|
+
*/
|
|
197
|
+
export namespace physicalHullFaces {
|
|
198
|
+
/** One supporting plane of the hull with its boundary. */
|
|
199
|
+
export interface IFace {
|
|
200
|
+
/** Outward unit normal, shape-local. */ normal: IAutoMovieVector3;
|
|
201
|
+
/** The plane's distance from the origin along the normal, metres. */ offset: number;
|
|
202
|
+
/** Boundary vertices, counter clockwise seen from outside. */ loop: IAutoMovieVector3[];
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
/** The hull of one point set. */
|
|
206
|
+
export interface IHull {
|
|
207
|
+
/** Every face; empty when the points span no volume. */ faces: IFace[];
|
|
208
|
+
/** The points that are corners of some face. */ vertices: IAutoMovieVector3[];
|
|
209
|
+
/** Mean of the vertices, shape-local metres. */ centre: IAutoMovieVector3;
|
|
210
|
+
/** Radius about `centre` of a sphere containing the hull, metres. */ radius: number;
|
|
211
|
+
/** Least distance from `centre` to a face plane, metres: a sphere of this radius about `centre` lies inside the hull. Zero without faces. */ depth: number;
|
|
212
|
+
/** Greatest depth of any input point below the surface, metres: at most `tolerance` when every point lies on the surface. */ buried: number;
|
|
213
|
+
/** The coplanarity tolerance used, metres: 1e-9 of the extent. */ tolerance: number;
|
|
214
|
+
}
|
|
215
|
+
}
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
import type {
|
|
2
|
+
IAutoMovieQuaternion,
|
|
3
|
+
IAutoMovieVector3,
|
|
4
|
+
} from "@automovie/interface";
|
|
5
|
+
|
|
6
|
+
import { Vector3 } from "../math/Vector3";
|
|
7
|
+
import { physicalHullFaces } from "./physicalHullFaces";
|
|
8
|
+
import { physicalPrincipalAxes } from "./physicalPrincipalAxes";
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* The volume, centroid and principal inertia of the uniform solid convex
|
|
12
|
+
* hull of a point set.
|
|
13
|
+
*
|
|
14
|
+
* Each face is fanned into triangles and each triangle joined to the hull's
|
|
15
|
+
* mean vertex, so the solid is a sum of tetrahedra. A tetrahedron's volume
|
|
16
|
+
* and centroid are closed forms, and its second moments are exact under the
|
|
17
|
+
* quadrature that weighs each vertex by a twentieth of the volume and the
|
|
18
|
+
* centroid by four fifths. The summed second moments move to the centroid by
|
|
19
|
+
* the parallel-axis theorem and are diagonalized by `physicalPrincipalAxes`.
|
|
20
|
+
*
|
|
21
|
+
* @param points Shape-local points, metres, spanning a volume.
|
|
22
|
+
* @returns The volume in cubic metres, the centroid in the points' frame, and
|
|
23
|
+
* the principal moments per unit mass (square metres, ascending) with the
|
|
24
|
+
* rotation from the principal frame to the points' frame.
|
|
25
|
+
* @throws {Error} When the points span no volume.
|
|
26
|
+
*
|
|
27
|
+
* @evidence contracts/development/common.md#meaningful-documentation States the decomposition, the exact quadrature, the frame of each result and that the moments are per unit mass.
|
|
28
|
+
* @evidence contracts/development/implementation.md#principled-implementation Polyhedral mass properties by tetrahedral decomposition (Mirtich 1996, Fast and accurate computation of polyhedral mass properties; Tonon 2004, Explicit exact formulas for the 3-D tetrahedron inertia tensor): the degree-two quadrature with weights 1/20 at the four vertices and 4/5 at the centroid integrates every product of two coordinates exactly.
|
|
29
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure Reads the faces from `physicalHullFaces` and the diagonalization from `physicalPrincipalAxes`; it owns only the integration.
|
|
30
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No tolerance and no sampling: the sums are exact for the polytope; the non-null assertions index loops and 3x3 rows the function bounds itself.
|
|
31
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Linear in the hull's triangle count, a few dozen for a body module, once per profile build.
|
|
32
|
+
* @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A profile integrates each hull once while it is built; the face search behind it is already shared by `physicalHullFaces`.
|
|
33
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps nothing between calls; its temporaries die with the call.
|
|
34
|
+
*/
|
|
35
|
+
export function physicalHullMass(points: readonly IAutoMovieVector3[]): {
|
|
36
|
+
volume: number;
|
|
37
|
+
centerOfMass: IAutoMovieVector3;
|
|
38
|
+
inertia: IAutoMovieVector3;
|
|
39
|
+
inertiaRotation: IAutoMovieQuaternion;
|
|
40
|
+
} {
|
|
41
|
+
const hull: physicalHullFaces.IHull = physicalHullFaces(points);
|
|
42
|
+
const axes: ("x" | "y" | "z")[] = ["x", "y", "z"];
|
|
43
|
+
let volume: number = 0;
|
|
44
|
+
let moment: IAutoMovieVector3 = { x: 0, y: 0, z: 0 };
|
|
45
|
+
const second: number[][] = [
|
|
46
|
+
[0, 0, 0],
|
|
47
|
+
[0, 0, 0],
|
|
48
|
+
[0, 0, 0],
|
|
49
|
+
];
|
|
50
|
+
for (const face of hull.faces)
|
|
51
|
+
for (let index: number = 1; index + 1 < face.loop.length; index++) {
|
|
52
|
+
const a: IAutoMovieVector3 = Vector3.subtract(face.loop[0]!, hull.centre);
|
|
53
|
+
const b: IAutoMovieVector3 = Vector3.subtract(
|
|
54
|
+
face.loop[index]!,
|
|
55
|
+
hull.centre,
|
|
56
|
+
);
|
|
57
|
+
const c: IAutoMovieVector3 = Vector3.subtract(
|
|
58
|
+
face.loop[index + 1]!,
|
|
59
|
+
hull.centre,
|
|
60
|
+
);
|
|
61
|
+
const v: number = Vector3.dot(a, Vector3.cross(b, c)) / 6;
|
|
62
|
+
const s: IAutoMovieVector3 = Vector3.add(Vector3.add(a, b), c);
|
|
63
|
+
volume += v;
|
|
64
|
+
moment = Vector3.add(moment, Vector3.scale(s, v / 4));
|
|
65
|
+
for (let row: number = 0; row < 3; row++)
|
|
66
|
+
for (let column: number = 0; column < 3; column++)
|
|
67
|
+
second[row]![column]! +=
|
|
68
|
+
(v / 20) *
|
|
69
|
+
(a[axes[row]!] * a[axes[column]!] +
|
|
70
|
+
b[axes[row]!] * b[axes[column]!] +
|
|
71
|
+
c[axes[row]!] * c[axes[column]!] +
|
|
72
|
+
s[axes[row]!] * s[axes[column]!]);
|
|
73
|
+
}
|
|
74
|
+
if (!(volume > 0)) throw new Error("A hull must span a volume");
|
|
75
|
+
const offset: IAutoMovieVector3 = Vector3.scale(moment, 1 / volume);
|
|
76
|
+
// Second moments about the centroid per unit mass, then the inertia tensor
|
|
77
|
+
// as their trace on the diagonal less the moments themselves.
|
|
78
|
+
for (let row: number = 0; row < 3; row++)
|
|
79
|
+
for (let column: number = 0; column < 3; column++)
|
|
80
|
+
second[row]![column] =
|
|
81
|
+
second[row]![column]! / volume -
|
|
82
|
+
offset[axes[row]!] * offset[axes[column]!];
|
|
83
|
+
const trace: number = second[0]![0]! + second[1]![1]! + second[2]![2]!;
|
|
84
|
+
const tensor: number[][] = second.map(
|
|
85
|
+
(line: number[], row: number): number[] =>
|
|
86
|
+
line.map(
|
|
87
|
+
(value: number, column: number): number =>
|
|
88
|
+
(row === column ? trace : 0) - value,
|
|
89
|
+
),
|
|
90
|
+
);
|
|
91
|
+
const principal: ReturnType<typeof physicalPrincipalAxes> =
|
|
92
|
+
physicalPrincipalAxes(tensor);
|
|
93
|
+
return {
|
|
94
|
+
volume,
|
|
95
|
+
centerOfMass: Vector3.add(hull.centre, offset),
|
|
96
|
+
inertia: principal.moments,
|
|
97
|
+
inertiaRotation: principal.rotation,
|
|
98
|
+
};
|
|
99
|
+
}
|
|
@@ -0,0 +1,210 @@
|
|
|
1
|
+
import type { IAutoMovieVector3 } from "@automovie/interface";
|
|
2
|
+
|
|
3
|
+
import { physicalHullFaces } from "./physicalHullFaces";
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* The nearest surface point of a convex hull to a point in the hull's own
|
|
7
|
+
* frame, with the outward normal there and the signed distance, negative
|
|
8
|
+
* inside.
|
|
9
|
+
*
|
|
10
|
+
* Inside, the nearest surface point is the projection onto the face whose
|
|
11
|
+
* plane is closest, and the normal is that face's. Outside, it is the
|
|
12
|
+
* projection onto a facing face when that projection falls within the face's
|
|
13
|
+
* loop, and otherwise the nearest point on the edges of the facing faces;
|
|
14
|
+
* the normal then points from the surface point to the query point.
|
|
15
|
+
*
|
|
16
|
+
* The planes and the edges are read from flat arrays built once per hull: a
|
|
17
|
+
* projection falls within a face's loop when it lies on the inner side of
|
|
18
|
+
* each edge, which is the sign of one product with the edge's inward
|
|
19
|
+
* direction in the face (the face normal crossed with the edge), as the
|
|
20
|
+
* query point and its projection differ along the normal only.
|
|
21
|
+
*
|
|
22
|
+
* @param points The hull's shape-local points, metres, spanning a volume.
|
|
23
|
+
* @param p The query point in the same frame.
|
|
24
|
+
* @returns The signed distance in metres, the surface point and the outward
|
|
25
|
+
* unit normal, both in the points' frame.
|
|
26
|
+
* @throws {Error} When the points span no volume.
|
|
27
|
+
*
|
|
28
|
+
* @evidence contracts/development/common.md#meaningful-documentation States both cases, which feature gives the point and the normal in each, the sign, the frame and the flat form the test reads.
|
|
29
|
+
* @evidence contracts/development/implementation.md#principled-implementation The signed distance of a convex polytope from its half-space form (Ericson, Real-Time Collision Detection, section 5.1): the greatest plane distance when no plane is in front, and the Voronoi region of a face or an edge of the facing faces otherwise; a vertex region is the end of an edge. The inner-side test is the edge's triple product with the projection written as one product with the precomputed in-face direction.
|
|
30
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure The single owner of point-to-hull proximity; `physicalShapeNearest` composes it with the shape frame, and `physicalHullSegment` owns the segment. The scalar arithmetic stays inline over typed arrays because the collision probes call it for every probe and shape at every iterate.
|
|
31
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No tolerance widens or narrows the distance; the hull's own coplanarity tolerance only decides when the offset is too short to carry a direction, where the facing plane's normal is exact. The non-null assertions index faces by bounded indices.
|
|
32
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms One pass over the face planes, and outside one product per edge of the facing faces with a nearest point only where the test fails, compared squared with one root at the end; the flat arrays are built once per hull and the plane distances reuse one module buffer.
|
|
33
|
+
* @evidence contracts/development/implementation.md#reuse-equivalent-work The faces come from `physicalHullFaces`, and their flat form is built once per hull and shared by every query through a `WeakMap`.
|
|
34
|
+
* @evidence contracts/development/implementation.md#bound-retention-and-release-resources The `WeakMap` holds one flat form per live hull record and releases it with the hull; the distance buffer grows to the largest hull queried and is overwritten by each call.
|
|
35
|
+
*/
|
|
36
|
+
export function physicalHullNearest(
|
|
37
|
+
points: readonly IAutoMovieVector3[],
|
|
38
|
+
p: IAutoMovieVector3,
|
|
39
|
+
): { distance: number; point: IAutoMovieVector3; normal: IAutoMovieVector3 } {
|
|
40
|
+
const hull: physicalHullFaces.IHull = physicalHullFaces(points);
|
|
41
|
+
if (!hull.faces.length) throw new Error("A hull must span a volume");
|
|
42
|
+
const flat: IFlat = flattened(hull);
|
|
43
|
+
const planes: Float64Array = flat.planes;
|
|
44
|
+
const count: number = hull.faces.length;
|
|
45
|
+
if (DISTANCES.length < count) DISTANCES = new Float64Array(count);
|
|
46
|
+
const distances: Float64Array = DISTANCES;
|
|
47
|
+
const px: number = p.x;
|
|
48
|
+
const py: number = p.y;
|
|
49
|
+
const pz: number = p.z;
|
|
50
|
+
let deepest: number = 0;
|
|
51
|
+
let depth: number = -Infinity;
|
|
52
|
+
for (let f: number = 0; f < count; f++) {
|
|
53
|
+
const d: number =
|
|
54
|
+
planes[4 * f]! * px +
|
|
55
|
+
planes[4 * f + 1]! * py +
|
|
56
|
+
planes[4 * f + 2]! * pz -
|
|
57
|
+
planes[4 * f + 3]!;
|
|
58
|
+
distances[f] = d;
|
|
59
|
+
if (d > depth) {
|
|
60
|
+
depth = d;
|
|
61
|
+
deepest = f;
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
const outward: IAutoMovieVector3 = hull.faces[deepest]!.normal;
|
|
65
|
+
if (depth <= 0)
|
|
66
|
+
return {
|
|
67
|
+
distance: depth,
|
|
68
|
+
point: {
|
|
69
|
+
x: px - depth * outward.x,
|
|
70
|
+
y: py - depth * outward.y,
|
|
71
|
+
z: pz - depth * outward.z,
|
|
72
|
+
},
|
|
73
|
+
normal: outward,
|
|
74
|
+
};
|
|
75
|
+
const edges: Float64Array = flat.edges;
|
|
76
|
+
let least: number = Infinity;
|
|
77
|
+
let bx: number = 0;
|
|
78
|
+
let by: number = 0;
|
|
79
|
+
let bz: number = 0;
|
|
80
|
+
for (let f: number = 0; f < count; f++) {
|
|
81
|
+
const d: number = distances[f]!;
|
|
82
|
+
if (!(d > 0)) continue;
|
|
83
|
+
let within: boolean = true;
|
|
84
|
+
for (let e: number = flat.starts[f]!; e < flat.starts[f + 1]!; e++) {
|
|
85
|
+
const o: number = EDGE * e;
|
|
86
|
+
// The projection is on the inner side of a counter clockwise edge.
|
|
87
|
+
if (
|
|
88
|
+
edges[o + 7]! * px +
|
|
89
|
+
edges[o + 8]! * py +
|
|
90
|
+
edges[o + 9]! * pz -
|
|
91
|
+
edges[o + 10]! >=
|
|
92
|
+
0
|
|
93
|
+
)
|
|
94
|
+
continue;
|
|
95
|
+
within = false;
|
|
96
|
+
const fx: number = edges[o]!;
|
|
97
|
+
const fy: number = edges[o + 1]!;
|
|
98
|
+
const fz: number = edges[o + 2]!;
|
|
99
|
+
const ex: number = edges[o + 3]!;
|
|
100
|
+
const ey: number = edges[o + 4]!;
|
|
101
|
+
const ez: number = edges[o + 5]!;
|
|
102
|
+
const along: number = Math.min(
|
|
103
|
+
1,
|
|
104
|
+
Math.max(
|
|
105
|
+
0,
|
|
106
|
+
((px - fx) * ex + (py - fy) * ey + (pz - fz) * ez) / edges[o + 6]!,
|
|
107
|
+
),
|
|
108
|
+
);
|
|
109
|
+
const cx: number = fx + ex * along;
|
|
110
|
+
const cy: number = fy + ey * along;
|
|
111
|
+
const cz: number = fz + ez * along;
|
|
112
|
+
const gap: number =
|
|
113
|
+
(px - cx) * (px - cx) + (py - cy) * (py - cy) + (pz - cz) * (pz - cz);
|
|
114
|
+
if (gap < least) {
|
|
115
|
+
least = gap;
|
|
116
|
+
bx = cx;
|
|
117
|
+
by = cy;
|
|
118
|
+
bz = cz;
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
if (within) {
|
|
122
|
+
const n: IAutoMovieVector3 = hull.faces[f]!.normal;
|
|
123
|
+
return {
|
|
124
|
+
distance: d,
|
|
125
|
+
point: { x: px - d * n.x, y: py - d * n.y, z: pz - d * n.z },
|
|
126
|
+
normal: d > hull.tolerance ? { x: n.x, y: n.y, z: n.z } : outward,
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
const best: number = Math.sqrt(least);
|
|
131
|
+
return {
|
|
132
|
+
distance: best,
|
|
133
|
+
point: { x: bx, y: by, z: bz },
|
|
134
|
+
normal:
|
|
135
|
+
best > hull.tolerance
|
|
136
|
+
? { x: (px - bx) / best, y: (py - by) / best, z: (pz - bz) / best }
|
|
137
|
+
: outward,
|
|
138
|
+
};
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
/** The numbers stored per edge. */
|
|
142
|
+
const EDGE: number = 11;
|
|
143
|
+
|
|
144
|
+
/**
|
|
145
|
+
* A hull's planes and edges as flat arrays: per face its normal and offset;
|
|
146
|
+
* per edge, in its face's loop order, its start, its vector, its squared
|
|
147
|
+
* length, its inward direction in the face (normal cross edge) and that
|
|
148
|
+
* direction's product with the start; `starts` bounds each face's edges.
|
|
149
|
+
*/
|
|
150
|
+
interface IFlat {
|
|
151
|
+
/** Four numbers per face: the normal and the offset. */ planes: Float64Array;
|
|
152
|
+
/** Each face's first edge, and the count of edges at the end. */ starts: Int32Array;
|
|
153
|
+
/** `EDGE` numbers per edge. */ edges: Float64Array;
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
/** Each hull's flat form, released with the hull. */
|
|
157
|
+
const FLATS: WeakMap<physicalHullFaces.IHull, IFlat> = new WeakMap();
|
|
158
|
+
|
|
159
|
+
/** The plane distances of the current query, reused by every call. */
|
|
160
|
+
let DISTANCES: Float64Array = new Float64Array(64);
|
|
161
|
+
|
|
162
|
+
/** A hull's flat form, built once. */
|
|
163
|
+
const flattened = (hull: physicalHullFaces.IHull): IFlat => {
|
|
164
|
+
const known: IFlat | undefined = FLATS.get(hull);
|
|
165
|
+
if (known !== undefined) return known;
|
|
166
|
+
const planes: Float64Array = new Float64Array(4 * hull.faces.length);
|
|
167
|
+
const starts: Int32Array = new Int32Array(hull.faces.length + 1);
|
|
168
|
+
const total: number = hull.faces.reduce(
|
|
169
|
+
(sum: number, face: physicalHullFaces.IFace): number =>
|
|
170
|
+
sum + face.loop.length,
|
|
171
|
+
0,
|
|
172
|
+
);
|
|
173
|
+
const edges: Float64Array = new Float64Array(EDGE * total);
|
|
174
|
+
let e: number = 0;
|
|
175
|
+
hull.faces.forEach((face: physicalHullFaces.IFace, f: number): void => {
|
|
176
|
+
const n: IAutoMovieVector3 = face.normal;
|
|
177
|
+
planes.set([n.x, n.y, n.z, face.offset], 4 * f);
|
|
178
|
+
starts[f] = e;
|
|
179
|
+
face.loop.forEach((from: IAutoMovieVector3, i: number): void => {
|
|
180
|
+
const to: IAutoMovieVector3 = face.loop[(i + 1) % face.loop.length]!;
|
|
181
|
+
const ex: number = to.x - from.x;
|
|
182
|
+
const ey: number = to.y - from.y;
|
|
183
|
+
const ez: number = to.z - from.z;
|
|
184
|
+
const mx: number = n.y * ez - n.z * ey;
|
|
185
|
+
const my: number = n.z * ex - n.x * ez;
|
|
186
|
+
const mz: number = n.x * ey - n.y * ex;
|
|
187
|
+
edges.set(
|
|
188
|
+
[
|
|
189
|
+
from.x,
|
|
190
|
+
from.y,
|
|
191
|
+
from.z,
|
|
192
|
+
ex,
|
|
193
|
+
ey,
|
|
194
|
+
ez,
|
|
195
|
+
ex * ex + ey * ey + ez * ez,
|
|
196
|
+
mx,
|
|
197
|
+
my,
|
|
198
|
+
mz,
|
|
199
|
+
mx * from.x + my * from.y + mz * from.z,
|
|
200
|
+
],
|
|
201
|
+
EDGE * e,
|
|
202
|
+
);
|
|
203
|
+
e++;
|
|
204
|
+
});
|
|
205
|
+
});
|
|
206
|
+
starts[hull.faces.length] = e;
|
|
207
|
+
const flat: IFlat = { planes, starts, edges };
|
|
208
|
+
FLATS.set(hull, flat);
|
|
209
|
+
return flat;
|
|
210
|
+
};
|