@automovie/engine 0.0.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
- package/lib/analysis/index.d.ts +5 -0
- package/lib/analysis/index.js +5 -0
- package/lib/analysis/index.js.map +1 -1
- package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
- package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
- package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
- package/lib/anthropometry/index.d.ts +1 -0
- package/lib/anthropometry/index.js +18 -0
- package/lib/anthropometry/index.js.map +1 -0
- package/lib/architecture/appendBuiltRegionDefects.d.ts +1 -1
- package/lib/architecture/appendBuiltRegionDefects.js +3 -3
- package/lib/architecture/appendBuiltRegionDefects.js.map +1 -1
- package/lib/architecture/builtOutlineIsClosed.d.ts +1 -1
- package/lib/architecture/builtOutlineIsClosed.js +3 -3
- package/lib/architecture/builtOutlineIsClosed.js.map +1 -1
- package/{src/architecture/constants/PLANAR_EPSILON.ts → lib/architecture/constants/BUILT_PLANAR_EPSILON.d.ts} +1 -1
- package/lib/architecture/constants/{PLANAR_EPSILON.js → BUILT_PLANAR_EPSILON.js} +3 -3
- package/lib/architecture/constants/BUILT_PLANAR_EPSILON.js.map +1 -0
- package/lib/architecture/constants/index.d.ts +1 -1
- package/lib/architecture/constants/index.js +1 -1
- package/lib/architecture/constants/index.js.map +1 -1
- package/lib/architecture/index.d.ts +157 -117
- package/lib/architecture/index.js +171 -158
- package/lib/architecture/index.js.map +1 -1
- package/lib/cache/index.d.ts +9 -0
- package/lib/cache/index.js +26 -0
- package/lib/cache/index.js.map +1 -0
- package/lib/composition/AutoMovieComposition.d.ts +25 -6
- package/lib/composition/AutoMovieComposition.js +4 -3
- package/lib/composition/AutoMovieComposition.js.map +1 -1
- package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
- package/lib/composition/AutoMovieScheduleCut.js +99 -0
- package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
- package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
- package/lib/composition/AutoMovieScheduleError.js +51 -0
- package/lib/composition/AutoMovieScheduleError.js.map +1 -0
- package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
- package/lib/composition/AutoMovieSchedulePlace.js +185 -0
- package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
- package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
- package/lib/composition/AutoMovieScheduleWalk.js +161 -0
- package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
- package/lib/composition/IAutoMovieIntent.d.ts +9 -6
- package/lib/composition/index.d.ts +12 -7
- package/lib/composition/index.js +12 -2
- package/lib/composition/index.js.map +1 -1
- package/lib/composition/markAutoMovieContacts.d.ts +29 -0
- package/lib/composition/markAutoMovieContacts.js +69 -0
- package/lib/composition/markAutoMovieContacts.js.map +1 -0
- package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
- package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
- package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
- package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
- package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
- package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
- package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
- package/lib/composition/resolveAutoMovieSchedule.js +32 -103
- package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
- package/lib/constants/index.d.ts +2 -0
- package/lib/constants/index.js +2 -0
- package/lib/constants/index.js.map +1 -1
- package/lib/createAutoMovieGeometryActorReader.js +2 -1
- package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
- package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
- package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
- package/lib/drawing/index.d.ts +12 -0
- package/lib/drawing/index.js +12 -0
- package/lib/drawing/index.js.map +1 -1
- package/lib/effectRuntime/index.d.ts +7 -0
- package/lib/effectRuntime/index.js +7 -0
- package/lib/effectRuntime/index.js.map +1 -1
- package/lib/film/compileAttach.js +2 -5
- package/lib/film/compileAttach.js.map +1 -1
- package/lib/film/compileLaunch.d.ts +2 -2
- package/lib/film/compileLaunch.js +4 -3
- package/lib/film/compileLaunch.js.map +1 -1
- package/lib/film/constants/index.d.ts +3 -0
- package/lib/film/constants/index.js +3 -0
- package/lib/film/constants/index.js.map +1 -1
- package/lib/film/index.d.ts +61 -6
- package/lib/film/index.js +61 -12
- package/lib/film/index.js.map +1 -1
- package/lib/film/propAnchorFrame.js +6 -9
- package/lib/film/propAnchorFrame.js.map +1 -1
- package/lib/film/stageScene.js +3 -10
- package/lib/film/stageScene.js.map +1 -1
- package/lib/film/staging/index.d.ts +11 -0
- package/lib/film/staging/index.js +28 -0
- package/lib/film/staging/index.js.map +1 -0
- package/lib/film/staging/lowerLightPlacement.js +4 -7
- package/lib/film/staging/lowerLightPlacement.js.map +1 -1
- package/lib/formationSlotPosition.d.ts +6 -1
- package/lib/formationSlotPosition.js +38 -3
- package/lib/formationSlotPosition.js.map +1 -1
- package/lib/geometry/IAutoMovieMark.d.ts +99 -0
- package/lib/geometry/IAutoMovieMark.js +3 -0
- package/lib/geometry/IAutoMovieMark.js.map +1 -0
- package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
- package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
- package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
- package/lib/geometry/constants/index.d.ts +2 -0
- package/lib/geometry/constants/index.js +2 -0
- package/lib/geometry/constants/index.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
- package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
- package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
- package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
- package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
- package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
- package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
- package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
- package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
- package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
- package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
- package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
- package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
- package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
- package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
- package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
- package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
- package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
- package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
- package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
- package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
- package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
- package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
- package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
- package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
- package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
- package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
- package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
- package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
- package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
- package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
- package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
- package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
- package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
- package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
- package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
- package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
- package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
- package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
- package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
- package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
- package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
- package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
- package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
- package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
- package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
- package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
- package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
- package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
- package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
- package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
- package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
- package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
- package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
- package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
- package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
- package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
- package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
- package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
- package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
- package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
- package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
- package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
- package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
- package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
- package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
- package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
- package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
- package/lib/geometry/construction/index.d.ts +82 -2
- package/lib/geometry/construction/index.js +82 -2
- package/lib/geometry/construction/index.js.map +1 -1
- package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
- package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
- package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
- package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
- package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
- package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
- package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
- package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
- package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
- package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
- package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
- package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
- package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
- package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
- package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
- package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
- package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
- package/lib/geometry/curve/index.d.ts +48 -25
- package/lib/geometry/curve/index.js +48 -25
- package/lib/geometry/curve/index.js.map +1 -1
- package/lib/geometry/extract/index.d.ts +0 -1
- package/lib/geometry/extract/index.js +0 -1
- package/lib/geometry/extract/index.js.map +1 -1
- package/lib/geometry/index.d.ts +87 -53
- package/lib/geometry/index.js +87 -50
- package/lib/geometry/index.js.map +1 -1
- package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
- package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
- package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
- package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
- package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
- package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
- package/lib/geometry/sweep/index.d.ts +54 -15
- package/lib/geometry/sweep/index.js +54 -1
- package/lib/geometry/sweep/index.js.map +1 -1
- package/lib/index.d.ts +41 -450
- package/lib/index.js +41 -660
- package/lib/index.js.map +1 -1
- package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
- package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
- package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
- package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
- package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
- package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
- package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
- package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
- package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
- package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
- package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
- package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
- package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
- package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
- package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
- package/lib/kinematics/alternateRigJointAngles.js +34 -0
- package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
- package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
- package/lib/kinematics/boxExcludedSwivels.js +187 -0
- package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
- package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
- package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
- package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
- package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
- package/lib/kinematics/curlChainUntilContact.js +45 -5
- package/lib/kinematics/curlChainUntilContact.js.map +1 -1
- package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
- package/lib/kinematics/decomposeJointRotation.js +10 -131
- package/lib/kinematics/decomposeJointRotation.js.map +1 -1
- package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
- package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
- package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
- package/lib/kinematics/fitDigitDescent.d.ts +66 -0
- package/lib/kinematics/fitDigitDescent.js +142 -0
- package/lib/kinematics/fitDigitDescent.js.map +1 -0
- package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
- package/lib/kinematics/fitDigitToTarget.js +251 -0
- package/lib/kinematics/fitDigitToTarget.js.map +1 -0
- package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
- package/lib/kinematics/hingedArmArticulation.js +273 -84
- package/lib/kinematics/hingedArmArticulation.js.map +1 -1
- package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
- package/lib/kinematics/hingedArmSwivel.js +196 -0
- package/lib/kinematics/hingedArmSwivel.js.map +1 -0
- package/lib/kinematics/index.d.ts +30 -7
- package/lib/kinematics/index.js +30 -5
- package/lib/kinematics/index.js.map +1 -1
- package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
- package/lib/kinematics/jointRomOvershoot.js +21 -17
- package/lib/kinematics/jointRomOvershoot.js.map +1 -1
- package/lib/kinematics/jointToQuaternion.d.ts +2 -2
- package/lib/kinematics/jointToQuaternion.js +4 -19
- package/lib/kinematics/jointToQuaternion.js.map +1 -1
- package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
- package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
- package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
- package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
- package/lib/kinematics/markAutoMovieBalance.js +65 -0
- package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
- package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
- package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
- package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
- package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
- package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
- package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
- package/lib/kinematics/normalizeJointAxes.js +52 -12
- package/lib/kinematics/normalizeJointAxes.js.map +1 -1
- package/lib/kinematics/poseJointCodec.d.ts +71 -0
- package/lib/kinematics/poseJointCodec.js +70 -0
- package/lib/kinematics/poseJointCodec.js.map +1 -0
- package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
- package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
- package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
- package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
- package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
- package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
- package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
- package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
- package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
- package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
- package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
- package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
- package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
- package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
- package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
- package/lib/kinematics/swingTwistBasis.d.ts +108 -0
- package/lib/kinematics/swingTwistBasis.js +116 -0
- package/lib/kinematics/swingTwistBasis.js.map +1 -0
- package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
- package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
- package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
- package/lib/kinematics/swingTwistRange.d.ts +246 -0
- package/lib/kinematics/swingTwistRange.js +322 -0
- package/lib/kinematics/swingTwistRange.js.map +1 -0
- package/lib/kinematics/swingTwistRegion.d.ts +50 -0
- package/lib/kinematics/swingTwistRegion.js +212 -0
- package/lib/kinematics/swingTwistRegion.js.map +1 -0
- package/lib/kinematics/swivelArcs.d.ts +166 -0
- package/lib/kinematics/swivelArcs.js +200 -0
- package/lib/kinematics/swivelArcs.js.map +1 -0
- package/lib/math/Quaternion.d.ts +29 -2
- package/lib/math/Quaternion.js +33 -2
- package/lib/math/Quaternion.js.map +1 -1
- package/lib/math/Transform.d.ts +50 -0
- package/lib/math/Transform.js +58 -0
- package/lib/math/Transform.js.map +1 -0
- package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
- package/lib/math/assignAutoMovieMinimumCost.js +86 -0
- package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
- package/lib/math/bracketedBisection.d.ts +33 -0
- package/lib/math/bracketedBisection.js +52 -0
- package/lib/math/bracketedBisection.js.map +1 -0
- package/lib/math/bracketedRoot.d.ts +32 -0
- package/lib/math/bracketedRoot.js +76 -0
- package/lib/math/bracketedRoot.js.map +1 -0
- package/lib/math/constants/index.d.ts +1 -0
- package/lib/math/constants/index.js +18 -0
- package/lib/math/constants/index.js.map +1 -0
- package/lib/math/index.d.ts +64 -5
- package/lib/math/index.js +64 -5
- package/lib/math/index.js.map +1 -1
- package/lib/math/nearestAngleAlias.d.ts +27 -0
- package/lib/math/nearestAngleAlias.js +44 -0
- package/lib/math/nearestAngleAlias.js.map +1 -0
- package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
- package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
- package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
- package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
- package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
- package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
- package/lib/measureAutoMovieGeometryReach.js +2 -4
- package/lib/measureAutoMovieGeometryReach.js.map +1 -1
- package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
- package/lib/motion/AirborneTakeoffLinear.js +58 -0
- package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
- package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
- package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
- package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
- package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
- package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
- package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
- package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
- package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
- package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
- package/lib/motion/MotionTrajectoryStepper.js +357 -0
- package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
- package/lib/motion/basisOf.d.ts +18 -0
- package/lib/motion/basisOf.js +25 -0
- package/lib/motion/basisOf.js.map +1 -0
- package/lib/motion/carriedAcceleration.d.ts +43 -0
- package/lib/motion/carriedAcceleration.js +55 -0
- package/lib/motion/carriedAcceleration.js.map +1 -0
- package/lib/motion/carriedRate.d.ts +48 -0
- package/lib/motion/carriedRate.js +60 -0
- package/lib/motion/carriedRate.js.map +1 -0
- package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
- package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
- package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
- package/lib/motion/constants/index.d.ts +1 -0
- package/lib/motion/constants/index.js +1 -0
- package/lib/motion/constants/index.js.map +1 -1
- package/lib/motion/fitChainBend.d.ts +23 -0
- package/lib/motion/fitChainBend.js +293 -0
- package/lib/motion/fitChainBend.js.map +1 -0
- package/lib/motion/fitChainToTarget.d.ts +11 -13
- package/lib/motion/fitChainToTarget.js +12 -283
- package/lib/motion/fitChainToTarget.js.map +1 -1
- package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
- package/lib/motion/fitHingedChainCandidate.js +186 -76
- package/lib/motion/fitHingedChainCandidate.js.map +1 -1
- package/lib/motion/fitHingedRotationError.d.ts +31 -0
- package/lib/motion/fitHingedRotationError.js +107 -0
- package/lib/motion/fitHingedRotationError.js.map +1 -0
- package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
- package/lib/motion/fitSeededChainToTarget.js +32 -0
- package/lib/motion/fitSeededChainToTarget.js.map +1 -0
- package/lib/motion/gaitMotion.js +7 -13
- package/lib/motion/gaitMotion.js.map +1 -1
- package/lib/motion/gestureMotion.js +2 -5
- package/lib/motion/gestureMotion.js.map +1 -1
- package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
- package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
- package/lib/motion/index.d.ts +40 -9
- package/lib/motion/index.js +40 -12
- package/lib/motion/index.js.map +1 -1
- package/lib/motion/inertializeOffset.d.ts +15 -2
- package/lib/motion/inertializeOffset.js +16 -3
- package/lib/motion/inertializeOffset.js.map +1 -1
- package/lib/motion/inertializePose.d.ts +36 -13
- package/lib/motion/inertializePose.js +122 -43
- package/lib/motion/inertializePose.js.map +1 -1
- package/lib/motion/integrateAirborneRotation.d.ts +151 -0
- package/lib/motion/integrateAirborneRotation.js +204 -0
- package/lib/motion/integrateAirborneRotation.js.map +1 -0
- package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
- package/lib/motion/integrateMotionTrajectory.js +156 -0
- package/lib/motion/integrateMotionTrajectory.js.map +1 -0
- package/lib/motion/orientChainEffector.d.ts +1 -1
- package/lib/motion/orientChainEffector.js +15 -7
- package/lib/motion/orientChainEffector.js.map +1 -1
- package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
- package/lib/motion/resolveHydrodynamicForce.js +100 -0
- package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
- package/lib/motion/sampleMotion.js +2 -5
- package/lib/motion/sampleMotion.js.map +1 -1
- package/lib/motion/samplePoseVelocity.d.ts +76 -13
- package/lib/motion/samplePoseVelocity.js +126 -38
- package/lib/motion/samplePoseVelocity.js.map +1 -1
- package/lib/motion/smoothMinimum.d.ts +29 -0
- package/lib/motion/smoothMinimum.js +40 -0
- package/lib/motion/smoothMinimum.js.map +1 -0
- package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
- package/lib/motion/solveAirborneTakeoff.js +324 -0
- package/lib/motion/solveAirborneTakeoff.js.map +1 -0
- package/lib/motion/solveDistalTwist.d.ts +62 -0
- package/lib/motion/solveDistalTwist.js +152 -0
- package/lib/motion/solveDistalTwist.js.map +1 -0
- package/lib/motion/speedProfile.d.ts +175 -0
- package/lib/motion/speedProfile.js +261 -0
- package/lib/motion/speedProfile.js.map +1 -0
- package/lib/motion/splitDistalTwist.d.ts +12 -17
- package/lib/motion/splitDistalTwist.js +37 -40
- package/lib/motion/splitDistalTwist.js.map +1 -1
- package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
- package/lib/motion/steerAutoMovieCrowd.js +249 -0
- package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
- package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
- package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
- package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
- package/lib/perform/index.d.ts +10 -0
- package/lib/perform/index.js +10 -0
- package/lib/perform/index.js.map +1 -1
- package/lib/physics/AutoMovieAir.d.ts +21 -0
- package/lib/physics/AutoMovieAir.js +26 -0
- package/lib/physics/AutoMovieAir.js.map +1 -0
- package/lib/physics/AutoMovieGravity.d.ts +22 -0
- package/lib/physics/AutoMovieGravity.js +30 -0
- package/lib/physics/AutoMovieGravity.js.map +1 -0
- package/lib/physics/IAutoMovieHit.d.ts +11 -7
- package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
- package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
- package/lib/physics/admitMotionGeometry.js +12 -0
- package/lib/physics/admitMotionGeometry.js.map +1 -1
- package/lib/physics/bindPhysicalWorld.js +16 -4
- package/lib/physics/bindPhysicalWorld.js.map +1 -1
- package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
- package/lib/physics/combinePhysicalMassProperties.js +8 -90
- package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
- package/lib/physics/deriveCenterOfMass.js +2 -5
- package/lib/physics/deriveCenterOfMass.js.map +1 -1
- package/lib/physics/derivePhysicalProfile.js +7 -5
- package/lib/physics/derivePhysicalProfile.js.map +1 -1
- package/lib/physics/index.d.ts +155 -2
- package/lib/physics/index.js +155 -2
- package/lib/physics/index.js.map +1 -1
- package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
- package/lib/physics/markAutoMovieSkeleton.js +62 -0
- package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
- package/lib/physics/physicalHullErode.d.ts +25 -0
- package/lib/physics/physicalHullErode.js +54 -0
- package/lib/physics/physicalHullErode.js.map +1 -0
- package/lib/physics/physicalHullFaces.d.ts +56 -0
- package/lib/physics/physicalHullFaces.js +151 -0
- package/lib/physics/physicalHullFaces.js.map +1 -0
- package/lib/physics/physicalHullMass.d.ts +32 -0
- package/lib/physics/physicalHullMass.js +80 -0
- package/lib/physics/physicalHullMass.js.map +1 -0
- package/lib/physics/physicalHullNearest.d.ts +37 -0
- package/lib/physics/physicalHullNearest.js +178 -0
- package/lib/physics/physicalHullNearest.js.map +1 -0
- package/lib/physics/physicalHullSegment.d.ts +34 -0
- package/lib/physics/physicalHullSegment.js +276 -0
- package/lib/physics/physicalHullSegment.js.map +1 -0
- package/lib/physics/physicalInertiaTensor.d.ts +28 -0
- package/lib/physics/physicalInertiaTensor.js +58 -0
- package/lib/physics/physicalInertiaTensor.js.map +1 -0
- package/lib/physics/physicalNativeShape.d.ts +1 -1
- package/lib/physics/physicalNativeShape.js +15 -4
- package/lib/physics/physicalNativeShape.js.map +1 -1
- package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
- package/lib/physics/physicalPrincipalAxes.js +96 -0
- package/lib/physics/physicalPrincipalAxes.js.map +1 -0
- package/lib/physics/physicalShapeBounds.d.ts +2 -1
- package/lib/physics/physicalShapeBounds.js +26 -2
- package/lib/physics/physicalShapeBounds.js.map +1 -1
- package/lib/physics/physicalShapeNearest.d.ts +70 -0
- package/lib/physics/physicalShapeNearest.js +201 -0
- package/lib/physics/physicalShapeNearest.js.map +1 -0
- package/lib/physics/physicalShapeNormal.d.ts +26 -0
- package/lib/physics/physicalShapeNormal.js +70 -0
- package/lib/physics/physicalShapeNormal.js.map +1 -0
- package/lib/physics/physicalShapePairDistance.d.ts +32 -0
- package/lib/physics/physicalShapePairDistance.js +124 -0
- package/lib/physics/physicalShapePairDistance.js.map +1 -0
- package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
- package/lib/physics/physicalShapeSegmentDistance.js +18 -70
- package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
- package/lib/physics/physicalShapeSpan.d.ts +21 -0
- package/lib/physics/physicalShapeSpan.js +55 -0
- package/lib/physics/physicalShapeSpan.js.map +1 -0
- package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
- package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
- package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
- package/lib/physics/projectileAt.d.ts +14 -12
- package/lib/physics/projectileAt.js +46 -16
- package/lib/physics/projectileAt.js.map +1 -1
- package/lib/physics/projectileContinue.d.ts +114 -0
- package/lib/physics/projectileContinue.js +189 -0
- package/lib/physics/projectileContinue.js.map +1 -0
- package/lib/physics/projectileDragFlight.d.ts +72 -0
- package/lib/physics/projectileDragFlight.js +166 -0
- package/lib/physics/projectileDragFlight.js.map +1 -0
- package/lib/physics/projectileFirstContact.d.ts +105 -0
- package/lib/physics/projectileFirstContact.js +174 -0
- package/lib/physics/projectileFirstContact.js.map +1 -0
- package/lib/physics/projectileTrajectory.js +3 -2
- package/lib/physics/projectileTrajectory.js.map +1 -1
- package/lib/physics/solveBallisticLaunch.js +2 -1
- package/lib/physics/solveBallisticLaunch.js.map +1 -1
- package/lib/physics/solveMovingLaunch.js +2 -1
- package/lib/physics/solveMovingLaunch.js.map +1 -1
- package/lib/physics/validatePhysicalProfile.js +18 -1
- package/lib/physics/validatePhysicalProfile.js.map +1 -1
- package/lib/populationRuntime/index.d.ts +6 -0
- package/lib/populationRuntime/index.js +6 -0
- package/lib/populationRuntime/index.js.map +1 -1
- package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
- package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
- package/lib/random/index.d.ts +1 -1
- package/lib/random/index.js +1 -0
- package/lib/random/index.js.map +1 -1
- package/lib/render/index.d.ts +20 -11
- package/lib/render/index.js +20 -11
- package/lib/render/index.js.map +1 -1
- package/lib/resolve/index.d.ts +7 -2
- package/lib/resolve/index.js +7 -5
- package/lib/resolve/index.js.map +1 -1
- package/lib/resolve/lowerSkeletonNodes.js +3 -10
- package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
- package/lib/rom/clampJointRom.d.ts +11 -3
- package/lib/rom/clampJointRom.js +43 -3
- package/lib/rom/clampJointRom.js.map +1 -1
- package/lib/rom/clampJointToSkeleton.d.ts +25 -2
- package/lib/rom/clampJointToSkeleton.js +39 -8
- package/lib/rom/clampJointToSkeleton.js.map +1 -1
- package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
- package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
- package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
- package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
- package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
- package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
- package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
- package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
- package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
- package/lib/rom/constants/index.d.ts +2 -0
- package/lib/rom/constants/index.js +2 -0
- package/lib/rom/constants/index.js.map +1 -1
- package/lib/rom/index.d.ts +1 -0
- package/lib/rom/index.js +1 -0
- package/lib/rom/index.js.map +1 -1
- package/lib/rom/scanJointRom.d.ts +62 -0
- package/lib/rom/scanJointRom.js +117 -0
- package/lib/rom/scanJointRom.js.map +1 -0
- package/lib/rom/validateJointRom.d.ts +4 -2
- package/lib/rom/validateJointRom.js +23 -45
- package/lib/rom/validateJointRom.js.map +1 -1
- package/lib/service/index.d.ts +9 -0
- package/lib/service/index.js +9 -0
- package/lib/service/index.js.map +1 -1
- package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
- package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
- package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
- package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
- package/lib/soft/applySoftBodyFriction.d.ts +34 -0
- package/lib/soft/applySoftBodyFriction.js +52 -0
- package/lib/soft/applySoftBodyFriction.js.map +1 -0
- package/lib/soft/index.d.ts +22 -0
- package/lib/soft/index.js +22 -0
- package/lib/soft/index.js.map +1 -1
- package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
- package/lib/soft/projectSoftCordSelfContact.js +172 -0
- package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
- package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
- package/lib/soft/simulateSoftBodyCore.js +108 -16
- package/lib/soft/simulateSoftBodyCore.js.map +1 -1
- package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
- package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
- package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
- package/lib/soft/softBodyBudget.js +7 -0
- package/lib/soft/softBodyBudget.js.map +1 -1
- package/lib/soft/softBodyHeldLoads.d.ts +34 -0
- package/lib/soft/softBodyHeldLoads.js +69 -0
- package/lib/soft/softBodyHeldLoads.js.map +1 -0
- package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
- package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
- package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
- package/lib/soft/validateSoftAnchors.d.ts +24 -0
- package/lib/soft/validateSoftAnchors.js +74 -0
- package/lib/soft/validateSoftAnchors.js.map +1 -0
- package/lib/soft/validateSoftBodyDomain.js +6 -48
- package/lib/soft/validateSoftBodyDomain.js.map +1 -1
- package/lib/soft/validateSoftBounded.d.ts +20 -0
- package/lib/soft/validateSoftBounded.js +27 -0
- package/lib/soft/validateSoftBounded.js.map +1 -0
- package/lib/soft/validateSoftCompliance.d.ts +30 -0
- package/lib/soft/validateSoftCompliance.js +54 -0
- package/lib/soft/validateSoftCompliance.js.map +1 -0
- package/lib/sound/index.d.ts +2 -0
- package/lib/sound/index.js +2 -0
- package/lib/sound/index.js.map +1 -1
- package/lib/text/index.d.ts +1 -0
- package/lib/text/index.js +1 -0
- package/lib/text/index.js.map +1 -1
- package/lib/validation/AffordanceArticulation.d.ts +69 -0
- package/lib/validation/AffordanceArticulation.js +142 -0
- package/lib/validation/AffordanceArticulation.js.map +1 -0
- package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
- package/lib/validation/affordanceFollowedTravel.js +43 -0
- package/lib/validation/affordanceFollowedTravel.js.map +1 -0
- package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
- package/lib/validation/affordanceLeadingTravel.js +99 -0
- package/lib/validation/affordanceLeadingTravel.js.map +1 -0
- package/lib/validation/affordanceTravelRange.d.ts +21 -0
- package/lib/validation/affordanceTravelRange.js +39 -0
- package/lib/validation/affordanceTravelRange.js.map +1 -0
- package/lib/validation/appendShotEventsArtifact.js +12 -0
- package/lib/validation/appendShotEventsArtifact.js.map +1 -1
- package/lib/validation/constants/index.d.ts +3 -3
- package/lib/validation/constants/index.js +3 -3
- package/lib/validation/constants/index.js.map +1 -1
- package/lib/validation/detectFreeFall.js +2 -1
- package/lib/validation/detectFreeFall.js.map +1 -1
- package/lib/validation/index.d.ts +52 -4
- package/lib/validation/index.js +52 -6
- package/lib/validation/index.js.map +1 -1
- package/lib/validation/markAutoMovieSlip.d.ts +26 -0
- package/lib/validation/markAutoMovieSlip.js +52 -0
- package/lib/validation/markAutoMovieSlip.js.map +1 -0
- package/lib/validation/validateAffordance.d.ts +3 -3
- package/lib/validation/validateAffordance.js +21 -3
- package/lib/validation/validateAffordance.js.map +1 -1
- package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
- package/lib/validation/validateAffordanceArticulation.js +183 -0
- package/lib/validation/validateAffordanceArticulation.js.map +1 -0
- package/lib/validation/validateBalanceSupport.d.ts +1 -2
- package/lib/validation/validateBalanceSupport.js.map +1 -1
- package/lib/validation/validateBody.d.ts +2 -2
- package/lib/validation/validateBody.js +27 -3
- package/lib/validation/validateBody.js.map +1 -1
- package/lib/validation/validateFootSkate.d.ts +1 -2
- package/lib/validation/validateFootSkate.js.map +1 -1
- package/lib/validation/validateGroundContact.d.ts +1 -2
- package/lib/validation/validateGroundContact.js.map +1 -1
- package/lib/validation/validateJointConstraint.d.ts +1 -1
- package/lib/validation/validateJointConstraint.js +9 -1
- package/lib/validation/validateJointConstraint.js.map +1 -1
- package/lib/validation/validateModel.js +2 -0
- package/lib/validation/validateModel.js.map +1 -1
- package/lib/validation/validateSelfIntersection.d.ts +1 -2
- package/lib/validation/validateSelfIntersection.js.map +1 -1
- package/lib/worldBlock.js +6 -9
- package/lib/worldBlock.js.map +1 -1
- package/package.json +6 -6
- package/src/IAutoMovieFormationPlacement.ts +4 -3
- package/src/analysis/index.ts +5 -0
- package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
- package/src/anthropometry/index.ts +1 -0
- package/src/architecture/appendBuiltRegionDefects.ts +3 -3
- package/src/architecture/builtOutlineIsClosed.ts +3 -3
- package/{lib/architecture/constants/PLANAR_EPSILON.d.ts → src/architecture/constants/BUILT_PLANAR_EPSILON.ts} +1 -1
- package/src/architecture/constants/index.ts +1 -1
- package/src/architecture/index.ts +157 -117
- package/src/cache/index.ts +9 -0
- package/src/composition/AutoMovieComposition.ts +34 -7
- package/src/composition/AutoMovieScheduleCut.ts +141 -0
- package/src/composition/AutoMovieScheduleError.ts +108 -0
- package/src/composition/AutoMovieSchedulePlace.ts +253 -0
- package/src/composition/AutoMovieScheduleWalk.ts +215 -0
- package/src/composition/IAutoMovieIntent.ts +9 -7
- package/src/composition/index.ts +12 -7
- package/src/composition/markAutoMovieContacts.ts +79 -0
- package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
- package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
- package/src/composition/resolveAutoMovieSchedule.ts +106 -145
- package/src/constants/index.ts +2 -0
- package/src/createAutoMovieGeometryActorReader.ts +2 -1
- package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
- package/src/drawing/index.ts +12 -0
- package/src/effectRuntime/index.ts +7 -0
- package/src/film/compileAttach.ts +2 -5
- package/src/film/compileLaunch.ts +5 -4
- package/src/film/constants/index.ts +3 -0
- package/src/film/index.ts +61 -6
- package/src/film/propAnchorFrame.ts +3 -6
- package/src/film/stageScene.ts +3 -10
- package/src/film/staging/index.ts +11 -0
- package/src/film/staging/lowerLightPlacement.ts +3 -7
- package/src/formationSlotPosition.ts +54 -7
- package/src/geometry/IAutoMovieMark.ts +115 -0
- package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
- package/src/geometry/constants/index.ts +2 -0
- package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
- package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
- package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
- package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
- package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
- package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
- package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
- package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
- package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
- package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
- package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
- package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
- package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
- package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
- package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
- package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
- package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
- package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
- package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
- package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
- package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
- package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
- package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
- package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
- package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
- package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
- package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
- package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
- package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
- package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
- package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
- package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
- package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
- package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
- package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
- package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
- package/src/geometry/construction/index.ts +82 -2
- package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
- package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
- package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
- package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
- package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
- package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
- package/src/geometry/curve/index.ts +48 -25
- package/src/geometry/extract/index.ts +0 -1
- package/src/geometry/index.ts +87 -53
- package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
- package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
- package/src/geometry/sweep/index.ts +54 -15
- package/src/index.ts +41 -450
- package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
- package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
- package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
- package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
- package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
- package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
- package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
- package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
- package/src/kinematics/alternateRigJointAngles.ts +41 -0
- package/src/kinematics/boxExcludedSwivels.ts +260 -0
- package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
- package/src/kinematics/curlChainUntilContact.ts +35 -8
- package/src/kinematics/decomposeJointRotation.ts +15 -178
- package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
- package/src/kinematics/fitDigitDescent.ts +253 -0
- package/src/kinematics/fitDigitToTarget.ts +425 -0
- package/src/kinematics/hingedArmArticulation.ts +402 -116
- package/src/kinematics/hingedArmSwivel.ts +295 -0
- package/src/kinematics/index.ts +30 -12
- package/src/kinematics/jointRomOvershoot.ts +30 -19
- package/src/kinematics/jointToQuaternion.ts +8 -43
- package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
- package/src/kinematics/markAutoMovieBalance.ts +75 -0
- package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
- package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
- package/src/kinematics/normalizeJointAxes.ts +66 -12
- package/src/kinematics/poseJointCodec.ts +148 -0
- package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
- package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
- package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
- package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
- package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
- package/src/kinematics/swingTwistBasis.ts +162 -0
- package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
- package/src/kinematics/swingTwistRange.ts +460 -0
- package/src/kinematics/swingTwistRegion.ts +298 -0
- package/src/kinematics/swivelArcs.ts +245 -0
- package/src/math/Quaternion.ts +42 -2
- package/src/math/Transform.ts +65 -0
- package/src/math/assignAutoMovieMinimumCost.ts +86 -0
- package/src/math/bracketedBisection.ts +51 -0
- package/src/math/bracketedRoot.ts +72 -0
- package/src/math/constants/index.ts +1 -0
- package/src/math/index.ts +64 -5
- package/src/math/nearestAngleAlias.ts +43 -0
- package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
- package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
- package/src/measureAutoMovieGeometryReach.ts +2 -4
- package/src/motion/AirborneTakeoffLinear.ts +70 -0
- package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
- package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
- package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
- package/src/motion/IFitChainToTargetProps.ts +67 -0
- package/src/motion/MotionTrajectoryStepper.ts +478 -0
- package/src/motion/basisOf.ts +29 -0
- package/src/motion/carriedAcceleration.ts +56 -0
- package/src/motion/carriedRate.ts +61 -0
- package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
- package/src/motion/constants/index.ts +1 -0
- package/src/motion/fitChainBend.ts +491 -0
- package/src/motion/fitChainToTarget.ts +13 -485
- package/src/motion/fitHingedChainCandidate.ts +281 -148
- package/src/motion/fitHingedRotationError.ts +164 -0
- package/src/motion/fitSeededChainToTarget.ts +34 -0
- package/src/motion/gaitMotion.ts +6 -10
- package/src/motion/gestureMotion.ts +2 -5
- package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
- package/src/motion/index.ts +40 -9
- package/src/motion/inertializeOffset.ts +16 -2
- package/src/motion/inertializePose.ts +158 -53
- package/src/motion/integrateAirborneRotation.ts +334 -0
- package/src/motion/integrateMotionTrajectory.ts +309 -0
- package/src/motion/orientChainEffector.ts +19 -13
- package/src/motion/resolveHydrodynamicForce.ts +143 -0
- package/src/motion/sampleMotion.ts +2 -5
- package/src/motion/samplePoseVelocity.ts +168 -41
- package/src/motion/smoothMinimum.ts +36 -0
- package/src/motion/solveAirborneTakeoff.ts +471 -0
- package/src/motion/solveDistalTwist.ts +256 -0
- package/src/motion/speedProfile.ts +470 -0
- package/src/motion/splitDistalTwist.ts +55 -64
- package/src/motion/steerAutoMovieCrowd.ts +381 -0
- package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
- package/src/perform/index.ts +10 -0
- package/src/physics/AutoMovieAir.ts +22 -0
- package/src/physics/AutoMovieGravity.ts +28 -0
- package/src/physics/IAutoMovieHit.ts +13 -7
- package/src/physics/IAutoMovieProjectile.ts +82 -6
- package/src/physics/IAutoMovieProjectileState.ts +10 -4
- package/src/physics/admitMotionGeometry.ts +16 -0
- package/src/physics/bindPhysicalWorld.ts +22 -11
- package/src/physics/combinePhysicalMassProperties.ts +9 -117
- package/src/physics/deriveCenterOfMass.ts +2 -5
- package/src/physics/derivePhysicalProfile.ts +3 -1
- package/src/physics/index.ts +155 -2
- package/src/physics/markAutoMovieSkeleton.ts +69 -0
- package/src/physics/physicalHullErode.ts +72 -0
- package/src/physics/physicalHullFaces.ts +215 -0
- package/src/physics/physicalHullMass.ts +99 -0
- package/src/physics/physicalHullNearest.ts +210 -0
- package/src/physics/physicalHullSegment.ts +338 -0
- package/src/physics/physicalInertiaTensor.ts +75 -0
- package/src/physics/physicalNativeShape.ts +31 -9
- package/src/physics/physicalPrincipalAxes.ts +114 -0
- package/src/physics/physicalShapeBounds.ts +24 -2
- package/src/physics/physicalShapeNearest.ts +287 -0
- package/src/physics/physicalShapeNormal.ts +105 -0
- package/src/physics/physicalShapePairDistance.ts +153 -0
- package/src/physics/physicalShapeSegmentDistance.ts +18 -92
- package/src/physics/physicalShapeSpan.ts +75 -0
- package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
- package/src/physics/projectileAt.ts +61 -20
- package/src/physics/projectileContinue.ts +287 -0
- package/src/physics/projectileDragFlight.ts +208 -0
- package/src/physics/projectileFirstContact.ts +286 -0
- package/src/physics/projectileTrajectory.ts +6 -5
- package/src/physics/solveBallisticLaunch.ts +2 -1
- package/src/physics/solveMovingLaunch.ts +2 -1
- package/src/physics/validatePhysicalProfile.ts +20 -1
- package/src/populationRuntime/index.ts +6 -0
- package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
- package/src/random/index.ts +1 -1
- package/src/render/index.ts +20 -11
- package/src/resolve/index.ts +7 -2
- package/src/resolve/lowerSkeletonNodes.ts +3 -10
- package/src/rom/clampJointRom.ts +59 -2
- package/src/rom/clampJointToSkeleton.ts +52 -15
- package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
- package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
- package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
- package/src/rom/constants/index.ts +2 -0
- package/src/rom/index.ts +1 -0
- package/src/rom/scanJointRom.ts +169 -0
- package/src/rom/validateJointRom.ts +69 -74
- package/src/service/index.ts +9 -0
- package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
- package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
- package/src/soft/applySoftBodyFriction.ts +65 -0
- package/src/soft/index.ts +22 -0
- package/src/soft/projectSoftCordSelfContact.ts +239 -0
- package/src/soft/simulateSoftBodyCore.ts +127 -15
- package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
- package/src/soft/softBodyBudget.ts +11 -0
- package/src/soft/softBodyHeldLoads.ts +85 -0
- package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
- package/src/soft/validateSoftAnchors.ts +143 -0
- package/src/soft/validateSoftBodyDomain.ts +5 -124
- package/src/soft/validateSoftBounded.ts +42 -0
- package/src/soft/validateSoftCompliance.ts +102 -0
- package/src/sound/index.ts +2 -0
- package/src/text/index.ts +1 -0
- package/src/validation/AffordanceArticulation.ts +173 -0
- package/src/validation/affordanceFollowedTravel.ts +40 -0
- package/src/validation/affordanceLeadingTravel.ts +108 -0
- package/src/validation/affordanceTravelRange.ts +42 -0
- package/src/validation/appendShotEventsArtifact.ts +26 -0
- package/src/validation/constants/index.ts +3 -3
- package/src/validation/detectFreeFall.ts +3 -2
- package/src/validation/index.ts +52 -4
- package/src/validation/markAutoMovieSlip.ts +65 -0
- package/src/validation/validateAffordance.ts +38 -3
- package/src/validation/validateAffordanceArticulation.ts +311 -0
- package/src/validation/validateBalanceSupport.ts +2 -5
- package/src/validation/validateBody.ts +80 -3
- package/src/validation/validateFootSkate.ts +1 -1
- package/src/validation/validateGroundContact.ts +2 -5
- package/src/validation/validateJointConstraint.ts +19 -1
- package/src/validation/validateModel.ts +7 -0
- package/src/validation/validateSelfIntersection.ts +2 -5
- package/src/worldBlock.ts +3 -6
- package/lib/architecture/constants/PLANAR_EPSILON.js.map +0 -1
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import type { IAutoMovieContactReceipt } from "@automovie/interface";
|
|
2
|
+
|
|
3
|
+
import type { IAutoMovieMark } from "../geometry/IAutoMovieMark";
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Turn the solved contacts acting at one second into inspection marks: one arrow per contact, at the contact point along its normal, as long as the mean force times a stated scale.
|
|
7
|
+
*
|
|
8
|
+
* A receipt acts at `seconds` when the solver measured it: its latest completed step at or before `seconds`, within that step's duration, has a positive finite impulse and no positive separation. The arrow starts at that step's point and runs along its normal, from the first collider toward the second, for `metresPerNewton` times the step's mean force, its impulse over its duration. Geometric receipts, which assert no impulse, draw nothing.
|
|
9
|
+
*
|
|
10
|
+
* The mark has kind `contact`, label `contact force`, colour teal `00c2a8` and path `<body>/<bone>/contact/<receipt id>` of the first collider, in world metres and unanchored.
|
|
11
|
+
*
|
|
12
|
+
* It throws for a scale that is not positive and finite and for an acting step without a positive duration.
|
|
13
|
+
*
|
|
14
|
+
* @param props.receipts Contact episodes, as the composition's contact measurement and the solver record them.
|
|
15
|
+
* @param props.seconds The drawn film second.
|
|
16
|
+
* @param props.metresPerNewton Arrow length per newton of mean force.
|
|
17
|
+
* @returns One mark per acting contact, in the receipts' order.
|
|
18
|
+
*
|
|
19
|
+
* @evidence contracts/development/common.md#meaningful-documentation States when a contact acts, how the arrow's place, direction and length follow from the step, what geometric receipts draw, the kind, label, colour, path and frame, and both refusals.
|
|
20
|
+
* @evidence contracts/development/implementation.md#principled-implementation A step's mean force is its normal impulse over its duration, so the arrow's length is a force on a stated scale; a step is read only once completed at or before the drawn second, so a still never shows a later impulse.
|
|
21
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure One pass over the receipts, each scanned from its last step back to the drawn second.
|
|
22
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The scale is the caller's stated parameter, and a step without a duration is refused instead of given an arbitrary length.
|
|
23
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Linear in the receipts' steps in the worst case; each receipt stops at its latest step at or before the second.
|
|
24
|
+
* @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure conversion of one second.
|
|
25
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Returns fresh marks and keeps nothing.
|
|
26
|
+
*/
|
|
27
|
+
export function markAutoMovieContacts(props: {
|
|
28
|
+
receipts: readonly IAutoMovieContactReceipt[];
|
|
29
|
+
seconds: number;
|
|
30
|
+
metresPerNewton: number;
|
|
31
|
+
}): IAutoMovieMark[] {
|
|
32
|
+
if (!(Number.isFinite(props.metresPerNewton) && props.metresPerNewton > 0))
|
|
33
|
+
throw new Error(
|
|
34
|
+
`markAutoMovieContacts: metres per newton ${props.metresPerNewton} is not positive and finite`,
|
|
35
|
+
);
|
|
36
|
+
const marks: IAutoMovieMark[] = [];
|
|
37
|
+
for (const receipt of props.receipts) {
|
|
38
|
+
if (receipt.source !== "solver") continue;
|
|
39
|
+
const steps: NonNullable<IAutoMovieContactReceipt["samples"]> =
|
|
40
|
+
receipt.samples ?? [];
|
|
41
|
+
let step: (typeof steps)[number] | undefined;
|
|
42
|
+
for (let i: number = steps.length - 1; i >= 0; i--)
|
|
43
|
+
if (steps[i]!.seconds <= props.seconds + 1e-9) {
|
|
44
|
+
step = steps[i];
|
|
45
|
+
break;
|
|
46
|
+
}
|
|
47
|
+
if (
|
|
48
|
+
step === undefined ||
|
|
49
|
+
!(step.impulse > 0 && Number.isFinite(step.impulse)) ||
|
|
50
|
+
step.separation > 0
|
|
51
|
+
)
|
|
52
|
+
continue;
|
|
53
|
+
if (!(step.duration > 0))
|
|
54
|
+
throw new Error(
|
|
55
|
+
`markAutoMovieContacts: contact ${receipt.id} has a step without a positive duration`,
|
|
56
|
+
);
|
|
57
|
+
if (props.seconds - step.seconds >= step.duration) continue;
|
|
58
|
+
const length: number =
|
|
59
|
+
(step.impulse / step.duration) * props.metresPerNewton;
|
|
60
|
+
marks.push({
|
|
61
|
+
path: `${receipt.a.body}/${receipt.a.bone}/contact/${receipt.id}`,
|
|
62
|
+
kind: "contact",
|
|
63
|
+
label: "contact force",
|
|
64
|
+
color: 0x00c2a8,
|
|
65
|
+
shape: {
|
|
66
|
+
type: "arrows",
|
|
67
|
+
origins: [step.point.x, step.point.y, step.point.z],
|
|
68
|
+
vectors: [
|
|
69
|
+
step.normal.x * length,
|
|
70
|
+
step.normal.y * length,
|
|
71
|
+
step.normal.z * length,
|
|
72
|
+
],
|
|
73
|
+
},
|
|
74
|
+
flagged: false,
|
|
75
|
+
anchor: null,
|
|
76
|
+
});
|
|
77
|
+
}
|
|
78
|
+
return marks;
|
|
79
|
+
}
|
|
@@ -9,7 +9,9 @@ import type { IAutoMovieVector3 } from "@automovie/interface";
|
|
|
9
9
|
* takes until it meets something), or a capsule, a segment swept by that
|
|
10
10
|
* radius, when it also gives the axis's other end: a shin, a forearm, any
|
|
11
11
|
* limb segment that strikes along its length, so another body crossing the
|
|
12
|
-
* segment between its ends is met, not passed between sparse points
|
|
12
|
+
* segment between its ends is met, not passed between sparse points; a
|
|
13
|
+
* tapered capsule's radius runs linearly from one end to the other, as a
|
|
14
|
+
* limb narrows from one joint to the next. Every
|
|
13
15
|
* body is a signed distance at a second, from a point and, for capsule
|
|
14
16
|
* weapons, from a segment (the least signed distance over the segment's
|
|
15
17
|
* points). Both may depend on which weapons have already stopped, because a
|
|
@@ -24,24 +26,41 @@ import type { IAutoMovieVector3 } from "@automovie/interface";
|
|
|
24
26
|
* bisections of the first crossing, so the result is deterministic; a
|
|
25
27
|
* contact shorter than one step (a weapon and a body passing through each
|
|
26
28
|
* other within it) is the scan's stated blind spot, so the step must stay
|
|
27
|
-
* below the time either needs to cross the other's thickness.
|
|
29
|
+
* below the time either needs to cross the other's thickness. A weapon
|
|
30
|
+
* that states the span it is live in (`from`, `to`) is scanned only on the
|
|
31
|
+
* scan's own steps that reach into that span, since outside it the weapon
|
|
32
|
+
* meets nothing; the steps are the same as a scan of the whole span, so the
|
|
33
|
+
* result is too, and a performance of many strikes scans each strike over
|
|
34
|
+
* its own window instead of over the whole performance. Since only the
|
|
35
|
+
* earliest impact is stopped, each round scans the weapons in the order
|
|
36
|
+
* they become live and no weapon past the earliest impact found so far: one
|
|
37
|
+
* that becomes live after it cannot be earlier. Ties in
|
|
28
38
|
* time are broken by the weapons' ids, and a weapon that touches the moment
|
|
29
39
|
* another stops is stopped at that same second, so the result does not
|
|
30
40
|
* depend on the order the weapons are listed in.
|
|
31
41
|
*
|
|
42
|
+
* A contact is mutual. A weapon and the body that carries it are two
|
|
43
|
+
* measures of one limb (a capsule and that body's signed distance), and they
|
|
44
|
+
* need not agree to the millimetre, so of two limbs swung into each other
|
|
45
|
+
* one weapon touches the other body before the other weapon touches back.
|
|
46
|
+
* When the part a weapon meets carries a weapon of its own that is still
|
|
47
|
+
* moving (the body says so through `carried`), that weapon stops at the same
|
|
48
|
+
* second against the striker's body: neither limb is driven on into the one
|
|
49
|
+
* that has already stopped on it.
|
|
50
|
+
*
|
|
32
51
|
* This resolves simultaneous strikes consistently: two fists crossing each
|
|
33
52
|
* other's arms, two shins meeting, a block that arrives first. It is a
|
|
34
53
|
* kinematic resolution of contact times, not a force simulation.
|
|
35
54
|
*
|
|
36
55
|
* @param input The weapons, the bodies and the span.
|
|
37
56
|
* @returns The stops, in time order.
|
|
38
|
-
* @throws {Error} When the span or the step is not positive, a weapon id repeats, or a capsule weapon meets a body that measures no segment.
|
|
57
|
+
* @throws {Error} When the span or the step is not positive, a weapon id repeats, a weapon's live span is not finite or ends before it begins, a tail radius is given without a tail or is not a finite non-negative length, a capsule weapon meets a body that measures no segment, or a body names a carried weapon that is not its own.
|
|
39
58
|
*
|
|
40
59
|
* @evidence contracts/development/common.md#meaningful-documentation States the method, its determinism, its tie rule and what it does not model.
|
|
41
60
|
* @evidence contracts/development/implementation.md#principled-implementation The time-ordered event loop of impulse-based simulation over continuous first-impact times.
|
|
42
61
|
* @evidence contracts/development/implementation.md#clear-and-simple-structure One loop over events and one first-impact search.
|
|
43
62
|
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Invalid spans, steps and repeated ids throw, and a capsule weapon is never reduced to its end points when a body cannot measure a segment: that throws.
|
|
44
|
-
* @evidence contracts/development/implementation.md#efficient-algorithms Each event re-scans the remaining weapons
|
|
63
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Each event re-scans the remaining weapons, each over the scan's samples inside its own live span and no later than the earliest impact found in that round: a performance of many strikes in sequence costs in proportion to its strikes, where scanning every weapon over the whole span after every event cost the square of them.
|
|
45
64
|
* @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its input; callers memoise.
|
|
46
65
|
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
|
|
47
66
|
*/
|
|
@@ -55,32 +74,95 @@ export function resolveAutoMovieContactEvents(
|
|
|
55
74
|
for (const w of input.weapons) {
|
|
56
75
|
if (ids.has(w.id)) throw new Error(`Repeated contact weapon ${w.id}`);
|
|
57
76
|
ids.add(w.id);
|
|
77
|
+
if (
|
|
78
|
+
(w.from !== undefined && !Number.isFinite(w.from)) ||
|
|
79
|
+
(w.to !== undefined && !Number.isFinite(w.to)) ||
|
|
80
|
+
(w.from !== undefined && w.to !== undefined && w.to < w.from)
|
|
81
|
+
)
|
|
82
|
+
throw new Error(
|
|
83
|
+
`Contact weapon ${w.id} has a live span that is not finite or ends before it begins`,
|
|
84
|
+
);
|
|
85
|
+
if (
|
|
86
|
+
w.tailRadius !== undefined &&
|
|
87
|
+
(w.tail === undefined ||
|
|
88
|
+
!Number.isFinite(w.tailRadius) ||
|
|
89
|
+
w.tailRadius < 0)
|
|
90
|
+
)
|
|
91
|
+
throw new Error(
|
|
92
|
+
`Contact weapon ${w.id} has a tail radius without a tail, or one that is not a finite non-negative length`,
|
|
93
|
+
);
|
|
58
94
|
}
|
|
59
95
|
const stopped: Map<string, number> = new Map();
|
|
60
96
|
const events: resolveAutoMovieContactEvents.IEvent[] = [];
|
|
61
|
-
|
|
62
|
-
|
|
97
|
+
// In the order the weapons become live, so the earliest impact is found
|
|
98
|
+
// early and bounds the scans after it; ties in time go to the lesser id.
|
|
99
|
+
const weapons: resolveAutoMovieContactEvents.IWeapon[] = [
|
|
100
|
+
...input.weapons,
|
|
101
|
+
].sort(
|
|
102
|
+
(
|
|
103
|
+
a: resolveAutoMovieContactEvents.IWeapon,
|
|
104
|
+
b: resolveAutoMovieContactEvents.IWeapon,
|
|
105
|
+
): number =>
|
|
106
|
+
(a.from ?? -Infinity) - (b.from ?? -Infinity) ||
|
|
107
|
+
(a.id < b.id ? -1 : a.id > b.id ? 1 : 0),
|
|
63
108
|
);
|
|
64
109
|
for (;;) {
|
|
65
110
|
let best: resolveAutoMovieContactEvents.IEvent | undefined;
|
|
66
111
|
const after: number = events.at(-1)?.seconds ?? input.from;
|
|
67
112
|
for (const weapon of weapons) {
|
|
68
113
|
if (stopped.has(weapon.id)) continue;
|
|
69
|
-
|
|
114
|
+
if (best !== undefined && (weapon.from ?? -Infinity) > best.seconds)
|
|
115
|
+
break;
|
|
116
|
+
const hit: { against: string; seconds: number } | undefined = firstImpact(
|
|
70
117
|
weapon,
|
|
71
118
|
input,
|
|
72
119
|
stopped,
|
|
73
120
|
Math.max(input.from, after),
|
|
121
|
+
best?.seconds ?? Infinity,
|
|
74
122
|
);
|
|
75
123
|
if (
|
|
76
124
|
hit !== undefined &&
|
|
77
|
-
(best === undefined ||
|
|
125
|
+
(best === undefined ||
|
|
126
|
+
hit.seconds < best.seconds ||
|
|
127
|
+
(hit.seconds === best.seconds && weapon.id < best.weapon))
|
|
78
128
|
)
|
|
79
129
|
best = { weapon: weapon.id, ...hit };
|
|
80
130
|
}
|
|
81
131
|
if (best === undefined) return events;
|
|
132
|
+
|
|
133
|
+
// The contact is mutual: when the part met carries a weapon of its own
|
|
134
|
+
// that is still moving, that weapon has met the striker in the same
|
|
135
|
+
// touch and stops at the same second.
|
|
136
|
+
const striker: resolveAutoMovieContactEvents.IWeapon = weapons.find(
|
|
137
|
+
(w: resolveAutoMovieContactEvents.IWeapon): boolean =>
|
|
138
|
+
w.id === best!.weapon,
|
|
139
|
+
)!;
|
|
140
|
+
const p: IAutoMovieVector3 = striker.position(best.seconds, stopped);
|
|
141
|
+
const own: string | undefined = input.bodies
|
|
142
|
+
.find(
|
|
143
|
+
(b: resolveAutoMovieContactEvents.IBody): boolean =>
|
|
144
|
+
b.id === best!.against,
|
|
145
|
+
)
|
|
146
|
+
?.carried?.(
|
|
147
|
+
p,
|
|
148
|
+
striker.tail?.(best.seconds, stopped) ?? p,
|
|
149
|
+
best.seconds,
|
|
150
|
+
stopped,
|
|
151
|
+
striker.owner,
|
|
152
|
+
);
|
|
82
153
|
stopped.set(best.weapon, best.seconds);
|
|
83
154
|
events.push(best);
|
|
155
|
+
if (own === undefined) continue;
|
|
156
|
+
if (
|
|
157
|
+
!weapons.some(
|
|
158
|
+
(w: resolveAutoMovieContactEvents.IWeapon): boolean =>
|
|
159
|
+
w.id === own && w.owner === best!.against,
|
|
160
|
+
)
|
|
161
|
+
)
|
|
162
|
+
throw new Error(`Body ${best.against} carries no contact weapon ${own}`);
|
|
163
|
+
if (stopped.has(own)) continue;
|
|
164
|
+
stopped.set(own, best.seconds);
|
|
165
|
+
events.push({ weapon: own, against: striker.owner, seconds: best.seconds });
|
|
84
166
|
}
|
|
85
167
|
}
|
|
86
168
|
|
|
@@ -88,7 +170,7 @@ export function resolveAutoMovieContactEvents(
|
|
|
88
170
|
* Companion types of {@link resolveAutoMovieContactEvents}.
|
|
89
171
|
*
|
|
90
172
|
* @evidence contracts/development/common.md#meaningful-documentation Documents each member's frame and unit.
|
|
91
|
-
* @evidence contracts/development/design.md#principled-representation Weapons are moving spheres or capsules (an optional axis end), bodies signed distances from a point and optionally from a segment, both functions of seconds and of the stops so far.
|
|
173
|
+
* @evidence contracts/development/design.md#principled-representation Weapons are moving spheres or capsules (an optional axis end, and an optional radius there for a tapered one), bodies signed distances from a point and optionally from a segment, both functions of seconds and of the stops so far.
|
|
92
174
|
* @evidence contracts/development/design.md#minimal-and-owned-surface What callers provide and read.
|
|
93
175
|
* @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses the interface vector.
|
|
94
176
|
*/
|
|
@@ -104,9 +186,23 @@ export namespace resolveAutoMovieContactEvents {
|
|
|
104
186
|
/** The body carrying it, whose own distance it ignores. */
|
|
105
187
|
owner: string;
|
|
106
188
|
|
|
107
|
-
/** The sphere's radius, metres
|
|
189
|
+
/** The sphere's radius, metres; a capsule's radius at `position`. */
|
|
108
190
|
radius: number;
|
|
109
191
|
|
|
192
|
+
/**
|
|
193
|
+
* A tapered capsule's radius at `tail`, metres: the capsule then narrows
|
|
194
|
+
* (or widens) linearly from `radius` at `position` to this, the round
|
|
195
|
+
* cone of a limb whose girth changes from one joint to the next. Absent
|
|
196
|
+
* for a sphere and for a capsule of one radius.
|
|
197
|
+
*/
|
|
198
|
+
tailRadius?: number;
|
|
199
|
+
|
|
200
|
+
/** When the weapon starts to be live, seconds, finite; it meets nothing before, whatever its path says. The span's start when absent. */
|
|
201
|
+
from?: number;
|
|
202
|
+
|
|
203
|
+
/** When it stops being live, seconds, finite and not before `from`; it meets nothing after, whatever its path says. The span's end when absent. */
|
|
204
|
+
to?: number;
|
|
205
|
+
|
|
110
206
|
/**
|
|
111
207
|
* The sphere's centre on its free path at a second, world metres.
|
|
112
208
|
*
|
|
@@ -148,11 +244,16 @@ export namespace resolveAutoMovieContactEvents {
|
|
|
148
244
|
* The signed distance from a segment to the body's surface at a second,
|
|
149
245
|
* metres: the least signed distance over the segment's points, positive
|
|
150
246
|
* when the whole segment is outside. Required to meet capsule weapons.
|
|
247
|
+
* Given a taper, the segment is widened by a radius running linearly
|
|
248
|
+
* from its first end's to its other end's, and the distance is that
|
|
249
|
+
* tapered capsule's: the least over its points of the distance less the
|
|
250
|
+
* radius there.
|
|
151
251
|
*
|
|
152
252
|
* @param a The segment's first end, world metres.
|
|
153
253
|
* @param b Its other end, world metres.
|
|
154
254
|
* @param seconds Seconds.
|
|
155
255
|
* @param stops The stops so far.
|
|
256
|
+
* @param taper The radii at `a` and at `b`, metres, for a tapered capsule weapon.
|
|
156
257
|
* @returns Metres.
|
|
157
258
|
*/
|
|
158
259
|
axis?(
|
|
@@ -160,7 +261,29 @@ export namespace resolveAutoMovieContactEvents {
|
|
|
160
261
|
b: IAutoMovieVector3,
|
|
161
262
|
seconds: number,
|
|
162
263
|
stops: IStops,
|
|
264
|
+
taper?: readonly [number, number],
|
|
163
265
|
): number;
|
|
266
|
+
|
|
267
|
+
/**
|
|
268
|
+
* The body's own weapon carried by the part a striking weapon met, when
|
|
269
|
+
* that weapon is still on its free path at the second: the contact is
|
|
270
|
+
* mutual, so it stops with the striker. Absent, or undefined, when the
|
|
271
|
+
* part met carries none.
|
|
272
|
+
*
|
|
273
|
+
* @param a The striking weapon's centre, or its axis's first end, world metres.
|
|
274
|
+
* @param b The axis's other end; the centre again for a sphere.
|
|
275
|
+
* @param seconds The contact second.
|
|
276
|
+
* @param stops The stops before this contact.
|
|
277
|
+
* @param by The id of the body carrying the striking weapon.
|
|
278
|
+
* @returns The id of one of this body's weapons, or undefined.
|
|
279
|
+
*/
|
|
280
|
+
carried?(
|
|
281
|
+
a: IAutoMovieVector3,
|
|
282
|
+
b: IAutoMovieVector3,
|
|
283
|
+
seconds: number,
|
|
284
|
+
stops: IStops,
|
|
285
|
+
by: string,
|
|
286
|
+
): string | undefined;
|
|
164
287
|
}
|
|
165
288
|
|
|
166
289
|
/** The input. */
|
|
@@ -194,14 +317,20 @@ export namespace resolveAutoMovieContactEvents {
|
|
|
194
317
|
}
|
|
195
318
|
}
|
|
196
319
|
|
|
197
|
-
/** A weapon's first impact from a second on, against the bodies it does not belong to
|
|
320
|
+
/** A weapon's first impact from a second on, against the bodies it does not belong to; undefined when it has none, or none before `horizon`. */
|
|
198
321
|
function firstImpact(
|
|
199
322
|
weapon: resolveAutoMovieContactEvents.IWeapon,
|
|
200
323
|
input: resolveAutoMovieContactEvents.IInput,
|
|
201
324
|
stops: resolveAutoMovieContactEvents.IStops,
|
|
202
325
|
from: number,
|
|
326
|
+
horizon: number,
|
|
203
327
|
): { against: string; seconds: number } | undefined {
|
|
328
|
+
const live: number = weapon.from ?? -Infinity;
|
|
329
|
+
const until: number = Math.min(input.to, weapon.to ?? Infinity);
|
|
204
330
|
const gap = (t: number): { distance: number; against: string } => {
|
|
331
|
+
// Outside its live span the weapon meets nothing, whatever its path.
|
|
332
|
+
if (t < live || t > (weapon.to ?? Infinity))
|
|
333
|
+
return { distance: Infinity, against: "" };
|
|
205
334
|
const p: IAutoMovieVector3 = weapon.position(t, stops);
|
|
206
335
|
const q: IAutoMovieVector3 | undefined = weapon.tail?.(t, stops);
|
|
207
336
|
let best: { distance: number; against: string } = {
|
|
@@ -219,17 +348,29 @@ function firstImpact(
|
|
|
219
348
|
`Body ${body.id} measures no segment for capsule weapon ${weapon.id}`,
|
|
220
349
|
);
|
|
221
350
|
const d: number =
|
|
222
|
-
|
|
223
|
-
? body.distance(p, t, stops)
|
|
224
|
-
:
|
|
351
|
+
q === undefined
|
|
352
|
+
? body.distance(p, t, stops) - weapon.radius
|
|
353
|
+
: weapon.tailRadius === undefined
|
|
354
|
+
? body.axis!(p, q, t, stops) - weapon.radius
|
|
355
|
+
: body.axis!(p, q, t, stops, [weapon.radius, weapon.tailRadius]);
|
|
225
356
|
if (d < best.distance) best = { distance: d, against: body.id };
|
|
226
357
|
}
|
|
227
358
|
return best;
|
|
228
359
|
};
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
360
|
+
// Outside its live span the weapon meets nothing, so the scan starts at
|
|
361
|
+
// the last of its steps before that span and ends at the first step past
|
|
362
|
+
// it: the same steps, and so the same result, as scanning from `from`.
|
|
363
|
+
if (until < from) return undefined;
|
|
364
|
+
const first: number =
|
|
365
|
+
live > from ? Math.max(1, Math.floor((live - from) / input.step)) : 1;
|
|
366
|
+
if (first === 1) {
|
|
367
|
+
const start: { distance: number; against: string } = gap(from);
|
|
368
|
+
if (start.distance <= 0) return { against: start.against, seconds: from };
|
|
369
|
+
}
|
|
370
|
+
let previous: number = first === 1 ? from : from + (first - 1) * input.step;
|
|
371
|
+
for (let k: number = first; ; k++) {
|
|
372
|
+
// An impact found past this step would come after `horizon`.
|
|
373
|
+
if (previous >= horizon) return undefined;
|
|
233
374
|
const t: number = Math.min(input.to, from + k * input.step);
|
|
234
375
|
if (gap(t).distance <= 0) {
|
|
235
376
|
let lo: number = previous;
|
|
@@ -241,7 +382,7 @@ function firstImpact(
|
|
|
241
382
|
}
|
|
242
383
|
return { against: gap(hi).against, seconds: hi };
|
|
243
384
|
}
|
|
244
|
-
if (t >=
|
|
385
|
+
if (t >= until) return undefined;
|
|
245
386
|
previous = t;
|
|
246
387
|
}
|
|
247
388
|
}
|
|
@@ -8,103 +8,177 @@ import { Vector3 } from "../math/Vector3";
|
|
|
8
8
|
*
|
|
9
9
|
* Neither person's goal is the other's hand, which moves; both aim at one
|
|
10
10
|
* shared point both can reach comfortably, the way joint-action studies find
|
|
11
|
-
* people converge on it.
|
|
12
|
-
*
|
|
13
|
-
*
|
|
14
|
-
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
*
|
|
11
|
+
* people converge on it. Each person has a comfortable reach, the
|
|
12
|
+
* shoulder-to-hand distance of the family's working elbow flexion, and the
|
|
13
|
+
* point is where both arms are at it at once: in the vertical plane through
|
|
14
|
+
* the two acting shoulders, the lower of the two points that lie one
|
|
15
|
+
* comfortable reach from each shoulder, so the hands meet below the line
|
|
16
|
+
* between the shoulders. For two equal people that is the midpoint between
|
|
17
|
+
* them, where human-human handovers take place (Hansen et al. 2017,
|
|
18
|
+
* Human-human handover tasks and how distance and object mass matter,
|
|
19
|
+
* Perceptual and Motor Skills 124(1), reviewed by Kopnarski et al. 2023,
|
|
20
|
+
* Front. Psychol. 14:1147296), `sqrt(reach^2 - h^2)` below the shoulders at
|
|
21
|
+
* the horizontal half gap `h`. Between people of unequal stature the same
|
|
22
|
+
* rule moves the point up and toward the taller one, who reaches down more
|
|
23
|
+
* steeply and less far forward while the shorter one reaches forward: the
|
|
22
24
|
* exchange height rises with stature (Sutiphotinun et al. 2020, reviewed by
|
|
23
|
-
* Kopnarski 2023)
|
|
24
|
-
*
|
|
25
|
-
*
|
|
26
|
-
*
|
|
27
|
-
* horizontal distance, so the shorter partner reaches up or the taller down
|
|
28
|
-
* only as far as the other cannot.
|
|
25
|
+
* Kopnarski 2023). The rule for unequal partners is provisional, as no study
|
|
26
|
+
* of the clasp point of partners of unequal stature or arm length was
|
|
27
|
+
* located; it replaces a horizontal division with a mean height that left
|
|
28
|
+
* the taller partner's arm straight at the end of its reach.
|
|
29
29
|
*
|
|
30
|
-
*
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
*
|
|
30
|
+
* Shoulders farther apart than the two comfortable reaches leave no such
|
|
31
|
+
* point, so both arms extend by one common factor of their comfortable
|
|
32
|
+
* reaches and the hands meet on the line between the shoulders; shoulders
|
|
33
|
+
* nearer than the difference of the reaches shorten both the same way. An
|
|
34
|
+
* action that has its own preferred contact height (`height`, as an object
|
|
35
|
+
* is handed over at chest height) passes it: the point then lies at that
|
|
36
|
+
* height where both arms are the same fraction of their comfortable reaches
|
|
37
|
+
* (by bisection along the horizontal line between the shoulders, on which
|
|
38
|
+
* one distance grows as the other shrinks), and the height is moved to the
|
|
39
|
+
* nearest one inside the band both straight arms reach there.
|
|
40
|
+
*
|
|
41
|
+
* A meeting is refused, not stretched, when it lies beyond a straight arm:
|
|
42
|
+
* the error gives both limits and the widest horizontal shoulder gap the
|
|
43
|
+
* pair can close, so the author moves the people instead of receiving an arm
|
|
44
|
+
* torn off its shoulder.
|
|
35
45
|
*
|
|
36
46
|
* @param input Both sides' acting shoulders and reaches.
|
|
37
47
|
* @returns The meeting point and each side's shoulder distance to it.
|
|
38
|
-
* @throws {Error} When a reach is not positive
|
|
48
|
+
* @throws {Error} When a reach is not positive or exceeds its limit, the shoulders coincide, or the point lies beyond a limit.
|
|
39
49
|
*
|
|
40
|
-
* @evidence contracts/development/common.md#meaningful-documentation States the
|
|
41
|
-
* @evidence contracts/development/implementation.md#principled-implementation
|
|
42
|
-
* @evidence contracts/development/implementation.md#clear-and-simple-structure One
|
|
43
|
-
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts An unreachable meeting is refused with the feasible gap, never clamped onto an arm;
|
|
44
|
-
* @evidence contracts/development/implementation.md#efficient-algorithms
|
|
50
|
+
* @evidence contracts/development/common.md#meaningful-documentation States the rule with its sources, the wide and the preferred-height cases, the frame and units, and the refusal.
|
|
51
|
+
* @evidence contracts/development/implementation.md#principled-implementation The midpoint of equal arms (Hansen 2017) generalised to the one point at which both arms hold their comfortable reach: the intersection of two spheres in the shoulders' vertical plane.
|
|
52
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure One common extension factor, one two-circle intersection, and for a preferred height one bisection and one band.
|
|
53
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts An unreachable meeting is refused with the feasible gap, never clamped onto an arm; a preferred height only moves inside both arms' reach.
|
|
54
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Closed form; a preferred height adds a fixed 50-step bisection, and its refusal another.
|
|
45
55
|
* @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its input.
|
|
46
56
|
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Allocates its result only.
|
|
47
57
|
*/
|
|
48
58
|
export function resolveAutoMovieMutualGoal(input: {
|
|
49
59
|
/** One person. */ a: resolveAutoMovieMutualGoal.ISide;
|
|
50
60
|
/** The other person. */ b: resolveAutoMovieMutualGoal.ISide;
|
|
61
|
+
/**
|
|
62
|
+
* The height the action itself prefers for the contact, world metres, when
|
|
63
|
+
* it has one (an object handed over at chest height): the point lies at it,
|
|
64
|
+
* or at the nearest height both straight arms reach.
|
|
65
|
+
*/
|
|
66
|
+
height?: number;
|
|
51
67
|
}): resolveAutoMovieMutualGoal.IGoal {
|
|
52
|
-
|
|
68
|
+
const a: resolveAutoMovieMutualGoal.ISide = input.a;
|
|
69
|
+
const b: resolveAutoMovieMutualGoal.ISide = input.b;
|
|
70
|
+
for (const side of [a, b])
|
|
53
71
|
if (!(side.reach > 0 && side.limit >= side.reach))
|
|
54
72
|
throw new Error(
|
|
55
73
|
`A mutual goal needs 0 < reach <= limit, but had reach ${side.reach} and limit ${side.limit}`,
|
|
56
74
|
);
|
|
57
|
-
const
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
const
|
|
63
|
-
|
|
64
|
-
|
|
75
|
+
const span: IAutoMovieVector3 = Vector3.subtract(b.shoulder, a.shoulder);
|
|
76
|
+
const apart: number = Vector3.length(span);
|
|
77
|
+
if (!(apart > 1e-9))
|
|
78
|
+
throw new Error("A mutual goal needs two shoulders at different places");
|
|
79
|
+
const gap: number = Math.hypot(span.x, span.z);
|
|
80
|
+
const refuse = (closable: number): Error =>
|
|
81
|
+
new Error(
|
|
82
|
+
`The hands cannot meet: no point lies within both arms' reach of ${a.limit.toFixed(3)} m and ${b.limit.toFixed(3)} m at a shoulder gap of ${gap.toFixed(3)} m; bring the shoulders within about ${closable.toFixed(3)} m of each other`,
|
|
83
|
+
);
|
|
84
|
+
const done = (
|
|
85
|
+
point: IAutoMovieVector3,
|
|
86
|
+
): resolveAutoMovieMutualGoal.IGoal => ({
|
|
87
|
+
point,
|
|
88
|
+
distance: [
|
|
89
|
+
Vector3.length(Vector3.subtract(point, a.shoulder)),
|
|
90
|
+
Vector3.length(Vector3.subtract(point, b.shoulder)),
|
|
91
|
+
],
|
|
92
|
+
});
|
|
65
93
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
const drop: number = Math.sqrt(
|
|
73
|
-
Math.max(0, side.limit * side.limit - h * h),
|
|
94
|
+
if (input.height === undefined) {
|
|
95
|
+
// The common factor both comfortable reaches are scaled by: 1 while the
|
|
96
|
+
// two spheres intersect, else the nearest factor at which they touch.
|
|
97
|
+
const factor: number = Math.min(
|
|
98
|
+
Math.max(1, apart / (a.reach + b.reach)),
|
|
99
|
+
apart / Math.abs(a.reach - b.reach),
|
|
74
100
|
);
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
101
|
+
const most: number = Math.min(a.limit / a.reach, b.limit / b.reach);
|
|
102
|
+
if (factor > most) {
|
|
103
|
+
const widest: number = most * (a.reach + b.reach);
|
|
104
|
+
throw refuse(Math.sqrt(Math.max(0, widest * widest - span.y * span.y)));
|
|
105
|
+
}
|
|
106
|
+
const axis: IAutoMovieVector3 = Vector3.scale(span, 1 / apart);
|
|
107
|
+
const reach: number = factor * a.reach;
|
|
108
|
+
const along: number =
|
|
109
|
+
(reach * reach - factor * factor * b.reach * b.reach + apart * apart) /
|
|
110
|
+
(2 * apart);
|
|
111
|
+
const off: number = Math.sqrt(Math.max(0, reach * reach - along * along));
|
|
112
|
+
// Downward across the line between the shoulders; one shoulder straight
|
|
113
|
+
// above the other leaves no such direction and no offset to place.
|
|
114
|
+
const down: IAutoMovieVector3 = Vector3.subtract(
|
|
115
|
+
{ x: 0, y: -1, z: 0 },
|
|
116
|
+
Vector3.scale(axis, -axis.y),
|
|
117
|
+
);
|
|
118
|
+
const length: number = Vector3.length(down);
|
|
119
|
+
return done(
|
|
120
|
+
Vector3.add(
|
|
121
|
+
Vector3.add(a.shoulder, Vector3.scale(axis, along)),
|
|
122
|
+
length > 1e-9
|
|
123
|
+
? Vector3.scale(down, off / length)
|
|
124
|
+
: { x: 0, y: 0, z: 0 },
|
|
125
|
+
),
|
|
126
|
+
);
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
// A preferred height: along the horizontal line between the shoulders, the
|
|
130
|
+
// place where both arms are the same fraction of their comfortable reaches.
|
|
131
|
+
const preferred: number = input.height;
|
|
132
|
+
const meet = (g: number): { share: number; low: number; high: number } => {
|
|
133
|
+
const excess = (t: number): number =>
|
|
134
|
+
Math.hypot(t, preferred - a.shoulder.y) * b.reach -
|
|
135
|
+
Math.hypot(g - t, preferred - b.shoulder.y) * a.reach;
|
|
136
|
+
let lo: number = 0;
|
|
137
|
+
let hi: number = g;
|
|
138
|
+
if (excess(lo) >= 0) hi = lo;
|
|
139
|
+
else if (excess(hi) <= 0) lo = hi;
|
|
140
|
+
else
|
|
141
|
+
for (let i: number = 0; i < 50; i++) {
|
|
142
|
+
const mid: number = (lo + hi) / 2;
|
|
143
|
+
if (excess(mid) < 0) lo = mid;
|
|
144
|
+
else hi = mid;
|
|
145
|
+
}
|
|
146
|
+
const t: number = (lo + hi) / 2;
|
|
147
|
+
// The heights each straight arm reaches at its horizontal distance.
|
|
148
|
+
const reachA: number = Math.sqrt(Math.max(0, a.limit * a.limit - t * t));
|
|
149
|
+
const reachB: number = Math.sqrt(
|
|
150
|
+
Math.max(0, b.limit * b.limit - (g - t) * (g - t)),
|
|
151
|
+
);
|
|
152
|
+
const beyond: boolean = t > a.limit || g - t > b.limit;
|
|
153
|
+
return {
|
|
154
|
+
share: g > 1e-9 ? t / g : 0,
|
|
155
|
+
low: beyond
|
|
156
|
+
? Infinity
|
|
157
|
+
: Math.max(a.shoulder.y - reachA, b.shoulder.y - reachB),
|
|
158
|
+
high: beyond
|
|
159
|
+
? -Infinity
|
|
160
|
+
: Math.min(a.shoulder.y + reachA, b.shoulder.y + reachB),
|
|
161
|
+
};
|
|
81
162
|
};
|
|
82
|
-
const
|
|
83
|
-
if (
|
|
84
|
-
// The widest closable gap, by bisection
|
|
85
|
-
//
|
|
163
|
+
const { share, low, high } = meet(gap);
|
|
164
|
+
if (low > high) {
|
|
165
|
+
// The widest closable gap, by bisection: the shared band only narrows as
|
|
166
|
+
// the gap widens.
|
|
86
167
|
let lo: number = 0;
|
|
87
|
-
let hi: number =
|
|
168
|
+
let hi: number = a.limit + b.limit;
|
|
88
169
|
for (let i: number = 0; i < 50; i++) {
|
|
89
170
|
const mid: number = (lo + hi) / 2;
|
|
90
|
-
const
|
|
91
|
-
if (
|
|
171
|
+
const band = meet(mid);
|
|
172
|
+
if (band.low <= band.high) lo = mid;
|
|
92
173
|
else hi = mid;
|
|
93
174
|
}
|
|
94
|
-
throw
|
|
95
|
-
`The hands cannot meet: no height lies within both arms' reach of ${input.a.limit.toFixed(3)} m and ${input.b.limit.toFixed(3)} m at a shoulder gap of ${(2 * half).toFixed(3)} m; bring the shoulders within about ${(2 * lo).toFixed(3)} m of each other`,
|
|
96
|
-
);
|
|
175
|
+
throw refuse(lo);
|
|
97
176
|
}
|
|
98
|
-
|
|
99
|
-
x:
|
|
100
|
-
y: Math.min(high, Math.max(low,
|
|
101
|
-
z:
|
|
102
|
-
};
|
|
103
|
-
const distance: [number, number] = [
|
|
104
|
-
Vector3.length(Vector3.subtract(point, input.a.shoulder)),
|
|
105
|
-
Vector3.length(Vector3.subtract(point, input.b.shoulder)),
|
|
106
|
-
];
|
|
107
|
-
return { point, distance };
|
|
177
|
+
return done({
|
|
178
|
+
x: a.shoulder.x + share * span.x,
|
|
179
|
+
y: Math.min(high, Math.max(low, preferred)),
|
|
180
|
+
z: a.shoulder.z + share * span.z,
|
|
181
|
+
});
|
|
108
182
|
}
|
|
109
183
|
|
|
110
184
|
/**
|
|
@@ -113,7 +187,7 @@ export function resolveAutoMovieMutualGoal(input: {
|
|
|
113
187
|
* @evidence contracts/development/common.md#meaningful-documentation Documents each member's unit and frame.
|
|
114
188
|
* @evidence contracts/development/design.md#principled-representation A world shoulder with two reach lengths per side; a world point with two distances.
|
|
115
189
|
* @evidence contracts/development/design.md#minimal-and-owned-surface What a two-person reaching law passes and reads.
|
|
116
|
-
* @evidence contracts/development/design.md#prohibited-design-shortcuts No body type: any rig supplies a shoulder and
|
|
190
|
+
* @evidence contracts/development/design.md#prohibited-design-shortcuts No body type: any rig supplies a shoulder and two lengths.
|
|
117
191
|
*/
|
|
118
192
|
export namespace resolveAutoMovieMutualGoal {
|
|
119
193
|
/** One person's acting arm. */
|