@omnimedia/omnitool 1.1.0-81 → 1.1.0-82

package/README.md

@@ -229,6 +229,16 @@ Object.entries(animations).forEach(([property, meta]) => {
 
 Each animation definition describes the semantic shape of the animation: its value kind, default interpolation, and numeric channels with defaults and units. This is useful for tools that need to create valid keyframes without hardcoding Omnitool's track layout.
 
+Utils:
+
+```ts
+import {resolveTransform} from "@omnimedia/omnitool"
+
+const transform = resolveTransform(spatial, localTime)
+```
+
+`resolveTransform` gets a spatial item's current transform. It returns the static transform for `Item.Spatial`, or resolves the animated transform for `Item.AnimatedSpatial` at the given local time.
+
 Worker URL notes:
 - `Driver.setup()` defaults to `/node_modules/@omnimedia/omnitool/x/driver/driver.worker.bundle.min.js`.
 - If you serve the worker from a different location, pass `workerUrl`:

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@omnimedia/omnitool",
-	"version": "1.1.0-81",
+	"version": "1.1.0-82",
 	"description": "open source video processing tools",
 	"license": "MIT",
 	"author": "Przemysław Gałęzki",

package/s/timeline/index.ts

@@ -19,3 +19,4 @@ export * from "./sugar/omni.js"
 
 export * from "./utils/checksum.js"
 export * from "./utils/datafile.js"
+export * from "./utils/anim.js"

package/s/timeline/renderers/parts/handy.ts

@@ -3,7 +3,7 @@ import {ms, Ms} from '../../../units/ms.js'
 import {Id, TimelineFile} from '../../parts/basics.js'
 import { SampleContext } from './samplers/visual/parts/types.js'
 import {I6, Mat6, mul6, transformToMat6} from '../../utils/matrix.js'
-import {resolveScalarAnimation, resolveSpatialTransform} from '../../utils/anim.js'
+import {resolveScalarAnimation, resolveTransform} from '../../utils/anim.js'
 import {ContainerItem, Item, Kind, PlayableItem, SpatialItem} from '../../parts/item.js'
 
 function isPlayableItem(item: Item.Any): item is PlayableItem {
@@ -101,7 +101,7 @@ function applySpatialIfAny(
 	if ("spatialId" in item && item.spatialId) {
 		const spatial = items.get(item.spatialId) as SpatialItem | undefined
 		if (spatial?.enabled) {
-			const local = transformToMat6(resolveSpatialTransform(spatial, time))
+			const local = transformToMat6(resolveTransform(spatial, time))
 			return mul6(local, parentMatrix)
 		}
 	}

package/s/timeline/utils/anim.ts

@@ -62,7 +62,7 @@ export const resolveScalarAnimation =(
 	anim: ScalarAnimation,
 ): number => resolveScalar(time, anim.track, anim.terp)
 
-export const resolveSpatialTransform =(
+export const resolveTransform =(
 	spatial: Item.Spatial | Item.AnimatedSpatial,
 	time: number,
 ): Transform =>