@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,189 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.projectileContinue = projectileContinue;
|
|
4
|
+
const Vector3_1 = require("../math/Vector3");
|
|
5
|
+
const projectileAt_1 = require("./projectileAt");
|
|
6
|
+
/**
|
|
7
|
+
* What a projectile does after a contact, by the outcome the caller decided:
|
|
8
|
+
*
|
|
9
|
+
* - `stick`: it stops at the contact, its point carried `depth` on along its
|
|
10
|
+
* velocity into the struck body, and rests there;
|
|
11
|
+
* - `bounce`: it leaves on a new flight from the contact, its velocity's
|
|
12
|
+
* normal part reversed and scaled by the restitution and its tangential
|
|
13
|
+
* part reduced by Coulomb friction's impulse, `min(mu (1 + e) |v_n|,
|
|
14
|
+
* |v_t|)` (the rigid-body impact model of Brach, Mechanical Impact
|
|
15
|
+
* Dynamics, 1991, ch. 4); when `roll` is given and the rebound would rise
|
|
16
|
+
* less than the body's radius above the surface, it rolls instead;
|
|
17
|
+
* - `roll`: it rolls along the surface with its velocity's tangential part,
|
|
18
|
+
* slowed at the rolling-resistance coefficient times the gravity pressing
|
|
19
|
+
* it on the surface, `a = c |g_n|`, to rest at `v^2 / (2 a)`;
|
|
20
|
+
* - `pass`: it continues through on the same flight, losing a share of its
|
|
21
|
+
* speed.
|
|
22
|
+
*
|
|
23
|
+
* Every coefficient is the caller's: the engine names no projectile. The
|
|
24
|
+
* gravity's pull along a tilted surface is not modelled in a roll, so a roll
|
|
25
|
+
* on a slope keeps the deceleration of a level one (stated, not hidden).
|
|
26
|
+
*
|
|
27
|
+
* @param projectile The flight that made contact.
|
|
28
|
+
* @param hit Its contact, with the surface's normal.
|
|
29
|
+
* @param outcome What happens.
|
|
30
|
+
* @returns The segment that follows, timed from the original flight's launch.
|
|
31
|
+
* @throws {RangeError} When the hit has no normal, or a coefficient is negative or not finite.
|
|
32
|
+
*
|
|
33
|
+
* @evidence contracts/development/common.md#meaningful-documentation States every outcome's law, its source and the slope it does not model.
|
|
34
|
+
* @evidence contracts/development/implementation.md#principled-implementation Newton's restitution on the normal part and Coulomb's impulse limit on the tangential part; constant deceleration for a roll.
|
|
35
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure Read the state at contact, split the velocity on the normal, one branch per outcome.
|
|
36
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Coefficients are inputs; a rebound below the radius becomes a roll only when the caller gives one.
|
|
37
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Constant work per contact.
|
|
38
|
+
* @evidence contracts/development/implementation.md#reuse-equivalent-work A new flight is a projectile record read by `projectileAt` like the first.
|
|
39
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
|
|
40
|
+
*/
|
|
41
|
+
function projectileContinue(projectile, hit, outcome) {
|
|
42
|
+
if (hit.normal === undefined)
|
|
43
|
+
throw new RangeError("a projectile continues only from a contact with a normal");
|
|
44
|
+
const state = (0, projectileAt_1.projectileAt)(projectile, hit.time);
|
|
45
|
+
const n = Vector3_1.Vector3.normalize(hit.normal);
|
|
46
|
+
const vn = Vector3_1.Vector3.dot(state.velocity, n);
|
|
47
|
+
const normal = Vector3_1.Vector3.scale(n, vn);
|
|
48
|
+
const tangent = Vector3_1.Vector3.subtract(state.velocity, normal);
|
|
49
|
+
const admit = (name, value) => {
|
|
50
|
+
if (!(Number.isFinite(value) && value >= 0))
|
|
51
|
+
throw new RangeError(`projectile ${name} must be finite and non-negative, but was ${value}`);
|
|
52
|
+
};
|
|
53
|
+
const held = state.rotation === undefined ? {} : { rotation: state.rotation };
|
|
54
|
+
const roll = (velocity, resistance) => {
|
|
55
|
+
admit("rolling resistance", resistance);
|
|
56
|
+
const deceleration = resistance * Math.abs(Vector3_1.Vector3.dot(projectile.gravity, n));
|
|
57
|
+
const speed = Vector3_1.Vector3.length(velocity);
|
|
58
|
+
const lasting = deceleration > 0 ? speed / deceleration : speed > 0 ? Infinity : 0;
|
|
59
|
+
return {
|
|
60
|
+
kind: "roll",
|
|
61
|
+
from: hit.time,
|
|
62
|
+
origin: state.position,
|
|
63
|
+
velocity,
|
|
64
|
+
deceleration,
|
|
65
|
+
until: hit.time + lasting,
|
|
66
|
+
...held,
|
|
67
|
+
};
|
|
68
|
+
};
|
|
69
|
+
switch (outcome.kind) {
|
|
70
|
+
case "stick": {
|
|
71
|
+
admit("embedding depth", outcome.depth);
|
|
72
|
+
const speed = Vector3_1.Vector3.length(state.velocity);
|
|
73
|
+
return {
|
|
74
|
+
kind: "rest",
|
|
75
|
+
from: hit.time,
|
|
76
|
+
position: speed > 0
|
|
77
|
+
? Vector3_1.Vector3.add(state.position, Vector3_1.Vector3.scale(state.velocity, outcome.depth / speed))
|
|
78
|
+
: state.position,
|
|
79
|
+
...held,
|
|
80
|
+
};
|
|
81
|
+
}
|
|
82
|
+
case "bounce": {
|
|
83
|
+
admit("restitution", outcome.restitution);
|
|
84
|
+
admit("friction", outcome.friction);
|
|
85
|
+
const rebound = -outcome.restitution * vn;
|
|
86
|
+
const slip = Vector3_1.Vector3.length(tangent);
|
|
87
|
+
const kept = slip > 0
|
|
88
|
+
? Math.max(0, slip -
|
|
89
|
+
outcome.friction * (1 + outcome.restitution) * Math.abs(vn)) / slip
|
|
90
|
+
: 0;
|
|
91
|
+
const velocity = Vector3_1.Vector3.add(Vector3_1.Vector3.scale(n, rebound), Vector3_1.Vector3.scale(tangent, kept));
|
|
92
|
+
// A rebound that rises less than the body's radius rolls instead.
|
|
93
|
+
const pull = Math.abs(Vector3_1.Vector3.dot(projectile.gravity, n));
|
|
94
|
+
if (outcome.roll !== undefined &&
|
|
95
|
+
(pull > 0 ? (rebound * rebound) / (2 * pull) : Infinity) <
|
|
96
|
+
outcome.roll.radius)
|
|
97
|
+
return roll(Vector3_1.Vector3.scale(tangent, kept), outcome.roll.resistance);
|
|
98
|
+
return {
|
|
99
|
+
kind: "flight",
|
|
100
|
+
from: hit.time,
|
|
101
|
+
projectile: {
|
|
102
|
+
...projectile,
|
|
103
|
+
origin: state.position,
|
|
104
|
+
velocity,
|
|
105
|
+
...(projectile.attitude === undefined ||
|
|
106
|
+
projectile.attitude.kind === "velocity"
|
|
107
|
+
? {}
|
|
108
|
+
: {
|
|
109
|
+
attitude: {
|
|
110
|
+
...projectile.attitude,
|
|
111
|
+
...(state.rotation === undefined
|
|
112
|
+
? {}
|
|
113
|
+
: { rotation: state.rotation }),
|
|
114
|
+
},
|
|
115
|
+
}),
|
|
116
|
+
},
|
|
117
|
+
};
|
|
118
|
+
}
|
|
119
|
+
case "roll":
|
|
120
|
+
return roll(tangent, outcome.resistance);
|
|
121
|
+
case "pass": {
|
|
122
|
+
admit("speed loss", outcome.loss);
|
|
123
|
+
return {
|
|
124
|
+
kind: "flight",
|
|
125
|
+
from: hit.time,
|
|
126
|
+
projectile: {
|
|
127
|
+
...projectile,
|
|
128
|
+
origin: state.position,
|
|
129
|
+
velocity: Vector3_1.Vector3.scale(state.velocity, Math.max(0, 1 - outcome.loss)),
|
|
130
|
+
...(projectile.attitude === undefined ||
|
|
131
|
+
projectile.attitude.kind === "velocity"
|
|
132
|
+
? {}
|
|
133
|
+
: {
|
|
134
|
+
attitude: {
|
|
135
|
+
...projectile.attitude,
|
|
136
|
+
...(state.rotation === undefined
|
|
137
|
+
? {}
|
|
138
|
+
: { rotation: state.rotation }),
|
|
139
|
+
},
|
|
140
|
+
}),
|
|
141
|
+
},
|
|
142
|
+
};
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
/**
|
|
147
|
+
* Companion types and the roll's reader of {@link projectileContinue}.
|
|
148
|
+
*
|
|
149
|
+
* @evidence contracts/development/common.md#meaningful-documentation Each member states its unit and time base.
|
|
150
|
+
* @evidence contracts/development/design.md#principled-representation A closed union of four outcomes and of three segments: a new flight, a roll and a rest.
|
|
151
|
+
* @evidence contracts/development/design.md#minimal-and-owned-surface What a caller decides and what it reads back.
|
|
152
|
+
* @evidence contracts/development/design.md#prohibited-design-shortcuts Every coefficient is the caller's.
|
|
153
|
+
*/
|
|
154
|
+
(function (projectileContinue) {
|
|
155
|
+
/**
|
|
156
|
+
* A segment's centre and velocity at a second since the original launch:
|
|
157
|
+
* a flight read from its own time zero, a roll's constant deceleration to
|
|
158
|
+
* rest, a rest's place.
|
|
159
|
+
*
|
|
160
|
+
* @param segment The segment.
|
|
161
|
+
* @param seconds Seconds since the original launch, at or after `from`.
|
|
162
|
+
* @returns The state.
|
|
163
|
+
*/
|
|
164
|
+
function at(segment, seconds) {
|
|
165
|
+
switch (segment.kind) {
|
|
166
|
+
case "flight":
|
|
167
|
+
return (0, projectileAt_1.projectileAt)(segment.projectile, seconds - segment.from);
|
|
168
|
+
case "roll": {
|
|
169
|
+
const t = Math.min(seconds, segment.until) - segment.from;
|
|
170
|
+
const speed = Vector3_1.Vector3.length(segment.velocity);
|
|
171
|
+
const along = speed > 0 ? Vector3_1.Vector3.scale(segment.velocity, 1 / speed) : segment.velocity;
|
|
172
|
+
const moving = Math.max(0, speed - segment.deceleration * t);
|
|
173
|
+
return {
|
|
174
|
+
position: Vector3_1.Vector3.add(segment.origin, Vector3_1.Vector3.scale(along, speed * t - 0.5 * segment.deceleration * t * t)),
|
|
175
|
+
velocity: Vector3_1.Vector3.scale(along, moving),
|
|
176
|
+
...(segment.rotation === undefined ? {} : { rotation: segment.rotation }),
|
|
177
|
+
};
|
|
178
|
+
}
|
|
179
|
+
case "rest":
|
|
180
|
+
return {
|
|
181
|
+
position: segment.position,
|
|
182
|
+
velocity: { x: 0, y: 0, z: 0 },
|
|
183
|
+
...(segment.rotation === undefined ? {} : { rotation: segment.rotation }),
|
|
184
|
+
};
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
projectileContinue.at = at;
|
|
188
|
+
})(projectileContinue || (exports.projectileContinue = projectileContinue = {}));
|
|
189
|
+
//# sourceMappingURL=projectileContinue.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"projectileContinue.js","sourceRoot":"","sources":["../../src/physics/projectileContinue.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import type { IAutoMovieProjectile } from "./IAutoMovieProjectile";
|
|
2
|
+
import type { IAutoMovieProjectileState } from "./IAutoMovieProjectileState";
|
|
3
|
+
/**
|
|
4
|
+
* A projectile's flight under gravity and quadratic drag, read by time:
|
|
5
|
+
* `dx/dt = v`, `dv/dt = gravity - k |v| v` with `k = rho Cd A / (2 m)`,
|
|
6
|
+
* solved by the engine's one fixed-step integrator
|
|
7
|
+
* (`integrateMotionTrajectory`, classical Runge-Kutta read by cubic Hermite)
|
|
8
|
+
* from the launch.
|
|
9
|
+
*
|
|
10
|
+
* The step is chosen once per flight by step doubling (Press et al.,
|
|
11
|
+
* Numerical Recipes, 3rd ed., 2007, sec. 17.2): from the integrator's own
|
|
12
|
+
* default step, the step is halved until one step and two half steps from
|
|
13
|
+
* the launch differ, divided by 15 (the fourth-order method's
|
|
14
|
+
* `2^4 - 1`), by no more than `TOLERANCE` metres per second of the step,
|
|
15
|
+
* so the error over a flight of `T` seconds stays near `TOLERANCE T`. The
|
|
16
|
+
* probe starts at the launch with the speed the flight can reach at most:
|
|
17
|
+
* a body faster than its terminal speed `sqrt(|g| / k)` only slows, one
|
|
18
|
+
* slower only approaches it, so the speed never exceeds the larger of the
|
|
19
|
+
* two, where the drag's acceleration is largest. The halving stops at the
|
|
20
|
+
* 52 bits of a double's mantissa, past which a step cannot shrink.
|
|
21
|
+
*
|
|
22
|
+
* The flight is integrated in chunks of `CHUNK` steps, each started from the
|
|
23
|
+
* previous chunk's end, so a read far along the flight integrates only up to
|
|
24
|
+
* its chunk, and every chunk depends on the launch alone: reads in any order
|
|
25
|
+
* give the same values. Times before the launch read the launch state.
|
|
26
|
+
*
|
|
27
|
+
* @param projectile A projectile with drag.
|
|
28
|
+
* @returns The flight's reader.
|
|
29
|
+
* @throws {RangeError} When the drag's mass is not positive, or its coefficient, area or density is negative or not finite.
|
|
30
|
+
*
|
|
31
|
+
* @evidence contracts/development/common.md#meaningful-documentation States the equations, the step rule with its source, the speed bound, the chunks and the held start.
|
|
32
|
+
* @evidence contracts/development/implementation.md#principled-implementation The quadratic drag law integrated by classical RK4 at a step from step doubling's error estimate, at the state where the drag's acceleration is largest.
|
|
33
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure Admit, choose the step, then integrate chunks lazily in order.
|
|
34
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The step comes from a stated tolerance, never from the frame grid; with zero drag the integrator reproduces the closed form, since RK4 and the cubic Hermite are exact for a quadratic path.
|
|
35
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Four right-hand-side evaluations per step, only up to the chunk read; a read is a chunk index and a Hermite evaluation.
|
|
36
|
+
* @evidence contracts/development/implementation.md#reuse-equivalent-work The integrator is the engine's one; the flight is memoised per projectile record, so every read of one launch shares one integration.
|
|
37
|
+
* @evidence contracts/development/implementation.md#bound-retention-and-release-resources The memo is a weak map keyed by the projectile record, so the knots go with the record.
|
|
38
|
+
*/
|
|
39
|
+
export declare function projectileDragFlight(projectile: IAutoMovieProjectile): projectileDragFlight.IFlight;
|
|
40
|
+
/**
|
|
41
|
+
* Companion types and constants of {@link projectileDragFlight}.
|
|
42
|
+
*
|
|
43
|
+
* @evidence contracts/development/common.md#meaningful-documentation Each member states its unit and why it has its value.
|
|
44
|
+
* @evidence contracts/development/design.md#principled-representation A flight is its chosen step and a reader by time.
|
|
45
|
+
* @evidence contracts/development/design.md#minimal-and-owned-surface What `projectileAt` and a contact search read.
|
|
46
|
+
* @evidence contracts/development/design.md#prohibited-design-shortcuts The tolerance is derived from the acceptance it serves.
|
|
47
|
+
*/
|
|
48
|
+
export declare namespace projectileDragFlight {
|
|
49
|
+
/**
|
|
50
|
+
* The error a flight may gather per second, metres: a tenth of the
|
|
51
|
+
* millimetre within which a flight's arrival is accepted (#3470: an arrow's
|
|
52
|
+
* arrival within 1 ms and 1 mm), so a flight of up to ten seconds stays
|
|
53
|
+
* inside it.
|
|
54
|
+
*/
|
|
55
|
+
const TOLERANCE: number;
|
|
56
|
+
/** Steps per chunk: a memory bound no flight reads, about a thousand knots of six numbers per chunk. */
|
|
57
|
+
const CHUNK: number;
|
|
58
|
+
/** A drag flight's reader. */
|
|
59
|
+
interface IFlight {
|
|
60
|
+
/** The integration step, seconds. */
|
|
61
|
+
step: number;
|
|
62
|
+
/** The largest speed the flight reaches, m/s: the launch speed or the terminal speed, whichever is larger. */
|
|
63
|
+
fastest: number;
|
|
64
|
+
/**
|
|
65
|
+
* The state at a second after the launch.
|
|
66
|
+
*
|
|
67
|
+
* @param seconds Seconds since the launch; before it, the launch state.
|
|
68
|
+
* @returns Position and velocity.
|
|
69
|
+
*/
|
|
70
|
+
at(seconds: number): IAutoMovieProjectileState;
|
|
71
|
+
}
|
|
72
|
+
}
|
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.projectileDragFlight = projectileDragFlight;
|
|
4
|
+
const Vector3_1 = require("../math/Vector3");
|
|
5
|
+
const integrateMotionTrajectory_1 = require("../motion/integrateMotionTrajectory");
|
|
6
|
+
const AutoMovieAir_1 = require("./AutoMovieAir");
|
|
7
|
+
/**
|
|
8
|
+
* A projectile's flight under gravity and quadratic drag, read by time:
|
|
9
|
+
* `dx/dt = v`, `dv/dt = gravity - k |v| v` with `k = rho Cd A / (2 m)`,
|
|
10
|
+
* solved by the engine's one fixed-step integrator
|
|
11
|
+
* (`integrateMotionTrajectory`, classical Runge-Kutta read by cubic Hermite)
|
|
12
|
+
* from the launch.
|
|
13
|
+
*
|
|
14
|
+
* The step is chosen once per flight by step doubling (Press et al.,
|
|
15
|
+
* Numerical Recipes, 3rd ed., 2007, sec. 17.2): from the integrator's own
|
|
16
|
+
* default step, the step is halved until one step and two half steps from
|
|
17
|
+
* the launch differ, divided by 15 (the fourth-order method's
|
|
18
|
+
* `2^4 - 1`), by no more than `TOLERANCE` metres per second of the step,
|
|
19
|
+
* so the error over a flight of `T` seconds stays near `TOLERANCE T`. The
|
|
20
|
+
* probe starts at the launch with the speed the flight can reach at most:
|
|
21
|
+
* a body faster than its terminal speed `sqrt(|g| / k)` only slows, one
|
|
22
|
+
* slower only approaches it, so the speed never exceeds the larger of the
|
|
23
|
+
* two, where the drag's acceleration is largest. The halving stops at the
|
|
24
|
+
* 52 bits of a double's mantissa, past which a step cannot shrink.
|
|
25
|
+
*
|
|
26
|
+
* The flight is integrated in chunks of `CHUNK` steps, each started from the
|
|
27
|
+
* previous chunk's end, so a read far along the flight integrates only up to
|
|
28
|
+
* its chunk, and every chunk depends on the launch alone: reads in any order
|
|
29
|
+
* give the same values. Times before the launch read the launch state.
|
|
30
|
+
*
|
|
31
|
+
* @param projectile A projectile with drag.
|
|
32
|
+
* @returns The flight's reader.
|
|
33
|
+
* @throws {RangeError} When the drag's mass is not positive, or its coefficient, area or density is negative or not finite.
|
|
34
|
+
*
|
|
35
|
+
* @evidence contracts/development/common.md#meaningful-documentation States the equations, the step rule with its source, the speed bound, the chunks and the held start.
|
|
36
|
+
* @evidence contracts/development/implementation.md#principled-implementation The quadratic drag law integrated by classical RK4 at a step from step doubling's error estimate, at the state where the drag's acceleration is largest.
|
|
37
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure Admit, choose the step, then integrate chunks lazily in order.
|
|
38
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The step comes from a stated tolerance, never from the frame grid; with zero drag the integrator reproduces the closed form, since RK4 and the cubic Hermite are exact for a quadratic path.
|
|
39
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms Four right-hand-side evaluations per step, only up to the chunk read; a read is a chunk index and a Hermite evaluation.
|
|
40
|
+
* @evidence contracts/development/implementation.md#reuse-equivalent-work The integrator is the engine's one; the flight is memoised per projectile record, so every read of one launch shares one integration.
|
|
41
|
+
* @evidence contracts/development/implementation.md#bound-retention-and-release-resources The memo is a weak map keyed by the projectile record, so the knots go with the record.
|
|
42
|
+
*/
|
|
43
|
+
function projectileDragFlight(projectile) {
|
|
44
|
+
const known = MEMO.get(projectile);
|
|
45
|
+
if (known !== undefined)
|
|
46
|
+
return known;
|
|
47
|
+
const drag = projectile.drag;
|
|
48
|
+
const density = drag.density ?? AutoMovieAir_1.AutoMovieAir.DENSITY;
|
|
49
|
+
for (const [name, value] of [
|
|
50
|
+
["coefficient", drag.coefficient],
|
|
51
|
+
["area", drag.area],
|
|
52
|
+
["density", density],
|
|
53
|
+
])
|
|
54
|
+
if (!(Number.isFinite(value) && value >= 0))
|
|
55
|
+
throw new RangeError(`projectile drag ${name} must be finite and non-negative, but was ${value}`);
|
|
56
|
+
if (!(Number.isFinite(drag.mass) && drag.mass > 0))
|
|
57
|
+
throw new RangeError(`projectile drag mass must be finite and positive, but was ${drag.mass}`);
|
|
58
|
+
const k = (density * drag.coefficient * drag.area) / (2 * drag.mass);
|
|
59
|
+
const g = projectile.gravity;
|
|
60
|
+
const f = (_, x) => {
|
|
61
|
+
const speed = Math.hypot(x[3], x[4], x[5]);
|
|
62
|
+
return {
|
|
63
|
+
dx: [
|
|
64
|
+
x[3],
|
|
65
|
+
x[4],
|
|
66
|
+
x[5],
|
|
67
|
+
g.x - k * speed * x[3],
|
|
68
|
+
g.y - k * speed * x[4],
|
|
69
|
+
g.z - k * speed * x[5],
|
|
70
|
+
],
|
|
71
|
+
};
|
|
72
|
+
};
|
|
73
|
+
const x0 = [
|
|
74
|
+
projectile.origin.x,
|
|
75
|
+
projectile.origin.y,
|
|
76
|
+
projectile.origin.z,
|
|
77
|
+
projectile.velocity.x,
|
|
78
|
+
projectile.velocity.y,
|
|
79
|
+
projectile.velocity.z,
|
|
80
|
+
];
|
|
81
|
+
// The probe: the launch point moving along the launch direction at the
|
|
82
|
+
// largest speed the flight can reach.
|
|
83
|
+
const v0 = Vector3_1.Vector3.length(projectile.velocity);
|
|
84
|
+
const terminal = k > 0 && Vector3_1.Vector3.length(g) > 0 ? Math.sqrt(Vector3_1.Vector3.length(g) / k) : 0;
|
|
85
|
+
const fastest = Math.max(v0, terminal);
|
|
86
|
+
const along = v0 > 0
|
|
87
|
+
? Vector3_1.Vector3.scale(projectile.velocity, fastest / v0)
|
|
88
|
+
: Vector3_1.Vector3.length(g) > 0
|
|
89
|
+
? Vector3_1.Vector3.scale(g, fastest / Vector3_1.Vector3.length(g))
|
|
90
|
+
: { x: 0, y: 0, z: 0 };
|
|
91
|
+
const probe = [...x0.slice(0, 3), along.x, along.y, along.z];
|
|
92
|
+
let h = integrateMotionTrajectory_1.integrateMotionTrajectory.STEP;
|
|
93
|
+
for (let halving = 0; halving < 52; halving++) {
|
|
94
|
+
const whole = (0, integrateMotionTrajectory_1.integrateMotionTrajectory)({
|
|
95
|
+
f,
|
|
96
|
+
x0: probe,
|
|
97
|
+
t0: 0,
|
|
98
|
+
t1: h,
|
|
99
|
+
h,
|
|
100
|
+
}).at(h).x;
|
|
101
|
+
const halves = (0, integrateMotionTrajectory_1.integrateMotionTrajectory)({
|
|
102
|
+
f,
|
|
103
|
+
x0: probe,
|
|
104
|
+
t0: 0,
|
|
105
|
+
t1: h,
|
|
106
|
+
h: h / 2,
|
|
107
|
+
}).at(h).x;
|
|
108
|
+
const error = Math.hypot(halves[0] - whole[0], halves[1] - whole[1], halves[2] - whole[2]) / 15;
|
|
109
|
+
if (error <= projectileDragFlight.TOLERANCE * h)
|
|
110
|
+
break;
|
|
111
|
+
h /= 2;
|
|
112
|
+
}
|
|
113
|
+
// Chunks integrated on demand, in order, each from its predecessor's end.
|
|
114
|
+
const span = projectileDragFlight.CHUNK * h;
|
|
115
|
+
const chunks = [];
|
|
116
|
+
const chunk = (index) => {
|
|
117
|
+
while (chunks.length <= index) {
|
|
118
|
+
const c = chunks.length;
|
|
119
|
+
const start = c === 0 ? x0 : chunks[c - 1].at(chunks[c - 1].t1).x;
|
|
120
|
+
chunks.push((0, integrateMotionTrajectory_1.integrateMotionTrajectory)({
|
|
121
|
+
f,
|
|
122
|
+
x0: start,
|
|
123
|
+
t0: c * span,
|
|
124
|
+
t1: (c + 1) * span,
|
|
125
|
+
h,
|
|
126
|
+
}));
|
|
127
|
+
}
|
|
128
|
+
return chunks[index];
|
|
129
|
+
};
|
|
130
|
+
const flight = {
|
|
131
|
+
step: h,
|
|
132
|
+
fastest,
|
|
133
|
+
at: (seconds) => {
|
|
134
|
+
const t = Math.max(0, seconds);
|
|
135
|
+
const x = chunk(Math.floor(t / span)).at(t).x;
|
|
136
|
+
return {
|
|
137
|
+
position: { x: x[0], y: x[1], z: x[2] },
|
|
138
|
+
velocity: { x: x[3], y: x[4], z: x[5] },
|
|
139
|
+
};
|
|
140
|
+
},
|
|
141
|
+
};
|
|
142
|
+
MEMO.set(projectile, flight);
|
|
143
|
+
return flight;
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* Companion types and constants of {@link projectileDragFlight}.
|
|
147
|
+
*
|
|
148
|
+
* @evidence contracts/development/common.md#meaningful-documentation Each member states its unit and why it has its value.
|
|
149
|
+
* @evidence contracts/development/design.md#principled-representation A flight is its chosen step and a reader by time.
|
|
150
|
+
* @evidence contracts/development/design.md#minimal-and-owned-surface What `projectileAt` and a contact search read.
|
|
151
|
+
* @evidence contracts/development/design.md#prohibited-design-shortcuts The tolerance is derived from the acceptance it serves.
|
|
152
|
+
*/
|
|
153
|
+
(function (projectileDragFlight) {
|
|
154
|
+
/**
|
|
155
|
+
* The error a flight may gather per second, metres: a tenth of the
|
|
156
|
+
* millimetre within which a flight's arrival is accepted (#3470: an arrow's
|
|
157
|
+
* arrival within 1 ms and 1 mm), so a flight of up to ten seconds stays
|
|
158
|
+
* inside it.
|
|
159
|
+
*/
|
|
160
|
+
projectileDragFlight.TOLERANCE = 1e-4;
|
|
161
|
+
/** Steps per chunk: a memory bound no flight reads, about a thousand knots of six numbers per chunk. */
|
|
162
|
+
projectileDragFlight.CHUNK = 1024;
|
|
163
|
+
})(projectileDragFlight || (exports.projectileDragFlight = projectileDragFlight = {}));
|
|
164
|
+
/** The flights integrated so far, by projectile record. */
|
|
165
|
+
const MEMO = new WeakMap();
|
|
166
|
+
//# sourceMappingURL=projectileDragFlight.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"projectileDragFlight.js","sourceRoot":"","sources":["../../src/physics/projectileDragFlight.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import type { IAutoMoviePhysicalProfile, IAutoMovieVector3 } from "@automovie/interface";
|
|
2
|
+
import type { IAutoMovieHit } from "./IAutoMovieHit";
|
|
3
|
+
import type { IAutoMovieProjectile } from "./IAutoMovieProjectile";
|
|
4
|
+
/**
|
|
5
|
+
* A projectile's first contact with any of several colliders over a span of
|
|
6
|
+
* its flight: when, where on the struck surface, the surface's outward
|
|
7
|
+
* normal there, and which collider.
|
|
8
|
+
*
|
|
9
|
+
* The projectile is a sphere about its flight's point, or a capsule from
|
|
10
|
+
* that point to a tail fixed in its body (an arrow from its point back to
|
|
11
|
+
* its nock), turned by its attitude. The sweep is the engine's one contact
|
|
12
|
+
* resolver (`resolveAutoMovieContactEvents`) with the projectile as its
|
|
13
|
+
* single weapon and each collider as a body measured by its own nearest-point
|
|
14
|
+
* reading, so the scan, the 24 bisections and the tie rule are the
|
|
15
|
+
* resolver's. Its step is chosen from the flight so that the projectile
|
|
16
|
+
* moves less than `thickness` in one step: `thickness` over the largest
|
|
17
|
+
* speed any point of the projectile reaches in the span, which is the
|
|
18
|
+
* larger end speed for a drag-free flight (the squared speed is convex in
|
|
19
|
+
* time), the drag flight's bound otherwise (`projectileDragFlight.fastest`),
|
|
20
|
+
* plus a spinning tail's turning speed. A collider thinner than `thickness`
|
|
21
|
+
* can be crossed within one step: the stated blind spot, as the resolver
|
|
22
|
+
* states its own. The point and the normal are the struck collider's
|
|
23
|
+
* nearest-point reading against the projectile at the contact second.
|
|
24
|
+
*
|
|
25
|
+
* @param projectile The flight.
|
|
26
|
+
* @param colliders What it may meet; `projectileFirstContact.plane` and `projectileFirstContact.shape` build the common ones.
|
|
27
|
+
* @param span Seconds since launch the search covers.
|
|
28
|
+
* @param options The projectile's radius and tail, and the thinnest collider the step must not cross.
|
|
29
|
+
* @returns The first contact, or null when the flight meets nothing in the span.
|
|
30
|
+
* @throws {RangeError} When the span is not forward, the thickness or the radius is not positive and finite, or a tail is given without an attitude.
|
|
31
|
+
*
|
|
32
|
+
* @evidence contracts/development/common.md#meaningful-documentation States the projectile's shape, the sweep's owner, the step rule, the blind spot and where the normal comes from.
|
|
33
|
+
* @evidence contracts/development/implementation.md#principled-implementation Continuous collision detection by the resolver's conservative scan and bisection, with the step bounded by the largest point speed so no collider of the stated thickness is stepped over.
|
|
34
|
+
* @evidence contracts/development/implementation.md#clear-and-simple-structure Admit, bound the speed, sweep with the one resolver, read the contact's point and normal.
|
|
35
|
+
* @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The step derives from the flight and the stated thickness; nothing is sampled on a frame grid.
|
|
36
|
+
* @evidence contracts/development/implementation.md#efficient-algorithms One nearest-point reading per collider per scan step and bisection, linear in the colliders and the span over the step.
|
|
37
|
+
* @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses the resolver's sweep, `physicalShapeNearest` for shapes and `projectileAt`'s memoised flight.
|
|
38
|
+
* @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing beyond the flight's own memo.
|
|
39
|
+
*/
|
|
40
|
+
export declare function projectileFirstContact(projectile: IAutoMovieProjectile, colliders: readonly projectileFirstContact.ICollider[], span: {
|
|
41
|
+
from: number;
|
|
42
|
+
to: number;
|
|
43
|
+
}, options: projectileFirstContact.IOptions): IAutoMovieHit | null;
|
|
44
|
+
/**
|
|
45
|
+
* Companion types and collider builders of {@link projectileFirstContact}.
|
|
46
|
+
*
|
|
47
|
+
* @evidence contracts/development/common.md#meaningful-documentation Each member states its frame and unit.
|
|
48
|
+
* @evidence contracts/development/design.md#principled-representation A collider is a nearest-point reading of a segment at a second, the one query the sweep and the normal both need; a plane and a placed shape are two builders of it.
|
|
49
|
+
* @evidence contracts/development/design.md#minimal-and-owned-surface What a caller gives and the two builders the engine's own colliders need.
|
|
50
|
+
* @evidence contracts/development/design.md#prohibited-design-shortcuts A person's colliders are the caller's reading, never a shape the engine guesses.
|
|
51
|
+
*/
|
|
52
|
+
export declare namespace projectileFirstContact {
|
|
53
|
+
/** Where a segment comes nearest a collider. */
|
|
54
|
+
interface INearest {
|
|
55
|
+
/** Signed distance, metres; negative when the segment enters. */
|
|
56
|
+
distance: number;
|
|
57
|
+
/** The nearest point of the collider's surface, world metres. */
|
|
58
|
+
point: IAutoMovieVector3;
|
|
59
|
+
/** The collider's outward unit normal there. */
|
|
60
|
+
normal: IAutoMovieVector3;
|
|
61
|
+
}
|
|
62
|
+
/** Something a flight may meet. */
|
|
63
|
+
interface ICollider {
|
|
64
|
+
/** Unique id among the colliders. */
|
|
65
|
+
id: string;
|
|
66
|
+
/**
|
|
67
|
+
* Where a world segment comes nearest it at a second; a point when both
|
|
68
|
+
* ends coincide.
|
|
69
|
+
*
|
|
70
|
+
* @param a One end, world metres.
|
|
71
|
+
* @param b The other end, world metres.
|
|
72
|
+
* @param seconds Seconds since the flight's launch.
|
|
73
|
+
* @returns The reading.
|
|
74
|
+
*/
|
|
75
|
+
nearest(a: IAutoMovieVector3, b: IAutoMovieVector3, seconds: number): INearest;
|
|
76
|
+
}
|
|
77
|
+
/** The projectile's size and the thinnest collider the search must see. */
|
|
78
|
+
interface IOptions {
|
|
79
|
+
/** The projectile's radius, metres; 0 for a point. */
|
|
80
|
+
radius: number;
|
|
81
|
+
/** A capsule's other end in the body's own frame from the flight's point, metres; a sphere when absent. Needs an attitude. */
|
|
82
|
+
tail?: IAutoMovieVector3;
|
|
83
|
+
/** The thinnest collider the search must not step over, metres; positive. */
|
|
84
|
+
thickness: number;
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* A fixed plane, solid on the side its normal points away from: the ground.
|
|
88
|
+
*
|
|
89
|
+
* @param id The collider's id.
|
|
90
|
+
* @param point A point of the plane, world metres.
|
|
91
|
+
* @param normal Its outward normal, non-zero.
|
|
92
|
+
* @returns The collider.
|
|
93
|
+
*/
|
|
94
|
+
function plane(id: string, point: IAutoMovieVector3, normal: IAutoMovieVector3): ICollider;
|
|
95
|
+
/**
|
|
96
|
+
* An admitted collider shape placed by a pose that may move with time: an
|
|
97
|
+
* archetype's part, a target butt.
|
|
98
|
+
*
|
|
99
|
+
* @param id The collider's id.
|
|
100
|
+
* @param shape The shape, in its parent's frame.
|
|
101
|
+
* @param pose The parent's world pose at a second since the launch.
|
|
102
|
+
* @returns The collider.
|
|
103
|
+
*/
|
|
104
|
+
function shape(id: string, shape: IAutoMoviePhysicalProfile.IShape, pose: (seconds: number) => IAutoMoviePhysicalProfile.ITransform): ICollider;
|
|
105
|
+
}
|