Was macht geomotion?
geomotion wandelt eine JSON-Spezifikation – eine Liste von Keyframes, die jeweils eine Liste von Formen enthalten – in eine handgezeichnete Animation um.
Formen mit derselben id verwandeln sich (morphen) zwischen den Keyframes ineinander; Linien bleiben
„kochend“ (ca. 12×/s neu gezeichnet), sodass das Ergebnis wie von Hand gezeichnet wirkt.
Website & Studio: https://hacimertgokhan.github.io/geomotion · Repository: https://github.com/hacimertgokhan/geomotion
Arbeitsablauf
- Wählen Sie einen Weg (verwenden Sie den ersten verfügbaren):
- MCP-Tools (
geomotion_guide,geomotion_get_preset,geomotion_render,geomotion_share_link): Rufen Siegeomotion_guideeinmal auf, dann rendern. - CLI (Node 18+ mit Netzwerk):
npx -y github:hacimertgokhan/geomotion render spec.json --both --formats svg,lottie,html - Ohne Werkzeuge: Schreiben Sie die Spezifikation, führen Sie dann
python scripts/link.py spec.json(in diesem Skill-Ordner) aus, um einen Player-/Studio-Link zu erhalten, den der Benutzer öffnen, bearbeiten und exportieren kann.
- MCP-Tools (
- Beginnen Sie mit einem Preset, wenn es in der Nähe ist (siehe Katalog unten) und passen Sie IDs, Positionen, Farben an.
- Schreiben Sie die Spezifikation gemäß den folgenden Regeln. Validieren Sie (MCP
geomotion_validateodergeomotion check spec.json). - Liefern Sie ab: Dateipfade und/oder den Player-Link. Erwähnen Sie den Studio-Link, damit der Benutzer ihn anpassen kann. Bieten Sie eine transparente Version an (
transparent: trueoder"both"), wenn die Animation auf einer Website platziert wird.
Spezifikations-Grundlagen
{
"name": "idee",
"size": [1200, 1200],
"fps": 24, "boil": 12, "loop": true,
"background": "ivory",
"hold": 0.7, "duration": 0.9, "ease": "inOutCubic",
"style": { "width": 24, "wobble": 1, "misregister": [-14, 10] },
"keyframes": [
{ "shapes": [ { "id": "glühbirne", "type": "circle", "cx": 600, "cy": 520, "r": 220, "fill": "oat" } ] },
{ "hold": 1.2, "shapes": [
{ "id": "glühbirne", "type": "circle", "cx": 600, "cy": 520, "r": 240, "fill": "sun" },
{ "id": "strahl", "type": "line", "from": [600, 200], "to": [600, 110], "enter": "draw", "delay": 0.3 }
] }
]
}
- Keyframe:
hold(Anzeigedauer in Sekunden),duration(Morph-Zeit zum nächsten Keyframe),ease. - Formtypen:
circle {cx,cy,r},ellipse {cx,cy,rx,ry},rect {x,y,w,h,radius?}oder{cx,cy,w,h},line {from,to},polyline {points,closed?},polygon {points},regular {cx,cy,r,sides},triangle {cx,cy,r},star {cx,cy,r,inner?,points?},heart {cx,cy,size},blob {cx,cy,r,seed?},crescent {cx,cy,r,thickness?,angle?},wave {from,to,amplitude?,waves?,phase?},spiral {cx,cy,r,turns?},arc {cx,cy,r,start,end}(Grad, 0 = rechts, im Uhrzeigersinn),path {d}(beliebiger SVG-Pfad). - Formoptionen:
id(für Keyframes abgleichen – immer setzen),fill,stroke(Farbe oderfalse),width,opacity,enter/exit(grow|pop|draw|fade|cut),delay(0–0.95, Staffelung),ease,transform {translate, rotate, scale, origin},misregister: falsefür kleine Vollkreise. - Palettennamen: ink, slate, ivory, paper, oat, kraft, clay, coral, fig, sky, cactus, olive, heather, sun, white (oder beliebiger Hex-Code).
- Easing-Funktionen: linear, in/out/inOut Quad·Cubic·Sine, inOutQuart, outExpo, inOutExpo, outBack, inOutBack, outElastic, outBounce.
Designregeln für ein gutes Aussehen
- 1200×1200 Leinwand, ca. 120 px Rand, 2–5 fette Formen pro Pose. Kleine Details wirken schlecht.
- Ink für jede Kontur, ein oder zwei Akzentfüllungen pro Pose (oat, clay, sun, sky, cactus, coral).
- Erzählen Sie eine Geschichte durch IDs: dasselbe Element verwandelt sich (Sonne → Mond, Umschlag → Papierflieger, Punkt → Herz).
- Staffeln mit
delay0 / 0.15 / 0.3; verwenden Sie"enter": "draw"für Linien, die wie geschrieben wirken sollen,"pop"für verspielte Ankünfte. - Halten 0.5–1.2 s, Morph 0.5–1.2 s.
inOutCubic= ruhig,inOutBack/outBack= verspielt,outElastic= wackelig. - Drehungen > 30° zwischen zwei Keyframes führen zu abgeschnittenen Ecken – teilen Sie große Drehungen in mehrere Keyframes auf (siehe die Presets
spinner,gears,orbit). - Solide Punkte (Augen, Tipp-Punkte):
"stroke": false, "fill": "ink", "misregister": false.
Preset-Katalog (Startpunkte)
- Benutzeroberfläche: loader, spinner, success, error, toggle, bell, search
- Natur: sunrise, sprout, rain, night, sea
- Kommunikation: chat, send, like, connect
- Ideen: idea, growth, target, gears, house
- Charaktere: smile, ghost, sparkle
- Abstrakt: drift, orbit, kaleido, pebbles
- Bewegung: bounce, pendulum, jelly
Jedes Preset kann direkt geöffnet werden: https://hacimertgokhan.github.io/geomotion/play/#preset=<name>
(fügen Sie &bg=0 für einen transparenten Hintergrund hinzu) oder im Studio: /studio/#preset=<name>.
Einbettung in eine Website
<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> <!-- der #s=…-Teil eines Share-Links -->