Que fait geomotion ?
geomotion transforme une spécification JSON — une liste de keyframes, chacune étant une liste de formes — en une animation dessinée à la main. Les formes ayant le même id se morphing entre les keyframes ; les lignes continuent à « bouillonner » (ré-encrées ~12×/s) pour un rendu qui semble tracé à la main.
Site & studio : https://hacimertgokhan.github.io/geomotion · Dépôt : https://github.com/hacimertgokhan/geomotion
Flux de travail
- Choisissez une méthode (utilisez la première disponible) :
- Outils MCP (
geomotion_guide,geomotion_get_preset,geomotion_render,geomotion_share_link) : appelezgeomotion_guideune fois, puis rendez. - CLI (Node 18+ avec réseau) :
npx -y github:hacimertgokhan/geomotion render spec.json --both --formats svg,lottie,html - Sans outillage : écrivez la spécification, puis exécutez
python scripts/link.py spec.json(dans ce dossier de compétence) pour obtenir un lien lecteur/studio que l'utilisateur peut ouvrir, modifier et exporter.
- Outils MCP (
- Partez d'un preset lorsqu'il est proche (voir le catalogue ci-dessous) et adaptez les identifiants, positions, couleurs.
- Écrivez la spécification selon les règles ci-dessous. Validez (MCP
geomotion_validateougeomotion check spec.json). - Livrez : chemins de fichiers et/ou lien du lecteur. Mentionnez le lien du studio pour qu'ils puissent l'ajuster. Proposez une version transparente (
transparent: trueou"both") lorsque l'animation sera placée sur un site web.
Éléments essentiels de la spécification
{
"name": "idée",
"size": [1200, 1200],
"fps": 24, "boil": 12, "loop": true,
"background": "ivoire",
"hold": 0.7, "duration": 0.9, "ease": "inOutCubic",
"style": { "width": 24, "wobble": 1, "misregister": [-14, 10] },
"keyframes": [
{ "shapes": [ { "id": "ampoule", "type": "cercle", "cx": 600, "cy": 520, "r": 220, "fill": "avoine" } ] },
{ "hold": 1.2, "shapes": [
{ "id": "ampoule", "type": "cercle", "cx": 600, "cy": 520, "r": 240, "fill": "soleil" },
{ "id": "rayon", "type": "ligne", "from": [600, 200], "to": [600, 110], "enter": "draw", "delay": 0.3 }
] }
]
}
- Keyframe :
hold(secondes affichées),duration(morphing vers la keyframe suivante),ease. - Types de formes :
cercle {cx,cy,r},ellipse {cx,cy,rx,ry},rectangle {x,y,w,h,radius?}ou{cx,cy,w,h},ligne {from,to},polyligne {points,closed?},polygone {points},régulier {cx,cy,r,côtés},triangle {cx,cy,r},étoile {cx,cy,r,inner?,points?},cœur {cx,cy,size},blob {cx,cy,r,seed?},croissant {cx,cy,r,épaisseur?,angle?},vague {from,to,amplitude?,vagues?,phase?},spirale {cx,cy,r,tours?},arc {cx,cy,r,début,fin}(degrés, 0 = droite, sens horaire),chemin {d}(tout chemin SVG). - Options de forme :
id(correspondance entre keyframes — toujours le définir),fill,stroke(couleur oufalse),width,opacity,enter/exit(grow|pop|draw|fade|cut),delay(0–0.95, décalage),ease,transform {translate, rotate, scale, origin},misregister: falsepour les petits points solides. - Noms de palette : encre, ardoise, ivoire, papier, avoine, kraft, argile, corail, figue, ciel, cactus, olive, bruyère, soleil, blanc (ou tout hexadécimal).
- Easing : linear, in/out/inOut Quad·Cubic·Sine, inOutQuart, outExpo, inOutExpo, outBack, inOutBack, outElastic, outBounce.
Règles de conception pour un rendu esthétique
- Toile 1200×1200, marge d'environ 120 px, 2 à 5 formes audacieuses par pose. Les petits détails sont peu lisibles.
- Encre pour chaque contour, un ou deux remplissages d'accent par pose (avoine, argile, soleil, ciel, cactus, corail).
- Racontez une histoire avec les identifiants : le même élément se transforme (soleil → lune, enveloppe → avion en papier, point → cœur).
- Échelonnez avec
delay0 / 0.15 / 0.3 ; utilisez"enter": "draw"pour les lignes qui doivent sembler écrites,"pop"pour des arrivées ludiques. - Pauses 0,5–1,2 s, morphing 0,5–1,2 s.
inOutCubic= calme,inOutBack/outBack= ludique,outElastic= gelée. - Les rotations > 30° entre deux keyframes font couper les coins aux lignes — divisez les grandes rotations en plusieurs keyframes (voir les presets
spinner,gears,orbit). - Points solides (yeux, points de frappe) :
"stroke": false, "fill": "encre", "misregister": false.
Catalogue de presets (points de départ)
- interface : loader, spinner, success, error, toggle, bell, search
- nature : sunrise, sprout, rain, night, sea
- communication : chat, send, like, connect
- idées : idea, growth, target, gears, house
- personnages : smile, ghost, sparkle
- abstrait : drift, orbit, kaleido, pebbles
- mouvement : bounce, pendulum, jelly
Tout preset s'ouvre directement : https://hacimertgokhan.github.io/geomotion/play/#preset=<nom>
(ajoutez &bg=0 pour un fond transparent) ou dans le studio : /studio/#preset=<nom>.
Intégration sur un site web
<script type="module" src="https://hacimertgokhan.github.io/geomotion/src/embed.js"></script>
<geo-motion preset="success" transparent style="width:160px"></geo-motion>
<geo-motion code="z…"></geo-motion> <!-- la partie #s=… d'un lien de partage -->