@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
package/src/rom/clampJointRom.ts
CHANGED
|
@@ -2,8 +2,13 @@ import {
|
|
|
2
2
|
IAutoMovieAngleRange,
|
|
3
3
|
IAutoMovieJointConstraint,
|
|
4
4
|
IAutoMovieJointPose,
|
|
5
|
+
IAutoMovieQuaternion,
|
|
5
6
|
} from "@automovie/interface";
|
|
6
7
|
|
|
8
|
+
import { IAutoMovieResolvedJointAngles } from "../kinematics/IAutoMovieResolvedJointAngles";
|
|
9
|
+
import { decomposeJointRotation } from "../kinematics/decomposeJointRotation";
|
|
10
|
+
import { jointToQuaternion } from "../kinematics/jointToQuaternion";
|
|
11
|
+
import { swingTwistRange } from "../kinematics/swingTwistRange";
|
|
7
12
|
import { swingConeBlend } from "./swingConeBlend";
|
|
8
13
|
|
|
9
14
|
const clampAxis: (
|
|
@@ -26,21 +31,70 @@ const clampAxis: (
|
|
|
26
31
|
/**
|
|
27
32
|
* Project one joint into admitted axis intervals, preserving null rest and forcing specified immobile axes to zero. Specified nonfinite angles first become neutral. A swing cap blends toward the box point nearest neutral; unrestricted multi-turn overrides are outside the bisection's monotonic-segment guarantee.
|
|
28
33
|
*
|
|
34
|
+
* A ball joint whose constraint declares `swingTwist`, on a bone with axes in its frame (the caller's `rig`, or the humanoid tables' through `swingTwistRange.of`), is instead brought into its range as a rotation (`swingTwistRange.project`: its direction along its great circle from rest, its twist clamped) and read back in the reading the three-angle box prefers; a joint already inside comes back as given.
|
|
35
|
+
*
|
|
36
|
+
* @param joint The joint's clinical angles.
|
|
37
|
+
* @param constraint Its resolved range.
|
|
38
|
+
* @param rig The bone's frame as the caller's rig resolves it; the humanoid tables' when absent.
|
|
39
|
+
* @returns The joint in range.
|
|
40
|
+
*
|
|
29
41
|
* @evidence contracts/development/implementation.md#principled-implementation Project finite-or-repaired axes into admitted intervals, force specified immobile axes to zero, preserve null rest and blend swing toward the box-nearest-neutral point.
|
|
30
42
|
* @evidence contracts/development/implementation.md#clear-and-simple-structure Axis projection and combined swing are distinct constraints; swingConeBlend supplies fixed bisection and the result preserves bone identity.
|
|
31
|
-
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Specified nonfinite angles reset to neutral before box projection; unrestricted multi-turn overrides can violate swing monotonicity, so universal box/cone projection is not certified.
|
|
43
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Specified nonfinite angles reset to neutral before box projection; unrestricted multi-turn overrides can violate swing monotonicity, so universal box/cone projection is not certified. For a swing-twist joint the edge tolerance `EDGE` (a millionth of a degree) only absorbs the rounding of reading a rotation back into angles, so a joint on the edge clamps to itself; it hides no real overshoot.
|
|
32
44
|
* @evidence contracts/development/common.md#meaningful-documentation Docs identify nonfinite repair, null/immobile distinction, degrees and finite ordered constraint premise with remaining cone limitation.
|
|
33
|
-
* @evidence contracts/development/implementation.md#efficient-algorithms Three clamps and at most forty fixed swing iterations cost constant work and one fixed-size result.
|
|
45
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Three clamps and at most forty fixed swing iterations cost constant work and one fixed-size result. A swing-twist joint costs one overshoot test and, only outside the range, one projection and one decomposition, reading the radius table that `swingTwistRange` builds once per constraint and basis and caches.
|
|
34
46
|
* @evidence contracts/development/implementation.md#reuse-equivalent-work Targeted/full-pose clamps reuse the same joint owner and borrow constraints; changed angles need new projection.
|
|
35
47
|
* @evidence contracts/development/implementation.md#bound-retention-and-release-resources The caller owns a fresh joint record and no pose population, native handle or task is retained.
|
|
36
48
|
*/
|
|
37
49
|
export const clampJointRom: (
|
|
38
50
|
joint: IAutoMovieJointPose,
|
|
39
51
|
constraint: IAutoMovieJointConstraint,
|
|
52
|
+
rig?: swingTwistRange.IJoint,
|
|
40
53
|
) => IAutoMovieJointPose = (
|
|
41
54
|
joint: IAutoMovieJointPose,
|
|
42
55
|
constraint: IAutoMovieJointConstraint,
|
|
56
|
+
rig?: swingTwistRange.IJoint,
|
|
43
57
|
): IAutoMovieJointPose => {
|
|
58
|
+
// A ball joint gated by swing and twist is brought into its range as a
|
|
59
|
+
// rotation (`swingTwistRange.project`) and read back in the reading the
|
|
60
|
+
// three-angle box prefers.
|
|
61
|
+
const range: swingTwistRange.IJoint | undefined =
|
|
62
|
+
constraint.swingTwist === undefined || constraint.swingTwist === null
|
|
63
|
+
? undefined
|
|
64
|
+
: (rig ?? swingTwistRange.of(joint.bone));
|
|
65
|
+
if (range !== undefined) {
|
|
66
|
+
// A non-finite angle first becomes its rest, as on every other joint.
|
|
67
|
+
const finite: (value: number | null) => number | null = (
|
|
68
|
+
value: number | null,
|
|
69
|
+
): number | null => (value === null || Number.isFinite(value) ? value : 0);
|
|
70
|
+
const sanitized: IAutoMovieJointPose = {
|
|
71
|
+
bone: joint.bone,
|
|
72
|
+
flexion: finite(joint.flexion),
|
|
73
|
+
abduction: finite(joint.abduction),
|
|
74
|
+
twist: finite(joint.twist),
|
|
75
|
+
};
|
|
76
|
+
const q: IAutoMovieQuaternion = jointToQuaternion(
|
|
77
|
+
sanitized,
|
|
78
|
+
range.axes,
|
|
79
|
+
range.frame,
|
|
80
|
+
);
|
|
81
|
+
// A joint on the range's edge within a rounding error is inside, so a
|
|
82
|
+
// clamped joint clamps to itself.
|
|
83
|
+
if (swingTwistRange.overshoot(q, constraint, range) <= EDGE)
|
|
84
|
+
return sanitized;
|
|
85
|
+
const read: IAutoMovieResolvedJointAngles = decomposeJointRotation(
|
|
86
|
+
swingTwistRange.project(q, constraint, range),
|
|
87
|
+
range.axes,
|
|
88
|
+
range.frame,
|
|
89
|
+
{ bone: joint.bone, constraint: { ...constraint, swingTwist: null } },
|
|
90
|
+
);
|
|
91
|
+
return {
|
|
92
|
+
bone: joint.bone,
|
|
93
|
+
flexion: read.flexion,
|
|
94
|
+
abduction: read.abduction,
|
|
95
|
+
twist: read.twist,
|
|
96
|
+
};
|
|
97
|
+
}
|
|
44
98
|
const flexion: number | null = clampAxis(joint.flexion, constraint.flexion);
|
|
45
99
|
const abduction: number | null = clampAxis(
|
|
46
100
|
joint.abduction,
|
|
@@ -85,6 +139,9 @@ export const clampJointRom: (
|
|
|
85
139
|
return { bone: joint.bone, flexion, abduction, twist };
|
|
86
140
|
};
|
|
87
141
|
|
|
142
|
+
/** How far past a swing-twist range a joint may lie and count as on its edge, degrees: a millionth, above the rounding of a rotation read back into angles. */
|
|
143
|
+
const EDGE: number = 1e-6;
|
|
144
|
+
|
|
88
145
|
/**
|
|
89
146
|
* The point of `allowed` closest to neutral: neutral itself when the range
|
|
90
147
|
* brackets it, else the nearer bound. This is the swing cone's pull target: the
|
|
@@ -5,13 +5,14 @@ import {
|
|
|
5
5
|
IAutoMovieSkeleton,
|
|
6
6
|
} from "@automovie/interface";
|
|
7
7
|
|
|
8
|
+
import { swingTwistRange } from "../kinematics/swingTwistRange";
|
|
8
9
|
import { clampJointRom } from "./clampJointRom";
|
|
9
10
|
import { getConstraint } from "./getConstraint";
|
|
10
11
|
|
|
11
12
|
/**
|
|
12
13
|
* Clamp one joint using its skeleton override, otherwise the humanoid default table. Unconstrained joints return by identity. This targeted seam lets derived contact/retarget corrections leave authored neighboring joints alone.
|
|
13
14
|
*
|
|
14
|
-
* @evidence contracts/development/implementation.md#principled-implementation Find the skeleton bone and prefer a nonnull override over the humanoid table, returning the original unconstrained joint or a new clamped record.
|
|
15
|
+
* @evidence contracts/development/implementation.md#principled-implementation Find the skeleton bone and prefer a nonnull override over the humanoid table, returning the original unconstrained joint or a new clamped record; a swing-twist joint is clamped in the frame the skeleton resolves for the bone (`swingTwistRange.of`).
|
|
15
16
|
* @evidence contracts/development/implementation.md#clear-and-simple-structure A one-joint seam permits selective retarget/contact correction without changing authored neighbors.
|
|
16
17
|
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Missing bones retain named-default fallback; this does not establish skeleton membership, identity or physical convergence.
|
|
17
18
|
* @evidence contracts/development/common.md#meaningful-documentation Docs state precedence, borrowed unconstrained result and targeted use, with numerical clamp limitations delegated.
|
|
@@ -19,19 +20,55 @@ import { getConstraint } from "./getConstraint";
|
|
|
19
20
|
* @evidence contracts/development/implementation.md#reuse-equivalent-work All consumers share getConstraint precedence; repeated standalone bone lookup remains uncached over mutable skeleton contents.
|
|
20
21
|
* @evidence contracts/development/implementation.md#bound-retention-and-release-resources The caller owns new joints and borrows unchanged joints/constraints, with no retained index, handle or task.
|
|
21
22
|
*/
|
|
22
|
-
export
|
|
23
|
+
export function clampJointToSkeleton(
|
|
23
24
|
joint: IAutoMovieJointPose,
|
|
24
25
|
skeleton: IAutoMovieSkeleton,
|
|
25
|
-
)
|
|
26
|
-
joint
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
26
|
+
): IAutoMovieJointPose {
|
|
27
|
+
return clampJointToSkeleton.of(joint.bone, skeleton)(joint);
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* Companion of {@link clampJointToSkeleton}.
|
|
32
|
+
*
|
|
33
|
+
* @evidence contracts/development/common.md#meaningful-documentation States what the companion holds.
|
|
34
|
+
* @evidence contracts/development/design.md#principled-representation One bone's clamp, resolved once.
|
|
35
|
+
* @evidence contracts/development/design.md#minimal-and-owned-surface One function.
|
|
36
|
+
* @evidence contracts/development/design.md#prohibited-design-shortcuts The clamp is `clampJointToSkeleton`'s own, with its lookup taken out of the call.
|
|
37
|
+
*/
|
|
38
|
+
export namespace clampJointToSkeleton {
|
|
39
|
+
/**
|
|
40
|
+
* One bone's clamp under a skeleton, its override or the humanoid table and
|
|
41
|
+
* its swing-twist frame resolved once, for a caller that clamps the same
|
|
42
|
+
* bone many times within one solve (a sweep's candidates): each call clamps
|
|
43
|
+
* exactly as `clampJointToSkeleton` does with the skeleton as it stood when
|
|
44
|
+
* the clamp was made. Nothing is kept beyond the closure, since a skeleton's
|
|
45
|
+
* contents may change between solves.
|
|
46
|
+
*
|
|
47
|
+
* @param bone The bone.
|
|
48
|
+
* @param skeleton The skeleton.
|
|
49
|
+
* @returns The clamp of a joint of that bone.
|
|
50
|
+
*/
|
|
51
|
+
export function of(
|
|
52
|
+
bone: IAutoMovieJointPose["bone"],
|
|
53
|
+
skeleton: IAutoMovieSkeleton,
|
|
54
|
+
): (joint: IAutoMovieJointPose) => IAutoMovieJointPose {
|
|
55
|
+
const found: IAutoMovieBone | undefined = skeleton.bones.find(
|
|
56
|
+
(b: IAutoMovieBone): boolean => b.bone === bone,
|
|
57
|
+
);
|
|
58
|
+
const constraint: IAutoMovieJointConstraint | null = getConstraint(
|
|
59
|
+
bone,
|
|
60
|
+
found?.constraint ?? null,
|
|
61
|
+
);
|
|
62
|
+
if (constraint === null)
|
|
63
|
+
return (joint: IAutoMovieJointPose): IAutoMovieJointPose => joint;
|
|
64
|
+
|
|
65
|
+
// A joint gated by swing and twist is read in the frame this skeleton
|
|
66
|
+
// resolves for its bone, the frame its angles are written in.
|
|
67
|
+
const rig: swingTwistRange.IJoint | undefined = swingTwistRange.of(
|
|
68
|
+
bone,
|
|
69
|
+
skeleton,
|
|
70
|
+
);
|
|
71
|
+
return (joint: IAutoMovieJointPose): IAutoMovieJointPose =>
|
|
72
|
+
clampJointRom(joint, constraint, rig);
|
|
73
|
+
}
|
|
74
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The ankle's dorsiflexion limits, degrees, each with the condition it holds
|
|
3
|
+
* under.
|
|
4
|
+
*
|
|
5
|
+
* - `loaded`: a foot bearing the body's weight, the tibia leaning over the
|
|
6
|
+
* flat foot: 39, the mean maximal weight-bearing lunge of healthy adults
|
|
7
|
+
* measured by inclinometer on the tibia (38.8 +- 5.2 degrees, Konor, Morton,
|
|
8
|
+
* Eckerson and Grindstaff 2012, Int J Sports Phys Ther 7(3):279), to the
|
|
9
|
+
* degree. The range table's foot rows (`DEFAULT_HUMANOID_ROM`) hold it, the
|
|
10
|
+
* most the joint reaches under any condition.
|
|
11
|
+
* - `unloaded`: a foot bearing no weight: 20, the passive non-weight-bearing
|
|
12
|
+
* norm (the AAOS norms as relayed, dorsiflexion 20 and plantarflexion 50,
|
|
13
|
+
* not checked against a primary source here).
|
|
14
|
+
*
|
|
15
|
+
* A planner or an audit that knows whether a foot bears weight reads the
|
|
16
|
+
* limit of that condition.
|
|
17
|
+
*/
|
|
18
|
+
export const ANKLE_DORSIFLEXION: Readonly<
|
|
19
|
+
Record<"loaded" | "unloaded", number>
|
|
20
|
+
> = { loaded: 39, unloaded: 20 };
|
|
@@ -4,6 +4,8 @@ import {
|
|
|
4
4
|
IAutoMovieJointConstraint,
|
|
5
5
|
} from "@automovie/interface";
|
|
6
6
|
|
|
7
|
+
import { ANKLE_DORSIFLEXION } from "./ANKLE_DORSIFLEXION";
|
|
8
|
+
|
|
7
9
|
const range = (min: number, max: number): IAutoMovieAngleRange => ({
|
|
8
10
|
min,
|
|
9
11
|
max,
|
|
@@ -20,13 +22,80 @@ const ballConstraint = (
|
|
|
20
22
|
abduction: IAutoMovieAngleRange | null,
|
|
21
23
|
twist: IAutoMovieAngleRange | null,
|
|
22
24
|
swingDeg: number,
|
|
23
|
-
|
|
25
|
+
turn?: IAutoMovieAngleRange,
|
|
26
|
+
reach?: number,
|
|
27
|
+
): IAutoMovieJointConstraint => ({
|
|
28
|
+
flexion,
|
|
29
|
+
abduction,
|
|
30
|
+
twist,
|
|
31
|
+
swingDeg,
|
|
32
|
+
...(turn === undefined
|
|
33
|
+
? {}
|
|
34
|
+
: {
|
|
35
|
+
swingTwist: { twist: turn, ...(reach === undefined ? {} : { reach }) },
|
|
36
|
+
}),
|
|
37
|
+
});
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* A finger's metacarpophalangeal joint (the knuckle): flexion 90 and
|
|
41
|
+
* hyperextension 45, abduction 30 to either side, no axial turn. The upper
|
|
42
|
+
* values of the active norms in McGraw-Hill's goniometry table (Prentice,
|
|
43
|
+
* "Rehabilitation Techniques for Sports Medicine and Athletic Training",
|
|
44
|
+
* ch. 8: MCP flexion 85-90, extension 30-45, abduction 20-30); the
|
|
45
|
+
* adduction toward the middle finger mirrors the abduction, provisional (no
|
|
46
|
+
* located source tabulates it apart). A two-freedom joint with no third
|
|
47
|
+
* freedom to read twice, so its box of flexion and abduction is its own
|
|
48
|
+
* coordinate range and needs no swing-twist gate.
|
|
49
|
+
*/
|
|
50
|
+
const KNUCKLE = constraint(range(-45, 90), range(-30, 30), null);
|
|
51
|
+
|
|
52
|
+
/** A finger's proximal interphalangeal joint: a hinge, flexion 0 to 115 (the same table's 100-115). */
|
|
53
|
+
const MIDDLE_JOINT = constraint(range(0, 115), null, null);
|
|
54
|
+
|
|
55
|
+
/** A finger's distal interphalangeal joint: a hinge, flexion 90 and hyperextension 20 (the same table's 80-90 and 20; AAOS 90 as relayed). */
|
|
56
|
+
const END_JOINT = constraint(range(-20, 90), null, null);
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* The thumb's carpometacarpal joint, a saddle, gated by swing and twist.
|
|
60
|
+
* Cooney, Lucca, Chao and Linscheid 1981 (J Bone Joint Surg Am
|
|
61
|
+
* 63:1371-1381) measured total arcs of 53 degrees of flexion-extension, 42
|
|
62
|
+
* of abduction-adduction and 17 of axial rotation on biplane radiographs of
|
|
63
|
+
* 19 subjects. The rig reads the thumb on the hand's basis
|
|
64
|
+
* (`HUMANOID_JOINT_AXES`, "as an approximation"), so its flexion, about the
|
|
65
|
+
* axis across the hand, moves the thumb out of the palm's plane toward the
|
|
66
|
+
* palm: anatomical palmar abduction, the 42-degree arc, from the rest's
|
|
67
|
+
* adducted thumb in the palm's plane (0) to 42. Its abduction, about the
|
|
68
|
+
* palm's normal, swings the thumb within the palm's plane: anatomical
|
|
69
|
+
* flexion-extension, the 53-degree arc, split evenly about the rest
|
|
70
|
+
* (provisional: the rest's place in Cooney's arc is not stated). The axial
|
|
71
|
+
* rotation's 17 degrees are split evenly likewise (provisional).
|
|
72
|
+
*/
|
|
73
|
+
const THUMB_BASE: IAutoMovieJointConstraint = {
|
|
74
|
+
flexion: range(0, 42),
|
|
75
|
+
abduction: range(-26.5, 26.5),
|
|
76
|
+
twist: range(-8.5, 8.5),
|
|
77
|
+
swingTwist: { twist: range(-8.5, 8.5) },
|
|
78
|
+
};
|
|
79
|
+
|
|
80
|
+
/** The thumb's metacarpophalangeal joint: flexion 0 to 55 (the same goniometry table's 50-55); its small abduction has no located norm, so it stays immobile. */
|
|
81
|
+
const THUMB_MIDDLE = constraint(range(0, 55), null, null);
|
|
82
|
+
|
|
83
|
+
/** The thumb's interphalangeal joint: flexion 90 and hyperextension 5 (the same table's 85-90 and 0-5). */
|
|
84
|
+
const THUMB_END = constraint(range(-5, 90), null, null);
|
|
24
85
|
|
|
25
86
|
/**
|
|
26
|
-
*
|
|
27
|
-
*
|
|
87
|
+
* The farthest a shoulder's arm points from the T-pose, degrees, which keeps
|
|
88
|
+
* the rest direction's antipode (the arm pointing through the chest, where
|
|
89
|
+
* the twist has no value) outside the range. Provisional, with a known
|
|
90
|
+
* defect: one radius on every great circle is a generalisation the anatomy
|
|
91
|
+
* does not have. The shoulder's directional limit is a measured cone that
|
|
92
|
+
* varies with the plane of elevation (Engin and Chen 1986, J Biomech Eng
|
|
93
|
+
* 108:215), not reached; the figure is horizontal adduction from 90 degrees
|
|
94
|
+
* of abduction, 130 in Physiotutors' active range of motion norms (IDEA
|
|
95
|
+
* gives 140; Norkin and White tabulate none), and applied elsewhere it
|
|
96
|
+
* clamps a hand wiping the mouth, which reaches 131.
|
|
28
97
|
*/
|
|
29
|
-
const
|
|
98
|
+
const REACH: number = 130;
|
|
30
99
|
|
|
31
100
|
/**
|
|
32
101
|
* Default anatomical range-of-motion table for the normalized humanoid, keyed
|
|
@@ -60,6 +129,34 @@ const FINGER = constraint(range(-20, 100), null, null);
|
|
|
60
129
|
* pure-plane 180° (arm straight overhead) must stay legal, so no cap below 180
|
|
61
130
|
* is possible without rejecting canonical overhead poses. The value documents
|
|
62
131
|
* the sourced anatomical bound rather than gating anything.
|
|
132
|
+
*
|
|
133
|
+
* The shoulders are gated by swing and twist
|
|
134
|
+
* (`IAutoMovieJointConstraint.swingTwist`): the limb may point wherever its
|
|
135
|
+
* flexion and abduction intervals (and the cone) reach, and may turn about
|
|
136
|
+
* its own axis within an interval measured from the rig's rest pose. Their
|
|
137
|
+
* clinical `twist` interval is then a reading only. Read as three angles,
|
|
138
|
+
* the shoulder's twist range is fixed in a frame that turns once about the
|
|
139
|
+
* arm pointing straight ahead, so two arms a fraction of a degree apart there
|
|
140
|
+
* could lie one inside and one far outside it, and an arm on a table with its
|
|
141
|
+
* forearm up (flexion 135, abduction 71) read only 22 degrees of external
|
|
142
|
+
* rotation left. The shoulder's rest is the T-pose, 90 degrees of
|
|
143
|
+
* abduction, where its rotation is measured clinically (external 90,
|
|
144
|
+
* internal 70, as relayed for the AAOS norms and not checked against a
|
|
145
|
+
* primary source here). Measured from that rest, the turn a raised or a
|
|
146
|
+
* lowered arm needs is larger: a hand behind the head reads 128 degrees and
|
|
147
|
+
* a hand clasped behind the back -104 (the reaches of
|
|
148
|
+
* `test_motion_fit_chain_reach`, which the three-angle box admitted). So the
|
|
149
|
+
* interval is [-110, 135], provisional: one interval for every swing, where
|
|
150
|
+
* the anatomical limit depends on the swing (Codman's paradox: the turn a
|
|
151
|
+
* swing adds makes one interval of clinical rotation, internal 70 and external
|
|
152
|
+
* 90 at 90 degrees of abduction, refuse a hand behind the head by 38 degrees
|
|
153
|
+
* and one behind the back by 34). Their swing is capped at `REACH` from the
|
|
154
|
+
* T-pose, so the rest direction's antipode, the arm pointing through the
|
|
155
|
+
* chest, where the twist has no value, lies 50 degrees outside the range. The hips keep the three-angle
|
|
156
|
+
* gate: their twist is proximal, about the rest axis, and measured from rest
|
|
157
|
+
* by swing and twist the turns their box admits run from -106 to 91 degrees
|
|
158
|
+
* (deep flexion with abduction), which no one interval of the clinical 45
|
|
159
|
+
* each way holds: a deadlift's planted feet slid 33.6 mm under it.
|
|
63
160
|
*/
|
|
64
161
|
export const DEFAULT_HUMANOID_ROM: Partial<
|
|
65
162
|
Record<AutoMovieHumanoidBone, IAutoMovieJointConstraint>
|
|
@@ -86,12 +183,16 @@ export const DEFAULT_HUMANOID_ROM: Partial<
|
|
|
86
183
|
range(-30, 180),
|
|
87
184
|
range(-90, 90),
|
|
88
185
|
180,
|
|
186
|
+
range(-110, 135),
|
|
187
|
+
REACH,
|
|
89
188
|
),
|
|
90
189
|
rightUpperArm: ballConstraint(
|
|
91
190
|
range(-60, 180),
|
|
92
191
|
range(-30, 180),
|
|
93
192
|
range(-90, 90),
|
|
94
193
|
180,
|
|
194
|
+
range(-110, 135),
|
|
195
|
+
REACH,
|
|
95
196
|
),
|
|
96
197
|
leftLowerArm: constraint(range(0, 150), null, range(-90, 90)),
|
|
97
198
|
rightLowerArm: constraint(range(0, 150), null, range(-90, 90)),
|
|
@@ -113,40 +214,50 @@ export const DEFAULT_HUMANOID_ROM: Partial<
|
|
|
113
214
|
),
|
|
114
215
|
leftLowerLeg: constraint(range(0, 150), null, null),
|
|
115
216
|
rightLowerLeg: constraint(range(0, 150), null, null),
|
|
116
|
-
|
|
117
|
-
|
|
217
|
+
// A foot's dorsiflexion reaches its loaded limit: a bearing foot is taken
|
|
218
|
+
// that far by the body's weight (`ANKLE_DORSIFLEXION`).
|
|
219
|
+
leftFoot: constraint(
|
|
220
|
+
range(-50, ANKLE_DORSIFLEXION.loaded),
|
|
221
|
+
range(-25, 25),
|
|
222
|
+
null,
|
|
223
|
+
),
|
|
224
|
+
rightFoot: constraint(
|
|
225
|
+
range(-50, ANKLE_DORSIFLEXION.loaded),
|
|
226
|
+
range(-25, 25),
|
|
227
|
+
null,
|
|
228
|
+
),
|
|
118
229
|
leftToes: constraint(range(-40, 80), null, null),
|
|
119
230
|
rightToes: constraint(range(-40, 80), null, null),
|
|
120
231
|
|
|
121
|
-
// ── fingers
|
|
122
|
-
leftThumbMetacarpal:
|
|
123
|
-
leftThumbProximal:
|
|
124
|
-
leftThumbDistal:
|
|
125
|
-
leftIndexProximal:
|
|
126
|
-
leftIndexIntermediate:
|
|
127
|
-
leftIndexDistal:
|
|
128
|
-
leftMiddleProximal:
|
|
129
|
-
leftMiddleIntermediate:
|
|
130
|
-
leftMiddleDistal:
|
|
131
|
-
leftRingProximal:
|
|
132
|
-
leftRingIntermediate:
|
|
133
|
-
leftRingDistal:
|
|
134
|
-
leftLittleProximal:
|
|
135
|
-
leftLittleIntermediate:
|
|
136
|
-
leftLittleDistal:
|
|
137
|
-
rightThumbMetacarpal:
|
|
138
|
-
rightThumbProximal:
|
|
139
|
-
rightThumbDistal:
|
|
140
|
-
rightIndexProximal:
|
|
141
|
-
rightIndexIntermediate:
|
|
142
|
-
rightIndexDistal:
|
|
143
|
-
rightMiddleProximal:
|
|
144
|
-
rightMiddleIntermediate:
|
|
145
|
-
rightMiddleDistal:
|
|
146
|
-
rightRingProximal:
|
|
147
|
-
rightRingIntermediate:
|
|
148
|
-
rightRingDistal:
|
|
149
|
-
rightLittleProximal:
|
|
150
|
-
rightLittleIntermediate:
|
|
151
|
-
rightLittleDistal:
|
|
232
|
+
// ── fingers ──
|
|
233
|
+
leftThumbMetacarpal: THUMB_BASE,
|
|
234
|
+
leftThumbProximal: THUMB_MIDDLE,
|
|
235
|
+
leftThumbDistal: THUMB_END,
|
|
236
|
+
leftIndexProximal: KNUCKLE,
|
|
237
|
+
leftIndexIntermediate: MIDDLE_JOINT,
|
|
238
|
+
leftIndexDistal: END_JOINT,
|
|
239
|
+
leftMiddleProximal: KNUCKLE,
|
|
240
|
+
leftMiddleIntermediate: MIDDLE_JOINT,
|
|
241
|
+
leftMiddleDistal: END_JOINT,
|
|
242
|
+
leftRingProximal: KNUCKLE,
|
|
243
|
+
leftRingIntermediate: MIDDLE_JOINT,
|
|
244
|
+
leftRingDistal: END_JOINT,
|
|
245
|
+
leftLittleProximal: KNUCKLE,
|
|
246
|
+
leftLittleIntermediate: MIDDLE_JOINT,
|
|
247
|
+
leftLittleDistal: END_JOINT,
|
|
248
|
+
rightThumbMetacarpal: THUMB_BASE,
|
|
249
|
+
rightThumbProximal: THUMB_MIDDLE,
|
|
250
|
+
rightThumbDistal: THUMB_END,
|
|
251
|
+
rightIndexProximal: KNUCKLE,
|
|
252
|
+
rightIndexIntermediate: MIDDLE_JOINT,
|
|
253
|
+
rightIndexDistal: END_JOINT,
|
|
254
|
+
rightMiddleProximal: KNUCKLE,
|
|
255
|
+
rightMiddleIntermediate: MIDDLE_JOINT,
|
|
256
|
+
rightMiddleDistal: END_JOINT,
|
|
257
|
+
rightRingProximal: KNUCKLE,
|
|
258
|
+
rightRingIntermediate: MIDDLE_JOINT,
|
|
259
|
+
rightRingDistal: END_JOINT,
|
|
260
|
+
rightLittleProximal: KNUCKLE,
|
|
261
|
+
rightLittleIntermediate: MIDDLE_JOINT,
|
|
262
|
+
rightLittleDistal: END_JOINT,
|
|
152
263
|
};
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The degrees past a joint's range of motion read as within it: the range
|
|
3
|
+
* verdict's tolerance (`HumanVerdicts`' `range`), and the resolution to which
|
|
4
|
+
* a solver need resolve a joint's angle. A swivel resolved to it moves a leg's
|
|
5
|
+
* knee by at most its length times it, 0.15 mm on a 0.87 m leg, finer than
|
|
6
|
+
* every clearance and contact verdict, which read millimetres.
|
|
7
|
+
*/
|
|
8
|
+
export const ROM_TOLERANCE: number = 0.01;
|
package/src/rom/index.ts
CHANGED
|
@@ -6,6 +6,7 @@ export * from "./clampPose";
|
|
|
6
6
|
export * from "./constants";
|
|
7
7
|
export * from "./getConstraint";
|
|
8
8
|
export * from "./restRelativeConstraint";
|
|
9
|
+
export * from "./scanJointRom";
|
|
9
10
|
export * from "./swingConeAngle";
|
|
10
11
|
export * from "./swingConeBlend";
|
|
11
12
|
export * from "./toClinicalAngle";
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
import {
|
|
2
|
+
IAutoMovieAngleRange,
|
|
3
|
+
IAutoMovieJointConstraint,
|
|
4
|
+
IAutoMovieJointPose,
|
|
5
|
+
} from "@automovie/interface";
|
|
6
|
+
|
|
7
|
+
import { jointToQuaternion } from "../kinematics/jointToQuaternion";
|
|
8
|
+
import { swingTwistRange } from "../kinematics/swingTwistRange";
|
|
9
|
+
import { nearestAngleAlias } from "../math/nearestAngleAlias";
|
|
10
|
+
import { swingConeAngle } from "./swingConeAngle";
|
|
11
|
+
|
|
12
|
+
const AXES: readonly ["flexion", "abduction", "twist"] = [
|
|
13
|
+
"flexion",
|
|
14
|
+
"abduction",
|
|
15
|
+
"twist",
|
|
16
|
+
] as const;
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* Measure one joint against its range of motion and report each fault to the
|
|
20
|
+
* caller, building no message: the single owner of what counts as a ROM
|
|
21
|
+
* fault and how far past the limit it lies, read by the pose gate
|
|
22
|
+
* ({@link validateJointRom}), which words each fault, and by the solvers'
|
|
23
|
+
* candidate ranking (`jointRomOvershoot`), which only sums them.
|
|
24
|
+
*
|
|
25
|
+
* Faults are reported in axis order (flexion, abduction, twist), then the
|
|
26
|
+
* combined swing. A `null` angle is rest and reports nothing on its own axis;
|
|
27
|
+
* `0` reports nothing on an immobile (`null`) axis, whose rest it is, but is
|
|
28
|
+
* measured against a range that excludes it. A non-finite angle is reported
|
|
29
|
+
* with an `undefined` overshoot, since it has no distance to a limit. An
|
|
30
|
+
* angle on an immobile axis overshoots by its whole magnitude, and one
|
|
31
|
+
* outside its interval by its distance to the nearer bound. The swing is the
|
|
32
|
+
* coupling of flexion and abduction, a `null` axis contributing its actual
|
|
33
|
+
* rotation, `0`, and overshoots by what it exceeds `swingDeg`.
|
|
34
|
+
*
|
|
35
|
+
* A ball joint whose constraint declares `swingTwist` is measured by its
|
|
36
|
+
* rotation instead (`swingTwistRange`), in the frame of its bone the caller's
|
|
37
|
+
* rig resolves (`rig`), or the humanoid tables' (`swingTwistRange.of`): a `swing` fault by the degrees its direction lies past
|
|
38
|
+
* the reach of its flexion and abduction ranges, then a `twist` fault by the
|
|
39
|
+
* degrees its turn about its own axis lies past `swingTwist.twist`. A
|
|
40
|
+
* non-finite angle is reported as above and nothing else is measured. A bone
|
|
41
|
+
* with no axes in that frame keeps the three-angle scan.
|
|
42
|
+
*
|
|
43
|
+
* @param joint Joint angles in the constraint's degree frame; `null` is rest.
|
|
44
|
+
* @param constraint Finite ordered axis intervals and an optional swing cone.
|
|
45
|
+
* @param report Called once per fault with the faulted part, the measured
|
|
46
|
+
* value in degrees and its overshoot in degrees, `undefined` for a
|
|
47
|
+
* non-finite value.
|
|
48
|
+
* @param rig The bone's frame as the caller's rig resolves it (`swingTwistRange.of(bone, skeleton)`); the humanoid tables' when absent.
|
|
49
|
+
*
|
|
50
|
+
* @evidence contracts/development/common.md#meaningful-documentation States who reads the scan and why it builds no message, the report order, what `null`, `0` and a non-finite angle mean on each kind of axis, how each overshoot is measured, the swing coupling, and each callback argument's unit.
|
|
51
|
+
* @evidence contracts/development/implementation.md#principled-implementation An interval's overshoot is the distance to its nearer bound and an immobile axis's is the whole angle, the distances a clamp would move the joint; the swing is measured by `swingConeAngle` on the rotation the renderer reads, so a resting axis counts as its actual 0.
|
|
52
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure The single owner of what a ROM fault is: the gate words its reports and the solvers sum them, so the two cannot judge by different rules; one loop over the three axes and one cone check.
|
|
53
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No tolerance is added and no bone or axis is special-cased; a non-finite angle is reported without a distance instead of being scored as zero or clamped.
|
|
54
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms A three-angle joint costs three comparisons and at most one cone angle, with no allocation. A swing-twist joint costs one rotation, one reading and one table lookup, with a few small records allocated; the radius table behind the lookup is built once per constraint and basis (`swingTwistRange.radius` caches it, 360 rays each scanned in half-degree steps and bisected) and every later call reads it. Both matter because a limb fit scans hundreds of candidates per solve.
|
|
55
|
+
* @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure scan of one joint and constraint that coordinates no work across calls.
|
|
56
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; faults leave through the caller's callback.
|
|
57
|
+
*/
|
|
58
|
+
export const scanJointRom: (
|
|
59
|
+
joint: IAutoMovieJointPose,
|
|
60
|
+
constraint: IAutoMovieJointConstraint,
|
|
61
|
+
report: (
|
|
62
|
+
part: scanJointRom.Part,
|
|
63
|
+
actual: number,
|
|
64
|
+
overshoot: number | undefined,
|
|
65
|
+
) => void,
|
|
66
|
+
rig?: swingTwistRange.IJoint,
|
|
67
|
+
) => void = (
|
|
68
|
+
joint: IAutoMovieJointPose,
|
|
69
|
+
constraint: IAutoMovieJointConstraint,
|
|
70
|
+
report: (
|
|
71
|
+
part: scanJointRom.Part,
|
|
72
|
+
actual: number,
|
|
73
|
+
overshoot: number | undefined,
|
|
74
|
+
) => void,
|
|
75
|
+
rig?: swingTwistRange.IJoint,
|
|
76
|
+
): void => {
|
|
77
|
+
// A ball joint gated by swing and twist reads its rotation, not its three
|
|
78
|
+
// angles: the swing past the reach of its flexion and abduction ranges,
|
|
79
|
+
// then the twist past its interval, in the frame its clinical angles are
|
|
80
|
+
// written in: the caller's rig's, or the humanoid tables'.
|
|
81
|
+
const range: swingTwistRange.IJoint | undefined =
|
|
82
|
+
constraint.swingTwist === undefined || constraint.swingTwist === null
|
|
83
|
+
? undefined
|
|
84
|
+
: (rig ?? swingTwistRange.of(joint.bone));
|
|
85
|
+
if (
|
|
86
|
+
range !== undefined &&
|
|
87
|
+
constraint.swingTwist !== undefined &&
|
|
88
|
+
constraint.swingTwist !== null
|
|
89
|
+
) {
|
|
90
|
+
for (const axis of AXES) {
|
|
91
|
+
const angle: number | null = joint[axis];
|
|
92
|
+
if (angle !== null && !Number.isFinite(angle))
|
|
93
|
+
report(axis, angle, undefined);
|
|
94
|
+
}
|
|
95
|
+
if (
|
|
96
|
+
AXES.some(
|
|
97
|
+
(axis: (typeof AXES)[number]): boolean =>
|
|
98
|
+
!Number.isFinite(joint[axis] ?? 0),
|
|
99
|
+
)
|
|
100
|
+
)
|
|
101
|
+
return;
|
|
102
|
+
const reading: swingTwistRange.IReading = swingTwistRange.read(
|
|
103
|
+
jointToQuaternion(joint, range.axes, range.frame),
|
|
104
|
+
range,
|
|
105
|
+
);
|
|
106
|
+
const reach: number = swingTwistRange.radius(
|
|
107
|
+
constraint,
|
|
108
|
+
range,
|
|
109
|
+
reading.azimuth,
|
|
110
|
+
);
|
|
111
|
+
if (reading.swing > reach)
|
|
112
|
+
report("swing", reading.swing, reading.swing - reach);
|
|
113
|
+
const twist: IAutoMovieAngleRange = constraint.swingTwist.twist;
|
|
114
|
+
const turned: number = nearestAngleAlias(reading.twist, twist);
|
|
115
|
+
if (turned < twist.min) report("twist", turned, twist.min - turned);
|
|
116
|
+
else if (turned > twist.max) report("twist", turned, turned - twist.max);
|
|
117
|
+
return;
|
|
118
|
+
}
|
|
119
|
+
for (const axis of AXES) {
|
|
120
|
+
const angle: number | null = joint[axis];
|
|
121
|
+
const allowed: IAutoMovieAngleRange | null = constraint[axis];
|
|
122
|
+
if (angle === null) continue;
|
|
123
|
+
// 0 is only implicitly fine on an IMMOBILE axis (it is that axis's rest);
|
|
124
|
+
// against a zero-excluding override like [10, 90] it must report, or
|
|
125
|
+
// validate would call clean what clampJointRom moves to the min (#1057)
|
|
126
|
+
if (angle === 0 && allowed === null) continue;
|
|
127
|
+
if (!Number.isFinite(angle)) report(axis, angle, undefined);
|
|
128
|
+
// immobile axis: the gap is the whole distance from the required 0
|
|
129
|
+
else if (allowed === null) report(axis, angle, Math.abs(angle));
|
|
130
|
+
else if (angle < allowed.min) report(axis, angle, allowed.min - angle);
|
|
131
|
+
else if (angle > allowed.max) report(axis, angle, angle - allowed.max);
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
// Combined swing cone (ball joints): caps the corner the per-axis boxes miss.
|
|
135
|
+
// The cone is a COUPLING between the two axes, not a per-axis check, so a
|
|
136
|
+
// resting (`null`) axis is not exempt. It contributes its actual rotation, 0,
|
|
137
|
+
// exactly as the renderer reads it (`jointToQuaternion`'s `?? 0`). Gating on
|
|
138
|
+
// both axes being non-null made `{flexion:150, abduction:null}` pass while its
|
|
139
|
+
// identical twin `{flexion:150, abduction:0}` (the same quaternion) failed
|
|
140
|
+
// (#1245).
|
|
141
|
+
if (typeof constraint.swingDeg === "number") {
|
|
142
|
+
const swing: number = swingConeAngle(
|
|
143
|
+
joint.flexion ?? 0,
|
|
144
|
+
joint.abduction ?? 0,
|
|
145
|
+
);
|
|
146
|
+
if (swing > constraint.swingDeg)
|
|
147
|
+
report("swing", swing, swing - constraint.swingDeg);
|
|
148
|
+
}
|
|
149
|
+
};
|
|
150
|
+
|
|
151
|
+
/**
|
|
152
|
+
* Companion declarations of {@link scanJointRom}.
|
|
153
|
+
*
|
|
154
|
+
* @evidence contracts/development/common.md#meaningful-documentation Names what the namespace holds; its one member states what each value stands for.
|
|
155
|
+
* @evidence contracts/development/design.md#principled-representation Holds the one type the scan's callback needs, the part a fault is measured on.
|
|
156
|
+
* @evidence contracts/development/design.md#minimal-and-owned-surface One type, declared beside the function whose callback takes it and read by its two callers.
|
|
157
|
+
* @evidence contracts/development/design.md#prohibited-design-shortcuts No cast, no index signature and no copy of a type owned elsewhere.
|
|
158
|
+
*/
|
|
159
|
+
export namespace scanJointRom {
|
|
160
|
+
/**
|
|
161
|
+
* What a fault is measured on: one clinical axis, or the combined swing.
|
|
162
|
+
*
|
|
163
|
+
* @evidence contracts/development/common.md#meaningful-documentation States the two kinds of part a fault can name.
|
|
164
|
+
* @evidence contracts/development/design.md#principled-representation A closed union of the three clinical axis names a joint pose carries and `swing`, the coupling of flexion and abduction that belongs to no single axis.
|
|
165
|
+
* @evidence contracts/development/design.md#minimal-and-owned-surface Four literals, one for each check the scan runs; the gate maps each to its message and the ranking ignores it.
|
|
166
|
+
* @evidence contracts/development/design.md#prohibited-design-shortcuts String literals rather than `string`, so a caller's switch over the parts is checked for exhaustiveness.
|
|
167
|
+
*/
|
|
168
|
+
export type Part = "flexion" | "abduction" | "twist" | "swing";
|
|
169
|
+
}
|