RNA4219/video-storyboard-forge

動画コンテ Forge

Basée sur des plans chronologiques plutôt que des pages de manuscrit. N'utilisez pas le découpage de cases, le retournement de page ou les bulles de bande dessinée pour le timing et la mise en scène vidéo.

Procédure

1. Vérifiez le scénario, la durée, le format d'écran, l'usage et les éléments fournis par l'utilisateur. Si non spécifié, prenez par défaut 24fps, 16:9, 30 secondes et précisez clairement l'hypothèse. Si une œuvre musicale ou un scénario existant impose sa durée, priorisez-la. N'introduisez pas d'œuvres ou de personnages antérieurs sans autorisation.
2. Lisez references/format.md et assets/sample.storyboard.yaml, puis créez un fichier YAML propre à chaque projet. Même si des paroles sont fournies, ne considérez pas le timing de chant comme mesuré sans source audio réelle.
3. Répartissez duration_frames de sorte que la somme soit égale à target_frames. Utilisez des identifiants stables comme C001. Ne les renommez pas lors d'un réordonnancement. Ne saisissez pas manuellement les heures de début/fin ; laissez le script les calculer.
4. Validez les données avec python scripts/storyboard.py validate PROJECT.yaml. Avec build, générez un tableau de storyboard provisoire ainsi que les instructions de génération d'images par plan pour vérifier la structure et la durée.
5. Si des dessins sont nécessaires, utilisez les outils de génération d'images disponibles / le skill de génération d'images. Transmettez les instructions (ex. prompts/C001.txt) et les références de personnages/décors spécifiées. Une image par plan ; n'incrustez pas de texte, dialogues ou lignes de tableau dans l'image. Si une action continue doit être décrite, indiquez par texte les poses clés dans le plan et, si nécessaire, divisez en plusieurs plans.
6. Ouvrez les images générées et inspectez le cadrage, les personnages, les actions, les regards, la direction d'écran et la continuité. Utilisez la sortie réelle des outils de génération ; ne déduisez pas les plans en fonction de l'ordre « le plus récent » dans le dossier de génération. Définissez image de chaque plan avec un chemin relatif ou absolu basé sur le YAML. Même si la génération d'images n'est pas disponible, terminez le tableau, les instructions et la timeline, et indiquez clairement les parties non dessinées.
7. Exécutez build --require-images pour finaliser le tableau avec les colonnes séparées pour les images, les instructions de mise en scène et les indications sonores. Vérifiez l'affichage et les sauts de page d'impression dans un navigateur ou autre. Si nécessaire, créez un MP4 avec animatic et vérifiez la durée et l'ordre avec ffprobe et la lecture.
8. Livrez les fichiers YAML, HTML, CSV, timeline.json et les images de plans. Suivez les instructions de l'utilisateur pour la destination de sauvegarde ; dans l'environnement Work, utilisez la procédure de sauvegarde de la bibliothèque. Après avoir sauvegardé les fichiers nécessaires, renvoyez les liens. Rapportez brièvement la durée totale, les plans non dessinés, les parties non inspectées et la présence ou non d'audio réel.

Exemples d'exécution

Spécifiez les scripts en fonction de la racine du skill. Python 3.10+ et PyYAML sont requis. Si non installés, utilisez python -m pip install -r scripts/requirements.txt. Pour l'affichage et l'impression PDF en japonais, une police japonaise est nécessaire dans l'environnement d'exécution.

python scripts/storyboard.py validate assets/sample.storyboard.yaml
python scripts/storyboard.py build assets/sample.storyboard.yaml --out /absolute/path/board-v1
python scripts/storyboard.py build PROJECT.yaml --out /absolute/path/board-v2 --require-images
python scripts/storyboard.py animatic PROJECT.yaml --out /absolute/path/animatic.mp4

build s'arrête si le dossier de sortie existe déjà et n'est pas vide. Pour les révisions, utilisez un dossier de sortie différent. animatic nécessite ffmpeg et des images réelles pour tous les plans. Il s'arrête si le MP4 de sortie existe déjà. N'envoyez pas automatiquement à des API ou CLI externes. Séparez la phase de sortie des instructions et des données de la phase de dessin par l'outil de génération d'images.

Conception de la mise en scène

• Chaque plan doit avoir un objectif principal unique. Distinguez la présentation de situation, l'action, la réaction et le climax.
• Spécifiez la taille dans camera.framing, l'angle (plongée, niveau des yeux, etc.) dans angle, et le mouvement (FIX, PAN, DOLLY, etc.) dans movement. Ne confondez pas le mouvement du personnage avec celui de la caméra.
• Séparez les dialogues dans dialogue, la musique et les effets sonores dans sound, et le texte à l'écran dans on_screen_text. Mentionnez explicitement le silence.
• Les timings de mise en scène dans un plan sont spécifiés par des trames relatives [start_frame,end_frame) dans cues. Puisque l'image est fixe, ne considérez pas que le mouvement de caméra, la danse ou le synchronisme labial sont vérifiés uniquement par l'image.
• Pour les clips musicaux, conservez la correspondance entre sections, temps, et paroles dans notes et cues. Même si vous calculez les positions des temps à partir du BPM, vérifiez séparément le début de la source audio et les variations de tempo.
• Vérifiez oralement qu'un long dialogue tient dans la durée. Vérifiez la ligne imaginaire, les regards, la continuité du fond, des costumes et des accessoires (main tenant un objet).
• Actuellement, seuls les cuts francs sont supportés pour les transitions. Les fondus, etc., sont conservés dans notes comme instructions de production. L'animatique sert à vérifier les changements d'images fixes et le silence ; ce n'est pas une vidéo finale.

Correction partielle

Modifiez uniquement le YAML et l'image du ou des plans concernés, puis reconstruisez dans un nouveau dossier de sortie. Après un changement de durée, revérifiez le total global. Ne régénérez pas en masse les images des plans déjà finalisés.

Origine

Dérivé de sa-san10/rimochan-nyamuru-manga-forge, repensant pour la vidéo le flux « conception structurée → génération d'images → collecte explicite → inspection ». Commit de référence : e1f002cd1073ea01fe17965ea0a8b32f6b6e70e3. Pas de compatibilité directe avec OMNY/OMAY pour la bande dessinée. Le code et les instructions sont nouvellement implémentés pour la vidéo. La licence originale est conservée dans LICENSE. Les exemples utilisent des personnages et décors originaux ; aucune image d'un personnage original n'est incluse.