@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,251 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.fitDigitToTarget = fitDigitToTarget;
|
|
4
|
+
const Quaternion_1 = require("../math/Quaternion");
|
|
5
|
+
const Vector3_1 = require("../math/Vector3");
|
|
6
|
+
const clampJointToSkeleton_1 = require("../rom/clampJointToSkeleton");
|
|
7
|
+
const ROM_TOLERANCE_1 = require("../rom/constants/ROM_TOLERANCE");
|
|
8
|
+
const getConstraint_1 = require("../rom/getConstraint");
|
|
9
|
+
const fitDigitDescent_1 = require("./fitDigitDescent");
|
|
10
|
+
const indexSkeletonTopology_1 = require("./indexSkeletonTopology");
|
|
11
|
+
const resolvePose_1 = require("./resolvePose");
|
|
12
|
+
/**
|
|
13
|
+
* Put a point of a digit (its tip or its pad, a frame on its distal phalanx)
|
|
14
|
+
* on a world point, with the digit's own joints alone, inside their range of
|
|
15
|
+
* motion: the inverse kinematics of one finger or the thumb with the hand
|
|
16
|
+
* where the pose has placed it.
|
|
17
|
+
*
|
|
18
|
+
* Every free axis of every joint of the digit (an axis its constraint does
|
|
19
|
+
* not hold immobile) is a variable, in clinical degrees. The fit has two
|
|
20
|
+
* tasks in priority order. The first puts the effector on the target: its
|
|
21
|
+
* residual is the distance between them. The second, bettered only in what
|
|
22
|
+
* the first leaves free, turns the effector's normal onto the target normal
|
|
23
|
+
* when one is given (the misalignment scaled by the effector's distance from
|
|
24
|
+
* its joint, an arc length, so a degree of tilt counts as the millimetres it
|
|
25
|
+
* swings the phalanx) and keeps a finger's interphalangeal coupling, the
|
|
26
|
+
* distal joint following the middle one at the ratio `coupling` (the
|
|
27
|
+
* coupling of hand animation, DIP = 2/3 PIP, Rijpkema and Girard 1991,
|
|
28
|
+
* SIGGRAPH 25(4):339-348, as relayed by the hand-animation literature;
|
|
29
|
+
* provisional until read at the source), its residual likewise that distance
|
|
30
|
+
* times the angle by which the distal joint misses the ratio. The point
|
|
31
|
+
* goal, optionally eased by soft IK as described below, is never traded
|
|
32
|
+
* against a normal or a coupling it does not allow.
|
|
33
|
+
*
|
|
34
|
+
* Each descent is `fitDigitDescent`: damped task-priority least squares
|
|
35
|
+
* (Nakamura, Hanafusa and Yoshikawa 1987; Chiaverini 1997) with the active
|
|
36
|
+
* set of a projected Newton method (Bertsekas 1982) for the joints on a
|
|
37
|
+
* bound, and Levenberg-Marquardt damping (Madsen, Nielsen and Tingleff 2004).
|
|
38
|
+
* The Jacobians are read by central differences on the engine's own forward
|
|
39
|
+
* kinematics, so the angles mean what `resolvePose` displays, and every
|
|
40
|
+
* trial is projected into the range (`clampJointToSkeleton`) before it is
|
|
41
|
+
* measured. The point counts as reached within the effector's motion for one
|
|
42
|
+
* resolution step of every joint, and a descent stops when its step moves no
|
|
43
|
+
* joint by more than `ROM_TOLERANCE`, the resolution to which the engine
|
|
44
|
+
* resolves a joint's angle.
|
|
45
|
+
* The fit is a continuation: it descends from the pose's own angles for the
|
|
46
|
+
* digit, so a caller that seeds each fit from the one before follows a
|
|
47
|
+
* moving target in one basin, its joints moving continuously. Only when that
|
|
48
|
+
* fit cannot reach the target (the tip farther from it than one joint
|
|
49
|
+
* resolution of every joint would move it) does it restart from the middle
|
|
50
|
+
* of every range, where a digit folded the wrong way round its target is not
|
|
51
|
+
* trapped, keeping the restart only if it comes nearer; it never takes the
|
|
52
|
+
* better of two starts for a target the continued fit reaches, an argmin
|
|
53
|
+
* that would switch basins between neighbouring targets. A caller's `rate`
|
|
54
|
+
* softens the target near full extension, where the exact inverse has an
|
|
55
|
+
* unbounded derivative: the exponential soft IK of Andy Nicholas (2006),
|
|
56
|
+
* demonstrated in Jeremie Passerin's "Control Rig: 5.3: Soft IK" (2024,
|
|
57
|
+
* https://dev.epicgames.com/community/learning/tutorials/y4Ll/unreal-engine-control-rig-5-3-soft-ik).
|
|
58
|
+
* Below the soft band the target is unchanged; within it, some reach is
|
|
59
|
+
* traded for a bounded radial extension rate. The band's width comes from
|
|
60
|
+
* the chain's lengths and the requested rate, not the seed's posture.
|
|
61
|
+
* This controls the full-extension singularity, not every possible change
|
|
62
|
+
* of basin of a constrained digit. The result is
|
|
63
|
+
* deterministic for its input: fixed starts, a fixed order of variables and
|
|
64
|
+
* no random draw. A target outside the digit's workspace is fitted as
|
|
65
|
+
* nearly as this constrained local solve reaches it. With `rate` it fits
|
|
66
|
+
* the eased target instead, so its constrained minimum may differ from
|
|
67
|
+
* the original target's. In either case `residual` reports distance to the
|
|
68
|
+
* original target, including any reach traded away, so a caller refuses
|
|
69
|
+
* or accepts by its own bound.
|
|
70
|
+
*
|
|
71
|
+
* @param input The rig, the posed body, the digit's joints and the effector and target.
|
|
72
|
+
* @returns The digit's fitted joints, the effector's world point and the residual.
|
|
73
|
+
* @throws {Error} When the digit names no joint, a bone cannot be resolved, or `rate` is not finite and positive.
|
|
74
|
+
*
|
|
75
|
+
* @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.
|
|
76
|
+
* @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.
|
|
77
|
+
* @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.
|
|
78
|
+
* @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.
|
|
79
|
+
* @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.
|
|
80
|
+
* @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its input; a caller keeps the result by its own plan.
|
|
81
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the returned joints belong to the caller.
|
|
82
|
+
*/
|
|
83
|
+
function fitDigitToTarget(input) {
|
|
84
|
+
if (input.bones.length === 0)
|
|
85
|
+
throw new Error("A digit fit needs the digit's joints");
|
|
86
|
+
if (input.rate !== undefined &&
|
|
87
|
+
!(Number.isFinite(input.rate) && input.rate > 0))
|
|
88
|
+
throw new Error("A digit fit's rate must be finite and positive");
|
|
89
|
+
const topology = input.topology ?? (0, indexSkeletonTopology_1.indexSkeletonTopology)(input.skeleton);
|
|
90
|
+
const coupling = input.coupling ?? null;
|
|
91
|
+
const target = softTarget(input, topology);
|
|
92
|
+
// The digit's free axes, in the order of its joints.
|
|
93
|
+
const variables = [];
|
|
94
|
+
for (const bone of input.bones) {
|
|
95
|
+
const constraint = (0, getConstraint_1.getConstraint)(bone, input.skeleton.bones.find((b) => b.bone === bone)
|
|
96
|
+
?.constraint ?? null);
|
|
97
|
+
for (const axis of AXES)
|
|
98
|
+
if (constraint === null || constraint[axis] !== null)
|
|
99
|
+
variables.push({ bone, axis, range: constraint?.[axis] ?? null });
|
|
100
|
+
}
|
|
101
|
+
const clamps = new Map(input.bones.map((bone) => [bone, clampJointToSkeleton_1.clampJointToSkeleton.of(bone, input.skeleton)]));
|
|
102
|
+
const others = input.pose.joints.filter((j) => !input.bones.includes(j.bone));
|
|
103
|
+
// The digit's joints for a vector of variables, projected into the range.
|
|
104
|
+
const joints = (x) => input.bones.map((bone) => {
|
|
105
|
+
const joint = {
|
|
106
|
+
bone,
|
|
107
|
+
flexion: null,
|
|
108
|
+
abduction: null,
|
|
109
|
+
twist: null,
|
|
110
|
+
};
|
|
111
|
+
variables.forEach((v, i) => {
|
|
112
|
+
if (v.bone === bone)
|
|
113
|
+
joint[v.axis] = x[i];
|
|
114
|
+
});
|
|
115
|
+
return clamps.get(bone)(joint);
|
|
116
|
+
});
|
|
117
|
+
const read = (list) => variables.map((v) => {
|
|
118
|
+
const joint = list.find((j) => j.bone === v.bone);
|
|
119
|
+
return joint?.[v.axis] ?? 0;
|
|
120
|
+
});
|
|
121
|
+
// The effector's world frame under the digit's joints.
|
|
122
|
+
const place = (list) => {
|
|
123
|
+
const pose = {
|
|
124
|
+
...input.pose,
|
|
125
|
+
joints: [...others, ...list],
|
|
126
|
+
};
|
|
127
|
+
const resolved = (0, resolvePose_1.resolvePose)(pose, input.skeleton, input.jointAxes, input.restFrames, topology).find((r) => r.bone === input.effector.bone);
|
|
128
|
+
if (resolved === undefined)
|
|
129
|
+
throw new Error(`A digit fit cannot resolve ${input.effector.bone}`);
|
|
130
|
+
return {
|
|
131
|
+
point: Vector3_1.Vector3.add(resolved.worldPosition, Quaternion_1.Quaternion.rotateVector(resolved.worldRotation, input.effector.point)),
|
|
132
|
+
normal: Quaternion_1.Quaternion.rotateVector(resolved.worldRotation, input.effector.normal),
|
|
133
|
+
};
|
|
134
|
+
};
|
|
135
|
+
// The primary residual, metres: where the effector is less the target.
|
|
136
|
+
// The secondary, metres: the normal's misalignment and the coupling, each
|
|
137
|
+
// as an arc length on the distal phalanx.
|
|
138
|
+
const length = Vector3_1.Vector3.length(input.effector.point);
|
|
139
|
+
const primary = (x) => {
|
|
140
|
+
const at = place(joints(x));
|
|
141
|
+
return [
|
|
142
|
+
at.point.x - target.x,
|
|
143
|
+
at.point.y - target.y,
|
|
144
|
+
at.point.z - target.z,
|
|
145
|
+
];
|
|
146
|
+
};
|
|
147
|
+
const secondary = (x) => {
|
|
148
|
+
const list = joints(x);
|
|
149
|
+
const r = [];
|
|
150
|
+
if (input.normal !== undefined) {
|
|
151
|
+
const miss = Vector3_1.Vector3.cross(place(list).normal, Vector3_1.Vector3.normalize(input.normal));
|
|
152
|
+
r.push(miss.x * length, miss.y * length, miss.z * length);
|
|
153
|
+
}
|
|
154
|
+
if (coupling !== null && input.bones.length >= 3) {
|
|
155
|
+
const middle = list[1].flexion ?? 0;
|
|
156
|
+
const distal = list[2].flexion ?? 0;
|
|
157
|
+
r.push(((distal - coupling * middle) * Math.PI * length) / 180);
|
|
158
|
+
}
|
|
159
|
+
return r;
|
|
160
|
+
};
|
|
161
|
+
// The effector's motion for one resolution step of every joint: the
|
|
162
|
+
// nearest the point can be put, so the primary counts as met within it.
|
|
163
|
+
const tolerance = (_x, J1) => variables.reduce((sum, _v, i) => sum + Math.hypot(J1[0][i], J1[1][i], J1[2][i]) * ROM_TOLERANCE_1.ROM_TOLERANCE, 0);
|
|
164
|
+
const jacobian = (x) => [0, 1, 2].map((k) => x.map((_v, i) => {
|
|
165
|
+
const up = [...x];
|
|
166
|
+
const down = [...x];
|
|
167
|
+
up[i] = up[i] + ROM_TOLERANCE_1.ROM_TOLERANCE;
|
|
168
|
+
down[i] = down[i] - ROM_TOLERANCE_1.ROM_TOLERANCE;
|
|
169
|
+
return (primary(up)[k] - primary(down)[k]) / (2 * ROM_TOLERANCE_1.ROM_TOLERANCE);
|
|
170
|
+
}));
|
|
171
|
+
const seed = read(input.pose.joints);
|
|
172
|
+
const descend = (start) => (0, fitDigitDescent_1.fitDigitDescent)({
|
|
173
|
+
start,
|
|
174
|
+
primary,
|
|
175
|
+
secondary,
|
|
176
|
+
project: (x) => read(joints(x)),
|
|
177
|
+
step: ROM_TOLERANCE_1.ROM_TOLERANCE,
|
|
178
|
+
tolerance,
|
|
179
|
+
});
|
|
180
|
+
// Continuation: the descent starts from the pose's own angles, so a
|
|
181
|
+
// caller that seeds each fit from the one before follows the target
|
|
182
|
+
// continuously in one basin. Only a continued fit that cannot reach (its
|
|
183
|
+
// point farther than `tolerance`) restarts from the middle of every range,
|
|
184
|
+
// where a digit folded the wrong way round its target is not trapped, and
|
|
185
|
+
// keeps that fit only when it comes nearer.
|
|
186
|
+
const reach = (x) => Math.hypot(...primary(x));
|
|
187
|
+
const continued = descend(seed);
|
|
188
|
+
let x = continued;
|
|
189
|
+
if (reach(continued) > tolerance(continued, jacobian(continued))) {
|
|
190
|
+
const restarted = descend(variables.map((v) => v.range === null ? 0 : (v.range.min + v.range.max) / 2));
|
|
191
|
+
if (reach(restarted) < reach(continued))
|
|
192
|
+
x = restarted;
|
|
193
|
+
}
|
|
194
|
+
const fitted = joints(x);
|
|
195
|
+
const at = place(fitted);
|
|
196
|
+
return {
|
|
197
|
+
joints: fitted,
|
|
198
|
+
point: at.point,
|
|
199
|
+
normal: at.normal,
|
|
200
|
+
residual: Vector3_1.Vector3.length(Vector3_1.Vector3.subtract(at.point, input.target)),
|
|
201
|
+
};
|
|
202
|
+
}
|
|
203
|
+
/**
|
|
204
|
+
* Exponential soft IK in the radial coordinate: identity below L-s and
|
|
205
|
+
* L-s exp(-(d-(L-s))/s) above it. For a hinge dividing the straight chain
|
|
206
|
+
* into lengths a and b, the cosine rule gives L-d = k theta² + O(theta⁴),
|
|
207
|
+
* k = ab/(2L) (pi/180)² in metres per degree squared. In that leading-order
|
|
208
|
+
* model the inverse's radial rate at the band's start is 1/(2 sqrt(k s))
|
|
209
|
+
* and falls exponentially thereafter, giving s = 1/(4 k rate²), using the
|
|
210
|
+
* smallest hinge curvature. This local model is not a global rate proof
|
|
211
|
+
* for the nonlinear, range-constrained chain.
|
|
212
|
+
* The band is at most the chain's whole length; a chain with no positive
|
|
213
|
+
* internal hinge has no full-extension fold to soften. Link lengths are
|
|
214
|
+
* invariant under the pose; only the base's world place follows it.
|
|
215
|
+
*/
|
|
216
|
+
const softTarget = (input, topology) => {
|
|
217
|
+
if (input.rate === undefined)
|
|
218
|
+
return input.target;
|
|
219
|
+
const posed = (0, resolvePose_1.resolvePose)(input.pose, input.skeleton, input.jointAxes, input.restFrames, topology);
|
|
220
|
+
const points = input.bones.map((bone) => {
|
|
221
|
+
const frame = posed.find((p) => p.bone === bone);
|
|
222
|
+
if (frame === undefined)
|
|
223
|
+
throw new Error(`A digit fit cannot resolve ${bone}`);
|
|
224
|
+
return frame.worldPosition;
|
|
225
|
+
});
|
|
226
|
+
const links = points
|
|
227
|
+
.slice(1)
|
|
228
|
+
.map((point, i) => Vector3_1.Vector3.length(Vector3_1.Vector3.subtract(point, points[i])));
|
|
229
|
+
links.push(Vector3_1.Vector3.length(input.effector.point));
|
|
230
|
+
const reach = links.reduce((sum, link) => sum + link, 0);
|
|
231
|
+
let left = 0;
|
|
232
|
+
const curvatures = links
|
|
233
|
+
.slice(0, -1)
|
|
234
|
+
.map((link) => {
|
|
235
|
+
left += link;
|
|
236
|
+
return ((left * (reach - left)) / (2 * reach)) * (Math.PI / 180) ** 2;
|
|
237
|
+
})
|
|
238
|
+
.filter((k) => k > 0);
|
|
239
|
+
if (curvatures.length === 0)
|
|
240
|
+
return input.target;
|
|
241
|
+
const width = Math.min(reach, 1 / (4 * Math.min(...curvatures) * input.rate ** 2));
|
|
242
|
+
const delta = Vector3_1.Vector3.subtract(input.target, points[0]);
|
|
243
|
+
const distance = Vector3_1.Vector3.length(delta);
|
|
244
|
+
if (distance === 0 || distance <= reach - width)
|
|
245
|
+
return input.target;
|
|
246
|
+
const eased = reach - width * Math.exp(-(distance - (reach - width)) / width);
|
|
247
|
+
return Vector3_1.Vector3.add(points[0], Vector3_1.Vector3.scale(delta, eased / distance));
|
|
248
|
+
};
|
|
249
|
+
/** The clinical axes of a joint, in the order variables are read. */
|
|
250
|
+
const AXES = ["flexion", "abduction", "twist"];
|
|
251
|
+
//# sourceMappingURL=fitDigitToTarget.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fitDigitToTarget.js","sourceRoot":"","sources":["../../src/kinematics/fitDigitToTarget.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { IAutoMovieQuaternion, IAutoMovieVector3 } from "@automovie/interface";
|
|
2
2
|
import { IAutoMovieChainBone } from "./IAutoMovieChainBone";
|
|
3
3
|
import { IAutoMovieHingedArticulation } from "./IAutoMovieHingedArticulation";
|
|
4
|
+
import { IAutoMovieSwivelNear } from "./IAutoMovieSwivelNear";
|
|
4
5
|
/**
|
|
5
6
|
* Two-bone arm IK whose mid joint bends only about its own flexion hinge, with
|
|
6
7
|
* the chain root's free swivel spent on the rig's range of motion.
|
|
@@ -16,14 +17,52 @@ import { IAutoMovieHingedArticulation } from "./IAutoMovieHingedArticulation";
|
|
|
16
17
|
* with `R = hypot(α, β)` and `φ = atan2(β, α)`: an arccos whose two roots are
|
|
17
18
|
* the chain's two bend branches. A target outside the reachable span takes the
|
|
18
19
|
* fully extended or fully folded root, so the effector stops on the reachable
|
|
19
|
-
* shell along the line to the target.
|
|
20
|
+
* shell along the line to the target. A root outside the mid joint's own
|
|
21
|
+
* `range` stops at the nearer limit in the same way, the effector resting on
|
|
22
|
+
* the legal shell along that line and the result reporting the `shortfall`;
|
|
23
|
+
* of two branches the one stopping nearer the target is swept, because a
|
|
24
|
+
* candidate past the hinge's limit would be clamped by the caller afterwards
|
|
25
|
+
* and land somewhere no candidate was scored at.
|
|
20
26
|
*
|
|
21
27
|
* The root joint first aims `m(θ)` at the target, then any extra rotation
|
|
22
28
|
* about `m(θ)` leaves the effector where it is. The function sweeps that swivel
|
|
23
|
-
* in `SWIVEL_STEP` increments on each branch
|
|
24
|
-
*
|
|
25
|
-
*
|
|
26
|
-
*
|
|
29
|
+
* in `SWIVEL_STEP` increments on each branch, ordering candidates by the least
|
|
30
|
+
* `overshoot` (legal, zero, ahead of any other exactly; two positive ones
|
|
31
|
+
* tied within the decomposition's rounding, `OVERSHOOT_ROUNDING`), then the
|
|
32
|
+
* least `deviation`, both from
|
|
33
|
+
* `score`. Every local minimum of a sweep is then refined between its
|
|
34
|
+
* neighbouring steps by golden-section search under the same ordering, and
|
|
35
|
+
* the best of the sweeps and the refinements is returned. A pass whose two
|
|
36
|
+
* probes tie closes the bracket onto both, so a request mirrored left to
|
|
37
|
+
* right, whose probes are the same two exchanged, refines to the mirrored
|
|
38
|
+
* swivel. So the chosen pose
|
|
39
|
+
* follows a moving target continuously rather than in swivel steps, a legal
|
|
40
|
+
* interval narrower than one step is still found from the dip it leaves in
|
|
41
|
+
* the sweep, and between two basins the truly better one wins rather than the
|
|
42
|
+
* one a sample happened to fall nearer the bottom of. The caller owns the
|
|
43
|
+
* decomposition and the rig's ROM, so the geometry here holds no rig policy.
|
|
44
|
+
*
|
|
45
|
+
* A caller that can certify swivels its score refuses (`excluded`) spares
|
|
46
|
+
* their scoring, and the pose is still the full sweep's. A step is skipped
|
|
47
|
+
* when every swivel within two steps of it is refused, and a step whose
|
|
48
|
+
* bracket, a step either way, is refused is not refined; every other step is
|
|
49
|
+
* scored and compared with its true neighbours, since a step that is not
|
|
50
|
+
* skipped and could be refined has both neighbours scored. When the pruned
|
|
51
|
+
* sweep finds a legal candidate, the full sweep's answer is that candidate:
|
|
52
|
+
* a refused swivel, a step or a refinement inside a refused bracket, is
|
|
53
|
+
* never legal, so it can never be ahead of a legal candidate (legality is
|
|
54
|
+
* compared exactly); every legal candidate of the full sweep is a scored
|
|
55
|
+
* step or the refinement of a step that is scored with the same neighbours,
|
|
56
|
+
* so it is the same candidate in both; and the ordering among legal
|
|
57
|
+
* candidates, met in the same order, is the same. When the pruned sweep
|
|
58
|
+
* finds none, the full sweep decides, so a chain that cannot reach legally
|
|
59
|
+
* still returns its least overshoot.
|
|
60
|
+
*
|
|
61
|
+
* A caller continuing a fit of a nearby target (`near`) skips the sweep: the
|
|
62
|
+
* seed's branch, its swivel refined within one step either way by the same
|
|
63
|
+
* golden-section search under the same ordering, to the seed's `tolerance`
|
|
64
|
+
* (`IAutoMovieSwivelNear`). Every result names its branch and swivel, the
|
|
65
|
+
* seed a nearby fit continues from.
|
|
27
66
|
*
|
|
28
67
|
* Returns `null` for a degenerate chain: a mid or end offset shorter than
|
|
29
68
|
* `1e-6`, a target within `1e-6` of the chain root, a hinge shorter than
|
|
@@ -34,9 +73,9 @@ import { IAutoMovieHingedArticulation } from "./IAutoMovieHingedArticulation";
|
|
|
34
73
|
* @evidence contracts/development/implementation.md#clear-and-simple-structure Pure chain geometry with the ROM policy injected through `score`, so `reachPose` owns the clinical decomposition and constraints while this function owns the branches and the sweep; the shared `aimRotation` aims the root.
|
|
35
74
|
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No rig, side or target is special-cased; the degeneracy thresholds are the engine's shared length scale, and a chain that cannot reach legally returns its least overshoot instead of being clamped into range.
|
|
36
75
|
* @evidence contracts/development/common.md#meaningful-documentation States the hinge-only elbow, the span formula and its branches, the out-of-span behavior, the swivel sweep and its ordering, who owns scoring, every `null` case with its threshold, and each input's frame.
|
|
37
|
-
* @evidence contracts/development/implementation.md#efficient-algorithms At most two branches times 360 swivel steps, each one quaternion product plus one `score` call, so cost is
|
|
76
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms At most two branches times 360 swivel steps plus 42 refinement probes per local minimum of a sweep (one more for each tied pass, at most 82), each one quaternion product plus one `score` call, so cost is bounded per solve and dominated by `score`; a level sweep refines nothing, and the step is a resolution choice among equally exact poses. A continued fit scores only its refinement, two probes and log(tolerance / 2 STEP) / log(GOLDEN) passes, 25 at the 3.8e-5 degrees a velocity read for a 0.4 s inertialization needs (`samplePoseVelocity.tolerance`). Steps a caller certifies refused are not scored, which leaves the answer the full sweep's and, when no legal candidate remains, costs one more full sweep.
|
|
38
77
|
* @evidence contracts/development/implementation.md#reuse-equivalent-work Each hinge branch computes its mid direction and aim once for the whole swivel sweep; scores cannot be shared because the caller evaluates distinct shoulder rotations under its own constraints.
|
|
39
|
-
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps
|
|
78
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps one branch's 360 scored candidates during its sweep and retains nothing after the solve; the caller owns the returned rotations.
|
|
40
79
|
*/
|
|
41
80
|
export declare const hingedArmArticulation: (props: {
|
|
42
81
|
upper: IAutoMovieChainBone;
|
|
@@ -45,8 +84,17 @@ export declare const hingedArmArticulation: (props: {
|
|
|
45
84
|
endOffset: IAutoMovieVector3;
|
|
46
85
|
hinge: IAutoMovieVector3;
|
|
47
86
|
target: IAutoMovieVector3;
|
|
87
|
+
range?: {
|
|
88
|
+
min: number;
|
|
89
|
+
max: number;
|
|
90
|
+
};
|
|
48
91
|
score: (upper: IAutoMovieQuaternion, lower: IAutoMovieQuaternion) => {
|
|
49
92
|
overshoot: number;
|
|
50
93
|
deviation: number;
|
|
94
|
+
exact?: () => number;
|
|
95
|
+
tiebreak?: () => number;
|
|
51
96
|
};
|
|
97
|
+
excluded?: (upper: (swivel: number) => IAutoMovieQuaternion) => (low: number, high: number) => boolean;
|
|
98
|
+
near?: IAutoMovieSwivelNear;
|
|
99
|
+
tie?: number;
|
|
52
100
|
}) => IAutoMovieHingedArticulation | null;
|