HyperFrames
Utilisez cette compétence lorsque l'utilisateur demande à Parsifal de réaliser une vidéo avec HyperFrames, par exemple une vidéo verticale de 30 secondes, une courte intro, une micro-bande-annonce cinématographique, une promotion de produit, des légendes animées, des visuels techniques de type HUD, un contenu web-vers-vidéo ou un rendu graphique animé en HTML/CSS/JS.
HyperFrames considère le HTML comme la source de vérité de la vidéo. Construisez les scènes vidéo sous forme de compositions HTML avec une mise en page CSS et une animation JavaScript, validez la mise en page, puis effectuez le rendu du résultat au format MP4.
Configuration
Si HyperFrames n'est pas installé ou si la compétence officielle est manquante, installez-la d'abord :
parsifal skills install official/creative/hyperframes
Utilisez npx hyperframes pour les opérations sur le projet. HyperFrames nécessite Node.js et FFmpeg. Si le rendu ou l'aperçu échoue, exécutez :
npx hyperframes doctor
Workflow
- Convertissez la demande de l'utilisateur en un court cahier des charges de production : durée, rapport hauteur/largeur, plateforme cible, langue, style, besoins en musique ou voix off, et chemin de sortie final.
- Pour les cahiers des charges incomplets, utilisez des valeurs par défaut raisonnables. Utilisez 1080×1920 pour une vidéo courte verticale, 1920×1080 pour une vidéo horizontale, 30 ips et une sortie MP4.
- Créez ou réutilisez un projet HyperFrames :
npx hyperframes init my-video --non-interactive
- Rédigez la composition en HTML/CSS/JS. Assurez-vous que la mise en page de l'image héro statique est correcte avant d'ajouter l'animation.
- Validez avant le rendu :
npx hyperframes lint
npx hyperframes inspect --samples 15
- Prévisualisez lorsque c'est utile :
npx hyperframes preview
- Effectuez le rendu de la vidéo finale :
npx hyperframes render --output final.mp4 --quality standard
Utilisez --quality draft pour une itération rapide et --quality high pour une livraison finale lorsque l'utilisateur demande un export soigné.
Règles de composition
- Utilisez un élément racine avec les attributs
data-composition-id,data-widthetdata-height. - Utilisez
data-start,data-durationetdata-track-indexpour les clips chronométrés. - Enregistrez les timelines GSAP de manière synchrone sur
window.__timelines. - Utilisez le CSS comme état de mise en page final, puis animez à partir de ou vers cet état.
- Laissez la lecture des médias sous le contrôle de l'environnement d'exécution HyperFrames. N'appelez pas manuellement
play(),pause()ou ne recherchez pas de position dans les médias. - Évitez la logique d'animation non déterministe comme
Math.random()ouDate.now(), sauf si vous utilisez un générateur à graine. - N'utilisez pas de répétitions infinies. Calculez des nombres de répétitions finis à partir de la durée de la composition.
- Vérifiez que le texte, les légendes, les panneaux d'interface et les éléments HUD restent à l'intérieur du cadre à chaque instant inspecté.
Livraison
Lorsque vous avez terminé, informez l'utilisateur :
- du chemin du MP4 rendu ;
- de l'URL de prévisualisation si un serveur d'aperçu est en cours d'exécution ;
- de toutes les hypothèses formulées concernant la durée, le rapport hauteur/largeur, le style, la narration ou la musique ;
- de tout problème de validation non résolu.
Ne vous arrêtez pas après avoir écrit le HTML. Une tâche HyperFrames n'est terminée qu'après avoir vérifié la composition avec lint et inspect, et effectué le rendu en MP4, sauf si l'utilisateur demande explicitement uniquement les fichiers sources.