@automovie/engine 0.0.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
- package/lib/analysis/index.d.ts +5 -0
- package/lib/analysis/index.js +5 -0
- package/lib/analysis/index.js.map +1 -1
- package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
- package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
- package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
- package/lib/anthropometry/index.d.ts +1 -0
- package/lib/anthropometry/index.js +18 -0
- package/lib/anthropometry/index.js.map +1 -0
- package/lib/architecture/appendBuiltRegionDefects.d.ts +1 -1
- package/lib/architecture/appendBuiltRegionDefects.js +3 -3
- package/lib/architecture/appendBuiltRegionDefects.js.map +1 -1
- package/lib/architecture/builtOutlineIsClosed.d.ts +1 -1
- package/lib/architecture/builtOutlineIsClosed.js +3 -3
- package/lib/architecture/builtOutlineIsClosed.js.map +1 -1
- package/{src/architecture/constants/PLANAR_EPSILON.ts → lib/architecture/constants/BUILT_PLANAR_EPSILON.d.ts} +1 -1
- package/lib/architecture/constants/{PLANAR_EPSILON.js → BUILT_PLANAR_EPSILON.js} +3 -3
- package/lib/architecture/constants/BUILT_PLANAR_EPSILON.js.map +1 -0
- package/lib/architecture/constants/index.d.ts +1 -1
- package/lib/architecture/constants/index.js +1 -1
- package/lib/architecture/constants/index.js.map +1 -1
- package/lib/architecture/index.d.ts +157 -117
- package/lib/architecture/index.js +171 -158
- package/lib/architecture/index.js.map +1 -1
- package/lib/cache/index.d.ts +9 -0
- package/lib/cache/index.js +26 -0
- package/lib/cache/index.js.map +1 -0
- package/lib/composition/AutoMovieComposition.d.ts +25 -6
- package/lib/composition/AutoMovieComposition.js +4 -3
- package/lib/composition/AutoMovieComposition.js.map +1 -1
- package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
- package/lib/composition/AutoMovieScheduleCut.js +99 -0
- package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
- package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
- package/lib/composition/AutoMovieScheduleError.js +51 -0
- package/lib/composition/AutoMovieScheduleError.js.map +1 -0
- package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
- package/lib/composition/AutoMovieSchedulePlace.js +185 -0
- package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
- package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
- package/lib/composition/AutoMovieScheduleWalk.js +161 -0
- package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
- package/lib/composition/IAutoMovieIntent.d.ts +9 -6
- package/lib/composition/index.d.ts +12 -7
- package/lib/composition/index.js +12 -2
- package/lib/composition/index.js.map +1 -1
- package/lib/composition/markAutoMovieContacts.d.ts +29 -0
- package/lib/composition/markAutoMovieContacts.js +69 -0
- package/lib/composition/markAutoMovieContacts.js.map +1 -0
- package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
- package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
- package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
- package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
- package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
- package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
- package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
- package/lib/composition/resolveAutoMovieSchedule.js +32 -103
- package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
- package/lib/constants/index.d.ts +2 -0
- package/lib/constants/index.js +2 -0
- package/lib/constants/index.js.map +1 -1
- package/lib/createAutoMovieGeometryActorReader.js +2 -1
- package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
- package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
- package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
- package/lib/drawing/index.d.ts +12 -0
- package/lib/drawing/index.js +12 -0
- package/lib/drawing/index.js.map +1 -1
- package/lib/effectRuntime/index.d.ts +7 -0
- package/lib/effectRuntime/index.js +7 -0
- package/lib/effectRuntime/index.js.map +1 -1
- package/lib/film/compileAttach.js +2 -5
- package/lib/film/compileAttach.js.map +1 -1
- package/lib/film/compileLaunch.d.ts +2 -2
- package/lib/film/compileLaunch.js +4 -3
- package/lib/film/compileLaunch.js.map +1 -1
- package/lib/film/constants/index.d.ts +3 -0
- package/lib/film/constants/index.js +3 -0
- package/lib/film/constants/index.js.map +1 -1
- package/lib/film/index.d.ts +61 -6
- package/lib/film/index.js +61 -12
- package/lib/film/index.js.map +1 -1
- package/lib/film/propAnchorFrame.js +6 -9
- package/lib/film/propAnchorFrame.js.map +1 -1
- package/lib/film/stageScene.js +3 -10
- package/lib/film/stageScene.js.map +1 -1
- package/lib/film/staging/index.d.ts +11 -0
- package/lib/film/staging/index.js +28 -0
- package/lib/film/staging/index.js.map +1 -0
- package/lib/film/staging/lowerLightPlacement.js +4 -7
- package/lib/film/staging/lowerLightPlacement.js.map +1 -1
- package/lib/formationSlotPosition.d.ts +6 -1
- package/lib/formationSlotPosition.js +38 -3
- package/lib/formationSlotPosition.js.map +1 -1
- package/lib/geometry/IAutoMovieMark.d.ts +99 -0
- package/lib/geometry/IAutoMovieMark.js +3 -0
- package/lib/geometry/IAutoMovieMark.js.map +1 -0
- package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
- package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
- package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
- package/lib/geometry/constants/index.d.ts +2 -0
- package/lib/geometry/constants/index.js +2 -0
- package/lib/geometry/constants/index.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
- package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
- package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
- package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
- package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
- package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
- package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
- package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
- package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
- package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
- package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
- package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
- package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
- package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
- package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
- package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
- package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
- package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
- package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
- package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
- package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
- package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
- package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
- package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
- package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
- package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
- package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
- package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
- package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
- package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
- package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
- package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
- package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
- package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
- package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
- package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
- package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
- package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
- package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
- package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
- package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
- package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
- package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
- package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
- package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
- package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
- package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
- package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
- package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
- package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
- package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
- package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
- package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
- package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
- package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
- package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
- package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
- package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
- package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
- package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
- package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
- package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
- package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
- package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
- package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
- package/lib/geometry/construction/index.d.ts +82 -2
- package/lib/geometry/construction/index.js +82 -2
- package/lib/geometry/construction/index.js.map +1 -1
- package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
- package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
- package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
- package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
- package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
- package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
- package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
- package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
- package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
- package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
- package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
- package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
- package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
- package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
- package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
- package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
- package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
- package/lib/geometry/curve/index.d.ts +48 -25
- package/lib/geometry/curve/index.js +48 -25
- package/lib/geometry/curve/index.js.map +1 -1
- package/lib/geometry/extract/index.d.ts +0 -1
- package/lib/geometry/extract/index.js +0 -1
- package/lib/geometry/extract/index.js.map +1 -1
- package/lib/geometry/index.d.ts +87 -53
- package/lib/geometry/index.js +87 -50
- package/lib/geometry/index.js.map +1 -1
- package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
- package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
- package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
- package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
- package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
- package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
- package/lib/geometry/sweep/index.d.ts +54 -15
- package/lib/geometry/sweep/index.js +54 -1
- package/lib/geometry/sweep/index.js.map +1 -1
- package/lib/index.d.ts +41 -450
- package/lib/index.js +41 -660
- package/lib/index.js.map +1 -1
- package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
- package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
- package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
- package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
- package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
- package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
- package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
- package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
- package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
- package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
- package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
- package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
- package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
- package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
- package/lib/kinematics/alternateRigJointAngles.js +34 -0
- package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
- package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
- package/lib/kinematics/boxExcludedSwivels.js +187 -0
- package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
- package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
- package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
- package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
- package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
- package/lib/kinematics/curlChainUntilContact.js +45 -5
- package/lib/kinematics/curlChainUntilContact.js.map +1 -1
- package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
- package/lib/kinematics/decomposeJointRotation.js +10 -131
- package/lib/kinematics/decomposeJointRotation.js.map +1 -1
- package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
- package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
- package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
- package/lib/kinematics/fitDigitDescent.d.ts +66 -0
- package/lib/kinematics/fitDigitDescent.js +142 -0
- package/lib/kinematics/fitDigitDescent.js.map +1 -0
- package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
- package/lib/kinematics/fitDigitToTarget.js +251 -0
- package/lib/kinematics/fitDigitToTarget.js.map +1 -0
- package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
- package/lib/kinematics/hingedArmArticulation.js +273 -84
- package/lib/kinematics/hingedArmArticulation.js.map +1 -1
- package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
- package/lib/kinematics/hingedArmSwivel.js +196 -0
- package/lib/kinematics/hingedArmSwivel.js.map +1 -0
- package/lib/kinematics/index.d.ts +30 -7
- package/lib/kinematics/index.js +30 -5
- package/lib/kinematics/index.js.map +1 -1
- package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
- package/lib/kinematics/jointRomOvershoot.js +21 -17
- package/lib/kinematics/jointRomOvershoot.js.map +1 -1
- package/lib/kinematics/jointToQuaternion.d.ts +2 -2
- package/lib/kinematics/jointToQuaternion.js +4 -19
- package/lib/kinematics/jointToQuaternion.js.map +1 -1
- package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
- package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
- package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
- package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
- package/lib/kinematics/markAutoMovieBalance.js +65 -0
- package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
- package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
- package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
- package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
- package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
- package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
- package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
- package/lib/kinematics/normalizeJointAxes.js +52 -12
- package/lib/kinematics/normalizeJointAxes.js.map +1 -1
- package/lib/kinematics/poseJointCodec.d.ts +71 -0
- package/lib/kinematics/poseJointCodec.js +70 -0
- package/lib/kinematics/poseJointCodec.js.map +1 -0
- package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
- package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
- package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
- package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
- package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
- package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
- package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
- package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
- package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
- package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
- package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
- package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
- package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
- package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
- package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
- package/lib/kinematics/swingTwistBasis.d.ts +108 -0
- package/lib/kinematics/swingTwistBasis.js +116 -0
- package/lib/kinematics/swingTwistBasis.js.map +1 -0
- package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
- package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
- package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
- package/lib/kinematics/swingTwistRange.d.ts +246 -0
- package/lib/kinematics/swingTwistRange.js +322 -0
- package/lib/kinematics/swingTwistRange.js.map +1 -0
- package/lib/kinematics/swingTwistRegion.d.ts +50 -0
- package/lib/kinematics/swingTwistRegion.js +212 -0
- package/lib/kinematics/swingTwistRegion.js.map +1 -0
- package/lib/kinematics/swivelArcs.d.ts +166 -0
- package/lib/kinematics/swivelArcs.js +200 -0
- package/lib/kinematics/swivelArcs.js.map +1 -0
- package/lib/math/Quaternion.d.ts +29 -2
- package/lib/math/Quaternion.js +33 -2
- package/lib/math/Quaternion.js.map +1 -1
- package/lib/math/Transform.d.ts +50 -0
- package/lib/math/Transform.js +58 -0
- package/lib/math/Transform.js.map +1 -0
- package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
- package/lib/math/assignAutoMovieMinimumCost.js +86 -0
- package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
- package/lib/math/bracketedBisection.d.ts +33 -0
- package/lib/math/bracketedBisection.js +52 -0
- package/lib/math/bracketedBisection.js.map +1 -0
- package/lib/math/bracketedRoot.d.ts +32 -0
- package/lib/math/bracketedRoot.js +76 -0
- package/lib/math/bracketedRoot.js.map +1 -0
- package/lib/math/constants/index.d.ts +1 -0
- package/lib/math/constants/index.js +18 -0
- package/lib/math/constants/index.js.map +1 -0
- package/lib/math/index.d.ts +64 -5
- package/lib/math/index.js +64 -5
- package/lib/math/index.js.map +1 -1
- package/lib/math/nearestAngleAlias.d.ts +27 -0
- package/lib/math/nearestAngleAlias.js +44 -0
- package/lib/math/nearestAngleAlias.js.map +1 -0
- package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
- package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
- package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
- package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
- package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
- package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
- package/lib/measureAutoMovieGeometryReach.js +2 -4
- package/lib/measureAutoMovieGeometryReach.js.map +1 -1
- package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
- package/lib/motion/AirborneTakeoffLinear.js +58 -0
- package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
- package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
- package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
- package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
- package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
- package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
- package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
- package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
- package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
- package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
- package/lib/motion/MotionTrajectoryStepper.js +357 -0
- package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
- package/lib/motion/basisOf.d.ts +18 -0
- package/lib/motion/basisOf.js +25 -0
- package/lib/motion/basisOf.js.map +1 -0
- package/lib/motion/carriedAcceleration.d.ts +43 -0
- package/lib/motion/carriedAcceleration.js +55 -0
- package/lib/motion/carriedAcceleration.js.map +1 -0
- package/lib/motion/carriedRate.d.ts +48 -0
- package/lib/motion/carriedRate.js +60 -0
- package/lib/motion/carriedRate.js.map +1 -0
- package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
- package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
- package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
- package/lib/motion/constants/index.d.ts +1 -0
- package/lib/motion/constants/index.js +1 -0
- package/lib/motion/constants/index.js.map +1 -1
- package/lib/motion/fitChainBend.d.ts +23 -0
- package/lib/motion/fitChainBend.js +293 -0
- package/lib/motion/fitChainBend.js.map +1 -0
- package/lib/motion/fitChainToTarget.d.ts +11 -13
- package/lib/motion/fitChainToTarget.js +12 -283
- package/lib/motion/fitChainToTarget.js.map +1 -1
- package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
- package/lib/motion/fitHingedChainCandidate.js +186 -76
- package/lib/motion/fitHingedChainCandidate.js.map +1 -1
- package/lib/motion/fitHingedRotationError.d.ts +31 -0
- package/lib/motion/fitHingedRotationError.js +107 -0
- package/lib/motion/fitHingedRotationError.js.map +1 -0
- package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
- package/lib/motion/fitSeededChainToTarget.js +32 -0
- package/lib/motion/fitSeededChainToTarget.js.map +1 -0
- package/lib/motion/gaitMotion.js +7 -13
- package/lib/motion/gaitMotion.js.map +1 -1
- package/lib/motion/gestureMotion.js +2 -5
- package/lib/motion/gestureMotion.js.map +1 -1
- package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
- package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
- package/lib/motion/index.d.ts +40 -9
- package/lib/motion/index.js +40 -12
- package/lib/motion/index.js.map +1 -1
- package/lib/motion/inertializeOffset.d.ts +15 -2
- package/lib/motion/inertializeOffset.js +16 -3
- package/lib/motion/inertializeOffset.js.map +1 -1
- package/lib/motion/inertializePose.d.ts +36 -13
- package/lib/motion/inertializePose.js +122 -43
- package/lib/motion/inertializePose.js.map +1 -1
- package/lib/motion/integrateAirborneRotation.d.ts +151 -0
- package/lib/motion/integrateAirborneRotation.js +204 -0
- package/lib/motion/integrateAirborneRotation.js.map +1 -0
- package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
- package/lib/motion/integrateMotionTrajectory.js +156 -0
- package/lib/motion/integrateMotionTrajectory.js.map +1 -0
- package/lib/motion/orientChainEffector.d.ts +1 -1
- package/lib/motion/orientChainEffector.js +15 -7
- package/lib/motion/orientChainEffector.js.map +1 -1
- package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
- package/lib/motion/resolveHydrodynamicForce.js +100 -0
- package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
- package/lib/motion/sampleMotion.js +2 -5
- package/lib/motion/sampleMotion.js.map +1 -1
- package/lib/motion/samplePoseVelocity.d.ts +76 -13
- package/lib/motion/samplePoseVelocity.js +126 -38
- package/lib/motion/samplePoseVelocity.js.map +1 -1
- package/lib/motion/smoothMinimum.d.ts +29 -0
- package/lib/motion/smoothMinimum.js +40 -0
- package/lib/motion/smoothMinimum.js.map +1 -0
- package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
- package/lib/motion/solveAirborneTakeoff.js +324 -0
- package/lib/motion/solveAirborneTakeoff.js.map +1 -0
- package/lib/motion/solveDistalTwist.d.ts +62 -0
- package/lib/motion/solveDistalTwist.js +152 -0
- package/lib/motion/solveDistalTwist.js.map +1 -0
- package/lib/motion/speedProfile.d.ts +175 -0
- package/lib/motion/speedProfile.js +261 -0
- package/lib/motion/speedProfile.js.map +1 -0
- package/lib/motion/splitDistalTwist.d.ts +12 -17
- package/lib/motion/splitDistalTwist.js +37 -40
- package/lib/motion/splitDistalTwist.js.map +1 -1
- package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
- package/lib/motion/steerAutoMovieCrowd.js +249 -0
- package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
- package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
- package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
- package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
- package/lib/perform/index.d.ts +10 -0
- package/lib/perform/index.js +10 -0
- package/lib/perform/index.js.map +1 -1
- package/lib/physics/AutoMovieAir.d.ts +21 -0
- package/lib/physics/AutoMovieAir.js +26 -0
- package/lib/physics/AutoMovieAir.js.map +1 -0
- package/lib/physics/AutoMovieGravity.d.ts +22 -0
- package/lib/physics/AutoMovieGravity.js +30 -0
- package/lib/physics/AutoMovieGravity.js.map +1 -0
- package/lib/physics/IAutoMovieHit.d.ts +11 -7
- package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
- package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
- package/lib/physics/admitMotionGeometry.js +12 -0
- package/lib/physics/admitMotionGeometry.js.map +1 -1
- package/lib/physics/bindPhysicalWorld.js +16 -4
- package/lib/physics/bindPhysicalWorld.js.map +1 -1
- package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
- package/lib/physics/combinePhysicalMassProperties.js +8 -90
- package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
- package/lib/physics/deriveCenterOfMass.js +2 -5
- package/lib/physics/deriveCenterOfMass.js.map +1 -1
- package/lib/physics/derivePhysicalProfile.js +7 -5
- package/lib/physics/derivePhysicalProfile.js.map +1 -1
- package/lib/physics/index.d.ts +155 -2
- package/lib/physics/index.js +155 -2
- package/lib/physics/index.js.map +1 -1
- package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
- package/lib/physics/markAutoMovieSkeleton.js +62 -0
- package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
- package/lib/physics/physicalHullErode.d.ts +25 -0
- package/lib/physics/physicalHullErode.js +54 -0
- package/lib/physics/physicalHullErode.js.map +1 -0
- package/lib/physics/physicalHullFaces.d.ts +56 -0
- package/lib/physics/physicalHullFaces.js +151 -0
- package/lib/physics/physicalHullFaces.js.map +1 -0
- package/lib/physics/physicalHullMass.d.ts +32 -0
- package/lib/physics/physicalHullMass.js +80 -0
- package/lib/physics/physicalHullMass.js.map +1 -0
- package/lib/physics/physicalHullNearest.d.ts +37 -0
- package/lib/physics/physicalHullNearest.js +178 -0
- package/lib/physics/physicalHullNearest.js.map +1 -0
- package/lib/physics/physicalHullSegment.d.ts +34 -0
- package/lib/physics/physicalHullSegment.js +276 -0
- package/lib/physics/physicalHullSegment.js.map +1 -0
- package/lib/physics/physicalInertiaTensor.d.ts +28 -0
- package/lib/physics/physicalInertiaTensor.js +58 -0
- package/lib/physics/physicalInertiaTensor.js.map +1 -0
- package/lib/physics/physicalNativeShape.d.ts +1 -1
- package/lib/physics/physicalNativeShape.js +15 -4
- package/lib/physics/physicalNativeShape.js.map +1 -1
- package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
- package/lib/physics/physicalPrincipalAxes.js +96 -0
- package/lib/physics/physicalPrincipalAxes.js.map +1 -0
- package/lib/physics/physicalShapeBounds.d.ts +2 -1
- package/lib/physics/physicalShapeBounds.js +26 -2
- package/lib/physics/physicalShapeBounds.js.map +1 -1
- package/lib/physics/physicalShapeNearest.d.ts +70 -0
- package/lib/physics/physicalShapeNearest.js +201 -0
- package/lib/physics/physicalShapeNearest.js.map +1 -0
- package/lib/physics/physicalShapeNormal.d.ts +26 -0
- package/lib/physics/physicalShapeNormal.js +70 -0
- package/lib/physics/physicalShapeNormal.js.map +1 -0
- package/lib/physics/physicalShapePairDistance.d.ts +32 -0
- package/lib/physics/physicalShapePairDistance.js +124 -0
- package/lib/physics/physicalShapePairDistance.js.map +1 -0
- package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
- package/lib/physics/physicalShapeSegmentDistance.js +18 -70
- package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
- package/lib/physics/physicalShapeSpan.d.ts +21 -0
- package/lib/physics/physicalShapeSpan.js +55 -0
- package/lib/physics/physicalShapeSpan.js.map +1 -0
- package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
- package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
- package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
- package/lib/physics/projectileAt.d.ts +14 -12
- package/lib/physics/projectileAt.js +46 -16
- package/lib/physics/projectileAt.js.map +1 -1
- package/lib/physics/projectileContinue.d.ts +114 -0
- package/lib/physics/projectileContinue.js +189 -0
- package/lib/physics/projectileContinue.js.map +1 -0
- package/lib/physics/projectileDragFlight.d.ts +72 -0
- package/lib/physics/projectileDragFlight.js +166 -0
- package/lib/physics/projectileDragFlight.js.map +1 -0
- package/lib/physics/projectileFirstContact.d.ts +105 -0
- package/lib/physics/projectileFirstContact.js +174 -0
- package/lib/physics/projectileFirstContact.js.map +1 -0
- package/lib/physics/projectileTrajectory.js +3 -2
- package/lib/physics/projectileTrajectory.js.map +1 -1
- package/lib/physics/solveBallisticLaunch.js +2 -1
- package/lib/physics/solveBallisticLaunch.js.map +1 -1
- package/lib/physics/solveMovingLaunch.js +2 -1
- package/lib/physics/solveMovingLaunch.js.map +1 -1
- package/lib/physics/validatePhysicalProfile.js +18 -1
- package/lib/physics/validatePhysicalProfile.js.map +1 -1
- package/lib/populationRuntime/index.d.ts +6 -0
- package/lib/populationRuntime/index.js +6 -0
- package/lib/populationRuntime/index.js.map +1 -1
- package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
- package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
- package/lib/random/index.d.ts +1 -1
- package/lib/random/index.js +1 -0
- package/lib/random/index.js.map +1 -1
- package/lib/render/index.d.ts +20 -11
- package/lib/render/index.js +20 -11
- package/lib/render/index.js.map +1 -1
- package/lib/resolve/index.d.ts +7 -2
- package/lib/resolve/index.js +7 -5
- package/lib/resolve/index.js.map +1 -1
- package/lib/resolve/lowerSkeletonNodes.js +3 -10
- package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
- package/lib/rom/clampJointRom.d.ts +11 -3
- package/lib/rom/clampJointRom.js +43 -3
- package/lib/rom/clampJointRom.js.map +1 -1
- package/lib/rom/clampJointToSkeleton.d.ts +25 -2
- package/lib/rom/clampJointToSkeleton.js +39 -8
- package/lib/rom/clampJointToSkeleton.js.map +1 -1
- package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
- package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
- package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
- package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
- package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
- package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
- package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
- package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
- package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
- package/lib/rom/constants/index.d.ts +2 -0
- package/lib/rom/constants/index.js +2 -0
- package/lib/rom/constants/index.js.map +1 -1
- package/lib/rom/index.d.ts +1 -0
- package/lib/rom/index.js +1 -0
- package/lib/rom/index.js.map +1 -1
- package/lib/rom/scanJointRom.d.ts +62 -0
- package/lib/rom/scanJointRom.js +117 -0
- package/lib/rom/scanJointRom.js.map +1 -0
- package/lib/rom/validateJointRom.d.ts +4 -2
- package/lib/rom/validateJointRom.js +23 -45
- package/lib/rom/validateJointRom.js.map +1 -1
- package/lib/service/index.d.ts +9 -0
- package/lib/service/index.js +9 -0
- package/lib/service/index.js.map +1 -1
- package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
- package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
- package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
- package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
- package/lib/soft/applySoftBodyFriction.d.ts +34 -0
- package/lib/soft/applySoftBodyFriction.js +52 -0
- package/lib/soft/applySoftBodyFriction.js.map +1 -0
- package/lib/soft/index.d.ts +22 -0
- package/lib/soft/index.js +22 -0
- package/lib/soft/index.js.map +1 -1
- package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
- package/lib/soft/projectSoftCordSelfContact.js +172 -0
- package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
- package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
- package/lib/soft/simulateSoftBodyCore.js +108 -16
- package/lib/soft/simulateSoftBodyCore.js.map +1 -1
- package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
- package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
- package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
- package/lib/soft/softBodyBudget.js +7 -0
- package/lib/soft/softBodyBudget.js.map +1 -1
- package/lib/soft/softBodyHeldLoads.d.ts +34 -0
- package/lib/soft/softBodyHeldLoads.js +69 -0
- package/lib/soft/softBodyHeldLoads.js.map +1 -0
- package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
- package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
- package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
- package/lib/soft/validateSoftAnchors.d.ts +24 -0
- package/lib/soft/validateSoftAnchors.js +74 -0
- package/lib/soft/validateSoftAnchors.js.map +1 -0
- package/lib/soft/validateSoftBodyDomain.js +6 -48
- package/lib/soft/validateSoftBodyDomain.js.map +1 -1
- package/lib/soft/validateSoftBounded.d.ts +20 -0
- package/lib/soft/validateSoftBounded.js +27 -0
- package/lib/soft/validateSoftBounded.js.map +1 -0
- package/lib/soft/validateSoftCompliance.d.ts +30 -0
- package/lib/soft/validateSoftCompliance.js +54 -0
- package/lib/soft/validateSoftCompliance.js.map +1 -0
- package/lib/sound/index.d.ts +2 -0
- package/lib/sound/index.js +2 -0
- package/lib/sound/index.js.map +1 -1
- package/lib/text/index.d.ts +1 -0
- package/lib/text/index.js +1 -0
- package/lib/text/index.js.map +1 -1
- package/lib/validation/AffordanceArticulation.d.ts +69 -0
- package/lib/validation/AffordanceArticulation.js +142 -0
- package/lib/validation/AffordanceArticulation.js.map +1 -0
- package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
- package/lib/validation/affordanceFollowedTravel.js +43 -0
- package/lib/validation/affordanceFollowedTravel.js.map +1 -0
- package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
- package/lib/validation/affordanceLeadingTravel.js +99 -0
- package/lib/validation/affordanceLeadingTravel.js.map +1 -0
- package/lib/validation/affordanceTravelRange.d.ts +21 -0
- package/lib/validation/affordanceTravelRange.js +39 -0
- package/lib/validation/affordanceTravelRange.js.map +1 -0
- package/lib/validation/appendShotEventsArtifact.js +12 -0
- package/lib/validation/appendShotEventsArtifact.js.map +1 -1
- package/lib/validation/constants/index.d.ts +3 -3
- package/lib/validation/constants/index.js +3 -3
- package/lib/validation/constants/index.js.map +1 -1
- package/lib/validation/detectFreeFall.js +2 -1
- package/lib/validation/detectFreeFall.js.map +1 -1
- package/lib/validation/index.d.ts +52 -4
- package/lib/validation/index.js +52 -6
- package/lib/validation/index.js.map +1 -1
- package/lib/validation/markAutoMovieSlip.d.ts +26 -0
- package/lib/validation/markAutoMovieSlip.js +52 -0
- package/lib/validation/markAutoMovieSlip.js.map +1 -0
- package/lib/validation/validateAffordance.d.ts +3 -3
- package/lib/validation/validateAffordance.js +21 -3
- package/lib/validation/validateAffordance.js.map +1 -1
- package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
- package/lib/validation/validateAffordanceArticulation.js +183 -0
- package/lib/validation/validateAffordanceArticulation.js.map +1 -0
- package/lib/validation/validateBalanceSupport.d.ts +1 -2
- package/lib/validation/validateBalanceSupport.js.map +1 -1
- package/lib/validation/validateBody.d.ts +2 -2
- package/lib/validation/validateBody.js +27 -3
- package/lib/validation/validateBody.js.map +1 -1
- package/lib/validation/validateFootSkate.d.ts +1 -2
- package/lib/validation/validateFootSkate.js.map +1 -1
- package/lib/validation/validateGroundContact.d.ts +1 -2
- package/lib/validation/validateGroundContact.js.map +1 -1
- package/lib/validation/validateJointConstraint.d.ts +1 -1
- package/lib/validation/validateJointConstraint.js +9 -1
- package/lib/validation/validateJointConstraint.js.map +1 -1
- package/lib/validation/validateModel.js +2 -0
- package/lib/validation/validateModel.js.map +1 -1
- package/lib/validation/validateSelfIntersection.d.ts +1 -2
- package/lib/validation/validateSelfIntersection.js.map +1 -1
- package/lib/worldBlock.js +6 -9
- package/lib/worldBlock.js.map +1 -1
- package/package.json +6 -6
- package/src/IAutoMovieFormationPlacement.ts +4 -3
- package/src/analysis/index.ts +5 -0
- package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
- package/src/anthropometry/index.ts +1 -0
- package/src/architecture/appendBuiltRegionDefects.ts +3 -3
- package/src/architecture/builtOutlineIsClosed.ts +3 -3
- package/{lib/architecture/constants/PLANAR_EPSILON.d.ts → src/architecture/constants/BUILT_PLANAR_EPSILON.ts} +1 -1
- package/src/architecture/constants/index.ts +1 -1
- package/src/architecture/index.ts +157 -117
- package/src/cache/index.ts +9 -0
- package/src/composition/AutoMovieComposition.ts +34 -7
- package/src/composition/AutoMovieScheduleCut.ts +141 -0
- package/src/composition/AutoMovieScheduleError.ts +108 -0
- package/src/composition/AutoMovieSchedulePlace.ts +253 -0
- package/src/composition/AutoMovieScheduleWalk.ts +215 -0
- package/src/composition/IAutoMovieIntent.ts +9 -7
- package/src/composition/index.ts +12 -7
- package/src/composition/markAutoMovieContacts.ts +79 -0
- package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
- package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
- package/src/composition/resolveAutoMovieSchedule.ts +106 -145
- package/src/constants/index.ts +2 -0
- package/src/createAutoMovieGeometryActorReader.ts +2 -1
- package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
- package/src/drawing/index.ts +12 -0
- package/src/effectRuntime/index.ts +7 -0
- package/src/film/compileAttach.ts +2 -5
- package/src/film/compileLaunch.ts +5 -4
- package/src/film/constants/index.ts +3 -0
- package/src/film/index.ts +61 -6
- package/src/film/propAnchorFrame.ts +3 -6
- package/src/film/stageScene.ts +3 -10
- package/src/film/staging/index.ts +11 -0
- package/src/film/staging/lowerLightPlacement.ts +3 -7
- package/src/formationSlotPosition.ts +54 -7
- package/src/geometry/IAutoMovieMark.ts +115 -0
- package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
- package/src/geometry/constants/index.ts +2 -0
- package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
- package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
- package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
- package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
- package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
- package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
- package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
- package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
- package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
- package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
- package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
- package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
- package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
- package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
- package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
- package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
- package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
- package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
- package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
- package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
- package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
- package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
- package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
- package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
- package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
- package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
- package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
- package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
- package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
- package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
- package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
- package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
- package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
- package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
- package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
- package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
- package/src/geometry/construction/index.ts +82 -2
- package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
- package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
- package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
- package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
- package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
- package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
- package/src/geometry/curve/index.ts +48 -25
- package/src/geometry/extract/index.ts +0 -1
- package/src/geometry/index.ts +87 -53
- package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
- package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
- package/src/geometry/sweep/index.ts +54 -15
- package/src/index.ts +41 -450
- package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
- package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
- package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
- package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
- package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
- package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
- package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
- package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
- package/src/kinematics/alternateRigJointAngles.ts +41 -0
- package/src/kinematics/boxExcludedSwivels.ts +260 -0
- package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
- package/src/kinematics/curlChainUntilContact.ts +35 -8
- package/src/kinematics/decomposeJointRotation.ts +15 -178
- package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
- package/src/kinematics/fitDigitDescent.ts +253 -0
- package/src/kinematics/fitDigitToTarget.ts +425 -0
- package/src/kinematics/hingedArmArticulation.ts +402 -116
- package/src/kinematics/hingedArmSwivel.ts +295 -0
- package/src/kinematics/index.ts +30 -12
- package/src/kinematics/jointRomOvershoot.ts +30 -19
- package/src/kinematics/jointToQuaternion.ts +8 -43
- package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
- package/src/kinematics/markAutoMovieBalance.ts +75 -0
- package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
- package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
- package/src/kinematics/normalizeJointAxes.ts +66 -12
- package/src/kinematics/poseJointCodec.ts +148 -0
- package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
- package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
- package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
- package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
- package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
- package/src/kinematics/swingTwistBasis.ts +162 -0
- package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
- package/src/kinematics/swingTwistRange.ts +460 -0
- package/src/kinematics/swingTwistRegion.ts +298 -0
- package/src/kinematics/swivelArcs.ts +245 -0
- package/src/math/Quaternion.ts +42 -2
- package/src/math/Transform.ts +65 -0
- package/src/math/assignAutoMovieMinimumCost.ts +86 -0
- package/src/math/bracketedBisection.ts +51 -0
- package/src/math/bracketedRoot.ts +72 -0
- package/src/math/constants/index.ts +1 -0
- package/src/math/index.ts +64 -5
- package/src/math/nearestAngleAlias.ts +43 -0
- package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
- package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
- package/src/measureAutoMovieGeometryReach.ts +2 -4
- package/src/motion/AirborneTakeoffLinear.ts +70 -0
- package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
- package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
- package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
- package/src/motion/IFitChainToTargetProps.ts +67 -0
- package/src/motion/MotionTrajectoryStepper.ts +478 -0
- package/src/motion/basisOf.ts +29 -0
- package/src/motion/carriedAcceleration.ts +56 -0
- package/src/motion/carriedRate.ts +61 -0
- package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
- package/src/motion/constants/index.ts +1 -0
- package/src/motion/fitChainBend.ts +491 -0
- package/src/motion/fitChainToTarget.ts +13 -485
- package/src/motion/fitHingedChainCandidate.ts +281 -148
- package/src/motion/fitHingedRotationError.ts +164 -0
- package/src/motion/fitSeededChainToTarget.ts +34 -0
- package/src/motion/gaitMotion.ts +6 -10
- package/src/motion/gestureMotion.ts +2 -5
- package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
- package/src/motion/index.ts +40 -9
- package/src/motion/inertializeOffset.ts +16 -2
- package/src/motion/inertializePose.ts +158 -53
- package/src/motion/integrateAirborneRotation.ts +334 -0
- package/src/motion/integrateMotionTrajectory.ts +309 -0
- package/src/motion/orientChainEffector.ts +19 -13
- package/src/motion/resolveHydrodynamicForce.ts +143 -0
- package/src/motion/sampleMotion.ts +2 -5
- package/src/motion/samplePoseVelocity.ts +168 -41
- package/src/motion/smoothMinimum.ts +36 -0
- package/src/motion/solveAirborneTakeoff.ts +471 -0
- package/src/motion/solveDistalTwist.ts +256 -0
- package/src/motion/speedProfile.ts +470 -0
- package/src/motion/splitDistalTwist.ts +55 -64
- package/src/motion/steerAutoMovieCrowd.ts +381 -0
- package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
- package/src/perform/index.ts +10 -0
- package/src/physics/AutoMovieAir.ts +22 -0
- package/src/physics/AutoMovieGravity.ts +28 -0
- package/src/physics/IAutoMovieHit.ts +13 -7
- package/src/physics/IAutoMovieProjectile.ts +82 -6
- package/src/physics/IAutoMovieProjectileState.ts +10 -4
- package/src/physics/admitMotionGeometry.ts +16 -0
- package/src/physics/bindPhysicalWorld.ts +22 -11
- package/src/physics/combinePhysicalMassProperties.ts +9 -117
- package/src/physics/deriveCenterOfMass.ts +2 -5
- package/src/physics/derivePhysicalProfile.ts +3 -1
- package/src/physics/index.ts +155 -2
- package/src/physics/markAutoMovieSkeleton.ts +69 -0
- package/src/physics/physicalHullErode.ts +72 -0
- package/src/physics/physicalHullFaces.ts +215 -0
- package/src/physics/physicalHullMass.ts +99 -0
- package/src/physics/physicalHullNearest.ts +210 -0
- package/src/physics/physicalHullSegment.ts +338 -0
- package/src/physics/physicalInertiaTensor.ts +75 -0
- package/src/physics/physicalNativeShape.ts +31 -9
- package/src/physics/physicalPrincipalAxes.ts +114 -0
- package/src/physics/physicalShapeBounds.ts +24 -2
- package/src/physics/physicalShapeNearest.ts +287 -0
- package/src/physics/physicalShapeNormal.ts +105 -0
- package/src/physics/physicalShapePairDistance.ts +153 -0
- package/src/physics/physicalShapeSegmentDistance.ts +18 -92
- package/src/physics/physicalShapeSpan.ts +75 -0
- package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
- package/src/physics/projectileAt.ts +61 -20
- package/src/physics/projectileContinue.ts +287 -0
- package/src/physics/projectileDragFlight.ts +208 -0
- package/src/physics/projectileFirstContact.ts +286 -0
- package/src/physics/projectileTrajectory.ts +6 -5
- package/src/physics/solveBallisticLaunch.ts +2 -1
- package/src/physics/solveMovingLaunch.ts +2 -1
- package/src/physics/validatePhysicalProfile.ts +20 -1
- package/src/populationRuntime/index.ts +6 -0
- package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
- package/src/random/index.ts +1 -1
- package/src/render/index.ts +20 -11
- package/src/resolve/index.ts +7 -2
- package/src/resolve/lowerSkeletonNodes.ts +3 -10
- package/src/rom/clampJointRom.ts +59 -2
- package/src/rom/clampJointToSkeleton.ts +52 -15
- package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
- package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
- package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
- package/src/rom/constants/index.ts +2 -0
- package/src/rom/index.ts +1 -0
- package/src/rom/scanJointRom.ts +169 -0
- package/src/rom/validateJointRom.ts +69 -74
- package/src/service/index.ts +9 -0
- package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
- package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
- package/src/soft/applySoftBodyFriction.ts +65 -0
- package/src/soft/index.ts +22 -0
- package/src/soft/projectSoftCordSelfContact.ts +239 -0
- package/src/soft/simulateSoftBodyCore.ts +127 -15
- package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
- package/src/soft/softBodyBudget.ts +11 -0
- package/src/soft/softBodyHeldLoads.ts +85 -0
- package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
- package/src/soft/validateSoftAnchors.ts +143 -0
- package/src/soft/validateSoftBodyDomain.ts +5 -124
- package/src/soft/validateSoftBounded.ts +42 -0
- package/src/soft/validateSoftCompliance.ts +102 -0
- package/src/sound/index.ts +2 -0
- package/src/text/index.ts +1 -0
- package/src/validation/AffordanceArticulation.ts +173 -0
- package/src/validation/affordanceFollowedTravel.ts +40 -0
- package/src/validation/affordanceLeadingTravel.ts +108 -0
- package/src/validation/affordanceTravelRange.ts +42 -0
- package/src/validation/appendShotEventsArtifact.ts +26 -0
- package/src/validation/constants/index.ts +3 -3
- package/src/validation/detectFreeFall.ts +3 -2
- package/src/validation/index.ts +52 -4
- package/src/validation/markAutoMovieSlip.ts +65 -0
- package/src/validation/validateAffordance.ts +38 -3
- package/src/validation/validateAffordanceArticulation.ts +311 -0
- package/src/validation/validateBalanceSupport.ts +2 -5
- package/src/validation/validateBody.ts +80 -3
- package/src/validation/validateFootSkate.ts +1 -1
- package/src/validation/validateGroundContact.ts +2 -5
- package/src/validation/validateJointConstraint.ts +19 -1
- package/src/validation/validateModel.ts +7 -0
- package/src/validation/validateSelfIntersection.ts +2 -5
- package/src/worldBlock.ts +3 -6
- package/lib/architecture/constants/PLANAR_EPSILON.js.map +0 -1
|
@@ -0,0 +1,253 @@
|
|
|
1
|
+
import { AutoMovieSolidVector } from "../geometry/construction/AutoMovieSolidVector";
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* One prioritized descent of a digit's fit: a primary residual (where the
|
|
5
|
+
* point goes) met first, and a secondary one (how it is turned, how its
|
|
6
|
+
* joints couple) bettered only in what the primary leaves free, inside the
|
|
7
|
+
* range the projection keeps.
|
|
8
|
+
*
|
|
9
|
+
* Each step is the damped least-squares step of the primary task, h1 =
|
|
10
|
+
* -(J1'J1 + mu I)^-1 J1'r1, plus the secondary task's damped step taken in
|
|
11
|
+
* the primary's damped null space, N = I - (J1'J1 + mu I)^-1 J1'J1, so the
|
|
12
|
+
* secondary moves only what leaves the primary where it is to first order:
|
|
13
|
+
* the task-priority inverse kinematics of Nakamura, Hanafusa and Yoshikawa
|
|
14
|
+
* 1987 ("Task-priority based redundancy control of robot manipulators",
|
|
15
|
+
* IJRR 6(2):3-15) in the damped form of Chiaverini 1997 ("Singularity-robust
|
|
16
|
+
* task-priority redundancy resolution", IEEE TRA 13(3):398-410). A variable
|
|
17
|
+
* standing on a bound its descent pushes against (the projection undoes a
|
|
18
|
+
* resolution's move along the negative gradient) is held for the step, the
|
|
19
|
+
* active set of a projected Newton method (Bertsekas 1982); the gradient is
|
|
20
|
+
* the primary's while the primary is unmet, so the secondary never holds a
|
|
21
|
+
* joint the primary needs.
|
|
22
|
+
*
|
|
23
|
+
* A trial is accepted lexicographically: while the primary is unmet, only
|
|
24
|
+
* when it lowers the primary; once met (within the effector's motion for one
|
|
25
|
+
* resolution step of every joint, `tolerance`), when it keeps the primary met
|
|
26
|
+
* and lowers the secondary. The damping follows Levenberg-Marquardt with
|
|
27
|
+
* Nielsen's update at its bounds (Madsen, Nielsen and Tingleff 2004,
|
|
28
|
+
* Algorithm 3.16, tau = 1e-3): a third on an accepted step, a doubling growth
|
|
29
|
+
* on a rejected one, so the steps shrink until the descent stops, when the
|
|
30
|
+
* step it would take moves no variable by more than `step`.
|
|
31
|
+
*
|
|
32
|
+
* @param props The start, the residuals, the projection, the resolution and the primary's tolerance.
|
|
33
|
+
* @returns The variables where the descent stops, projected.
|
|
34
|
+
*
|
|
35
|
+
* @evidence contracts/development/common.md#meaningful-documentation States the two tasks, the step's form and its sources, the active set, the lexicographic acceptance, the damping and the stop.
|
|
36
|
+
* @evidence contracts/development/implementation.md#principled-implementation Damped task-priority least squares (Nakamura et al. 1987, Chiaverini 1997) with a projected Newton active set (Bertsekas 1982) and Levenberg-Marquardt damping (Madsen, Nielsen and Tingleff 2004).
|
|
37
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure One loop: Jacobians, active set, primary step, null-space secondary step, acceptance.
|
|
38
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No iteration count and no weight between the tasks: the primary is never traded for the secondary, and the descent stops at the resolution.
|
|
39
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Two residual evaluations per variable per Jacobian and two small dense solves per step, the variables at most a digit's nine.
|
|
40
|
+
* @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its input; the caller keeps the result.
|
|
41
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
|
|
42
|
+
*/
|
|
43
|
+
export function fitDigitDescent(props: fitDigitDescent.IProps): number[] {
|
|
44
|
+
const { primary, secondary, project, step }: fitDigitDescent.IProps = props;
|
|
45
|
+
const n: number = props.start.length;
|
|
46
|
+
const jacobian = (
|
|
47
|
+
f: (x: readonly number[]) => number[],
|
|
48
|
+
x: readonly number[],
|
|
49
|
+
): number[][] => {
|
|
50
|
+
const columns: number[][] = x.map((_v: number, i: number): number[] => {
|
|
51
|
+
const up: number[] = [...x];
|
|
52
|
+
const down: number[] = [...x];
|
|
53
|
+
up[i] = up[i]! + step;
|
|
54
|
+
down[i] = down[i]! - step;
|
|
55
|
+
const a: number[] = f(up);
|
|
56
|
+
const b: number[] = f(down);
|
|
57
|
+
return a.map((v: number, k: number): number => (v - b[k]!) / (2 * step));
|
|
58
|
+
});
|
|
59
|
+
return columns[0]!.map((_r: number, k: number): number[] =>
|
|
60
|
+
columns.map((c: number[]): number => c[k]!),
|
|
61
|
+
);
|
|
62
|
+
};
|
|
63
|
+
const squared = (r: readonly number[]): number =>
|
|
64
|
+
r.reduce((sum: number, v: number): number => sum + v * v, 0);
|
|
65
|
+
const gram = (
|
|
66
|
+
J: readonly (readonly number[])[],
|
|
67
|
+
at: readonly number[],
|
|
68
|
+
): number[][] =>
|
|
69
|
+
at.map((i: number): number[] =>
|
|
70
|
+
at.map((j: number): number =>
|
|
71
|
+
J.reduce(
|
|
72
|
+
(s: number, row: readonly number[]): number => s + row[i]! * row[j]!,
|
|
73
|
+
0,
|
|
74
|
+
),
|
|
75
|
+
),
|
|
76
|
+
);
|
|
77
|
+
const times = (
|
|
78
|
+
J: readonly (readonly number[])[],
|
|
79
|
+
at: readonly number[],
|
|
80
|
+
r: readonly number[],
|
|
81
|
+
): number[] =>
|
|
82
|
+
at.map((i: number): number =>
|
|
83
|
+
J.reduce(
|
|
84
|
+
(s: number, row: readonly number[], k: number): number =>
|
|
85
|
+
s + row[i]! * r[k]!,
|
|
86
|
+
0,
|
|
87
|
+
),
|
|
88
|
+
);
|
|
89
|
+
const damped = (A: number[][], mu: number): number[][] =>
|
|
90
|
+
A.map((row: number[], i: number): number[] =>
|
|
91
|
+
row.map((v: number, j: number): number => (i === j ? v + mu : v)),
|
|
92
|
+
);
|
|
93
|
+
|
|
94
|
+
let x: number[] = project(props.start);
|
|
95
|
+
let r1: number[] = primary(x);
|
|
96
|
+
let r2: number[] = secondary(x);
|
|
97
|
+
let J1: number[][] = jacobian(primary, x);
|
|
98
|
+
let J2: number[][] = r2.length === 0 ? [] : jacobian(secondary, x);
|
|
99
|
+
const all: number[] = Array.from(
|
|
100
|
+
{ length: n },
|
|
101
|
+
(_: unknown, i: number): number => i,
|
|
102
|
+
);
|
|
103
|
+
let mu: number =
|
|
104
|
+
TAU *
|
|
105
|
+
Math.max(
|
|
106
|
+
...all.map(
|
|
107
|
+
(i: number): number =>
|
|
108
|
+
gram(J1, [i])[0]![0]! + (J2.length === 0 ? 0 : gram(J2, [i])[0]![0]!),
|
|
109
|
+
),
|
|
110
|
+
);
|
|
111
|
+
let nu: number = 2;
|
|
112
|
+
for (;;) {
|
|
113
|
+
// The active set, by the gradient of the task being served: the
|
|
114
|
+
// primary's while it is unmet, so a bound the secondary pushes against
|
|
115
|
+
// never holds a joint the primary needs; the whole residual's once met.
|
|
116
|
+
const met: number = props.tolerance(x, J1);
|
|
117
|
+
const served: boolean = Math.sqrt(squared(r1)) <= met;
|
|
118
|
+
const g: number[] = all.map(
|
|
119
|
+
(i: number): number =>
|
|
120
|
+
times(J1, [i], r1)[0]! +
|
|
121
|
+
(J2.length === 0 || !served ? 0 : times(J2, [i], r2)[0]!),
|
|
122
|
+
);
|
|
123
|
+
const free: number[] = all.filter((i: number): boolean => {
|
|
124
|
+
if (g[i] === 0) return true;
|
|
125
|
+
const probe: number[] = [...x];
|
|
126
|
+
probe[i] = x[i]! - Math.sign(g[i]!) * step;
|
|
127
|
+
return Math.abs(project(probe)[i]! - x[i]!) >= step / 2;
|
|
128
|
+
});
|
|
129
|
+
if (free.length === 0) break;
|
|
130
|
+
|
|
131
|
+
// The primary's damped step and its damped null space.
|
|
132
|
+
const A1: number[][] = damped(gram(J1, free), mu);
|
|
133
|
+
const h1: number[] | null = AutoMovieSolidVector.solve(
|
|
134
|
+
A1,
|
|
135
|
+
times(J1, free, r1).map((v: number): number => -v),
|
|
136
|
+
);
|
|
137
|
+
if (h1 === null) break;
|
|
138
|
+
let h: number[] = h1;
|
|
139
|
+
if (J2.length !== 0) {
|
|
140
|
+
const G: number[][] = gram(J1, free);
|
|
141
|
+
const P: (number[] | null)[] = free.map(
|
|
142
|
+
(_c: number, c: number): number[] | null =>
|
|
143
|
+
AutoMovieSolidVector.solve(
|
|
144
|
+
A1,
|
|
145
|
+
G.map((row: number[]): number => row[c]!),
|
|
146
|
+
),
|
|
147
|
+
);
|
|
148
|
+
if (P.some((col: number[] | null): boolean => col === null)) break;
|
|
149
|
+
// N = I - P, P's columns solved above.
|
|
150
|
+
const N: number[][] = free.map((_r: number, a: number): number[] =>
|
|
151
|
+
free.map(
|
|
152
|
+
(_c: number, c: number): number => (a === c ? 1 : 0) - P[c]![a]!,
|
|
153
|
+
),
|
|
154
|
+
);
|
|
155
|
+
const J2f: number[][] = J2.map((row: number[]): number[] =>
|
|
156
|
+
free.map((i: number): number => row[i]!),
|
|
157
|
+
);
|
|
158
|
+
const M: number[][] = J2f.map((row: number[]): number[] =>
|
|
159
|
+
free.map((_c: number, c: number): number =>
|
|
160
|
+
row.reduce(
|
|
161
|
+
(s: number, v: number, a: number): number => s + v * N[a]![c]!,
|
|
162
|
+
0,
|
|
163
|
+
),
|
|
164
|
+
),
|
|
165
|
+
);
|
|
166
|
+
const b: number[] = J2f.map(
|
|
167
|
+
(row: number[], k: number): number =>
|
|
168
|
+
r2[k]! +
|
|
169
|
+
row.reduce(
|
|
170
|
+
(s: number, v: number, a: number): number => s + v * h1[a]!,
|
|
171
|
+
0,
|
|
172
|
+
),
|
|
173
|
+
);
|
|
174
|
+
const local: number[] = free.map((_v: number, a: number): number => a);
|
|
175
|
+
const z: number[] | null = AutoMovieSolidVector.solve(
|
|
176
|
+
damped(gram(M, local), mu),
|
|
177
|
+
times(M, local, b).map((v: number): number => -v),
|
|
178
|
+
);
|
|
179
|
+
if (z !== null)
|
|
180
|
+
h = h1.map(
|
|
181
|
+
(v: number, a: number): number =>
|
|
182
|
+
v +
|
|
183
|
+
N[a]!.reduce(
|
|
184
|
+
(s: number, w: number, c: number): number => s + w * z[c]!,
|
|
185
|
+
0,
|
|
186
|
+
),
|
|
187
|
+
);
|
|
188
|
+
}
|
|
189
|
+
if (Math.max(...h.map((v: number): number => Math.abs(v))) <= step) break;
|
|
190
|
+
|
|
191
|
+
const trial: number[] = project(
|
|
192
|
+
x.map((v: number, i: number): number => {
|
|
193
|
+
const a: number = free.indexOf(i);
|
|
194
|
+
return a < 0 ? v : v + h[a]!;
|
|
195
|
+
}),
|
|
196
|
+
);
|
|
197
|
+
const t1: number[] = primary(trial);
|
|
198
|
+
const t2: number[] = secondary(trial);
|
|
199
|
+
const accepted: boolean = !served
|
|
200
|
+
? squared(t1) < squared(r1)
|
|
201
|
+
: Math.sqrt(squared(t1)) <= met && squared(t2) < squared(r2);
|
|
202
|
+
if (accepted) {
|
|
203
|
+
x = trial;
|
|
204
|
+
r1 = t1;
|
|
205
|
+
r2 = t2;
|
|
206
|
+
J1 = jacobian(primary, x);
|
|
207
|
+
J2 = r2.length === 0 ? [] : jacobian(secondary, x);
|
|
208
|
+
mu /= 3;
|
|
209
|
+
nu = 2;
|
|
210
|
+
} else {
|
|
211
|
+
mu *= nu;
|
|
212
|
+
nu *= 2;
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
return x;
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
/**
|
|
219
|
+
* Companion of {@link fitDigitDescent}.
|
|
220
|
+
*
|
|
221
|
+
* @evidence contracts/development/common.md#meaningful-documentation Documents each member's meaning and unit.
|
|
222
|
+
* @evidence contracts/development/design.md#principled-representation The two tasks as residual functions of the variables, the projection into the range, the resolution and the primary's tolerance.
|
|
223
|
+
* @evidence contracts/development/design.md#minimal-and-owned-surface What one descent reads.
|
|
224
|
+
* @evidence contracts/development/design.md#prohibited-design-shortcuts Plain functions of number arrays; no rig type leaks in.
|
|
225
|
+
*/
|
|
226
|
+
export namespace fitDigitDescent {
|
|
227
|
+
/** What one descent reads. */
|
|
228
|
+
export interface IProps {
|
|
229
|
+
/** The start, the variables' values. */
|
|
230
|
+
start: readonly number[];
|
|
231
|
+
|
|
232
|
+
/** The primary residual, metres. */
|
|
233
|
+
primary: (x: readonly number[]) => number[];
|
|
234
|
+
|
|
235
|
+
/** The secondary residual, metres; empty when there is none. */
|
|
236
|
+
secondary: (x: readonly number[]) => number[];
|
|
237
|
+
|
|
238
|
+
/** The variables projected into their range. */
|
|
239
|
+
project: (x: readonly number[]) => number[];
|
|
240
|
+
|
|
241
|
+
/** The variables' resolution: the finite-difference step and the stop. */
|
|
242
|
+
step: number;
|
|
243
|
+
|
|
244
|
+
/** The primary residual's length at which the primary counts as met, at `x` with its Jacobian. */
|
|
245
|
+
tolerance: (
|
|
246
|
+
x: readonly number[],
|
|
247
|
+
J1: readonly (readonly number[])[],
|
|
248
|
+
) => number;
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
/** The damping start of Levenberg-Marquardt relative to the largest diagonal entry of the normal matrix (Madsen, Nielsen and Tingleff 2004, section 3.2, tau = 1e-3 for a start believed close). */
|
|
253
|
+
const TAU: number = 1e-3;
|
|
@@ -0,0 +1,425 @@
|
|
|
1
|
+
import type {
|
|
2
|
+
AutoMovieHumanoidBone,
|
|
3
|
+
IAutoMovieAngleRange,
|
|
4
|
+
IAutoMovieBone,
|
|
5
|
+
IAutoMovieJointAxes,
|
|
6
|
+
IAutoMovieJointConstraint,
|
|
7
|
+
IAutoMovieJointPose,
|
|
8
|
+
IAutoMoviePose,
|
|
9
|
+
IAutoMovieSkeleton,
|
|
10
|
+
IAutoMovieVector3,
|
|
11
|
+
} from "@automovie/interface";
|
|
12
|
+
|
|
13
|
+
import { Quaternion } from "../math/Quaternion";
|
|
14
|
+
import { Vector3 } from "../math/Vector3";
|
|
15
|
+
import type { IAutoMovieRestFrame } from "../rom/IAutoMovieRestFrame";
|
|
16
|
+
import { clampJointToSkeleton } from "../rom/clampJointToSkeleton";
|
|
17
|
+
import { ROM_TOLERANCE } from "../rom/constants/ROM_TOLERANCE";
|
|
18
|
+
import { getConstraint } from "../rom/getConstraint";
|
|
19
|
+
import type { IAutoMovieResolvedBone } from "./IAutoMovieResolvedBone";
|
|
20
|
+
import type { IAutoMovieSkeletonTopology } from "./IAutoMovieSkeletonTopology";
|
|
21
|
+
import { fitDigitDescent } from "./fitDigitDescent";
|
|
22
|
+
import { indexSkeletonTopology } from "./indexSkeletonTopology";
|
|
23
|
+
import { resolvePose } from "./resolvePose";
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* Put a point of a digit (its tip or its pad, a frame on its distal phalanx)
|
|
27
|
+
* on a world point, with the digit's own joints alone, inside their range of
|
|
28
|
+
* motion: the inverse kinematics of one finger or the thumb with the hand
|
|
29
|
+
* where the pose has placed it.
|
|
30
|
+
*
|
|
31
|
+
* Every free axis of every joint of the digit (an axis its constraint does
|
|
32
|
+
* not hold immobile) is a variable, in clinical degrees. The fit has two
|
|
33
|
+
* tasks in priority order. The first puts the effector on the target: its
|
|
34
|
+
* residual is the distance between them. The second, bettered only in what
|
|
35
|
+
* the first leaves free, turns the effector's normal onto the target normal
|
|
36
|
+
* when one is given (the misalignment scaled by the effector's distance from
|
|
37
|
+
* its joint, an arc length, so a degree of tilt counts as the millimetres it
|
|
38
|
+
* swings the phalanx) and keeps a finger's interphalangeal coupling, the
|
|
39
|
+
* distal joint following the middle one at the ratio `coupling` (the
|
|
40
|
+
* coupling of hand animation, DIP = 2/3 PIP, Rijpkema and Girard 1991,
|
|
41
|
+
* SIGGRAPH 25(4):339-348, as relayed by the hand-animation literature;
|
|
42
|
+
* provisional until read at the source), its residual likewise that distance
|
|
43
|
+
* times the angle by which the distal joint misses the ratio. The point
|
|
44
|
+
* goal, optionally eased by soft IK as described below, is never traded
|
|
45
|
+
* against a normal or a coupling it does not allow.
|
|
46
|
+
*
|
|
47
|
+
* Each descent is `fitDigitDescent`: damped task-priority least squares
|
|
48
|
+
* (Nakamura, Hanafusa and Yoshikawa 1987; Chiaverini 1997) with the active
|
|
49
|
+
* set of a projected Newton method (Bertsekas 1982) for the joints on a
|
|
50
|
+
* bound, and Levenberg-Marquardt damping (Madsen, Nielsen and Tingleff 2004).
|
|
51
|
+
* The Jacobians are read by central differences on the engine's own forward
|
|
52
|
+
* kinematics, so the angles mean what `resolvePose` displays, and every
|
|
53
|
+
* trial is projected into the range (`clampJointToSkeleton`) before it is
|
|
54
|
+
* measured. The point counts as reached within the effector's motion for one
|
|
55
|
+
* resolution step of every joint, and a descent stops when its step moves no
|
|
56
|
+
* joint by more than `ROM_TOLERANCE`, the resolution to which the engine
|
|
57
|
+
* resolves a joint's angle.
|
|
58
|
+
* The fit is a continuation: it descends from the pose's own angles for the
|
|
59
|
+
* digit, so a caller that seeds each fit from the one before follows a
|
|
60
|
+
* moving target in one basin, its joints moving continuously. Only when that
|
|
61
|
+
* fit cannot reach the target (the tip farther from it than one joint
|
|
62
|
+
* resolution of every joint would move it) does it restart from the middle
|
|
63
|
+
* of every range, where a digit folded the wrong way round its target is not
|
|
64
|
+
* trapped, keeping the restart only if it comes nearer; it never takes the
|
|
65
|
+
* better of two starts for a target the continued fit reaches, an argmin
|
|
66
|
+
* that would switch basins between neighbouring targets. A caller's `rate`
|
|
67
|
+
* softens the target near full extension, where the exact inverse has an
|
|
68
|
+
* unbounded derivative: the exponential soft IK of Andy Nicholas (2006),
|
|
69
|
+
* demonstrated in Jeremie Passerin's "Control Rig: 5.3: Soft IK" (2024,
|
|
70
|
+
* https://dev.epicgames.com/community/learning/tutorials/y4Ll/unreal-engine-control-rig-5-3-soft-ik).
|
|
71
|
+
* Below the soft band the target is unchanged; within it, some reach is
|
|
72
|
+
* traded for a bounded radial extension rate. The band's width comes from
|
|
73
|
+
* the chain's lengths and the requested rate, not the seed's posture.
|
|
74
|
+
* This controls the full-extension singularity, not every possible change
|
|
75
|
+
* of basin of a constrained digit. The result is
|
|
76
|
+
* deterministic for its input: fixed starts, a fixed order of variables and
|
|
77
|
+
* no random draw. A target outside the digit's workspace is fitted as
|
|
78
|
+
* nearly as this constrained local solve reaches it. With `rate` it fits
|
|
79
|
+
* the eased target instead, so its constrained minimum may differ from
|
|
80
|
+
* the original target's. In either case `residual` reports distance to the
|
|
81
|
+
* original target, including any reach traded away, so a caller refuses
|
|
82
|
+
* or accepts by its own bound.
|
|
83
|
+
*
|
|
84
|
+
* @param input The rig, the posed body, the digit's joints and the effector and target.
|
|
85
|
+
* @returns The digit's fitted joints, the effector's world point and the residual.
|
|
86
|
+
* @throws {Error} When the digit names no joint, a bone cannot be resolved, or `rate` is not finite and positive.
|
|
87
|
+
*
|
|
88
|
+
* @evidence contracts/development/common.md#meaningful-documentation States the variables, the two tasks and their units and order, the coupling's source and status, the method and its sources, the reach and stop rules and their owner, the continuation, determinism and the out-of-reach behaviour.
|
|
89
|
+
* @evidence contracts/development/implementation.md#principled-implementation Damped task-priority least squares (Nakamura et al. 1987, Chiaverini 1997) through `fitDigitDescent` on the engine's forward kinematics, every trial measured after the range clamp, stopping at the engine's joint-angle resolution; continuation from the caller's seed. Optional exponential soft IK eases only the target's radial distance in a band derived from the full-extension curvature.
|
|
90
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure Two residual functions over the digit's variables, one continued descent and a restart only when it cannot reach.
|
|
91
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No iteration count and no weight between the tasks: the fit ends at the joint-angle resolution and reports distance from the original target, including any reach soft IK trades away. The width is derived from the chain lengths and `rate`; it does not penalise departure from an arbitrary seed.
|
|
92
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Each evaluation is one forward kinematics of the rig, linear in its bones; a Jacobian costs two per variable (at most 9 for a digit of three joints) and the active set's probe one clamp per variable; a step solves two small systems of the free variables; a restart, run only for a target the continued fit cannot reach, doubles the work.
|
|
93
|
+
* @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its input; a caller keeps the result by its own plan.
|
|
94
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the returned joints belong to the caller.
|
|
95
|
+
*/
|
|
96
|
+
export function fitDigitToTarget(
|
|
97
|
+
input: fitDigitToTarget.IInput,
|
|
98
|
+
): fitDigitToTarget.IResult {
|
|
99
|
+
if (input.bones.length === 0)
|
|
100
|
+
throw new Error("A digit fit needs the digit's joints");
|
|
101
|
+
if (
|
|
102
|
+
input.rate !== undefined &&
|
|
103
|
+
!(Number.isFinite(input.rate) && input.rate > 0)
|
|
104
|
+
)
|
|
105
|
+
throw new Error("A digit fit's rate must be finite and positive");
|
|
106
|
+
const topology: IAutoMovieSkeletonTopology =
|
|
107
|
+
input.topology ?? indexSkeletonTopology(input.skeleton);
|
|
108
|
+
const coupling: number | null = input.coupling ?? null;
|
|
109
|
+
const target: IAutoMovieVector3 = softTarget(input, topology);
|
|
110
|
+
|
|
111
|
+
// The digit's free axes, in the order of its joints.
|
|
112
|
+
const variables: IVariable[] = [];
|
|
113
|
+
for (const bone of input.bones) {
|
|
114
|
+
const constraint: IAutoMovieJointConstraint | null = getConstraint(
|
|
115
|
+
bone,
|
|
116
|
+
input.skeleton.bones.find((b: IAutoMovieBone): boolean => b.bone === bone)
|
|
117
|
+
?.constraint ?? null,
|
|
118
|
+
);
|
|
119
|
+
for (const axis of AXES)
|
|
120
|
+
if (constraint === null || constraint[axis] !== null)
|
|
121
|
+
variables.push({ bone, axis, range: constraint?.[axis] ?? null });
|
|
122
|
+
}
|
|
123
|
+
const clamps: Map<
|
|
124
|
+
AutoMovieHumanoidBone,
|
|
125
|
+
(joint: IAutoMovieJointPose) => IAutoMovieJointPose
|
|
126
|
+
> = new Map(
|
|
127
|
+
input.bones.map(
|
|
128
|
+
(
|
|
129
|
+
bone: AutoMovieHumanoidBone,
|
|
130
|
+
): [
|
|
131
|
+
AutoMovieHumanoidBone,
|
|
132
|
+
(joint: IAutoMovieJointPose) => IAutoMovieJointPose,
|
|
133
|
+
] => [bone, clampJointToSkeleton.of(bone, input.skeleton)],
|
|
134
|
+
),
|
|
135
|
+
);
|
|
136
|
+
const others: IAutoMovieJointPose[] = input.pose.joints.filter(
|
|
137
|
+
(j: IAutoMovieJointPose): boolean => !input.bones.includes(j.bone),
|
|
138
|
+
);
|
|
139
|
+
|
|
140
|
+
// The digit's joints for a vector of variables, projected into the range.
|
|
141
|
+
const joints = (x: readonly number[]): IAutoMovieJointPose[] =>
|
|
142
|
+
input.bones.map((bone: AutoMovieHumanoidBone): IAutoMovieJointPose => {
|
|
143
|
+
const joint: IAutoMovieJointPose = {
|
|
144
|
+
bone,
|
|
145
|
+
flexion: null,
|
|
146
|
+
abduction: null,
|
|
147
|
+
twist: null,
|
|
148
|
+
};
|
|
149
|
+
variables.forEach((v: IVariable, i: number): void => {
|
|
150
|
+
if (v.bone === bone) joint[v.axis] = x[i]!;
|
|
151
|
+
});
|
|
152
|
+
return clamps.get(bone)!(joint);
|
|
153
|
+
});
|
|
154
|
+
const read = (list: readonly IAutoMovieJointPose[]): number[] =>
|
|
155
|
+
variables.map((v: IVariable): number => {
|
|
156
|
+
const joint: IAutoMovieJointPose | undefined = list.find(
|
|
157
|
+
(j: IAutoMovieJointPose): boolean => j.bone === v.bone,
|
|
158
|
+
);
|
|
159
|
+
return joint?.[v.axis] ?? 0;
|
|
160
|
+
});
|
|
161
|
+
|
|
162
|
+
// The effector's world frame under the digit's joints.
|
|
163
|
+
const place = (
|
|
164
|
+
list: readonly IAutoMovieJointPose[],
|
|
165
|
+
): { point: IAutoMovieVector3; normal: IAutoMovieVector3 } => {
|
|
166
|
+
const pose: IAutoMoviePose = {
|
|
167
|
+
...input.pose,
|
|
168
|
+
joints: [...others, ...list],
|
|
169
|
+
};
|
|
170
|
+
const resolved: IAutoMovieResolvedBone | undefined = resolvePose(
|
|
171
|
+
pose,
|
|
172
|
+
input.skeleton,
|
|
173
|
+
input.jointAxes,
|
|
174
|
+
input.restFrames,
|
|
175
|
+
topology,
|
|
176
|
+
).find(
|
|
177
|
+
(r: IAutoMovieResolvedBone): boolean => r.bone === input.effector.bone,
|
|
178
|
+
);
|
|
179
|
+
if (resolved === undefined)
|
|
180
|
+
throw new Error(`A digit fit cannot resolve ${input.effector.bone}`);
|
|
181
|
+
return {
|
|
182
|
+
point: Vector3.add(
|
|
183
|
+
resolved.worldPosition,
|
|
184
|
+
Quaternion.rotateVector(resolved.worldRotation, input.effector.point),
|
|
185
|
+
),
|
|
186
|
+
normal: Quaternion.rotateVector(
|
|
187
|
+
resolved.worldRotation,
|
|
188
|
+
input.effector.normal,
|
|
189
|
+
),
|
|
190
|
+
};
|
|
191
|
+
};
|
|
192
|
+
|
|
193
|
+
// The primary residual, metres: where the effector is less the target.
|
|
194
|
+
// The secondary, metres: the normal's misalignment and the coupling, each
|
|
195
|
+
// as an arc length on the distal phalanx.
|
|
196
|
+
const length: number = Vector3.length(input.effector.point);
|
|
197
|
+
const primary = (x: readonly number[]): number[] => {
|
|
198
|
+
const at = place(joints(x));
|
|
199
|
+
return [
|
|
200
|
+
at.point.x - target.x,
|
|
201
|
+
at.point.y - target.y,
|
|
202
|
+
at.point.z - target.z,
|
|
203
|
+
];
|
|
204
|
+
};
|
|
205
|
+
const secondary = (x: readonly number[]): number[] => {
|
|
206
|
+
const list: IAutoMovieJointPose[] = joints(x);
|
|
207
|
+
const r: number[] = [];
|
|
208
|
+
if (input.normal !== undefined) {
|
|
209
|
+
const miss: IAutoMovieVector3 = Vector3.cross(
|
|
210
|
+
place(list).normal,
|
|
211
|
+
Vector3.normalize(input.normal),
|
|
212
|
+
);
|
|
213
|
+
r.push(miss.x * length, miss.y * length, miss.z * length);
|
|
214
|
+
}
|
|
215
|
+
if (coupling !== null && input.bones.length >= 3) {
|
|
216
|
+
const middle: number = list[1]!.flexion ?? 0;
|
|
217
|
+
const distal: number = list[2]!.flexion ?? 0;
|
|
218
|
+
r.push(((distal - coupling * middle) * Math.PI * length) / 180);
|
|
219
|
+
}
|
|
220
|
+
return r;
|
|
221
|
+
};
|
|
222
|
+
|
|
223
|
+
// The effector's motion for one resolution step of every joint: the
|
|
224
|
+
// nearest the point can be put, so the primary counts as met within it.
|
|
225
|
+
const tolerance = (
|
|
226
|
+
_x: readonly number[],
|
|
227
|
+
J1: readonly (readonly number[])[],
|
|
228
|
+
): number =>
|
|
229
|
+
variables.reduce(
|
|
230
|
+
(sum: number, _v: IVariable, i: number): number =>
|
|
231
|
+
sum + Math.hypot(J1[0]![i]!, J1[1]![i]!, J1[2]![i]!) * ROM_TOLERANCE,
|
|
232
|
+
0,
|
|
233
|
+
);
|
|
234
|
+
const jacobian = (x: readonly number[]): number[][] =>
|
|
235
|
+
[0, 1, 2].map((k: number): number[] =>
|
|
236
|
+
x.map((_v: number, i: number): number => {
|
|
237
|
+
const up: number[] = [...x];
|
|
238
|
+
const down: number[] = [...x];
|
|
239
|
+
up[i] = up[i]! + ROM_TOLERANCE;
|
|
240
|
+
down[i] = down[i]! - ROM_TOLERANCE;
|
|
241
|
+
return (primary(up)[k]! - primary(down)[k]!) / (2 * ROM_TOLERANCE);
|
|
242
|
+
}),
|
|
243
|
+
);
|
|
244
|
+
|
|
245
|
+
const seed: number[] = read(input.pose.joints);
|
|
246
|
+
const descend = (start: readonly number[]): number[] =>
|
|
247
|
+
fitDigitDescent({
|
|
248
|
+
start,
|
|
249
|
+
primary,
|
|
250
|
+
secondary,
|
|
251
|
+
project: (x: readonly number[]): number[] => read(joints(x)),
|
|
252
|
+
step: ROM_TOLERANCE,
|
|
253
|
+
tolerance,
|
|
254
|
+
});
|
|
255
|
+
|
|
256
|
+
// Continuation: the descent starts from the pose's own angles, so a
|
|
257
|
+
// caller that seeds each fit from the one before follows the target
|
|
258
|
+
// continuously in one basin. Only a continued fit that cannot reach (its
|
|
259
|
+
// point farther than `tolerance`) restarts from the middle of every range,
|
|
260
|
+
// where a digit folded the wrong way round its target is not trapped, and
|
|
261
|
+
// keeps that fit only when it comes nearer.
|
|
262
|
+
const reach = (x: readonly number[]): number => Math.hypot(...primary(x));
|
|
263
|
+
const continued: number[] = descend(seed);
|
|
264
|
+
let x: number[] = continued;
|
|
265
|
+
if (reach(continued) > tolerance(continued, jacobian(continued))) {
|
|
266
|
+
const restarted: number[] = descend(
|
|
267
|
+
variables.map((v: IVariable): number =>
|
|
268
|
+
v.range === null ? 0 : (v.range.min + v.range.max) / 2,
|
|
269
|
+
),
|
|
270
|
+
);
|
|
271
|
+
if (reach(restarted) < reach(continued)) x = restarted;
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
const fitted: IAutoMovieJointPose[] = joints(x);
|
|
275
|
+
const at = place(fitted);
|
|
276
|
+
return {
|
|
277
|
+
joints: fitted,
|
|
278
|
+
point: at.point,
|
|
279
|
+
normal: at.normal,
|
|
280
|
+
residual: Vector3.length(Vector3.subtract(at.point, input.target)),
|
|
281
|
+
};
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
/**
|
|
285
|
+
* Companion types of {@link fitDigitToTarget}.
|
|
286
|
+
*
|
|
287
|
+
* @evidence contracts/development/common.md#meaningful-documentation Documents each member's frame and unit.
|
|
288
|
+
* @evidence contracts/development/design.md#principled-representation A posed rig, the digit's joints proximal to distal, a bone-local effector frame and a world target point with an optional normal.
|
|
289
|
+
* @evidence contracts/development/design.md#minimal-and-owned-surface What the fit reads and what its caller needs back: the joints, where the effector ended and how far from the target.
|
|
290
|
+
* @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses the interface's poses, bones and vectors; the effector is the region frame `resolveAutoMovieHumanoidSurfaces` already gives.
|
|
291
|
+
*/
|
|
292
|
+
export namespace fitDigitToTarget {
|
|
293
|
+
/** What a digit fit reads. */
|
|
294
|
+
export interface IInput {
|
|
295
|
+
/** The rig. */
|
|
296
|
+
skeleton: IAutoMovieSkeleton;
|
|
297
|
+
|
|
298
|
+
/** The posed body: its root, arm and hand place the digit's base; its own entries for the digit's joints are the fit's start. */
|
|
299
|
+
pose: IAutoMoviePose;
|
|
300
|
+
|
|
301
|
+
/** The digit's joints, proximal to distal: a finger's three, or the thumb's metacarpal, proximal and distal. */
|
|
302
|
+
bones: readonly AutoMovieHumanoidBone[];
|
|
303
|
+
|
|
304
|
+
/** The point brought to the target, in its bone's rest frame relative to the bone's joint, metres, with the outward unit normal there: a region frame of the digit's tip or pad. */
|
|
305
|
+
effector: {
|
|
306
|
+
bone: AutoMovieHumanoidBone;
|
|
307
|
+
point: IAutoMovieVector3;
|
|
308
|
+
normal: IAutoMovieVector3;
|
|
309
|
+
};
|
|
310
|
+
|
|
311
|
+
/** The target, world metres. */
|
|
312
|
+
target: IAutoMovieVector3;
|
|
313
|
+
|
|
314
|
+
/** The world direction the effector's normal is turned onto, when the contact needs one (a pad laid on a key faces against the key's normal); none when absent. */
|
|
315
|
+
normal?: IAutoMovieVector3;
|
|
316
|
+
|
|
317
|
+
/** The ratio of the distal joint's flexion to the middle joint's that a finger keeps as its second task, after the point; no coupling when absent (the thumb). */
|
|
318
|
+
coupling?: number;
|
|
319
|
+
|
|
320
|
+
/** The joint axes the pose is read with, as `resolvePose` takes them; the skeleton's own when absent. */
|
|
321
|
+
jointAxes?: Partial<Record<AutoMovieHumanoidBone, IAutoMovieJointAxes>>;
|
|
322
|
+
|
|
323
|
+
/** The rest frames the pose's clinical angles are lifted by, as `resolvePose` takes them; none when absent. */
|
|
324
|
+
restFrames?: Partial<Record<AutoMovieHumanoidBone, IAutoMovieRestFrame>>;
|
|
325
|
+
|
|
326
|
+
/** The rig's topology, when the caller has it. */
|
|
327
|
+
topology?: IAutoMovieSkeletonTopology;
|
|
328
|
+
|
|
329
|
+
/** Desired radial extension rate near full reach, positive finite degrees per metre. Derives a soft-IK band from the chain's smallest full-extension hinge curvature; targets in that band are eased short of full reach, and `residual` still measures the original target. Other constrained-IK basin changes are not bounded by this value. No softening when absent. */
|
|
330
|
+
rate?: number;
|
|
331
|
+
}
|
|
332
|
+
|
|
333
|
+
/** What a digit fit returns. */
|
|
334
|
+
export interface IResult {
|
|
335
|
+
/** The digit's joints, inside their range, clinical degrees. */
|
|
336
|
+
joints: IAutoMovieJointPose[];
|
|
337
|
+
|
|
338
|
+
/** Where the effector ended, world metres. */
|
|
339
|
+
point: IAutoMovieVector3;
|
|
340
|
+
|
|
341
|
+
/** The effector's outward unit normal there, world frame. */
|
|
342
|
+
normal: IAutoMovieVector3;
|
|
343
|
+
|
|
344
|
+
/** The distance from the effector to the target, metres; zero within rounding when the target is reached. */
|
|
345
|
+
residual: number;
|
|
346
|
+
}
|
|
347
|
+
}
|
|
348
|
+
|
|
349
|
+
/**
|
|
350
|
+
* Exponential soft IK in the radial coordinate: identity below L-s and
|
|
351
|
+
* L-s exp(-(d-(L-s))/s) above it. For a hinge dividing the straight chain
|
|
352
|
+
* into lengths a and b, the cosine rule gives L-d = k theta² + O(theta⁴),
|
|
353
|
+
* k = ab/(2L) (pi/180)² in metres per degree squared. In that leading-order
|
|
354
|
+
* model the inverse's radial rate at the band's start is 1/(2 sqrt(k s))
|
|
355
|
+
* and falls exponentially thereafter, giving s = 1/(4 k rate²), using the
|
|
356
|
+
* smallest hinge curvature. This local model is not a global rate proof
|
|
357
|
+
* for the nonlinear, range-constrained chain.
|
|
358
|
+
* The band is at most the chain's whole length; a chain with no positive
|
|
359
|
+
* internal hinge has no full-extension fold to soften. Link lengths are
|
|
360
|
+
* invariant under the pose; only the base's world place follows it.
|
|
361
|
+
*/
|
|
362
|
+
const softTarget = (
|
|
363
|
+
input: fitDigitToTarget.IInput,
|
|
364
|
+
topology: IAutoMovieSkeletonTopology,
|
|
365
|
+
): IAutoMovieVector3 => {
|
|
366
|
+
if (input.rate === undefined) return input.target;
|
|
367
|
+
const posed: IAutoMovieResolvedBone[] = resolvePose(
|
|
368
|
+
input.pose,
|
|
369
|
+
input.skeleton,
|
|
370
|
+
input.jointAxes,
|
|
371
|
+
input.restFrames,
|
|
372
|
+
topology,
|
|
373
|
+
);
|
|
374
|
+
const points: IAutoMovieVector3[] = input.bones.map(
|
|
375
|
+
(bone: AutoMovieHumanoidBone): IAutoMovieVector3 => {
|
|
376
|
+
const frame: IAutoMovieResolvedBone | undefined = posed.find(
|
|
377
|
+
(p: IAutoMovieResolvedBone): boolean => p.bone === bone,
|
|
378
|
+
);
|
|
379
|
+
if (frame === undefined)
|
|
380
|
+
throw new Error(`A digit fit cannot resolve ${bone}`);
|
|
381
|
+
return frame.worldPosition;
|
|
382
|
+
},
|
|
383
|
+
);
|
|
384
|
+
const links: number[] = points
|
|
385
|
+
.slice(1)
|
|
386
|
+
.map((point: IAutoMovieVector3, i: number): number =>
|
|
387
|
+
Vector3.length(Vector3.subtract(point, points[i]!)),
|
|
388
|
+
);
|
|
389
|
+
links.push(Vector3.length(input.effector.point));
|
|
390
|
+
const reach: number = links.reduce(
|
|
391
|
+
(sum: number, link: number): number => sum + link,
|
|
392
|
+
0,
|
|
393
|
+
);
|
|
394
|
+
let left: number = 0;
|
|
395
|
+
const curvatures: number[] = links
|
|
396
|
+
.slice(0, -1)
|
|
397
|
+
.map((link: number): number => {
|
|
398
|
+
left += link;
|
|
399
|
+
return ((left * (reach - left)) / (2 * reach)) * (Math.PI / 180) ** 2;
|
|
400
|
+
})
|
|
401
|
+
.filter((k: number): boolean => k > 0);
|
|
402
|
+
if (curvatures.length === 0) return input.target;
|
|
403
|
+
const width: number = Math.min(
|
|
404
|
+
reach,
|
|
405
|
+
1 / (4 * Math.min(...curvatures) * input.rate ** 2),
|
|
406
|
+
);
|
|
407
|
+
const delta: IAutoMovieVector3 = Vector3.subtract(input.target, points[0]!);
|
|
408
|
+
const distance: number = Vector3.length(delta);
|
|
409
|
+
if (distance === 0 || distance <= reach - width) return input.target;
|
|
410
|
+
const eased: number =
|
|
411
|
+
reach - width * Math.exp(-(distance - (reach - width)) / width);
|
|
412
|
+
return Vector3.add(points[0]!, Vector3.scale(delta, eased / distance));
|
|
413
|
+
};
|
|
414
|
+
|
|
415
|
+
/** A variable of the fit: one free axis of one joint. */
|
|
416
|
+
interface IVariable {
|
|
417
|
+
bone: AutoMovieHumanoidBone;
|
|
418
|
+
axis: (typeof AXES)[number];
|
|
419
|
+
|
|
420
|
+
/** The axis's range, clinical degrees; none when the joint has no constraint. */
|
|
421
|
+
range: IAutoMovieAngleRange | null;
|
|
422
|
+
}
|
|
423
|
+
|
|
424
|
+
/** The clinical axes of a joint, in the order variables are read. */
|
|
425
|
+
const AXES = ["flexion", "abduction", "twist"] as const;
|