@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
|
@@ -1,21 +1,27 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.hingedArmArticulation = void 0;
|
|
4
|
-
const
|
|
5
|
-
|
|
6
|
-
const
|
|
7
|
-
|
|
4
|
+
const hingedArmSwivel_1 = require("./hingedArmSwivel");
|
|
5
|
+
/** The sweep's swivel step, degrees (`hingedArmSwivel.STEP`). */
|
|
6
|
+
const SWIVEL_STEP = hingedArmSwivel_1.hingedArmSwivel.STEP;
|
|
7
|
+
/** The golden-section ratio (`hingedArmSwivel.GOLDEN`). */
|
|
8
|
+
const GOLDEN = hingedArmSwivel_1.hingedArmSwivel.GOLDEN;
|
|
9
|
+
/** Golden-section passes per refinement (`hingedArmSwivel.REFINEMENTS`). */
|
|
10
|
+
const REFINEMENTS = hingedArmSwivel_1.hingedArmSwivel.REFINEMENTS;
|
|
8
11
|
/**
|
|
9
|
-
*
|
|
12
|
+
* Two positive overshoots closer than this, in degrees, are one overshoot.
|
|
10
13
|
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
*
|
|
14
|
-
*
|
|
14
|
+
* An overshoot is read off a clinical decomposition whose rounding is near
|
|
15
|
+
* 1e-13 degree, and a part of it may not depend on the swivel at all: a
|
|
16
|
+
* straight arm's swivel only turns the upper arm about its own length, so
|
|
17
|
+
* its flexion and abduction, and their excess past a limit, are the same for
|
|
18
|
+
* every candidate except in their last digits. Compared exactly, those
|
|
19
|
+
* digits ranked the swivels ahead of the deviation, and a request mirrored
|
|
20
|
+
* left to right, whose rounding is not mirrored, chose a twist 14 degrees
|
|
21
|
+
* away. Zero stays exact, so a candidate past a limit by any amount never
|
|
22
|
+
* ties a legal one.
|
|
15
23
|
*/
|
|
16
|
-
const
|
|
17
|
-
/** Below this the mid joint cannot change the chain's span at all. */
|
|
18
|
-
const SPAN_EPSILON = 1e-9;
|
|
24
|
+
const OVERSHOOT_ROUNDING = 1e-9;
|
|
19
25
|
/**
|
|
20
26
|
* Two-bone arm IK whose mid joint bends only about its own flexion hinge, with
|
|
21
27
|
* the chain root's free swivel spent on the rig's range of motion.
|
|
@@ -31,14 +37,52 @@ const SPAN_EPSILON = 1e-9;
|
|
|
31
37
|
* with `R = hypot(α, β)` and `φ = atan2(β, α)`: an arccos whose two roots are
|
|
32
38
|
* the chain's two bend branches. A target outside the reachable span takes the
|
|
33
39
|
* fully extended or fully folded root, so the effector stops on the reachable
|
|
34
|
-
* shell along the line to the target.
|
|
40
|
+
* shell along the line to the target. A root outside the mid joint's own
|
|
41
|
+
* `range` stops at the nearer limit in the same way, the effector resting on
|
|
42
|
+
* the legal shell along that line and the result reporting the `shortfall`;
|
|
43
|
+
* of two branches the one stopping nearer the target is swept, because a
|
|
44
|
+
* candidate past the hinge's limit would be clamped by the caller afterwards
|
|
45
|
+
* and land somewhere no candidate was scored at.
|
|
35
46
|
*
|
|
36
47
|
* The root joint first aims `m(θ)` at the target, then any extra rotation
|
|
37
48
|
* about `m(θ)` leaves the effector where it is. The function sweeps that swivel
|
|
38
|
-
* in `SWIVEL_STEP` increments on each branch
|
|
39
|
-
*
|
|
40
|
-
*
|
|
41
|
-
*
|
|
49
|
+
* in `SWIVEL_STEP` increments on each branch, ordering candidates by the least
|
|
50
|
+
* `overshoot` (legal, zero, ahead of any other exactly; two positive ones
|
|
51
|
+
* tied within the decomposition's rounding, `OVERSHOOT_ROUNDING`), then the
|
|
52
|
+
* least `deviation`, both from
|
|
53
|
+
* `score`. Every local minimum of a sweep is then refined between its
|
|
54
|
+
* neighbouring steps by golden-section search under the same ordering, and
|
|
55
|
+
* the best of the sweeps and the refinements is returned. A pass whose two
|
|
56
|
+
* probes tie closes the bracket onto both, so a request mirrored left to
|
|
57
|
+
* right, whose probes are the same two exchanged, refines to the mirrored
|
|
58
|
+
* swivel. So the chosen pose
|
|
59
|
+
* follows a moving target continuously rather than in swivel steps, a legal
|
|
60
|
+
* interval narrower than one step is still found from the dip it leaves in
|
|
61
|
+
* the sweep, and between two basins the truly better one wins rather than the
|
|
62
|
+
* one a sample happened to fall nearer the bottom of. The caller owns the
|
|
63
|
+
* decomposition and the rig's ROM, so the geometry here holds no rig policy.
|
|
64
|
+
*
|
|
65
|
+
* A caller that can certify swivels its score refuses (`excluded`) spares
|
|
66
|
+
* their scoring, and the pose is still the full sweep's. A step is skipped
|
|
67
|
+
* when every swivel within two steps of it is refused, and a step whose
|
|
68
|
+
* bracket, a step either way, is refused is not refined; every other step is
|
|
69
|
+
* scored and compared with its true neighbours, since a step that is not
|
|
70
|
+
* skipped and could be refined has both neighbours scored. When the pruned
|
|
71
|
+
* sweep finds a legal candidate, the full sweep's answer is that candidate:
|
|
72
|
+
* a refused swivel, a step or a refinement inside a refused bracket, is
|
|
73
|
+
* never legal, so it can never be ahead of a legal candidate (legality is
|
|
74
|
+
* compared exactly); every legal candidate of the full sweep is a scored
|
|
75
|
+
* step or the refinement of a step that is scored with the same neighbours,
|
|
76
|
+
* so it is the same candidate in both; and the ordering among legal
|
|
77
|
+
* candidates, met in the same order, is the same. When the pruned sweep
|
|
78
|
+
* finds none, the full sweep decides, so a chain that cannot reach legally
|
|
79
|
+
* still returns its least overshoot.
|
|
80
|
+
*
|
|
81
|
+
* A caller continuing a fit of a nearby target (`near`) skips the sweep: the
|
|
82
|
+
* seed's branch, its swivel refined within one step either way by the same
|
|
83
|
+
* golden-section search under the same ordering, to the seed's `tolerance`
|
|
84
|
+
* (`IAutoMovieSwivelNear`). Every result names its branch and swivel, the
|
|
85
|
+
* seed a nearby fit continues from.
|
|
42
86
|
*
|
|
43
87
|
* Returns `null` for a degenerate chain: a mid or end offset shorter than
|
|
44
88
|
* `1e-6`, a target within `1e-6` of the chain root, a hinge shorter than
|
|
@@ -49,84 +93,229 @@ const SPAN_EPSILON = 1e-9;
|
|
|
49
93
|
* @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.
|
|
50
94
|
* @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.
|
|
51
95
|
* @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.
|
|
52
|
-
* @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
|
|
96
|
+
* @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.
|
|
53
97
|
* @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.
|
|
54
|
-
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps
|
|
98
|
+
* @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.
|
|
55
99
|
*/
|
|
56
100
|
const hingedArmArticulation = (props) => {
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
const
|
|
64
|
-
if (
|
|
65
|
-
return null;
|
|
66
|
-
const hingeLength = Vector3_1.Vector3.length(props.hinge);
|
|
67
|
-
if (hingeLength < 1e-6)
|
|
68
|
-
return null;
|
|
69
|
-
const hinge = Vector3_1.Vector3.normalize(props.hinge);
|
|
70
|
-
// |m(θ)|² = k + α cos θ + β sin θ, with the far segment split into the part
|
|
71
|
-
// the hinge cannot move (along the hinge) and the part it swings.
|
|
72
|
-
const along = Vector3_1.Vector3.dot(hinge, endOffset);
|
|
73
|
-
const swung = Vector3_1.Vector3.subtract(endOffset, Vector3_1.Vector3.scale(hinge, along));
|
|
74
|
-
const radius = Vector3_1.Vector3.length(swung);
|
|
75
|
-
const rotated = (vector) => Quaternion_1.Quaternion.rotateVector(props.midRest, vector);
|
|
76
|
-
const k = Vector3_1.Vector3.dot(midOffset, midOffset) +
|
|
77
|
-
Vector3_1.Vector3.dot(endOffset, endOffset) +
|
|
78
|
-
2 * along * Vector3_1.Vector3.dot(midOffset, rotated(hinge));
|
|
79
|
-
let alpha = 0;
|
|
80
|
-
let beta = 0;
|
|
81
|
-
if (radius >= SPAN_EPSILON) {
|
|
82
|
-
const unit = Vector3_1.Vector3.scale(swung, 1 / radius);
|
|
83
|
-
alpha = 2 * radius * Vector3_1.Vector3.dot(midOffset, rotated(unit));
|
|
84
|
-
beta =
|
|
85
|
-
2 * radius * Vector3_1.Vector3.dot(midOffset, rotated(Vector3_1.Vector3.cross(hinge, unit)));
|
|
86
|
-
}
|
|
87
|
-
const span = Math.hypot(alpha, beta);
|
|
88
|
-
if (span < SPAN_EPSILON)
|
|
101
|
+
// The bend branches toward the target, each stopped inside the mid joint's
|
|
102
|
+
// own range (`hingedArmSwivel.branches`): a hinge angle outside the range
|
|
103
|
+
// stops at the nearer limit, so the effector rests on the legal shell along
|
|
104
|
+
// the line to the target, as it does on the geometric shell. Of two
|
|
105
|
+
// branches the one stopping nearer the target is kept; branches inside the
|
|
106
|
+
// range stop nowhere and tie.
|
|
107
|
+
const found = hingedArmSwivel_1.hingedArmSwivel.branches(props);
|
|
108
|
+
if (found === null)
|
|
89
109
|
return null;
|
|
90
|
-
const
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
110
|
+
const stops = found
|
|
111
|
+
.map((stop, branch) => ({
|
|
112
|
+
...stop,
|
|
113
|
+
branch,
|
|
114
|
+
}))
|
|
115
|
+
.filter((stop, index, all) => all.findIndex((other) => other.theta === stop.theta) === index);
|
|
116
|
+
const shortfall = Math.min(...stops.map((stop) => stop.shortfall));
|
|
117
|
+
// The candidates of one branch: the chain posed at its hinge angle and a
|
|
118
|
+
// swivel (`hingedArmSwivel.pose`), scored, and named by both so the chosen
|
|
119
|
+
// one can seed a nearby fit.
|
|
120
|
+
const prober = (stop, posed) => (angle) => {
|
|
121
|
+
const { upper, lower } = posed(angle);
|
|
122
|
+
return {
|
|
123
|
+
upper,
|
|
124
|
+
lower,
|
|
125
|
+
shortfall: stop.shortfall,
|
|
126
|
+
swivel: angle,
|
|
127
|
+
branch: stop.branch,
|
|
128
|
+
...props.score(upper, lower),
|
|
129
|
+
};
|
|
130
|
+
};
|
|
131
|
+
// Legality is compared EXACTLY, with no tolerance band. A band let a
|
|
132
|
+
// candidate sitting one part in 1e12 outside a limit count as tied with a
|
|
133
|
+
// strictly legal one and then win on deviation, so the solve returned a
|
|
134
|
+
// pose the gate refuses by 1.5e-12 of a degree. The deviation prior pulls
|
|
135
|
+
// toward the ROM box's edges, which is precisely where that happens, so
|
|
136
|
+
// the ordering has to put "inside the box" ahead of "closer to neutral"
|
|
137
|
+
// without qualification.
|
|
138
|
+
//
|
|
139
|
+
// A tie on the overshoot is decided by the deviation; two positive
|
|
140
|
+
// overshoots within `OVERSHOOT_ROUNDING` tie, since what parts them is the
|
|
141
|
+
// decomposition's rounding. A candidate scored
|
|
142
|
+
// with a lower bound of it first tries the bound: a bound already no less
|
|
143
|
+
// than the other's exact deviation decides that it is not ahead, since the
|
|
144
|
+
// exact one is no smaller, and only otherwise is the exact one computed.
|
|
145
|
+
// The answer is the one the exact deviations give, every time.
|
|
146
|
+
const better = (a, b) => {
|
|
147
|
+
const tied = a.overshoot === b.overshoot ||
|
|
148
|
+
(a.overshoot > 0 &&
|
|
149
|
+
b.overshoot > 0 &&
|
|
150
|
+
Math.abs(a.overshoot - b.overshoot) <= OVERSHOOT_ROUNDING);
|
|
151
|
+
if (!tied)
|
|
152
|
+
return a.overshoot < b.overshoot;
|
|
153
|
+
const theirs = exactOf(b);
|
|
154
|
+
// With a second key, deviations within `tie` of each other are one
|
|
155
|
+
// deviation, and the second key decides between them.
|
|
156
|
+
if (props.tie === undefined) {
|
|
157
|
+
if (a.exact !== undefined && a.deviation >= theirs)
|
|
158
|
+
return false;
|
|
159
|
+
return exactOf(a) < theirs;
|
|
120
160
|
}
|
|
161
|
+
if (a.exact !== undefined && a.deviation > theirs + props.tie)
|
|
162
|
+
return false;
|
|
163
|
+
const mine = exactOf(a);
|
|
164
|
+
if (Math.abs(mine - theirs) > props.tie)
|
|
165
|
+
return mine < theirs;
|
|
166
|
+
return tiebreakOf(a) < tiebreakOf(b);
|
|
167
|
+
};
|
|
168
|
+
// The sweep, with or without the steps `excluded` refuses: a step is
|
|
169
|
+
// skipped when the swivels within two steps of it are refused, and a step
|
|
170
|
+
// whose bracket (a step either way) is refused is not refined.
|
|
171
|
+
const sweep = (excluding) => {
|
|
172
|
+
let chosen = null;
|
|
173
|
+
let skipped = false;
|
|
174
|
+
for (const stop of stops.filter((stop) => stop.shortfall === shortfall)) {
|
|
175
|
+
const posed = hingedArmSwivel_1.hingedArmSwivel.pose(props, stop.theta);
|
|
176
|
+
const probe = prober(stop, posed);
|
|
177
|
+
const refused = excluding && props.excluded !== undefined
|
|
178
|
+
? props.excluded((angle) => posed(angle).upper)
|
|
179
|
+
: null;
|
|
180
|
+
const swept = [];
|
|
181
|
+
for (let step = 0; step * SWIVEL_STEP < 360; ++step) {
|
|
182
|
+
const angle = step * SWIVEL_STEP;
|
|
183
|
+
const out = refused !== null &&
|
|
184
|
+
refused(angle - 2 * SWIVEL_STEP, angle + 2 * SWIVEL_STEP);
|
|
185
|
+
if (out)
|
|
186
|
+
skipped = true;
|
|
187
|
+
swept.push(out ? null : probe(angle));
|
|
188
|
+
}
|
|
189
|
+
for (let step = 0; step < swept.length; ++step) {
|
|
190
|
+
const at = swept[step];
|
|
191
|
+
if (at === null)
|
|
192
|
+
continue;
|
|
193
|
+
const before = swept[(step + swept.length - 1) % swept.length];
|
|
194
|
+
const after = swept[(step + 1) % swept.length];
|
|
195
|
+
if (chosen === null || better(at, chosen))
|
|
196
|
+
chosen = at;
|
|
197
|
+
// Every local minimum of the sweep is refined, not only the sweep's
|
|
198
|
+
// best step: a legal sliver narrower than one step shows in the sweep
|
|
199
|
+
// only as a dip of the overshoot, and of two basins the one that is
|
|
200
|
+
// truly better must win, not the one whose sample fell nearer its
|
|
201
|
+
// bottom. A step level with both neighbours has nothing to refine.
|
|
202
|
+
if (before === null || after === null)
|
|
203
|
+
continue;
|
|
204
|
+
if (refused !== null &&
|
|
205
|
+
refused(step * SWIVEL_STEP - SWIVEL_STEP, step * SWIVEL_STEP + SWIVEL_STEP))
|
|
206
|
+
continue;
|
|
207
|
+
if (better(before, at) || better(after, at))
|
|
208
|
+
continue;
|
|
209
|
+
if (!better(at, before) && !better(at, after))
|
|
210
|
+
continue;
|
|
211
|
+
const refined = refine(probe, better, step * SWIVEL_STEP, REFINEMENTS);
|
|
212
|
+
if (better(refined, chosen))
|
|
213
|
+
chosen = refined;
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
return { chosen, skipped };
|
|
217
|
+
};
|
|
218
|
+
// A continued fit refines its seed on the seed's branch alone.
|
|
219
|
+
if (props.near !== undefined) {
|
|
220
|
+
const near = props.near;
|
|
221
|
+
if (!(near.tolerance > 0) || !Number.isFinite(near.tolerance))
|
|
222
|
+
throw new Error("A continued fit needs a positive finite tolerance");
|
|
223
|
+
const branch = Math.min(near.branch, found.length - 1);
|
|
224
|
+
const stop = { ...found[branch], branch };
|
|
225
|
+
const seeded = refine(prober(stop, hingedArmSwivel_1.hingedArmSwivel.pose(props, stop.theta)), better, near.swivel, Math.max(0, Math.ceil(Math.log(near.tolerance / (2 * SWIVEL_STEP)) / Math.log(GOLDEN))));
|
|
226
|
+
return {
|
|
227
|
+
upper: seeded.upper,
|
|
228
|
+
lower: seeded.lower,
|
|
229
|
+
overshoot: seeded.overshoot,
|
|
230
|
+
shortfall: seeded.shortfall,
|
|
231
|
+
swivel: seeded.swivel,
|
|
232
|
+
branch: seeded.branch,
|
|
233
|
+
deviation: exactOf(seeded),
|
|
234
|
+
...(props.tie === undefined ? {} : { second: tiebreakOf(seeded) }),
|
|
235
|
+
};
|
|
121
236
|
}
|
|
122
|
-
//
|
|
123
|
-
//
|
|
124
|
-
const
|
|
237
|
+
// Pruned, the sweep is the full one whenever it finds a legal candidate;
|
|
238
|
+
// otherwise the full sweep decides.
|
|
239
|
+
const pruned = sweep(props.excluded !== undefined);
|
|
240
|
+
const chosen = pruned.chosen !== null && (pruned.chosen.overshoot === 0 || !pruned.skipped)
|
|
241
|
+
? pruned.chosen
|
|
242
|
+
: sweep(false).chosen;
|
|
243
|
+
// `branches` is never empty and the full sweep scores 360 candidates, so
|
|
244
|
+
// `chosen` is assigned by here.
|
|
125
245
|
return {
|
|
126
246
|
upper: chosen.upper,
|
|
127
247
|
lower: chosen.lower,
|
|
128
248
|
overshoot: chosen.overshoot,
|
|
249
|
+
shortfall,
|
|
250
|
+
swivel: chosen.swivel,
|
|
251
|
+
branch: chosen.branch,
|
|
252
|
+
deviation: exactOf(chosen),
|
|
253
|
+
...(props.tie === undefined ? {} : { second: tiebreakOf(chosen) }),
|
|
129
254
|
};
|
|
130
255
|
};
|
|
131
256
|
exports.hingedArmArticulation = hingedArmArticulation;
|
|
257
|
+
/** A candidate's exact tie-break, read once. */
|
|
258
|
+
const exactOf = (scored) => {
|
|
259
|
+
if (scored.exact === undefined)
|
|
260
|
+
return scored.deviation;
|
|
261
|
+
if (scored.known === undefined)
|
|
262
|
+
scored.known = scored.exact();
|
|
263
|
+
return scored.known;
|
|
264
|
+
};
|
|
265
|
+
/** A candidate's second key, read once; 0 without one. */
|
|
266
|
+
const tiebreakOf = (scored) => {
|
|
267
|
+
if (scored.tiebreak === undefined)
|
|
268
|
+
return 0;
|
|
269
|
+
if (scored.second === undefined)
|
|
270
|
+
scored.second = scored.tiebreak();
|
|
271
|
+
return scored.second;
|
|
272
|
+
};
|
|
273
|
+
/**
|
|
274
|
+
* Refine the swivel between a sweep step's neighbours by golden-section
|
|
275
|
+
* search (Kiefer 1953) under the sweep's own ordering, so the swivel varies
|
|
276
|
+
* continuously with the target instead of in `SWIVEL_STEP` jumps.
|
|
277
|
+
*
|
|
278
|
+
* @param probe Scores the candidate at a swivel angle, degrees.
|
|
279
|
+
* @param better Whether the first candidate is strictly ahead of the second.
|
|
280
|
+
* @param angle The swivel the bracket, one step either way, is centred on, degrees.
|
|
281
|
+
* @param passes The passes, each shrinking the bracket by `GOLDEN`.
|
|
282
|
+
* @returns The better of the search's last two probes.
|
|
283
|
+
*/
|
|
284
|
+
const refine = (probe, better, angle, passes) => {
|
|
285
|
+
let low = angle - SWIVEL_STEP;
|
|
286
|
+
let high = angle + SWIVEL_STEP;
|
|
287
|
+
let inner = high - GOLDEN * (high - low);
|
|
288
|
+
let outer = low + GOLDEN * (high - low);
|
|
289
|
+
let atInner = probe(inner);
|
|
290
|
+
let atOuter = probe(outer);
|
|
291
|
+
for (let pass = 0; pass < passes; ++pass) {
|
|
292
|
+
if (better(atInner, atOuter)) {
|
|
293
|
+
high = outer;
|
|
294
|
+
outer = inner;
|
|
295
|
+
atOuter = atInner;
|
|
296
|
+
inner = high - GOLDEN * (high - low);
|
|
297
|
+
atInner = probe(inner);
|
|
298
|
+
}
|
|
299
|
+
else if (better(atOuter, atInner)) {
|
|
300
|
+
low = inner;
|
|
301
|
+
inner = outer;
|
|
302
|
+
atInner = atOuter;
|
|
303
|
+
outer = low + GOLDEN * (high - low);
|
|
304
|
+
atOuter = probe(outer);
|
|
305
|
+
}
|
|
306
|
+
else {
|
|
307
|
+
// A tie: the minimum of a unimodal score lies between the two probes,
|
|
308
|
+
// so both ends close in. Keeping either side instead would send a
|
|
309
|
+
// mirrored request, whose probes are these two exchanged, to the
|
|
310
|
+
// opposite end of a level stretch.
|
|
311
|
+
low = inner;
|
|
312
|
+
high = outer;
|
|
313
|
+
inner = high - GOLDEN * (high - low);
|
|
314
|
+
outer = low + GOLDEN * (high - low);
|
|
315
|
+
atInner = probe(inner);
|
|
316
|
+
atOuter = probe(outer);
|
|
317
|
+
}
|
|
318
|
+
}
|
|
319
|
+
return better(atOuter, atInner) ? atOuter : atInner;
|
|
320
|
+
};
|
|
132
321
|
//# sourceMappingURL=hingedArmArticulation.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hingedArmArticulation.js","sourceRoot":"","sources":["../../src/kinematics/hingedArmArticulation.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"hingedArmArticulation.js","sourceRoot":"","sources":["../../src/kinematics/hingedArmArticulation.ts"],"names":[],"mappings":";;;AAKA,uDAAoD;AAEpD,iEAAiE;AACjE,MAAM,WAAW,GAAW,iCAAe,CAAC,IAAI,CAAC;AAEjD,2DAA2D;AAC3D,MAAM,MAAM,GAAW,iCAAe,CAAC,MAAM,CAAC;AAE9C,4EAA4E;AAC5E,MAAM,WAAW,GAAW,iCAAe,CAAC,WAAW,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,MAAM,kBAAkB,GAAW,IAAI,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACI,MAAM,qBAAqB,GAsBU,CAAC,KA2E5C,EAAuC,EAAE;IACxC,2EAA2E;IAC3E,0EAA0E;IAC1E,4EAA4E;IAC5E,oEAAoE;IACpE,2EAA2E;IAC3E,8BAA8B;IAC9B,MAAM,KAAK,GAAmC,iCAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9E,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,KAAK,GAAc,KAAK;SAC3B,GAAG,CACF,CAAC,IAA2B,EAAE,MAAc,EAAW,EAAE,CAAC,CAAC;QACzD,GAAG,IAAI;QACP,MAAM;KACP,CAAC,CACH;SACA,MAAM,CACL,CAAC,IAAa,EAAE,KAAa,EAAE,GAAc,EAAW,EAAE,CACxD,GAAG,CAAC,SAAS,CACX,CAAC,KAAc,EAAW,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CACxD,KAAK,KAAK,CACd,CAAC;IACJ,MAAM,SAAS,GAAW,IAAI,CAAC,GAAG,CAChC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAa,EAAU,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CACxD,CAAC;IACF,yEAAyE;IACzE,2EAA2E;IAC3E,6BAA6B;IAC7B,MAAM,MAAM,GACV,CACE,IAAa,EACb,KAA8C,EAChB,EAAE,CAClC,CAAC,KAAa,EAAW,EAAE;QACzB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,OAAO;YACL,KAAK;YACL,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC;SAC7B,CAAC;IACJ,CAAC,CAAC;IACJ,qEAAqE;IACrE,0EAA0E;IAC1E,wEAAwE;IACxE,0EAA0E;IAC1E,wEAAwE;IACxE,wEAAwE;IACxE,yBAAyB;IACzB,EAAE;IACF,mEAAmE;IACnE,2EAA2E;IAC3E,+CAA+C;IAC/C,0EAA0E;IAC1E,2EAA2E;IAC3E,yEAAyE;IACzE,+DAA+D;IAC/D,MAAM,MAAM,GAAG,CAAC,CAAU,EAAE,CAAU,EAAW,EAAE;QACjD,MAAM,IAAI,GACR,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS;YAC3B,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC;gBACd,CAAC,CAAC,SAAS,GAAG,CAAC;gBACf,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,IAAI,kBAAkB,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;QAC5C,MAAM,MAAM,GAAW,OAAO,CAAC,CAAC,CAAC,CAAC;QAClC,mEAAmE;QACnE,sDAAsD;QACtD,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,IAAI,MAAM;gBAAE,OAAO,KAAK,CAAC;YACjE,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,GAAG,MAAM,GAAG,KAAK,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QAC5E,MAAM,IAAI,GAAW,OAAO,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG;YAAE,OAAO,IAAI,GAAG,MAAM,CAAC;QAC9D,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC;IAEF,qEAAqE;IACrE,0EAA0E;IAC1E,+DAA+D;IAC/D,MAAM,KAAK,GAAG,CACZ,SAAkB,EAC4B,EAAE;QAChD,IAAI,MAAM,GAAmB,IAAI,CAAC;QAClC,IAAI,OAAO,GAAY,KAAK,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,CAC7B,CAAC,IAAa,EAAW,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CACzD,EAAE,CAAC;YACF,MAAM,KAAK,GAAG,iCAAe,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACtD,MAAM,KAAK,GAA+B,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC9D,MAAM,OAAO,GACX,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;gBACvC,CAAC,CAAC,KAAK,CAAC,QAAQ,CACZ,CAAC,KAAa,EAAwB,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAC5D;gBACH,CAAC,CAAC,IAAI,CAAC;YACX,MAAM,KAAK,GAAuB,EAAE,CAAC;YACrC,KAAK,IAAI,IAAI,GAAW,CAAC,EAAE,IAAI,GAAG,WAAW,GAAG,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC;gBAC5D,MAAM,KAAK,GAAW,IAAI,GAAG,WAAW,CAAC;gBACzC,MAAM,GAAG,GACP,OAAO,KAAK,IAAI;oBAChB,OAAO,CAAC,KAAK,GAAG,CAAC,GAAG,WAAW,EAAE,KAAK,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;gBAC5D,IAAI,GAAG;oBAAE,OAAO,GAAG,IAAI,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YACxC,CAAC;YACD,KAAK,IAAI,IAAI,GAAW,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC;gBACvD,MAAM,EAAE,GAAmB,KAAK,CAAC,IAAI,CAAE,CAAC;gBACxC,IAAI,EAAE,KAAK,IAAI;oBAAE,SAAS;gBAC1B,MAAM,MAAM,GACV,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAE,CAAC;gBACnD,MAAM,KAAK,GAAmB,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAE,CAAC;gBAChE,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC;oBAAE,MAAM,GAAG,EAAE,CAAC;gBAEvD,oEAAoE;gBACpE,sEAAsE;gBACtE,oEAAoE;gBACpE,kEAAkE;gBAClE,mEAAmE;gBACnE,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI;oBAAE,SAAS;gBAChD,IACE,OAAO,KAAK,IAAI;oBAChB,OAAO,CACL,IAAI,GAAG,WAAW,GAAG,WAAW,EAChC,IAAI,GAAG,WAAW,GAAG,WAAW,CACjC;oBAED,SAAS;gBACX,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;oBAAE,SAAS;gBACtD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC;oBAAE,SAAS;gBACxD,MAAM,OAAO,GAAY,MAAM,CAC7B,KAAK,EACL,MAAM,EACN,IAAI,GAAG,WAAW,EAClB,WAAW,CACZ,CAAC;gBACF,IAAI,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;oBAAE,MAAM,GAAG,OAAO,CAAC;YAChD,CAAC;QACH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC,CAAC;IACF,+DAA+D;IAC/D,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAyB,KAAK,CAAC,IAAI,CAAC;QAC9C,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,MAAM,MAAM,GAAW,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAY,EAAE,GAAG,KAAK,CAAC,MAAM,CAAE,EAAE,MAAM,EAAE,CAAC;QACpD,MAAM,MAAM,GAAY,MAAM,CAC5B,MAAM,CAAC,IAAI,EAAE,iCAAe,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EACrD,MAAM,EACN,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,GAAG,CACN,CAAC,EACD,IAAI,CAAC,IAAI,CACP,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAChE,CACF,CACF,CAAC;QACF,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC;YAC1B,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,oCAAoC;IACpC,MAAM,MAAM,GAAiD,KAAK,CAChE,KAAK,CAAC,QAAQ,KAAK,SAAS,CAC7B,CAAC;IACF,MAAM,MAAM,GACV,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAC1E,CAAC,CAAC,MAAM,CAAC,MAAM;QACf,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAC1B,yEAAyE;IACzE,gCAAgC;IAChC,OAAO;QACL,KAAK,EAAE,MAAO,CAAC,KAAK;QACpB,KAAK,EAAE,MAAO,CAAC,KAAK;QACpB,SAAS,EAAE,MAAO,CAAC,SAAS;QAC5B,SAAS;QACT,MAAM,EAAE,MAAO,CAAC,MAAM;QACtB,MAAM,EAAE,MAAO,CAAC,MAAM;QACtB,SAAS,EAAE,OAAO,CAAC,MAAO,CAAC;QAC3B,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAO,CAAC,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC,CAAC;AAlSW,QAAA,qBAAqB,GAArB,qBAAqB,CAkShC;AA0BF,gDAAgD;AAChD,MAAM,OAAO,GAAG,CAAC,MAAe,EAAU,EAAE;IAC1C,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,SAAS,CAAC;IACxD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;IAC9D,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC,CAAC;AAEF,0DAA0D;AAC1D,MAAM,UAAU,GAAG,CAAC,MAAe,EAAU,EAAE;IAC7C,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IACnE,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,GAAG,CACb,KAAiC,EACjC,MAA2C,EAC3C,KAAa,EACb,MAAc,EACL,EAAE;IACX,IAAI,GAAG,GAAW,KAAK,GAAG,WAAW,CAAC;IACtC,IAAI,IAAI,GAAW,KAAK,GAAG,WAAW,CAAC;IACvC,IAAI,KAAK,GAAW,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;IACjD,IAAI,KAAK,GAAW,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;IAChD,IAAI,OAAO,GAAY,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,OAAO,GAAY,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,KAAK,IAAI,IAAI,GAAW,CAAC,EAAE,IAAI,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC;QACjD,IAAI,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;YAC7B,IAAI,GAAG,KAAK,CAAC;YACb,KAAK,GAAG,KAAK,CAAC;YACd,OAAO,GAAG,OAAO,CAAC;YAClB,KAAK,GAAG,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;YACrC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;aAAM,IAAI,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;YACpC,GAAG,GAAG,KAAK,CAAC;YACZ,KAAK,GAAG,KAAK,CAAC;YACd,OAAO,GAAG,OAAO,CAAC;YAClB,KAAK,GAAG,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;YACpC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,sEAAsE;YACtE,kEAAkE;YAClE,iEAAiE;YACjE,mCAAmC;YACnC,GAAG,GAAG,KAAK,CAAC;YACZ,IAAI,GAAG,KAAK,CAAC;YACb,KAAK,GAAG,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;YACrC,KAAK,GAAG,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;YACpC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YACvB,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AACtD,CAAC,CAAC"}
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
import { IAutoMovieQuaternion, IAutoMovieVector3 } from "@automovie/interface";
|
|
2
|
+
import { IAutoMovieChainBone } from "./IAutoMovieChainBone";
|
|
3
|
+
/**
|
|
4
|
+
* The geometry of a two-bone chain whose mid joint bends only about its own
|
|
5
|
+
* hinge, as `hingedArmArticulation` poses it: the hinge angles that reach a
|
|
6
|
+
* target's distance (the chain's bend branches, each stopped inside the mid
|
|
7
|
+
* joint's range), and the root rotation that aims the chain at the target
|
|
8
|
+
* and then turns it by a swivel about its own root-to-effector line, which
|
|
9
|
+
* leaves the effector where it is (Tolani, Goswami and Badler 2000). A
|
|
10
|
+
* swivel and a branch name one pose of the chain for any target, so a
|
|
11
|
+
* caller that holds them while the target moves poses the chain exactly as
|
|
12
|
+
* the articulation does, and `read` recovers them from a posed chain.
|
|
13
|
+
*
|
|
14
|
+
* @evidence contracts/development/common.md#meaningful-documentation States the branches, the aim and swivel, and what a held swivel means.
|
|
15
|
+
* @evidence contracts/development/design.md#principled-representation The swivel parameterisation of Tolani, Goswami and Badler 2000: a hinge angle per branch and a swivel about the root-to-effector line.
|
|
16
|
+
* @evidence contracts/development/design.md#minimal-and-owned-surface The chain, the swivel and three functions: the branches, the pose and its reading; `hingedArmArticulation` poses its candidates through them.
|
|
17
|
+
* @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses `aimRotation`; the scoring and the sweep stay with `hingedArmArticulation`.
|
|
18
|
+
*/
|
|
19
|
+
export declare namespace hingedArmSwivel {
|
|
20
|
+
/**
|
|
21
|
+
* Swivel resolution of `hingedArmArticulation`'s candidate sweep, in
|
|
22
|
+
* degrees.
|
|
23
|
+
*
|
|
24
|
+
* Every candidate lands the effector on the same point, so the step decides
|
|
25
|
+
* only which of the equally exact poses is chosen, never how close the hand
|
|
26
|
+
* gets. One degree gives 360 candidates per bend branch, and the solve runs
|
|
27
|
+
* once per authored action rather than per frame.
|
|
28
|
+
*/
|
|
29
|
+
const STEP: number;
|
|
30
|
+
/** The golden-section ratio, `(sqrt(5) - 1) / 2`, by which each refinement pass shrinks the swivel bracket. */
|
|
31
|
+
const GOLDEN: number;
|
|
32
|
+
/**
|
|
33
|
+
* Golden-section passes refining the swivel inside the two-step bracket
|
|
34
|
+
* around each local minimum of the sweep: the fewest that shrink the
|
|
35
|
+
* bracket, `2 STEP`, by `GOLDEN` a pass to within the joint's tolerance
|
|
36
|
+
* (`ROM_TOLERANCE`), since a swivel turns the chain root's joint by itself
|
|
37
|
+
* and a solver need resolve a joint's angle no finer.
|
|
38
|
+
*/
|
|
39
|
+
const REFINEMENTS: number;
|
|
40
|
+
/** The width the refinement leaves of a swivel's bracket, degrees: the two-step bracket shrunk by `GOLDEN` per pass, the swivel's resolution, within `ROM_TOLERANCE`. */
|
|
41
|
+
const RESOLUTION: number;
|
|
42
|
+
/**
|
|
43
|
+
* A hinged chain toward a target.
|
|
44
|
+
*
|
|
45
|
+
* @evidence contracts/development/common.md#meaningful-documentation Each member states its frame.
|
|
46
|
+
* @evidence contracts/development/design.md#principled-representation The chain's rest geometry, its root's frame and the target, as `hingedArmArticulation` takes them.
|
|
47
|
+
* @evidence contracts/development/design.md#minimal-and-owned-surface Seven members.
|
|
48
|
+
* @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses `IAutoMovieChainBone`.
|
|
49
|
+
*/
|
|
50
|
+
interface IChain {
|
|
51
|
+
/** Chain-root bone (the shoulder or the hip) resolved under the rig's rest FK. */
|
|
52
|
+
upper: IAutoMovieChainBone;
|
|
53
|
+
/** Mid bone's rest offset from the chain root, in the root's bone frame. */
|
|
54
|
+
midOffset: IAutoMovieVector3;
|
|
55
|
+
/** Mid bone's rest rotation relative to the chain root. */
|
|
56
|
+
midRest: IAutoMovieQuaternion;
|
|
57
|
+
/** Effector's rest offset from the mid joint, in the mid bone's frame. */
|
|
58
|
+
endOffset: IAutoMovieVector3;
|
|
59
|
+
/** The mid joint's flexion axis in the mid bone's frame; any length. */
|
|
60
|
+
hinge: IAutoMovieVector3;
|
|
61
|
+
/** World target the effector should land on. */
|
|
62
|
+
target: IAutoMovieVector3;
|
|
63
|
+
/** The mid joint's legal rotation about `hinge`, radians, `min <= max` and no wider than a full turn; every hinge angle is legal when absent. */
|
|
64
|
+
range?: {
|
|
65
|
+
min: number;
|
|
66
|
+
max: number;
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* One bend branch after the hinge's range.
|
|
71
|
+
*
|
|
72
|
+
* @evidence contracts/development/common.md#meaningful-documentation Each member states its unit.
|
|
73
|
+
* @evidence contracts/development/design.md#principled-representation A hinge angle and how far short of the target it stops.
|
|
74
|
+
* @evidence contracts/development/design.md#minimal-and-owned-surface Two members.
|
|
75
|
+
* @evidence contracts/development/design.md#prohibited-design-shortcuts None.
|
|
76
|
+
*/
|
|
77
|
+
interface IStop {
|
|
78
|
+
/** The hinge angle, radians, inside the range when one is given. */
|
|
79
|
+
theta: number;
|
|
80
|
+
/** Metres between the chain's span at `theta` and the target distance; `0` for a branch that reaches the distance inside the range. */
|
|
81
|
+
shortfall: number;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* The chain's bend branches toward its target: the two hinge angles whose
|
|
85
|
+
* span is the target's distance, `phase + acos` first, or the fully
|
|
86
|
+
* extended or folded one outside the span, each stopped at the nearer limit
|
|
87
|
+
* of the range.
|
|
88
|
+
*
|
|
89
|
+
* @param chain The chain.
|
|
90
|
+
* @returns The branches, in that order, or null for a degenerate chain (`hingedArmArticulation`).
|
|
91
|
+
*
|
|
92
|
+
* @evidence contracts/development/common.md#meaningful-documentation States the order, the stops and the null.
|
|
93
|
+
* @evidence contracts/development/implementation.md#principled-implementation The span is an exact sinusoid in the hinge angle, so its two arccos roots are the only hinge angles reaching the distance.
|
|
94
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure The sinusoid, its roots, then the range.
|
|
95
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The degeneracy thresholds are the engine's shared length scale.
|
|
96
|
+
* @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work with no algorithm to choose.
|
|
97
|
+
* @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Nothing to reuse.
|
|
98
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
|
|
99
|
+
*/
|
|
100
|
+
function branches(chain: IChain): IStop[] | null;
|
|
101
|
+
/**
|
|
102
|
+
* The chain posed at a hinge angle, for any swivel: the mid joint turned by
|
|
103
|
+
* the hinge angle, the root aimed so the chain's root-to-effector line
|
|
104
|
+
* points at the target (`aimRotation`), then turned about that line by the
|
|
105
|
+
* swivel.
|
|
106
|
+
*
|
|
107
|
+
* @param chain The chain.
|
|
108
|
+
* @param theta The hinge angle, radians.
|
|
109
|
+
* @returns The bone-local root and mid rotations at a swivel about the root-to-effector line, degrees.
|
|
110
|
+
*
|
|
111
|
+
* @evidence contracts/development/common.md#meaningful-documentation States the order of the turns and the units.
|
|
112
|
+
* @evidence contracts/development/implementation.md#principled-implementation The swivel about the root-to-effector line is an exact null space of the effector's position.
|
|
113
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure The hinge, the line and the aim once, then the swivel per call.
|
|
114
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
|
|
115
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms The mid direction and the aim are read once for every swivel of a branch.
|
|
116
|
+
* @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses `aimRotation`.
|
|
117
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains the branch's mid rotation, line and aim in the returned function only.
|
|
118
|
+
*/
|
|
119
|
+
function pose(chain: IChain, theta: number): (swivel: number) => {
|
|
120
|
+
upper: IAutoMovieQuaternion;
|
|
121
|
+
lower: IAutoMovieQuaternion;
|
|
122
|
+
};
|
|
123
|
+
/**
|
|
124
|
+
* The swivel of a posed chain: the root's turn about the chain's
|
|
125
|
+
* root-to-effector line past the aim `pose` gives for its hinge angle.
|
|
126
|
+
*
|
|
127
|
+
* @param chain The chain, its target where the posed effector lies.
|
|
128
|
+
* @param upper The posed bone-local root rotation.
|
|
129
|
+
* @param theta The posed hinge angle, radians.
|
|
130
|
+
* @returns Degrees, in (-180, 180].
|
|
131
|
+
*
|
|
132
|
+
* @evidence contracts/development/common.md#meaningful-documentation States what is read and its range.
|
|
133
|
+
* @evidence contracts/development/implementation.md#principled-implementation The inverse of `pose`: the aim removed, the rest is a turn about the line.
|
|
134
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure The aim, the remainder, its angle.
|
|
135
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
|
|
136
|
+
* @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work with no algorithm to choose.
|
|
137
|
+
* @evidence contracts/development/implementation.md#reuse-equivalent-work Shares `pose`'s aim.
|
|
138
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
|
|
139
|
+
*/
|
|
140
|
+
function read(chain: IChain, upper: IAutoMovieQuaternion, theta: number): number;
|
|
141
|
+
}
|