shwemahendran/jmathanim-skill

JMathAnim

JMathAnim génère des animations MP4 à partir de code Java (Scene2D, play.*). Ce skill cible la version 1.5.1. Chaque règle a été vérifiée par rendu, et les exemples dans examples/ le prouvent.

Avant d'écrire une scène

1. Lisez les fichiers de règles correspondant à ce que la scène utilise (tableau ci-dessous). Lisez toujours rules/known-bugs.md.
2. Étendez starter/StarterScene.java (copiez-le dans le projet) et appelez configure(dark) dans setupSketch().
3. Planifiez en séquences : une idée par séquence, chacune avec sa propre ligne de narration. Lisez rules/motion-design.md pour savoir ce qui rend une séquence agréable à regarder.

Conservez les modifications de l'utilisateur. Si un fichier de scène a changé depuis votre dernière lecture, supposez que le changement est intentionnel : relisez-le et construisez dessus. Ne l'écrasez jamais avec votre version précédente. Demandez si un changement semble être une erreur.

Les dix règles les plus importantes

1. Un point focal par séquence, révélé dans l'ordre de la narration. Rien n'apparaît avant d'être mentionné. Atténuez ou retirez ce qui n'est plus discuté.
2. Gardez le contenu dans la zone de sécurité : x entre ±1,96, y entre −0,97 et 1,075. La vue fait 4 × 2,25. Lancez avec -Daudit=true pour lister les violations.
3. Positionnez par rapport aux objets : stack().toObject(), align(), les groupes avec setLayout(). Ne jamais placer par coordonnées tapées.
4. Le texte brut est TextMathObject avec une police réelle ("Arial") ; LaTeX uniquement pour les maths. Hauteur du corps 0,058, jamais en dessous de 0,050. Prévoyez les largeurs (chars × hauteur × 0,45) et utilisez le retour à la ligne plutôt que de réduire la taille.
5. Terminez chaque séquence par endBeat() après beat(clipSeconds). Ne faites jamais la somme manuelle des durées ; elles sont arrondies à la trame inférieure.
6. Pour montrer des choses ensemble, mettez-les dans un seul play.run(...). Des appels séparés s'exécutent l'un après l'autre.
7. setArrowThickness(5) sur chaque flèche et connecteur. La tête par défaut est énorme.
8. Les boîtes arrondies proviennent de roundedRectangle(), jamais de OvalBox.make.
9. Les images entrent avec fadeIn, jamais showCreation ; cela n'ajoute rien silencieusement.
10. Lisez le journal de rendu pour les ERROR. Plusieurs échecs ne plantent pas : ils omettent simplement quelque chose.

Fichiers de règles

sujet	fichier
Maven, cycle de vie de la scène, configurations, résolution	rules/setup.md
coordonnées, taille de la vue, zone de sécurité	rules/coordinates-and-safe-area.md
texte, LaTeX, tailles, estimation de largeur, retour à la ligne	rules/text.md
formes, couleurs, API setXxx, remplissages, calques, ombres	rules/shapes-and-styling.md
empilement, alignement, groupes, tableaux	rules/layout.md
play.*, commandes, parallélisation, décalage, morphing	rules/animation.md
séquences, synchronisme avec la narration, rythme	rules/timing-and-beats.md
règles de conception, assouplissement, focus, annotations, zoom caméra, transitions de scène	rules/motion-design.md
flèches, connecteurs, coudes, accolades	rules/arrows-and-connectors.md
bitmaps, SVG	rules/images-and-svg.md
échecs silencieux et contournements	rules/known-bugs.md

Après avoir écrit une scène

1. Compilez avec -Xlint:deprecation,rawtypes et corrigez chaque avertissement.
2. Rendez à la taille d'aperçu (-Dpreview=true -Daudit=true) et corrigez toute ligne AUDIT ou ERROR.
3. Regardez la vidéo, ou extrayez des images avec ffmpeg (ffmpeg -sseof -0.3 -i media/X_360.mp4 -frames:v 1 last.png). Vérifiez les chevauchements, le texte coupé et tout élément manquant.
4. Rendez à la taille de production uniquement lorsque l'aperçu est correct.