You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 819ed63
Browse filesBrowse the repository at this point in the historyBrowse files
docs(prompting): add colour grading and film effects chapter
Ten A/B demos, each with the plain-language prompt that produced it and
the payload it compiled to. Slots into Level 4 — Substance.
The chapter teaches technique and leaves the key/bound reference to the
Colour Grading guide rather than duplicating it.
Also adds two sections to docs/guides/color-grading.mdx:
- Animating a Grade — the nine CSS custom properties, plus driving the
payload from the timeline for effects that have none. Documents that
--hf-color-grading-intensity does not scale a grade at render time,
and that payload-rewrite animation is effect-dependent: verified
working for halftone and twoInkPrint, verified not working for
crtCurvature, scanlines, chromaBleed and chromaticAberration.
- Limiting a Grade to Part of the Frame — grading qualifies by value,
never by screen position, so a region has to become its own layer.
Includes the three layer recipes and a worked face-redaction example.
Previously the support matrix said "not supported" with nowhere to go.
Renders are served from the CDN; docs/images/ is gitignored.
Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
Everything outside the clip falls through to the clean copy beneath. Because the
362
+
graded layer *is* the cutout, the ellipse can overshoot the head without
363
+
touching the room — there is nothing outside the silhouette to paint — so size
364
+
it generously rather than tightly around the features.
365
+
366
+
Pixelate preserves alpha, so the block grid clips to the silhouette instead of
367
+
filling a rectangle.
368
+
369
+
<Warning>
370
+
A fixed `clip-path` is only valid for footage where the subject barely moves.
371
+
Measure before relying on it. Anything with real subject movement needs a
372
+
tracked matte produced outside HyperFrames — there is no tracking in the
373
+
grading pipeline.
374
+
</Warning>
375
+
376
+
The prompt that produces the composition above:
377
+
378
+
```text
379
+
Take room.mp4 and its matted cutout subject.webm and build a 4-second
380
+
1920x1080 composition that redacts only the subject's face.
381
+
382
+
Three stacked layers inside one band, all playing the same 4 seconds:
383
+
1. room.mp4, no grading at all
384
+
2. subject.webm, no grading at all
385
+
3. subject.webm again, on top, carrying the grade
386
+
387
+
Layer 3 is the only graded element: pixelate at 0.5, held constant for the
388
+
whole shot — no ramp and no fade-up. A redaction that animates on reads as an
389
+
effect; one that is simply on reads as policy. Mid strength should leave a
390
+
recognisable human shape without a readable face.
391
+
392
+
Limit layer 3 to the head with a CSS clip-path ellipse. Do not try to do this
393
+
with the grading payload — it has no spatial masking. Size the ellipse
394
+
generously so it takes in the hairline, ears, and jaw rather than sitting tight
395
+
on the features; it can overshoot the head safely, because outside the
396
+
silhouette the cutout is transparent and there is nothing to paint.
397
+
398
+
Use the original room clip as the background plate rather than a
399
+
subject-removed plate, and if the cutout has premultiplied alpha, rebuild it
400
+
with ffmpeg alphamerge first so the edges do not come out with a black rim.
401
+
```
402
+
240
403
## Custom LUTs
241
404
242
405
HyperFrames supports project-local 3D `.cube` LUTs:
@@ -275,7 +438,7 @@ validation, and rendered comparisons to evaluate it.
275
438
| HDR delivery render | Separate workflow | The native HDR compositor preserves HDR source pixels and does not apply this SDR grading/effects pipeline to native HDR layers |
276
439
| LOG camera footage | Partial | Requires a known matching transform/LUT; no automatic camera profile management |
277
440
| Full-scene grade including DOM/text | Not supported | Current grading targets individual media elements |
278
-
| Face or region tracking | Not supported |Use a separate isolated media layer or external tracking/masking workflow|
441
+
| Face or region tracking | Not supported |No masks or tracking in the contract. Isolate the region as its own layer — see [Limiting a Grade to Part of the Frame](#limiting-a-grade-to-part-of-the-frame)|
279
442
| Remote media | Partial | Requires compatible CORS headers; project-local assets are reliable |
280
443
| ACES/OCIO finishing | Not supported | Outside the current browser shader pipeline |
0 commit comments