carvercat/carvercat-motion

Graphiques animés Carvercat

Vous ne trouvez pas quelque chose ? references/INDEX.md répond à "où se trouve X" pour l'ensemble de la compétence (conception, application, effets, dessin, cartes, flux de travail, problèmes connus).

Fonctionne avec tout agent capable d'appeler les outils MCP Carvercat : Claude, GPT/Codex, Gemini, ou une personne lisant les instructions. Rien ici ne dépend d'un fournisseur en particulier. Les noms d'outils peuvent comporter un préfixe client (par exemple mcp__carvercat__carvercat_run).

0. Unités et la nouvelle surface (lisez ceci en premier)

Tout ce que vous écrivez est en unités de conception : px depuis le coin supérieur gauche du cadre avec y vers le bas, degrés dans le sens horaire, couleurs et easings CSS, fontSize en px, durées en images, "1.5s" ou "500ms". Construisez une scène entière en un seul appel validé (scene.apply, d'abord un essai à sec), sélectionnez des objets avec des sélecteurs de type CSS, utilisez les helpers (layout.*, text.fit, motion.apply, measure.*) et exécutez carve.preflight {host} avant tout envoi. Guide : references/app/design-units.md. Les anciens noms fonctionnent encore pour une version et y sont listés une fois ; ne les écrivez pas.

0b. Avant de toucher à quoi que ce soit

• Localisez l'application Carvercat installée sur cette machine et utilisez le dossier de cette compétence comme installé ; pour les travaux créatifs, cette compétence suffit. N'utilisez pas un chemin historique fixe.
• carvercat_session (attachement) puis carvercat_state : vérifiez la build, le projet ouvert et la composition avant de modifier quoi que ce soit. carvercat_list donne les identifiants.
• Demandez à la personne de ne pas cliquer dans l'application pendant que vous construisez : le changement de sa composition redirige vos commandes suivantes.
• Ne videz jamais le document d'un utilisateur pour le reconstruire. Sauvegardez le fichier .carverproj modifiable à la destination du travail.

1. Planifiez comme un motion designer (conception)

Lisez seulement ce dont le travail a besoin :

Besoin	À lire
Durées, easing, les 12 principes, chorégraphie, rythme sur la musique, anti-patrons	references/craft/motion-principles.md ; une page par principe dans references/craft/principles/
Échelle typographique, temps de lecture, styles d'entrée, emphase ; suivi mesuré, interlignage et seuils de lint	references/craft/typography.md
Quelle transition, combien de temps, la passation à la coupe	references/craft/transitions.md
Effets sonores et musique : un clip par événement, niveaux, spécifications pop/whoosh	references/craft/sound-design.md
Zones de sécurité 9:16 / réseaux sociaux, conversion d'une pièce 16:9	references/craft/vertical-and-safe-areas.md
Rôles de la palette, contraste, dégradés, valeurs de couleur	references/craft/colour.md
Système de mouvement d'une marque : famille d'easing, durées, mouvement signature, packs de marque	references/craft/brand-systems.md
Point focal, ordre de lecture, grilles, hiérarchie, zones de sécurité	references/craft/composition-and-layout.md
Lire un brief : faits, budget d'images, style, recette	references/craft/reading-a-brief.md
Quel pack de style pour un brief	references/craft/style-families.md
Comptes d'images mesurés par style ; la liste de révision du style	references/craft/timing-by-style.md, references/craft/review-by-style.md
Pourquoi un mouvement fonctionne : les 12 principes et au-delà, fondamentaux du design, techniques, genres, rythme, workflow, accessibilité, histoire (chaque page se termine par comment le faire dans Carvercat)	../wiki/README.md, index machine ../wiki/index.json

Règles valables partout :

• Un héros par scène.
• Les éléments de support entrent avec un expo-out ou en décélérant.
• Les sorties accélèrent et prennent environ 70 % du temps d'entrée.
• Espacez les voisins de 3 à 6 i.
• Chaque scène a une entrée, un mouvement au milieu et une sortie (jamais un arrêt figé).
• Le texte est maintenu au moins max(25 i, 10 i par mot) + 10 i. Le lint de Carvercat demande 17 caractères par seconde (espaces non comptés), au moins 25 images totalement opaques.

2. Construisez d'abord à partir de la bibliothèque de motifs

patterns/README.md contient 25 presets et 5 templates, tous vérifiés sur 0.0.72 avec des images de dépassement et de stabilisation mesurées, ainsi que des recettes pour push, zoom-through, pile de cartes et highlight sweep. Le pack est ../library/templates/motion-patterns/. Vérifiez qu'il est installé avec library.list {query:"expo"} ; sinon, installez-le dans le dossier Bibliothèque de l'utilisateur (Aide > Dossier Bibliothèque ou library.folder, copiez dans templates/, puis library.reload ; nécessite Carvercat 0.1.8+ ; voir patterns/README.md). Avant 0.1.8, une application installée ne peut pas le charger. Un template placé devient une composition imbriquée — voir le README des motifs.

• Un objet : preset.apply {name, id}, par exemple Rise - expo, Pop - spring, Stamp, Exit up - accelerate.
• Texte : Words rise - expo, Letters cascade - spring, Lines reveal - decelerate, et autres.
• Plusieurs objets : library.place {name, frame} puis template.apply {id}. Par exemple Two-tone wipe, Colour iris, Lower third - accent bar, Logo - stamp reveal, Bar chart - grow.
• Une pièce entière multi-temps dans une seule composition : patterns/promo-assembly.md.
• Packs de style (même installation que Motion Patterns) : SaaS UI, Kinetic Typography, Data Viz, Corporate Brand, Minimal Luxury, Social Short-form 9:16, Cartoon Bounce, Funky, Futuristic HUD, Retro, Glitch, Sports, Explainer ; choisissez-en un avec references/craft/style-families.md. Ils nécessitent Rethink Sans installée (le texte ne peut pas utiliser les polices fournies avec l'application, KI-136). Chacun a un laboratoire et un projet de démonstration sous ../categories/.
• Recettes pour les briefs courants (lancement SaaS, mise à jour sportive, bobine de conseils 9:16, ouverture de rapport annuel, résultats trimestriels, teaser de luxe, leçon explicative, bobine de citations cinétiques, explicateur pour enfants, promo de vente, bande-annonce tech, nuit rétro, teaser musical) : listes de plans avec images et exemples de projets vérifiés construits uniquement à partir des templates de la Bibliothèque, dans recipes/README.md.
• Une courbe exacte : ease: "cubic-bezier(a, b, c, d)" sur l'image qui part (patterns/custom-curves.md).
• Ressorts et rebonds : scripts/motion/curves.py les intègre dans les images clés.

3. Pilotez l'application

Règle permanente (23 Oct 2026) : construisez et modifiez les scènes en éditant directement le JSON .carverproj, puis edit.open {force:true}. Une scène entière passe également par MCP en un seul scene.apply validé et atomique ; le fichier projet est maintenant carvercat/2 (px, y vers le bas, images ; chaque sauvegarde l'écrit, les fichiers v1 s'ouvrent toujours), et la route JSON ci-dessous décrit l'ancienne forme v1 (fractions, y vers le haut) que json_author/cc.py écrit et que l'application charge encore ; pour un nouveau générateur, écrivez carvercat/2 (cc_project.py, comme le font les constructeurs de recettes). Utilisez MCP pour les étapes que le fichier ne peut pas faire (mesure de texte, look, sauvegarde, transfert Resolve, ajustements en direct). Procédure et solutions de repli : references/app/json-authoring.md.

references/app/design-units.md est le guide de travail : unités, scene.apply, sélecteurs, anim.set (interpolations, easing, stagger), effets en termes CSS, helpers, notes headless. references/app/mcp-essentials.md couvre la boucle build -> look -> check, les commandes qui valent le coup et les pièges qui coûtent des heures (clip.move écrase, les identifiants redémarrent par composition). Le catalogue lisible par machine est carvercat://schema/design, carvercat://schema/commands et carvercat://schema/scene (le schema/agent/json-schema/ du dépôt de l'application) : lisez l'entrée avant d'utiliser une clé inconnue ; ne devinez jamais les arguments ou les identifiants d'entrée générés.

Pour un travail scripté, utilisez les scripts Python maintenus : ai/scripts/cc_client.py + cc_scene.py (references/app/creative-toolkit.md) ; l'application a également son propre helper Python (carvercat_py). Les effets, remplissages/contours, dégradés, couleurs, transformations, stagger et découpage de chemin sont dans references/app/creative-controls.md. Les plans en attente peuvent être vérifiés avec scene.apply {dry_run: true} et measure.* ; rien n'est stocké à côté du document. Mesurez le texte façonné réel ; choisissez les polices délibérément, y compris les passages numériques LTR séparés dans un texte RTL mixte. Chaque exemple dans les guides est exécuté par ai/scripts/verify_examples.py contre un Carvercat headless.

3b. Effets, dessin, cartes et travaux entiers

Besoin	À lire
Flou, lueur (avec limites de brûlure), ombre, flou de mouvement, dégradés, dessin de contour/découpage, bords doux et adoucissement de masque, contour de texte, stagger, masques	references/effects/README.md
Paramètres cachés du sous-sol, leur promotion, cordes entre paramètres	references/effects/basement-promote-ropes.md
Toutes les formes (rectangle, ellipse, étoile, polygone, chemin), agencement et groupement	references/drawing/shapes.md
Personnages/objets à partir de pièces : ancres comme articulations, parentage, l'objet nul (object.new {kind: "null"}) comme pivot ou poignée	references/drawing/rigging.md
Cartes : frontières, routes, épingles, itinéraires, anneaux, pop-ups de points de repère, flèches, zoom avant/arrière	references/maps/maps.md
Sous-titres + VO, RTL/Arabe, transfert vers Resolve, exportation, la boucle de travail	references/workflows/
Quelque chose se comporte mal	references/known-issues.md

Règles d'effet valables partout : la force glow ≤ 0,8 (0,9 écrète, 1,0 brûle en blanc), le rayon définit la portée du halo ; flou et ombre uniquement pour la profondeur sur le héros ; dessin de découpage pour les lignes ; softEdge de 2 à 6 px pour les formes UI, de 160 à 320 px pour la lumière ambiante (references/effects/soft-edge.md, avec la révélation du masque adouci).

4. Vérifiez avant de dire que c'est terminé

• Regardez l'entrée, le maintien et la sortie (carvercat_look). Mesurez avec carvercat_inspect (timing, curves pour le dépassement et la stabilisation, lint, expect, qc pour les flashs) et les helpers sans rendu (measure.boxes, measure.overlaps {within: "safe"}, measure.contrast). Pré-volez avec carve.preflight {host} avant un envoi.
• Parcourez references/craft/review-checklist.md : histoire, rythme, texte, UI, transitions, look, son, hygiène.
• Construisez d'abord une composition représentative, révisez-la, puis développez. Les recettes sont des points de départ : adaptez la hiérarchie, l'imagerie et le rythme au brief et aux séquences. Les limites de sécurité ne remplacent pas le jugement visuel.
• Latence ou famine audio : references/app/performance.md.

5. Outils qui vivent en dehors de l'application (scripts/motion/, Python 3, bibliothèque standard + ffmpeg)

• vo_align.py : voix-off → images de mots et de lignes.
• sfx_kit.py / sfx_render.py : SFX synthétisés (pop, whoosh-hit, tic, impact...) → un WAV par signal.
• music_bed.py : un fond musical qui s'adapte à la coupe ; mix_check.py : LUFS des pistes et un mix de référence.
• reformat.py : un projet 16:9 → compositions 9:16.
• carverproj.py : helpers JSON de projet (identifiants, clés).
• build_pattern_pack.py / comp_to_template.py : régénérer le pack.
• effects_param_tables.py : régénérer la table des paramètres d'effet.
• ../maps/geo_paths.py / ../maps/map_overlay.py : géographie réelle → chemins ; superposition explicative (épingles, anneaux, itinéraires, cartes, flèches).

6. Sécurité et livraison

Utilisez les identifiants de scène (et les espaces de noms Scene.component) afin qu'une révision mette à jour les mêmes objets : appliquez à nouveau le même document et seules les différences changent. Après un refus, arrêtez le travail qui en dépend. Après un résultat inconnu, inspectez l'identité et l'état avant tout changement supplémentaire ; ne rejouez jamais une écriture ou une exportation dont vous ne connaissez pas le résultat. Les opérations Resolve nécessitent l'autorisation actuelle de l'utilisateur ; sans elle, authorisez et testez uniquement en natif. Lorsque vous êtes autorisé, vérifiez le projet, la timeline et le format réels, préservez la modification originale et inspectez des échantillons composites. L'unité de travail Carvercat est une composition ; une timeline Resolve est séparée. Pour l'inspection de transfert, la consolidation, le déplacement et le relinking, lisez references/app/media-recovery.md ; lorsque la couverture de référence de nettoyage est incomplète, conservez les fichiers.

Crédits et licences pour les idées derrière les références de conception : SOURCES.md.