@dantea/opencut 0.1.0 → 0.1.3
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/dist/commands.d.ts +1 -0
- package/dist/commands.js +3 -1
- package/dist/system-probe +0 -0
- package/dist/video.js +7 -0
- package/docs/CLI.md +40 -6
- package/docs/INSTALL.md +13 -8
- package/docs/SDK.md +10 -3
- package/docs/VIDEO_DEFINITIONS.md +13 -8
- package/node_modules/@opencut/core/dist/render-plan.d.ts +1 -0
- package/node_modules/@opencut/core/dist/render-plan.js +5 -4
- package/node_modules/@opencut/core/dist/render-sources.d.ts +1 -0
- package/node_modules/@opencut/core/dist/video-build.js +2 -2
- package/node_modules/@opencut/core/dist/video-media-cache.d.ts +15 -0
- package/node_modules/@opencut/core/dist/{video-recipe-cache.js → video-media-cache.js} +7 -7
- package/node_modules/@opencut/core/dist/video-picture-cache.d.ts +3 -0
- package/node_modules/@opencut/core/dist/video-picture-cache.js +29 -0
- package/node_modules/@opencut/core/dist/video-processing.js +2 -2
- package/node_modules/@opencut/core/dist/video-render.d.ts +4 -1
- package/node_modules/@opencut/core/dist/video-render.js +6 -1
- package/node_modules/@opencut/core/package.json +3 -3
- package/node_modules/@opencut/media/dist/enhance.js +11 -3
- package/node_modules/@opencut/media/dist/index.d.ts +1 -0
- package/node_modules/@opencut/media/dist/picture-cache.d.ts +39 -0
- package/node_modules/@opencut/media/dist/picture-cache.js +169 -0
- package/node_modules/@opencut/media/dist/picture-seek.d.ts +4 -0
- package/node_modules/@opencut/media/dist/picture-seek.js +77 -0
- package/node_modules/@opencut/media/dist/process-memory +0 -0
- package/node_modules/@opencut/media/dist/render.d.ts +5 -1
- package/node_modules/@opencut/media/dist/render.js +195 -109
- package/node_modules/@opencut/media/dist/transform-layer.d.ts +7 -1
- package/node_modules/@opencut/media/dist/transform-layer.js +32 -2
- package/node_modules/@opencut/media/dist/video-enhance +0 -0
- package/node_modules/@opencut/media/dist/video-filter.d.ts +2 -0
- package/node_modules/@opencut/media/dist/video-filter.js +4 -0
- package/node_modules/@opencut/media/dist/video-interpolate +0 -0
- package/node_modules/@opencut/media/package.json +2 -2
- package/node_modules/@opencut/sdk/package.json +3 -3
- package/node_modules/@opencut/shared/package.json +1 -1
- package/package.json +5 -5
- package/skills/video-editor/SKILL.md +7 -1
- package/skills/video-editor/references/cli.md +7 -0
- package/skills/video-editor/references/sdk.md +5 -0
- package/skills/video-editor/references/video-definitions.md +7 -3
- package/node_modules/@opencut/core/dist/video-recipe-cache.d.ts +0 -16
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@opencut/sdk",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.3",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"exports": {
|
|
6
6
|
".": {
|
|
@@ -9,8 +9,8 @@
|
|
|
9
9
|
}
|
|
10
10
|
},
|
|
11
11
|
"dependencies": {
|
|
12
|
-
"@opencut/core": "0.1.
|
|
13
|
-
"@opencut/media": "0.1.
|
|
12
|
+
"@opencut/core": "0.1.3",
|
|
13
|
+
"@opencut/media": "0.1.3"
|
|
14
14
|
},
|
|
15
15
|
"license": "MIT"
|
|
16
16
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dantea/opencut",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.3",
|
|
4
4
|
"description": "OpenCut video-as-code CLI and TypeScript SDK for Apple Silicon",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -39,10 +39,10 @@
|
|
|
39
39
|
"@img/sharp-libvips-darwin-arm64": "1.3.4",
|
|
40
40
|
"@napi-rs/canvas": "1.1.0",
|
|
41
41
|
"@napi-rs/canvas-darwin-arm64": "1.1.0",
|
|
42
|
-
"@opencut/core": "0.1.
|
|
43
|
-
"@opencut/media": "0.1.
|
|
44
|
-
"@opencut/sdk": "0.1.
|
|
45
|
-
"@opencut/shared": "0.1.
|
|
42
|
+
"@opencut/core": "0.1.3",
|
|
43
|
+
"@opencut/media": "0.1.3",
|
|
44
|
+
"@opencut/sdk": "0.1.3",
|
|
45
|
+
"@opencut/shared": "0.1.3",
|
|
46
46
|
"detect-libc": "2.1.2",
|
|
47
47
|
"lru-cache": "11.5.3",
|
|
48
48
|
"semver": "7.8.5",
|
|
@@ -22,6 +22,8 @@ discover commands and `opencut render --help` for export controls.
|
|
|
22
22
|
transcoding. Use `interpolateFrames` to preserve duration at a higher
|
|
23
23
|
frame rate or `smoothSlowMotion` to extend picture duration and mute it.
|
|
24
24
|
Use `superResolution` for AI upscaling and `denoise` on supported hardware.
|
|
25
|
+
Preserve authored quality; never silently downsize a source or substitute a
|
|
26
|
+
lighter model to satisfy an unsupported processor.
|
|
25
27
|
Check [AI recipe support and scene boundaries](references/video-definitions.md#media-recipes).
|
|
26
28
|
2. Set canvas size, frame rate, ordered tracks, and clip ranges. Use integer
|
|
27
29
|
frame positions or exact rationals as documented. Add subtitles, effects,
|
|
@@ -34,7 +36,11 @@ discover commands and `opencut render --help` for export controls.
|
|
|
34
36
|
contact sheet from `opencut preview --help`. Preview defaults to `fast`.
|
|
35
37
|
Use `--quality quality` to review offline AI processing, such as 4×
|
|
36
38
|
super-resolution. A failed watch rebuild leaves the last valid preview
|
|
37
|
-
available.
|
|
39
|
+
available. Desktop review keeps the playhead at the same timeline time
|
|
40
|
+
across rebuilds, including frame-rate changes, and clamps it to the last
|
|
41
|
+
frame if the revision ends earlier. Select a clip, subtitle, or transition
|
|
42
|
+
to pause on the first frame at or after its start. A selection made during
|
|
43
|
+
loading takes effect when the preview is ready.
|
|
38
44
|
5. Deliver a new MP4 with `opencut render DEFINITION --output final.mp4`.
|
|
39
45
|
The CLI defaults to `quality` and runs directly. Use `--quality maximum`
|
|
40
46
|
for slower MP4 encoding with the same AI algorithms as `quality`.
|
|
@@ -24,6 +24,13 @@ automatically processes referenced recipes and reuses completed steps. The
|
|
|
24
24
|
`--recipe-cache` to choose a cache and `--recipe-workers` and the other
|
|
25
25
|
[recipe flags](../../../docs/CLI.md#media-recipes) to set processing limits.
|
|
26
26
|
|
|
27
|
+
For revisions, pass the same `--picture-cache <directory>` on the initial
|
|
28
|
+
export and each subsequent `render`. OpenCut can reuse lossless picture
|
|
29
|
+
ranges after a timeline shift, including ranges with captions that shift
|
|
30
|
+
together with picture. Audio is mixed on the revised timeline. Read
|
|
31
|
+
`pictureRanges` in JSON for the status of each half-open project-frame range.
|
|
32
|
+
See [picture cache options](../../../docs/CLI.md#reuse-picture-between-exports).
|
|
33
|
+
|
|
27
34
|
On macOS, `opencut system inspect --json` reports the VideoToolbox processor
|
|
28
35
|
and tested formats and dimensions. Recipe inspection checks declarations
|
|
29
36
|
and input streams. Use normal `validate` with the same recipe limits as
|
|
@@ -10,6 +10,11 @@ Use `renderVideo` to compile and render in one call. If `renderCompiledVideo`
|
|
|
10
10
|
reports that source media changed, recompile before retrying.
|
|
11
11
|
See the repository's [SDK guide](../../../docs/SDK.md) for the public API.
|
|
12
12
|
|
|
13
|
+
For picture reuse, pass the same `pictureCacheDirectory` to `renderVideo`
|
|
14
|
+
or `renderCompiledVideo` on the initial export and revisions. Read
|
|
15
|
+
`pictureRanges` for the status of each range in project frames.
|
|
16
|
+
See [picture cache behavior](../../../docs/CLI.md#reuse-picture-between-exports).
|
|
17
|
+
|
|
13
18
|
Use `inspectVideoRecipes(file)` for recipe validation and inspection without
|
|
14
19
|
transcoding. `compileVideo`, `renderVideo`, and `watchVideo` accept `processing`
|
|
15
20
|
options for the cache, worker limits, and step progress.
|
|
@@ -145,14 +145,18 @@ enhancement to select a range on the source container's clock. A later
|
|
|
145
145
|
`trim` uses the derived clock, where the first retained stream starts at
|
|
146
146
|
zero and the relative audio delay is preserved. `fast` uses a size-dependent
|
|
147
147
|
1.5× or 2× model.
|
|
148
|
-
`quality` and `maximum`
|
|
148
|
+
`quality` and `maximum` compute the temporal model's full 4× output before
|
|
149
|
+
resizing to the target. The model's input limit applies after earlier recipe
|
|
150
|
+
steps. OpenCut reports unsupported dimensions.
|
|
149
151
|
For `denoise`, set `strength` to `light`, `medium`, or `strong` and check temporal
|
|
150
152
|
noise-filter support before use. AI enhancement accepts constant-rate,
|
|
151
153
|
progressive, square-pixel, 8-bit video-range SDR input. If the color matrix
|
|
152
154
|
tag is missing, OpenCut resolves it from the input dimensions and codec
|
|
153
155
|
before enhancement. Recipe order determines whether enhancement runs
|
|
154
|
-
before or after interpolation.
|
|
155
|
-
the
|
|
156
|
+
before or after interpolation. Enhancing before doubling the frame rate halves
|
|
157
|
+
the number of enhanced frames, but requires interpolation support at the larger
|
|
158
|
+
size. Interpolating first keeps interpolation smaller and doubles enhancement
|
|
159
|
+
work. Compare the processed sequence with a Lanczos resize when judging detail and
|
|
156
160
|
temporal consistency. See the [enhancement reference](../../../docs/VIDEO_DEFINITIONS.md#ai-enhancement).
|
|
157
161
|
|
|
158
162
|
## Parameterized composition
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
import type { MediaMetadata } from '@opencut/media';
|
|
2
|
-
import type { IdentifiedMedia } from './video-input.js';
|
|
3
|
-
import type { RecipeFormat } from './video-recipe-schema.js';
|
|
4
|
-
type RecipeEntry = IdentifiedMedia & {
|
|
5
|
-
sha256: string;
|
|
6
|
-
};
|
|
7
|
-
export declare function materializeRecipeEntry(directory: string, key: string, format: RecipeFormat, signal: AbortSignal, encode: (output: string) => Promise<MediaMetadata>): Promise<{
|
|
8
|
-
entry: RecipeEntry;
|
|
9
|
-
reused: boolean;
|
|
10
|
-
}>;
|
|
11
|
-
/** Find validated media without publishing or removing anything. */
|
|
12
|
-
export declare function findRecipeEntry(directory: string, key: string, format: RecipeFormat, signal?: AbortSignal): Promise<{
|
|
13
|
-
directory: string;
|
|
14
|
-
entry: RecipeEntry;
|
|
15
|
-
} | undefined>;
|
|
16
|
-
export {};
|