HyperFrames Core — Kompositionsvertrag
HTML-Skelett
<!DOCTYPE html>
<html data-hf-version="1">
<head>
<meta charset="UTF-8" />
<meta name="hf:canvas-width" content="1920" />
<meta name="hf:canvas-height" content="1080" />
<meta name="hf:fps" content="30" />
<meta name="hf:duration" content="auto" />
</head>
<body>
<div data-hf-scene="intro" data-hf-duration="5s">
<div data-hf-track="background">
<div data-hf-clip data-hf-start="0s" data-hf-duration="5s"
style="background:#111;width:100%;height:100%;position:absolute;"></div>
</div>
<div data-hf-track="title">
<div data-hf-clip data-hf-start="0.5s" data-hf-duration="4s"
data-hf-animate="fade-in">
<h1>Hallo Welt</h1>
</div>
</div>
</div>
</body>
</html>
Canvas-Meta-Tags
| Tag | Standard | Hinweise |
|---|
hf:canvas-width | 1920 | Pixel |
hf:canvas-height | 1080 | Pixel |
hf:fps | 30 | Bilder pro Sekunde |
hf:duration | auto | Gesamtdauer; oder explizit z. B. 60s |
hf:bg-color | #000 | Standard-Szenenhintergrund |
Szenen-Attribute (data-hf-scene)
| Attribut | Typ | Beschreibung |
|---|
data-hf-scene | string | Szenenname / -ID |
data-hf-duration | time | 5s, 10s, auto |
data-hf-transition | string | cut, fade, slide-left, slide-right, zoom |
data-hf-transition-duration | time | Standard 0.5s |
data-hf-bg | url oder color | Szenenhintergrund |
Track-Attribute (data-hf-track)
| Attribut | Typ | Beschreibung |
|---|
data-hf-track | string | Track-Name |
data-hf-z | number | Z-Index-Überlagerung |
data-hf-mute | boolean | Audio auf diesem Track stummschalten |
Clip-Attribute (data-hf-clip)
| Attribut | Typ | Beschreibung |
|---|
data-hf-clip | — | Markiert Element als Clip |
data-hf-start | time | Start-Offset innerhalb der Szene |
data-hf-duration | time | Clip-Dauer; auto = Inhaltsdauer |
data-hf-end | time | Alternative zu Dauer |
data-hf-animate | string | Kurzform-Animationsvoreinstellung |
data-hf-in | string | Eingangsanimation |
data-hf-out | string | Ausgangsanimation |
data-hf-volume | 0–1 | Audio-Lautstärke |
data-hf-speed | number | Wiedergabegeschwindigkeits-Multiplikator |
data-hf-loop | boolean | Medium loopen |
data-hf-trim-start | time | Medium von Anfang an trimmen |
data-hf-trim-end | time | Medium am Ende trimmen |
Medien-Clips
<video data-hf-clip data-hf-start="0s" src="assets/hero.mp4" />
<img data-hf-clip data-hf-start="0s" data-hf-duration="3s" src="assets/logo.png" />
<audio data-hf-clip data-hf-start="0s" src="assets/music.mp3" data-hf-volume="0.4" />
<div data-hf-clip data-hf-tts="Hallo, willkommen zur Demo." data-hf-start="1s" />
Zeitformat
Alle Zeitwerte verwenden die CSS-artige Notation: 0s, 1.5s, 2000ms. Bruchteilige Sekunden sind erlaubt.
Validierung
npx hyperframes lint index.html