geomotion은(는) 무엇을 하나요?
geomotion은 JSON 스펙(키프레임 목록, 각 키프레임은 도형 목록)을 손으로 그린 듯한 애니메이션으로 변환합니다. 같은 id를 가진 도형은 키프레임 간에 서로 모핑되며, 선은 계속 "끓는"(초당 약 12회 재잉크) 효과를 유지하여 결과물이 손으로 그린 듯한 느낌을 줍니다.
사이트 및 스튜디오: https://hacimertgokhan.github.io/geomotion · 저장소: https://github.com/hacimertgokhan/geomotion
워크플로우
- 경로를 선택하세요(사용 가능한 첫 번째 경로 사용):
- MCP 도구 (
geomotion_guide,geomotion_get_preset,geomotion_render,geomotion_share_link):geomotion_guide를 한 번 호출한 후 렌더링합니다. - CLI (Node 18+ 및 네트워크 필요):
npx -y github:hacimertgokhan/geomotion render spec.json --both --formats svg,lottie,html - 도구 없음: 스펙을 작성한 다음 (이 스킬 폴더에서)
python scripts/link.py spec.json을 실행하여 사용자가 열고, 편집하고, 내보낼 수 있는 플레이어/스튜디오 링크를 얻습니다.
- MCP 도구 (
- 비슷한 프리셋이 있을 때는 프리셋부터 시작하여(아래 카탈로그 참조) id, 위치, 색상을 조정합니다.
- 아래 규칙에 따라 스펙을 작성합니다. 검증(MCP
geomotion_validate또는geomotion check spec.json)합니다. - 전달: 파일 경로 및/또는 플레이어 링크. 사용자가 조정할 수 있도록 스튜디오 링크를 언급합니다. 애니메이션이 웹사이트에 표시될 때는 투명 버전(
transparent: true또는"both")을 제공합니다.
스펙 필수 사항
{
"name": "idea",
"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": "bulb", "type": "circle", "cx": 600, "cy": 520, "r": 220, "fill": "oat" } ] },
{ "hold": 1.2, "shapes": [
{ "id": "bulb", "type": "circle", "cx": 600, "cy": 520, "r": 240, "fill": "sun" },
{ "id": "ray", "type": "line", "from": [600, 200], "to": [600, 110], "enter": "draw", "delay": 0.3 }
] }
]
}
- 키프레임:
hold(표시 시간(초)),duration(다음 키프레임으로 모핑 시간),ease. - 도형 유형:
circle {cx,cy,r},ellipse {cx,cy,rx,ry},rect {x,y,w,h,radius?}또는{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}(각도, 0 = 오른쪽, 시계 방향),path {d}(모든 SVG 패스). - 도형 옵션:
id(키프레임 간 일치시킴 — 항상 설정),fill,stroke(색상 또는false),width,opacity,enter/exit(grow|pop|draw|fade|cut),delay(0–0.95, 지연),ease,transform {translate, rotate, scale, origin},misregister: false(작고 단단한 점용). - 팔레트 이름: ink, slate, ivory, paper, oat, kraft, clay, coral, fig, sky, cactus, olive, heather, sun, white (또는 모든 16진수).
- 이징: linear, in/out/inOut Quad·Cubic·Sine, inOutQuart, outExpo, inOutExpo, outBack, inOutBack, outElastic, outBounce.
디자인 룰 - 좋은 결과를 위한 팁
- 1200×1200 캔버스, 약 120px 여백, 포즈당 2–5개의 굵은 도형. 작은 디테일은 표현이 안 좋습니다.
- 모든 외곽선은 ink, 포즈당 하나 또는 두 개의 악센트 채움색(oat, clay, sun, sky, cactus, coral).
- id를 통해 스토리를 전달하세요: 같은 요소가 변형됩니다(sun → moon, envelope → paper plane, dot → heart).
delay0 / 0.15 / 0.3으로 지연을 주고, 선이 쓰여지는 듯한 느낌이 필요하면"enter": "draw", 장난기 있는 등장에는"pop"을 사용하세요.- 홀드: 0.5–1.2초, 모핑: 0.5–1.2초.
inOutCubic= 차분함,inOutBack/outBack= 장난기,outElastic= 젤리. - 두 키프레임 사이의 회전이 30° 이상이면 선이 모서리를 자르게 됩니다 — 큰 회전은 여러 키프레임으로 나누세요(
spinner,gears,orbit프리셋 참조). - 단단한 점(눈, 타이핑 점):
"stroke": false, "fill": "ink", "misregister": false.
프리셋 카탈로그 (시작점)
- 인터페이스: loader, spinner, success, error, toggle, bell, search
- 자연: sunrise, sprout, rain, night, sea
- 커뮤니케이션: chat, send, like, connect
- 아이디어: idea, growth, target, gears, house
- 캐릭터: smile, ghost, sparkle
- 추상: drift, orbit, kaleido, pebbles
- 모션: bounce, pendulum, jelly
모든 프리셋은 바로 열 수 있습니다: https://hacimertgokhan.github.io/geomotion/play/#preset=<name>
(투명 배경을 원하면 &bg=0 추가) 또는 스튜디오: /studio/#preset=<name>.
웹사이트에 임베드하기
<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> <!-- 공유 링크의 #s=… 부분 -->