Stick scene
Kamran의 잉크 앤 버터 스타일로 그린 막대기 인물이 제품의 기능을 하나의 동작으로 보여줍니다. 장면은 대기 상태(숨 쉬기, 훔쳐보기, 턱 긁적이기)를 유지하다가 트리거되면 5~8초의 동작을 재생한 후 다시 대기 상태로 돌아옵니다. 이는 단일 <canvas>를 <stick-scene> 엘리먼트 내부에 사용하며, 외부 의존성이 없습니다.
모든 것은 kamranahmed.info/story에서 약 90개의 장면을 통해 검증되었습니다. 해당 패턴에서 시작하십시오. 새로운 드로잉 스타일을 만들지 마십시오.
파일
runtime/stick.js: 전체 런타임. 리깅(인물, 포즈, 이징, 펜), 소품 키트, 무대,<stick-scene>엘리먼트를 포함합니다. 변경 없이 프로젝트의 정적 폴더에 복사하십시오.templates/scene.js: 새 장면의 시작점 템플릿입니다.templates/preview.html+scripts/frames.mjs: 장면을 선택한 시점에서 정지 프레임으로 렌더링하여 하나의 연속 이미지 시트로 만들고 오류를 보고합니다.scripts/motion.mjs: 60fps로 장면을 단계별로 실행하고 정지 프레임에서 숨길 수 있는 결함(관절 끊김, 얼굴을 통과하는 팔, 머리를 가리는 소품, 잘못된 방향으로 꺾인 팔꿈치, 뒤로 튀어나온 팔, 찌그러진 회전, 미끄러지는 발, 닿지 않는 손, 동작 시작/끝 부분의 튐)을 보고합니다.references/craft.md: API 치트 시트, 포즈 요리책, 타이밍 레시피, 소품 레시피, 은유 카탈로그 및 이미 겪었던 실수 모음입니다. 장면을 작성하기 전에 반드시 읽으십시오.examples/: 실제 장면 예제입니다.diffity-review.js(댓글 → 에이전트 수정 → 승인, 두 인물, 보드와 책상)가 가장 깔끔한 전체 예제입니다.scenes-p3.js와scenes-p4.js에는 약 30개의 장면이 더 있으며, 은유 카탈로그(craft.md)에 각각의 매핑이 설명되어 있습니다.
워크플로우
- 제품 이해하기. 사용자가 무엇을 하고, 무엇을 얻는지 각각 한 줄로 정리하십시오. 랜딩 페이지나 README가 있다면 읽으십시오.
- 2~3가지 은유 제안하기. 사용자가 바로 진행하라고 하지 않은 이상, 선택하게 하십시오. 각 아이디어당 한 줄: 소품, 동작, 결과물. 좋은 은유는 물리적(레버, 도장, 컨베이어, 핀보드, 프레임 레일, 상자 더미)이고, 한눈에 읽히며(캡션 없이), 눈에 보이는 결과(체크 표시, 도장, 무언가 올라가거나 빛나는 것)로 끝납니다. craft.md의 카탈로그를 참조하십시오.
- 장면 작성하기.
templates/scene.js에서 시작하십시오. 먼저 고정된 세계 좌표로 소품을 배치하고, 그 다음 대기 동작, 마지막으로T초 동안의 타임라인으로 동작을 작성하십시오.label에는 스크린 리더를 위한 평이한 문장을 제공하십시오. - 연속 이미지 시트로 확인하기. 작업이 완료되었다고 판단하기 전에 모든 시트를 확인하십시오.
# 한 번, 임시 디렉토리에서: npm i [email protected] NODE_PATH=<scratch>/node_modules node <skill-dir>/scripts/frames.mjs \ --scene <id> --src path/to/scene.js \ --frames "idle:0,idle:2.5,s:0.8,s:1.6,s:2.4,s:3.2,s:4.0,s:5.0" --fw 400 --out /tmp/<id>.png<skill-dir>는 이 SKILL.md가 있는 폴더입니다. 그런 다음 PNG를 읽으십시오.idle:<sec>는 대기 루프를 정지시키고,s:<sec>는 동작 중 특정 시점,u:<0..1>은 동작의 일부 비율을 나타냅니다.@<n>을 추가하면 n번째 재생을 렌더링하므로(s:2.4@1),S.n에 따라 변하는 장면의 모든 변형을 확인할 수 있습니다. 다음 조건을 만족할 때까지 수정하고 다시 렌더링하십시오: 가장자리가 잘리지 않음, 소품이 얼굴이나 설명 중인 대상을 가리지 않음, 모든 비트가 자체적으로 읽힘, 텍스트가 박스 안에 상하 여유 공간을 두고 위치함, 손은 잡고 있는 것의 앞에 위치함, 잡고 있는 것이 실제와 같이 신체에 닿음(마이크는 입에, 손잡이는 손바닥에), 화살표는 손으로 그린 갈매기 모양(채워진 삼각형 아님), 마지막 프레임이 대기 상태와 일치함(루프로 돌아갈 때 튀지 않음). 보통 2~3회 반복합니다. 그런 다음 시트로 확인할 수 없는 모션을 확인하십시오:"motion is clean"이 출력될 때까지 모든NODE_PATH=<scratch>/node_modules node <skill-dir>/scripts/motion.mjs --scene <id> --src path/to/scene.jsjump(포즈를 전환하지 않고 블렌딩),arm-through-face,head-covered(얼굴 위에 그려진 소품, 메모 또는 말풍선),bent-back-elbow,elbow-out-back(날개가 부러진 팔이 잠시라도 유지되는 경우),squash,start-pop,end-pop을 수정하십시오. 걷기 동작의 시작이나 끝에서 짧은skate는 허용됩니다. - 삽입하기.
runtime/stick.js와 장면 파일을 사이트의 정적 폴더에 복사하고 다음을 추가하십시오:Astro에서는<stick-scene scene="<id>" play="view" style="height:230px; max-width:560px"></stick-scene> <script src="/scenes/stick.js" defer></script> <script src="/scenes/<id>.js" defer></script><script is:inline ... defer>를 사용하십시오.stick.js는 문서 순서상 모든 장면 스크립트보다 먼저 와야 합니다(지연된 스크립트는 순서대로 실행되며, 장면은 로드 시window.RIG를 읽습니다). 여러 장면이 있는 랜딩 페이지에서는 각 장면을 프레임 안에 넣어 바닥 선 위에 떠 있지 않도록 하십시오: 둥근 모서리 카드, 1px 테두리, 흰색 배경, 희미한 점선 그리드(radial-gradient(#e6e6e6 1px, transparent 1.2px)at 14px), 바닥 밴드를 유지(no-floor사용 안 함); 그러면 바닥 선이 마치 작은 무대처럼 가장자리까지 이어집니다. 페이지의 모든 장면에 동일한 프레임과 전체 콘텐츠 너비를 제공하십시오. 그런 다음 실제 페이지를 헤드리스 브라우저에 로드하고, 요소가 뷰에 들어올 때까지 스크롤한 후 약 3초 동안 기다렸다가 데스크탑 및 모바일 너비로 스크린샷을 찍으십시오.
엘리먼트
scene:SCENES['<id>']로 등록된 id입니다.play:view(절반이 보일 때 한 번 재생, 그 후 클릭 시 재생; 랜딩 페이지에 가장 적합한 기본값),click,hover(마우스가 위에 있는 동안 반복, 터치 시 클릭),loop(항상 재생, 드물게 사용),idle(재생 안 함).no-floor: 바닥 선 아래 밝은 회색 밴드를 제거합니다. 흰색 페이지에서 사용하십시오.no-ground: 바닥 선도 제거합니다.zoom: 상자 내부의 그림을 확대/축소합니다 (기본값 1).label또는aria-label: 장면이 보여주는 내용입니다. 기본값은 장면의label입니다.no-font: Google Fonts에서 Balsamiq Sans를 로드하지 않습니다 (사이트에서 이미 자체 호스팅하거나 Google을 호출할 수 없는 경우).- CSS로 크기를 지정하십시오. 그림은 높이(230px이 기본 크기)와 장면의 세계 좌표
width에 맞춰 중앙 정렬됩니다. - Reduced motion 모드에서는 한 프레임을 정지 상태로 표시하고 재생하지 않습니다. 화면 밖의 장면은 그리지 않습니다.
STICK.theme({ butter: '#…', greenInk: '#…' })는 페이지 전체의 팔레트 색상을 변경합니다. 오직 한 장면에만 필요한 경우(diffity-review.js의 GitHub 추가/삭제 녹색과 같이) 장면 내에서 지역 색상 상수를 사용하는 것이 좋습니다.
스타일 규칙
- 잉크
#141414, 흰색 종이 채움, 하나의 버터 또는 악센트 하이라이트, 많은 여백. 단어는 Balsamiq Sans 8.5~11pt로, 몇 단어만 사용하십시오. - 인물이 주인공입니다: 머리나 활동하는 손을 소품 뒤에 숨기지 마십시오. 소품을 먼저 그리고, 그 다음 인물, 그 다음 잡고 있거나 날아가는 것을 그리십시오.
- 장면당 하나의 아이디어. 설명을 위한 캡션이 필요하다면 은유가 잘못된 것입니다.
- 작업 자체보다는 결과를 보여주십시오: 상태가 변경되어 잠시 유지되는 것으로 끝나야 합니다.
- 그려진 동물이나 세부 캐릭터보다는 물리적 객체를 사용하십시오. 두 번째 인물(도우미)은
ink/far로 단일 색상을 받습니다. AI 에이전트는 로봇입니다:fig(..., { ink: '#d97757', far: '#e8b7a3', bot: { col: '#d97757', dark: '#a8553a', glow, blink, happy } })는 둥근 머리, 어두운 바이저, 빛나는 눈, 귀 볼트, 안테나 전구 및 가슴 조명을 그립니다. 두 번째 에이전트는 청록색(#3d7a8c, dark#2a5866, far#a9c9d1)을 사용하십시오. 검은색 에이전트도 가능합니다: 어두운col은 자동으로 흰색 바이저와 잉크 눈을 얻습니다. 작업 중에는 밝은glow, 완료 시happy, 각 인물 아래y = 16에 작은 레이블(you,agent,claude)을 추가하십시오. - 에이전트는 즉시 반응하지 않아야 합니다. 요청이 도착한 후, 작업을 시작하기 전에 잠시 멈춤(
thinking…라인,hmm…말풍선, 턱을 괴는 손, 느린 안테나 깜빡임)을 유지하십시오. - 다른 회사의 로고를 사용하지 마십시오. 소품에 일반 텍스트로 된 제품 이름은 괜찮습니다.