@automovie/engine 0.1.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/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/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 +5 -0
- package/lib/composition/index.js +5 -0
- 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/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/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/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/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/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 +5 -0
- package/lib/geometry/construction/index.js +5 -0
- 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/index.d.ts +4 -0
- package/lib/geometry/index.js +4 -0
- 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/index.d.ts +1 -0
- package/lib/index.js +1 -0
- 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 +24 -0
- package/lib/kinematics/index.js +24 -0
- 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/index.d.ts +7 -0
- package/lib/math/index.js +7 -0
- 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 +15 -0
- package/lib/motion/index.js +15 -0
- 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/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 +17 -0
- package/lib/physics/index.js +17 -0
- 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/materializeCompiledFormation.js +2 -5
- package/lib/populationRuntime/materializeCompiledFormation.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/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 +6 -0
- package/lib/soft/index.js +6 -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/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/detectFreeFall.js +2 -1
- package/lib/validation/detectFreeFall.js.map +1 -1
- package/lib/validation/index.d.ts +6 -0
- package/lib/validation/index.js +6 -0
- 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/validateBody.d.ts +2 -2
- package/lib/validation/validateBody.js +27 -3
- package/lib/validation/validateBody.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/worldBlock.js +6 -9
- package/lib/worldBlock.js.map +1 -1
- package/package.json +6 -6
- package/src/IAutoMovieFormationPlacement.ts +4 -3
- package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
- package/src/anthropometry/index.ts +1 -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 +5 -0
- 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/createAutoMovieGeometryActorReader.ts +2 -1
- package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
- package/src/film/compileAttach.ts +2 -5
- package/src/film/compileLaunch.ts +5 -4
- package/src/film/propAnchorFrame.ts +3 -6
- package/src/film/stageScene.ts +3 -10
- 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/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 +5 -0
- 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/index.ts +4 -0
- package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
- package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
- package/src/index.ts +1 -0
- 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 +24 -0
- 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/index.ts +7 -0
- 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 +15 -0
- 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/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 +17 -0
- 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/materializeCompiledFormation.ts +3 -6
- 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/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
- package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
- package/src/soft/applySoftBodyFriction.ts +65 -0
- package/src/soft/index.ts +6 -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/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/detectFreeFall.ts +3 -2
- package/src/validation/index.ts +6 -0
- package/src/validation/markAutoMovieSlip.ts +65 -0
- package/src/validation/validateAffordance.ts +38 -3
- package/src/validation/validateAffordanceArticulation.ts +311 -0
- package/src/validation/validateBody.ts +80 -3
- package/src/validation/validateJointConstraint.ts +19 -1
- package/src/validation/validateModel.ts +7 -0
- package/src/worldBlock.ts +3 -6
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.alternateRigJointAngles = void 0;
|
|
4
|
+
/**
|
|
5
|
+
* The second Euler chart of a joint rotation, in rest-relative (rig)
|
|
6
|
+
* degrees: the other triple that composes to the same rotation.
|
|
7
|
+
*
|
|
8
|
+
* A distal twist composes `Ry(a)·Rx(f)·Rz(t)`, whose second chart is
|
|
9
|
+
* `(180 − f, a + 180, t + 180)`; a proximal twist composes `Rz(t)·Ry(a)·Rx(f)`,
|
|
10
|
+
* whose second chart is `(f + 180, 180 − a, t + 180)`. A left-handed basis is
|
|
11
|
+
* extracted against `−twist`, so its twist takes `−180` where a right-handed
|
|
12
|
+
* one takes `+180`, the same rotation by a full turn. No angle is wrapped:
|
|
13
|
+
* the caller chooses the full-turn alias it needs.
|
|
14
|
+
*
|
|
15
|
+
* @param rig The rest-relative angles of one chart, degrees.
|
|
16
|
+
* @param placement Where the basis places the twist; absent means proximal.
|
|
17
|
+
* @param handed `1` for a right-handed basis (`flexion × abduction = +twist`), `-1` for a left-handed one.
|
|
18
|
+
* @returns The other chart's rest-relative angles, degrees.
|
|
19
|
+
*
|
|
20
|
+
* @evidence contracts/development/implementation.md#principled-implementation The two charts of a three-angle composition differ by a half turn of each outer angle and the reflection of the middle one about its right angle, which leaves every entry of the composed matrix unchanged.
|
|
21
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure One record of three sums; `decomposeJointRotationOnBasis` scores it against a range, so the chart rule is written once.
|
|
22
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No angle is wrapped or clamped and no bone is named.
|
|
23
|
+
* @evidence contracts/development/common.md#meaningful-documentation States both composition orders with their second chart, the handedness term, the unit and that aliases are the caller's.
|
|
24
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Three additions.
|
|
25
|
+
* @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of three numbers with nothing to share between calls.
|
|
26
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the caller owns the returned angles.
|
|
27
|
+
*/
|
|
28
|
+
const alternateRigJointAngles = (rig, placement, handed) => ({
|
|
29
|
+
flexion: placement === "distal" ? 180 - rig.flexion : rig.flexion + 180,
|
|
30
|
+
abduction: placement === "distal" ? rig.abduction + 180 : 180 - rig.abduction,
|
|
31
|
+
twist: rig.twist + 180 * handed,
|
|
32
|
+
});
|
|
33
|
+
exports.alternateRigJointAngles = alternateRigJointAngles;
|
|
34
|
+
//# sourceMappingURL=alternateRigJointAngles.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"alternateRigJointAngles.js","sourceRoot":"","sources":["../../src/kinematics/alternateRigJointAngles.ts"],"names":[],"mappings":";;;AAIA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,MAAM,uBAAuB,GAIC,CACnC,GAAkC,EAClC,SAAmD,EACnD,MAAc,EACiB,EAAE,CAAC,CAAC;IACnC,OAAO,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,GAAG,GAAG;IACvE,SAAS,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,SAAS;IAC7E,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,GAAG,GAAG,MAAM;CAChC,CAAC,CAAC;AAZU,QAAA,uBAAuB,GAAvB,uBAAuB,CAYjC"}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { IAutoMovieJointAxes, IAutoMovieJointConstraint, IAutoMovieQuaternion } from "@automovie/interface";
|
|
2
|
+
import { IAutoMovieRestFrame } from "../rom/IAutoMovieRestFrame";
|
|
3
|
+
import type { swingTwistRange } from "./swingTwistRange";
|
|
4
|
+
/**
|
|
5
|
+
* The swivels a joint's three-angle box provably refuses: for a joint whose
|
|
6
|
+
* bone-local rotation is a fixed rotation turned about a fixed axis by the
|
|
7
|
+
* swivel (the chain root of `hingedArmSwivel.pose`), a test of whether every
|
|
8
|
+
* swivel from `low` to `high` degrees reads past the joint's box in both of
|
|
9
|
+
* the charts `decomposeJointRotationOnBasis` chooses between, so that
|
|
10
|
+
* `jointRomOvershoot` scores each of them above zero.
|
|
11
|
+
*
|
|
12
|
+
* A rotation turned about a fixed axis by `ψ` has a matrix whose every entry
|
|
13
|
+
* is `a + b cos ψ + c sin ψ` (Rodrigues' formula between two fixed
|
|
14
|
+
* rotations), so every entry the decomposition reads is such a sinusoid,
|
|
15
|
+
* fitted exactly from the rotation at 0, 90 and 180 degrees. Each clinical
|
|
16
|
+
* bound is then a sinusoid's sign. The middle angle of the composition
|
|
17
|
+
* (`atan2(s, cos)` with a non-negative cosine, so `asin(s)`) lies past a
|
|
18
|
+
* bound `q` where `s - sin q` is positive; an outer angle `atan2(y, x)` lies
|
|
19
|
+
* past the upper end `β` of an interval no wider than a half turn where
|
|
20
|
+
* `y cos β - x sin β` (the vector's length times `sin(δ - β)`) is positive,
|
|
21
|
+
* and past the lower end `α` where `x sin α - y cos α` is. The alternate
|
|
22
|
+
* chart (`alternateRigJointAngles`) turns each outer angle by a half turn,
|
|
23
|
+
* negating its vector, and reflects the middle angle about its right angle.
|
|
24
|
+
* Where one such sinusoid exceeds `MARGIN`, its exact roots bound an arc of
|
|
25
|
+
* swivels (`φ ± acos((MARGIN - a) / R)`), and a reading is refused on the
|
|
26
|
+
* union of its axes' arcs.
|
|
27
|
+
*
|
|
28
|
+
* Every refusal is certain. A sinusoid above `MARGIN` puts its angle past
|
|
29
|
+
* the bound by more than `MARGIN` radians, the joints' tolerance
|
|
30
|
+
* (`ROM_TOLERANCE`, about 1.7e-4), far beyond the rounding of the fit, of
|
|
31
|
+
* the arc's ends and of the decomposition itself (near 1e-15); and an outer
|
|
32
|
+
* angle's vector is then longer than `MARGIN`, past the gimbal band
|
|
33
|
+
* (`sqrt(ε)`, 1.5e-8) inside which the decomposition pins that angle
|
|
34
|
+
* instead. A joint gated by swing and twist, which the box does not score,
|
|
35
|
+
* is read by its range instead (`swingTwistExcludedSwivels`) when the frame
|
|
36
|
+
* the overshoot reads it in is given, and refuses nothing otherwise; an
|
|
37
|
+
* axis without an interval, an outer interval wider than a half turn
|
|
38
|
+
* (whose refusal is an intersection, not a union, of two arcs) and a middle
|
|
39
|
+
* interval met twice by the half turn the middle angle covers refuse
|
|
40
|
+
* nothing, so the test only ever says less than the box would.
|
|
41
|
+
*
|
|
42
|
+
* @param props The joint and its rotation by swivel.
|
|
43
|
+
* @returns Whether every swivel in `[low, high]`, degrees, is refused; a joint with nothing to refuse refuses no swivel.
|
|
44
|
+
*
|
|
45
|
+
* @evidence contracts/development/common.md#meaningful-documentation States the premise on the rotation, why each entry is a sinusoid, each bound's sinusoid for both charts, the margin and why every refusal is certain, and every case that refuses nothing.
|
|
46
|
+
* @evidence contracts/development/implementation.md#principled-implementation Rodrigues' formula makes each entry an exact sinusoid in the swivel, so each bound's crossing swivels are a sinusoid's two arccos roots, and an angle's interval maps through the rest frame and the chart exactly as `decomposeJointRotationOnBasis` and `alternateRigJointAngles` read it.
|
|
47
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure The entries are fitted once, each reading's axes give their bound sinusoids, the sinusoids their arcs, the arcs one merged list per reading, and the test reads the lists.
|
|
48
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Sound by construction, never by sampling: an arc is refused only from its sinusoid's roots with the joints' tolerance to spare, and a case the analysis does not cover refuses nothing rather than guessing.
|
|
49
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Three rotations and nine dot products each fit the entries, a few arcs per reading are merged once, and each test is a scan of a handful of merged arcs.
|
|
50
|
+
* @evidence contracts/development/implementation.md#reuse-equivalent-work The fit, the arcs, their union and its test are `swivelArcs`'s, shared with a point's bounds; the arcs are built once per rotation and read by every test of its sweep.
|
|
51
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains the two merged arc lists in the returned test only.
|
|
52
|
+
*/
|
|
53
|
+
export declare function boxExcludedSwivels(props: {
|
|
54
|
+
/** The joint's clinical basis, admitted and normalized (`normalizeJointAxes`). */
|
|
55
|
+
basis: IAutoMovieJointAxes;
|
|
56
|
+
/** The rest frame lifting the joint's rest-relative angles to clinical ones; omitted, they are clinical. */
|
|
57
|
+
frame?: IAutoMovieRestFrame | undefined;
|
|
58
|
+
/** The joint's resolved range of motion, as the decomposition's domain and the overshoot read it; `null` refuses nothing. */
|
|
59
|
+
constraint: IAutoMovieJointConstraint | null;
|
|
60
|
+
/** The frame a swing-twist gate is read in, as the overshoot reads it (`scanJointRom`); omitted, a gated joint refuses nothing. */
|
|
61
|
+
joint?: swingTwistRange.IJoint | undefined;
|
|
62
|
+
/** The joint's bone-local rotation at a swivel, degrees: a fixed rotation turned about a fixed axis by the swivel. */
|
|
63
|
+
rotation: (swivel: number) => IAutoMovieQuaternion;
|
|
64
|
+
}): (low: number, high: number) => boolean;
|
|
@@ -0,0 +1,187 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.boxExcludedSwivels = boxExcludedSwivels;
|
|
4
|
+
const Quaternion_1 = require("../math/Quaternion");
|
|
5
|
+
const Vector3_1 = require("../math/Vector3");
|
|
6
|
+
const ROM_TOLERANCE_1 = require("../rom/constants/ROM_TOLERANCE");
|
|
7
|
+
const swingTwistExcludedSwivels_1 = require("./swingTwistExcludedSwivels");
|
|
8
|
+
const swivelArcs_1 = require("./swivelArcs");
|
|
9
|
+
/**
|
|
10
|
+
* The swivels a joint's three-angle box provably refuses: for a joint whose
|
|
11
|
+
* bone-local rotation is a fixed rotation turned about a fixed axis by the
|
|
12
|
+
* swivel (the chain root of `hingedArmSwivel.pose`), a test of whether every
|
|
13
|
+
* swivel from `low` to `high` degrees reads past the joint's box in both of
|
|
14
|
+
* the charts `decomposeJointRotationOnBasis` chooses between, so that
|
|
15
|
+
* `jointRomOvershoot` scores each of them above zero.
|
|
16
|
+
*
|
|
17
|
+
* A rotation turned about a fixed axis by `ψ` has a matrix whose every entry
|
|
18
|
+
* is `a + b cos ψ + c sin ψ` (Rodrigues' formula between two fixed
|
|
19
|
+
* rotations), so every entry the decomposition reads is such a sinusoid,
|
|
20
|
+
* fitted exactly from the rotation at 0, 90 and 180 degrees. Each clinical
|
|
21
|
+
* bound is then a sinusoid's sign. The middle angle of the composition
|
|
22
|
+
* (`atan2(s, cos)` with a non-negative cosine, so `asin(s)`) lies past a
|
|
23
|
+
* bound `q` where `s - sin q` is positive; an outer angle `atan2(y, x)` lies
|
|
24
|
+
* past the upper end `β` of an interval no wider than a half turn where
|
|
25
|
+
* `y cos β - x sin β` (the vector's length times `sin(δ - β)`) is positive,
|
|
26
|
+
* and past the lower end `α` where `x sin α - y cos α` is. The alternate
|
|
27
|
+
* chart (`alternateRigJointAngles`) turns each outer angle by a half turn,
|
|
28
|
+
* negating its vector, and reflects the middle angle about its right angle.
|
|
29
|
+
* Where one such sinusoid exceeds `MARGIN`, its exact roots bound an arc of
|
|
30
|
+
* swivels (`φ ± acos((MARGIN - a) / R)`), and a reading is refused on the
|
|
31
|
+
* union of its axes' arcs.
|
|
32
|
+
*
|
|
33
|
+
* Every refusal is certain. A sinusoid above `MARGIN` puts its angle past
|
|
34
|
+
* the bound by more than `MARGIN` radians, the joints' tolerance
|
|
35
|
+
* (`ROM_TOLERANCE`, about 1.7e-4), far beyond the rounding of the fit, of
|
|
36
|
+
* the arc's ends and of the decomposition itself (near 1e-15); and an outer
|
|
37
|
+
* angle's vector is then longer than `MARGIN`, past the gimbal band
|
|
38
|
+
* (`sqrt(ε)`, 1.5e-8) inside which the decomposition pins that angle
|
|
39
|
+
* instead. A joint gated by swing and twist, which the box does not score,
|
|
40
|
+
* is read by its range instead (`swingTwistExcludedSwivels`) when the frame
|
|
41
|
+
* the overshoot reads it in is given, and refuses nothing otherwise; an
|
|
42
|
+
* axis without an interval, an outer interval wider than a half turn
|
|
43
|
+
* (whose refusal is an intersection, not a union, of two arcs) and a middle
|
|
44
|
+
* interval met twice by the half turn the middle angle covers refuse
|
|
45
|
+
* nothing, so the test only ever says less than the box would.
|
|
46
|
+
*
|
|
47
|
+
* @param props The joint and its rotation by swivel.
|
|
48
|
+
* @returns Whether every swivel in `[low, high]`, degrees, is refused; a joint with nothing to refuse refuses no swivel.
|
|
49
|
+
*
|
|
50
|
+
* @evidence contracts/development/common.md#meaningful-documentation States the premise on the rotation, why each entry is a sinusoid, each bound's sinusoid for both charts, the margin and why every refusal is certain, and every case that refuses nothing.
|
|
51
|
+
* @evidence contracts/development/implementation.md#principled-implementation Rodrigues' formula makes each entry an exact sinusoid in the swivel, so each bound's crossing swivels are a sinusoid's two arccos roots, and an angle's interval maps through the rest frame and the chart exactly as `decomposeJointRotationOnBasis` and `alternateRigJointAngles` read it.
|
|
52
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure The entries are fitted once, each reading's axes give their bound sinusoids, the sinusoids their arcs, the arcs one merged list per reading, and the test reads the lists.
|
|
53
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Sound by construction, never by sampling: an arc is refused only from its sinusoid's roots with the joints' tolerance to spare, and a case the analysis does not cover refuses nothing rather than guessing.
|
|
54
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Three rotations and nine dot products each fit the entries, a few arcs per reading are merged once, and each test is a scan of a handful of merged arcs.
|
|
55
|
+
* @evidence contracts/development/implementation.md#reuse-equivalent-work The fit, the arcs, their union and its test are `swivelArcs`'s, shared with a point's bounds; the arcs are built once per rotation and read by every test of its sweep.
|
|
56
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains the two merged arc lists in the returned test only.
|
|
57
|
+
*/
|
|
58
|
+
function boxExcludedSwivels(props) {
|
|
59
|
+
const constraint = props.constraint;
|
|
60
|
+
if (constraint === null)
|
|
61
|
+
return () => false;
|
|
62
|
+
if (constraint.swingTwist !== undefined && constraint.swingTwist !== null)
|
|
63
|
+
return props.joint === undefined
|
|
64
|
+
? () => false
|
|
65
|
+
: (0, swingTwistExcludedSwivels_1.swingTwistExcludedSwivels)({
|
|
66
|
+
basis: props.basis,
|
|
67
|
+
frame: props.frame,
|
|
68
|
+
constraint,
|
|
69
|
+
joint: props.joint,
|
|
70
|
+
rotation: props.rotation,
|
|
71
|
+
});
|
|
72
|
+
const basis = props.basis;
|
|
73
|
+
const handed = Vector3_1.Vector3.dot(basis.twist, Vector3_1.Vector3.cross(basis.flexion, basis.abduction)) >= 0
|
|
74
|
+
? 1
|
|
75
|
+
: -1;
|
|
76
|
+
const axes = [
|
|
77
|
+
basis.flexion,
|
|
78
|
+
basis.abduction,
|
|
79
|
+
Vector3_1.Vector3.scale(basis.twist, handed),
|
|
80
|
+
];
|
|
81
|
+
// The entries R'[i][j] = axisᵢ · (R axisⱼ) at swivels 0, 90 and 180.
|
|
82
|
+
const sampled = [0, 90, 180].map((swivel) => {
|
|
83
|
+
const q = props.rotation(swivel);
|
|
84
|
+
const turned = axes.map((axis) => Quaternion_1.Quaternion.rotateVector(q, axis));
|
|
85
|
+
return axes.map((row) => turned.map((column) => Vector3_1.Vector3.dot(row, column)));
|
|
86
|
+
});
|
|
87
|
+
const entry = (i, j) => {
|
|
88
|
+
const [zero, quarter, half] = sampled.map((m) => m[i][j]);
|
|
89
|
+
return swivelArcs_1.swivelArcs.fitted(zero, quarter, half);
|
|
90
|
+
};
|
|
91
|
+
// How each clinical axis is read from the entries (as
|
|
92
|
+
// `decomposeJointRotationOnBasis` reads it): a distal twist composes
|
|
93
|
+
// Ry(a)·Rx(f)·Rz(t), with flexion in the middle; a proximal one
|
|
94
|
+
// Rz(t)·Ry(a)·Rx(f), with abduction in the middle.
|
|
95
|
+
const reading = basis.twistPlacement === "distal"
|
|
96
|
+
? {
|
|
97
|
+
flexion: { sine: swivelArcs_1.swivelArcs.scaled(entry(1, 2), -1) },
|
|
98
|
+
abduction: { y: entry(0, 2), x: entry(2, 2), turn: 1 },
|
|
99
|
+
twist: { y: entry(1, 0), x: entry(1, 1), turn: handed },
|
|
100
|
+
}
|
|
101
|
+
: {
|
|
102
|
+
flexion: { y: entry(2, 1), x: entry(2, 2), turn: 1 },
|
|
103
|
+
abduction: { sine: swivelArcs_1.swivelArcs.scaled(entry(2, 0), -1) },
|
|
104
|
+
twist: { y: entry(1, 0), x: entry(0, 0), turn: handed },
|
|
105
|
+
};
|
|
106
|
+
// Each chart's refused swivels: the union of its axes' arcs.
|
|
107
|
+
const charts = [false, true].map((alternate) => {
|
|
108
|
+
const arcs = [];
|
|
109
|
+
for (const axis of AXES) {
|
|
110
|
+
const range = constraint[axis];
|
|
111
|
+
if (range === null)
|
|
112
|
+
continue;
|
|
113
|
+
const read = reading[axis];
|
|
114
|
+
for (const bound of bounds(read, rig(range, props.frame?.[axis]), alternate)) {
|
|
115
|
+
const arc = swivelArcs_1.swivelArcs.above(bound, MARGIN);
|
|
116
|
+
if (arc === "all")
|
|
117
|
+
return "all";
|
|
118
|
+
if (arc !== null)
|
|
119
|
+
arcs.push(arc);
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
return swivelArcs_1.swivelArcs.union(arcs);
|
|
123
|
+
});
|
|
124
|
+
return (low, high) => charts.every((chart) => swivelArcs_1.swivelArcs.covers(chart, low, high));
|
|
125
|
+
}
|
|
126
|
+
/**
|
|
127
|
+
* How far past a bound, in sine or projected units, a reading must lie to be
|
|
128
|
+
* refused: the joints' tolerance (`ROM_TOLERANCE`) in radians, past the
|
|
129
|
+
* rounding of every step and the decomposition's gimbal band.
|
|
130
|
+
*/
|
|
131
|
+
const MARGIN = (ROM_TOLERANCE_1.ROM_TOLERANCE * Math.PI) / 180;
|
|
132
|
+
/** The three clinical axes. */
|
|
133
|
+
const AXES = ["flexion", "abduction", "twist"];
|
|
134
|
+
/** A clinical interval as rest-relative degrees, ordered (the inverse of `toClinicalAngle`). */
|
|
135
|
+
function rig(range, frame) {
|
|
136
|
+
const sign = frame?.sign ?? 1;
|
|
137
|
+
const neutral = frame?.neutral ?? 0;
|
|
138
|
+
const ends = [
|
|
139
|
+
(range.min - neutral) * sign,
|
|
140
|
+
(range.max - neutral) * sign,
|
|
141
|
+
];
|
|
142
|
+
return [Math.min(...ends), Math.max(...ends)];
|
|
143
|
+
}
|
|
144
|
+
/**
|
|
145
|
+
* The sinusoids positive where one chart's reading of an axis lies past its
|
|
146
|
+
* rest-relative interval `[lo, hi]`, any full-turn alias of the angle
|
|
147
|
+
* considered (`nearestAngleAlias`); none where the analysis cannot refuse.
|
|
148
|
+
*/
|
|
149
|
+
function bounds(read, [lo, hi], alternate) {
|
|
150
|
+
if (hi - lo >= 360)
|
|
151
|
+
return [];
|
|
152
|
+
if ("sine" in read) {
|
|
153
|
+
// The middle angle is asin(s), or in the alternate chart 180 - asin(s),
|
|
154
|
+
// which lies in [lo, hi] exactly where asin(s) lies in [180 - hi, 180 - lo].
|
|
155
|
+
const [from, to] = alternate ? [180 - hi, 180 - lo] : [lo, hi];
|
|
156
|
+
const first = Math.ceil((-90 - to) / 360);
|
|
157
|
+
const last = Math.floor((90 - from) / 360);
|
|
158
|
+
if (last < first)
|
|
159
|
+
return [{ a: 1, b: 0, c: 0 }];
|
|
160
|
+
if (last > first)
|
|
161
|
+
return [];
|
|
162
|
+
const p = Math.max(from + 360 * first, -90);
|
|
163
|
+
const q = Math.min(to + 360 * first, 90);
|
|
164
|
+
const out = [];
|
|
165
|
+
if (q < 90)
|
|
166
|
+
out.push({
|
|
167
|
+
...read.sine,
|
|
168
|
+
a: read.sine.a - Math.sin(q * Quaternion_1.Quaternion.DEG2RAD),
|
|
169
|
+
});
|
|
170
|
+
if (p > -90)
|
|
171
|
+
out.push(swivelArcs_1.swivelArcs.scaled({ ...read.sine, a: read.sine.a - Math.sin(p * Quaternion_1.Quaternion.DEG2RAD) }, -1));
|
|
172
|
+
return out;
|
|
173
|
+
}
|
|
174
|
+
// An outer angle δ = atan2(y, x) reads `turn · δ`, or a half turn more in
|
|
175
|
+
// the alternate chart, where the vector is negated.
|
|
176
|
+
if (hi - lo > 180)
|
|
177
|
+
return [];
|
|
178
|
+
const ends = [lo * read.turn, hi * read.turn];
|
|
179
|
+
const alpha = Math.min(...ends) * Quaternion_1.Quaternion.DEG2RAD;
|
|
180
|
+
const beta = Math.max(...ends) * Quaternion_1.Quaternion.DEG2RAD;
|
|
181
|
+
const sign = alternate ? -1 : 1;
|
|
182
|
+
return [
|
|
183
|
+
swivelArcs_1.swivelArcs.scaled(swivelArcs_1.swivelArcs.combined(read.y, Math.cos(beta), read.x, -Math.sin(beta)), sign),
|
|
184
|
+
swivelArcs_1.swivelArcs.scaled(swivelArcs_1.swivelArcs.combined(read.x, Math.sin(alpha), read.y, -Math.cos(alpha)), sign),
|
|
185
|
+
];
|
|
186
|
+
}
|
|
187
|
+
//# sourceMappingURL=boxExcludedSwivels.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"boxExcludedSwivels.js","sourceRoot":"","sources":["../../src/kinematics/boxExcludedSwivels.ts"],"names":[],"mappings":"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"}
|
|
@@ -37,8 +37,22 @@ import { AutoMovieHumanoidBone, IAutoMovieJointAxes } from "@automovie/interface
|
|
|
37
37
|
* The forearm's twist is pronation and supination, which happens beyond the
|
|
38
38
|
* elbow's hinge, so the lower arms declare a distal twist
|
|
39
39
|
* (`AutoMovieJointTwistPlacement`): twisting a bent forearm turns it about its
|
|
40
|
-
* own length and leaves where it points unchanged.
|
|
41
|
-
*
|
|
40
|
+
* own length and leaves where it points unchanged.
|
|
41
|
+
*
|
|
42
|
+
* The upper arms declare a distal twist too. The humerus's internal and
|
|
43
|
+
* external rotation turns it about its own length wherever the arm points,
|
|
44
|
+
* which only the distal order composes. In the proximal order the twist turns
|
|
45
|
+
* about the T-pose arm line, fixed in the shoulder girdle: for an arm in the
|
|
46
|
+
* sagittal plane (hanging, swinging, reaching forward) that line is the
|
|
47
|
+
* flexion axis carried there by the 90 degree abduction from rest, so flexion
|
|
48
|
+
* and twist turn about one axis, the chart is at its gimbal for every such
|
|
49
|
+
* pose, and the arm's rotation about its length has no coordinate of its own
|
|
50
|
+
* there. With the distal order `flexion` and `abduction` alone place the arm
|
|
51
|
+
* (its line's latitude toward the front and its longitude in the frontal
|
|
52
|
+
* plane) and `twist` is the humeral rotation; the only gimbal left is the arm
|
|
53
|
+
* pointing straight forward or back, where abduction and twist turn about the
|
|
54
|
+
* arm's own line. A pose with no twist is the same rotation in both orders.
|
|
55
|
+
* Every other bone keeps the proximal default.
|
|
42
56
|
*
|
|
43
57
|
* Opt in by passing this to {@link resolvePose} / `applyPose`; a bone that
|
|
44
58
|
* declares its own `axes` keeps them, and a bone absent from both uses
|
|
@@ -58,8 +58,22 @@ const HAND = [
|
|
|
58
58
|
* The forearm's twist is pronation and supination, which happens beyond the
|
|
59
59
|
* elbow's hinge, so the lower arms declare a distal twist
|
|
60
60
|
* (`AutoMovieJointTwistPlacement`): twisting a bent forearm turns it about its
|
|
61
|
-
* own length and leaves where it points unchanged.
|
|
62
|
-
*
|
|
61
|
+
* own length and leaves where it points unchanged.
|
|
62
|
+
*
|
|
63
|
+
* The upper arms declare a distal twist too. The humerus's internal and
|
|
64
|
+
* external rotation turns it about its own length wherever the arm points,
|
|
65
|
+
* which only the distal order composes. In the proximal order the twist turns
|
|
66
|
+
* about the T-pose arm line, fixed in the shoulder girdle: for an arm in the
|
|
67
|
+
* sagittal plane (hanging, swinging, reaching forward) that line is the
|
|
68
|
+
* flexion axis carried there by the 90 degree abduction from rest, so flexion
|
|
69
|
+
* and twist turn about one axis, the chart is at its gimbal for every such
|
|
70
|
+
* pose, and the arm's rotation about its length has no coordinate of its own
|
|
71
|
+
* there. With the distal order `flexion` and `abduction` alone place the arm
|
|
72
|
+
* (its line's latitude toward the front and its longitude in the frontal
|
|
73
|
+
* plane) and `twist` is the humeral rotation; the only gimbal left is the arm
|
|
74
|
+
* pointing straight forward or back, where abduction and twist turn about the
|
|
75
|
+
* arm's own line. A pose with no twist is the same rotation in both orders.
|
|
76
|
+
* Every other bone keeps the proximal default.
|
|
63
77
|
*
|
|
64
78
|
* Opt in by passing this to {@link resolvePose} / `applyPose`; a bone that
|
|
65
79
|
* declares its own `axes` keeps them, and a bone absent from both uses
|
|
@@ -80,10 +94,11 @@ exports.HUMANOID_JOINT_AXES = (() => {
|
|
|
80
94
|
"rightUpperArm",
|
|
81
95
|
"rightLowerArm",
|
|
82
96
|
];
|
|
83
|
-
|
|
97
|
+
// the humerus and the forearm turn about their own length beyond the swing
|
|
98
|
+
const turning = { ...arm, twistPlacement: "distal" };
|
|
84
99
|
const table = {};
|
|
85
100
|
for (const s of slots)
|
|
86
|
-
table[s] = s === "
|
|
101
|
+
table[s] = s === "leftShoulder" || s === "rightShoulder" ? arm : turning;
|
|
87
102
|
const hand = {
|
|
88
103
|
flexion: { x: 0, y: 0, z: 1 },
|
|
89
104
|
abduction: { x: 0, y: 1, z: 0 },
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"HUMANOID_JOINT_AXES.js","sourceRoot":"","sources":["../../../src/kinematics/constants/HUMANOID_JOINT_AXES.ts"],"names":[],"mappings":";;;AAKA,4EAA4E;AAC5E,MAAM,IAAI,GAAsB;IAC9B,MAAM;IACN,iBAAiB;IACjB,eAAe;IACf,aAAa;IACb,eAAe;IACf,mBAAmB;IACnB,aAAa;IACb,gBAAgB;IAChB,oBAAoB;IACpB,cAAc;IACd,cAAc;IACd,kBAAkB;IAClB,YAAY;IACZ,gBAAgB;IAChB,oBAAoB;IACpB,cAAc;CACf,CAAC;AAEF
|
|
1
|
+
{"version":3,"file":"HUMANOID_JOINT_AXES.js","sourceRoot":"","sources":["../../../src/kinematics/constants/HUMANOID_JOINT_AXES.ts"],"names":[],"mappings":"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"}
|
|
@@ -66,6 +66,22 @@ export declare function curlChainUntilContact(input: curlChainUntilContact.IInpu
|
|
|
66
66
|
* @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses the physical profile's shape union and the resolver's axes and rest frames.
|
|
67
67
|
*/
|
|
68
68
|
export declare namespace curlChainUntilContact {
|
|
69
|
+
/**
|
|
70
|
+
* How far a curled digit's angle may move with the limb that carries it,
|
|
71
|
+
* degrees: a point the limb carries moves by no more than the limb's reach
|
|
72
|
+
* times the joints' tolerance (`ROM_TOLERANCE`, in radians) when the
|
|
73
|
+
* limb's chain is resolved to it, and a digit that closes on a contact
|
|
74
|
+
* follows the hand by about as far at its tip, which at its lever (the
|
|
75
|
+
* length from the joint to the digit's tip) turns it by this angle. A
|
|
76
|
+
* curl solves its own contact far finer (a step bisected 30 times); this
|
|
77
|
+
* is the change a curled digit shows when the limb's resolution moves the
|
|
78
|
+
* hand, not the curl's precision.
|
|
79
|
+
*
|
|
80
|
+
* @param reach The limb's reach, metres: its two segments' lengths.
|
|
81
|
+
* @param lever The joint's lever, metres: its length to the digit's tip.
|
|
82
|
+
* @returns Degrees.
|
|
83
|
+
*/
|
|
84
|
+
function resolution(reach: number, lever: number): number;
|
|
69
85
|
/** The curl request. */
|
|
70
86
|
interface IInput {
|
|
71
87
|
/** The rig, whose range of motion caps every flexion. */
|
|
@@ -3,8 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
3
3
|
exports.curlChainUntilContact = curlChainUntilContact;
|
|
4
4
|
const Quaternion_1 = require("../math/Quaternion");
|
|
5
5
|
const Vector3_1 = require("../math/Vector3");
|
|
6
|
+
const physicalHullFaces_1 = require("../physics/physicalHullFaces");
|
|
6
7
|
const physicalShapeSegmentDistance_1 = require("../physics/physicalShapeSegmentDistance");
|
|
7
8
|
const clampJointToSkeleton_1 = require("../rom/clampJointToSkeleton");
|
|
9
|
+
const ROM_TOLERANCE_1 = require("../rom/constants/ROM_TOLERANCE");
|
|
8
10
|
const resolvePose_1 = require("./resolvePose");
|
|
9
11
|
/**
|
|
10
12
|
* Close articulated chains (fingers and thumb) around an object: each
|
|
@@ -150,15 +152,53 @@ function curlChainUntilContact(input) {
|
|
|
150
152
|
}
|
|
151
153
|
return { pose: pose(), chains: reports };
|
|
152
154
|
}
|
|
155
|
+
/**
|
|
156
|
+
* Companion types of {@link curlChainUntilContact}.
|
|
157
|
+
*
|
|
158
|
+
* @evidence contracts/development/common.md#meaningful-documentation Documents each member's frame and unit.
|
|
159
|
+
* @evidence contracts/development/design.md#principled-representation Chains of rig bones with a tip and a radius, world-placed physical shapes, and per-chain angles and gaps in degrees and metres.
|
|
160
|
+
* @evidence contracts/development/design.md#minimal-and-owned-surface What a grasping consumer passes and reads.
|
|
161
|
+
* @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses the physical profile's shape union and the resolver's axes and rest frames.
|
|
162
|
+
*/
|
|
163
|
+
(function (curlChainUntilContact) {
|
|
164
|
+
/**
|
|
165
|
+
* How far a curled digit's angle may move with the limb that carries it,
|
|
166
|
+
* degrees: a point the limb carries moves by no more than the limb's reach
|
|
167
|
+
* times the joints' tolerance (`ROM_TOLERANCE`, in radians) when the
|
|
168
|
+
* limb's chain is resolved to it, and a digit that closes on a contact
|
|
169
|
+
* follows the hand by about as far at its tip, which at its lever (the
|
|
170
|
+
* length from the joint to the digit's tip) turns it by this angle. A
|
|
171
|
+
* curl solves its own contact far finer (a step bisected 30 times); this
|
|
172
|
+
* is the change a curled digit shows when the limb's resolution moves the
|
|
173
|
+
* hand, not the curl's precision.
|
|
174
|
+
*
|
|
175
|
+
* @param reach The limb's reach, metres: its two segments' lengths.
|
|
176
|
+
* @param lever The joint's lever, metres: its length to the digit's tip.
|
|
177
|
+
* @returns Degrees.
|
|
178
|
+
*/
|
|
179
|
+
function resolution(reach, lever) {
|
|
180
|
+
return (ROM_TOLERANCE_1.ROM_TOLERANCE * reach) / lever;
|
|
181
|
+
}
|
|
182
|
+
curlChainUntilContact.resolution = resolution;
|
|
183
|
+
})(curlChainUntilContact || (exports.curlChainUntilContact = curlChainUntilContact = {}));
|
|
153
184
|
/** Refuse a shape whose dimensions cannot give a distance. */
|
|
154
185
|
function validate(shape) {
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
186
|
+
let ok;
|
|
187
|
+
if (shape.kind === "sphere")
|
|
188
|
+
ok = shape.radius > 0;
|
|
189
|
+
else if (shape.kind === "capsule")
|
|
190
|
+
ok = shape.radius > 0 && shape.halfLength >= 0;
|
|
191
|
+
else if (shape.kind === "box")
|
|
192
|
+
ok =
|
|
193
|
+
shape.halfExtents.x > 0 &&
|
|
160
194
|
shape.halfExtents.y > 0 &&
|
|
161
195
|
shape.halfExtents.z > 0;
|
|
196
|
+
else if (shape.kind === "hull")
|
|
197
|
+
ok = (0, physicalHullFaces_1.physicalHullFaces)(shape.points).faces.length >= 4;
|
|
198
|
+
else {
|
|
199
|
+
shape;
|
|
200
|
+
ok = false;
|
|
201
|
+
}
|
|
162
202
|
if (!ok)
|
|
163
203
|
throw new Error(`A collider ${shape.id} has non-positive dimensions`);
|
|
164
204
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"curlChainUntilContact.js","sourceRoot":"","sources":["../../src/kinematics/curlChainUntilContact.ts"],"names":[],"mappings":";;;AAWA,mDAAgD;AAChD,6CAA0C;AAC1C,0FAAuF;AAEvF,sEAAmE;
|
|
1
|
+
{"version":3,"file":"curlChainUntilContact.js","sourceRoot":"","sources":["../../src/kinematics/curlChainUntilContact.ts"],"names":[],"mappings":"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"}
|
|
@@ -15,6 +15,9 @@ import { IAutoMovieResolvedJointAngles } from "./IAutoMovieResolvedJointAngles";
|
|
|
15
15
|
* (abduction ±90 for a proximal twist, flexion ±90 for a distal one) only one
|
|
16
16
|
* combination of the outer angles is determined, so the other outer angle is
|
|
17
17
|
* pinned to 0 and twist takes the rest; the angles still rebuild the rotation.
|
|
18
|
+
* The pin holds within a projected cosine of the square root of the unit
|
|
19
|
+
* roundoff, about 1.5e-8, where the two outer angles are otherwise rounding
|
|
20
|
+
* noise and the pinned angles rebuild the rotation within 1e-7 radian.
|
|
18
21
|
* A left-handed basis, such as the default (`flexion × abduction = −twist`),
|
|
19
22
|
* is extracted against `−twist` and the twist sign restored, so the round trip
|
|
20
23
|
* holds for any orthonormal basis.
|
|
@@ -23,7 +26,7 @@ import { IAutoMovieResolvedJointAngles } from "./IAutoMovieResolvedJointAngles";
|
|
|
23
26
|
* `clinical = sign · r + neutral`. A `domain` with a non-null constraint also
|
|
24
27
|
* considers the rotation's second Euler chart, `(f + 180, 180 − a, t + 180)`
|
|
25
28
|
* for a proximal twist and `(180 − f, a + 180, t + 180)` for a distal one, and
|
|
26
|
-
* full-turn
|
|
29
|
+
* the full-turn alias of each angle nearest the constraint's range. The
|
|
27
30
|
* candidate with the least {@link jointRomOvershoot} wins, the principal chart
|
|
28
31
|
* on a tie. Every candidate is the same rotation, so a pose no chart can hold
|
|
29
32
|
* keeps its overshoot instead of being clamped.
|
|
@@ -39,7 +42,7 @@ import { IAutoMovieResolvedJointAngles } from "./IAutoMovieResolvedJointAngles";
|
|
|
39
42
|
* @param domain Bone and resolved ROM that choose among equivalent charts;
|
|
40
43
|
* omitted or with a `null` constraint, the principal chart is returned.
|
|
41
44
|
*
|
|
42
|
-
* @evidence contracts/development/implementation.md#principled-implementation Closed-form Euler extraction reads sine and projected cosine through atan2, preserving resolvable near-gimbal rotations that asin can round to ninety degrees; only cosine
|
|
45
|
+
* @evidence contracts/development/implementation.md#principled-implementation Closed-form Euler extraction reads sine and projected cosine through atan2, preserving resolvable near-gimbal rotations that asin can round to ninety degrees; only a projected cosine within the square root of the binary64 unit roundoff, where a rounding error and the pin's truncation error meet, takes the undetermined-angle convention. Normalized orthogonal axes and unit input rotations are the premises, and alternate charts/full turns retain the same rotation up to roundoff.
|
|
43
46
|
* @evidence contracts/development/implementation.md#clear-and-simple-structure The extraction, the handedness correction, the clinical lift and the ROM chart choice sit in one inverse because each depends on the others' convention; ROM scoring is delegated to `jointRomOvershoot` and frame arithmetic to `toClinicalAngle`, so the gate and this inverse read one rule.
|
|
44
47
|
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Selection compares the caller's unchanged constraint and never clamps an angle into range; the gimbal pin is the standard convention for an undetermined pair, not a compensation, and no bone is special-cased.
|
|
45
48
|
* @evidence contracts/development/common.md#meaningful-documentation States the inverse relationship, both composition orders, the gimbal convention, the handedness correction, the frame lift, both alternate charts and the tie rule, the thrown inputs, the unit-quaternion premise, and each parameter's default.
|