Community이미지github.com

paper-brush

평평한 종이 오리기 그림(초상화, 아바타, 캐릭터, 장면, 아이콘)을 이미지 모델 없이 결정론적 코드로 그리는 도구입니다. 한 세트를 동일한 종이 스타일로 유지하거나 일관된 그림을 추가할 때 사용합니다.

paper-brush란 무엇인가요?

Paper Brush는 AI 에이전트가 평평한 종이 오리기 삽화를 결정론적으로 렌더링할 수 있게 해주는 기술 스킬입니다. 각 그림은 색깔 있는 종이 모양을 짧게 쌓아 올린 것으로, 모든 모양은 펜 도구 경로를 따라 잘라집니다. 동일한 드로잉 파일을 입력하면 항상 동일한 픽셀 이미지를 출력하므로, 세트 내 일관성이 유지되며 몇 개의 숫자만 수정하여 모양을 조정할 수 있습니다. 이 스킬은 Claude Code, Cursor, Codex, Windsurf, Cline 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있습니다. 렌더러는 Python 코드 블록으로 제공되며, numpy와 opencv-python을 필요로 합니다. 사용자는 참조 파일에서 엔진 파일과 예제 드로잉 파일을 추출하여 프로젝트에 설정한 후, 명령어를 통해 노드를 추출하고 렌더링합니다. 워크플로우는 스타일 가이드 준수, 드로잉 파일 설정, 참조 그리드 위에서 좌표 읽기, 마스크로 모양 대략 잡기, 렌더링, 비교 및 조정, 최종 전달 순으로 진행됩니다. 기존 세트에 맞출 때는 먼저 규칙을 문서화하고, 하나의 참조를 다시 그려 보정한 후, 부품을 추출하여 재사용함으로써 일관된 손길을 유지합니다. 얼굴 드로잉에서는 눈 위치를 기준으로 한 머리 축을 정의하여 부품을 재사용하고 미러링할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hanlianlu/paper-brush/tree/HEAD/skills/paper-brush

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Paper brush(紙藝畫筆)

평평한 종이 오리기 그림을 위한 결정론적 렌더러입니다. 모든 그림은 색깔 있는 종이 모양을 짧게 쌓아 올린 것으로, 각 모양은 펜 도구 경로를 따라 잘라집니다. 동일한 드로잉 파일을 입력하면 항상 동일한 픽셀을 출력하므로 세트가 일관되게 유지되며, 몇 개의 숫자만 수정하여 모양을 조정할 수 있습니다. 종횡비, 종이 색상 및 크기는 자유롭게 설정할 수 있습니다.

엔진 설정(프로젝트당 한 번): 렌더러는 references/engine.md에 코드 블록으로 제공됩니다. 다시 입력하지 말고 명령어로 복사하세요: awk '/^```python$/{f=1;next} /^```$/{f=0} f' references/engine.md > DIR/paper.py. 여기서 DIR은 프로젝트의 아트 폴더(또는 임시 폴더)입니다. 같은 명령어로 references/example_drawings.md를 시작용 드로잉 파일로 변환합니다. python3 paper.py ...로 실행합니다(numpy와 opencv-python 필요). 아래 명령어는 이 파일이 있다고 가정합니다. paper.py가 이미 존재하면 재사용하세요.

스타일(지키세요)

그리기 전에 references/style.md를 읽으세요. 간단히 요약하면: 큰 모양 몇 개; 긴 호와 함께 적은 수의 노드; 실제 모서리는 모서리로 표시; 재질당 2~3가지 톤(기본, 그림자, 때로는 밝은 톤); 그림자는 부모 내부에 클리핑된 깔끔한 모양으로, 종종 한쪽은 단단한 가장자리, 다른 쪽은 흐려지는 가장자리; 모양 주위에 윤곽선 없음; 펜 선이 있을 만한 곳(눈썹, 속눈썹, 입, 주름)에만 선이 있으며 항상 가늘어짐; 블러는 볼터치에만 사용; 따뜻한 오프화이트 종이와 미세하고 균일한 전체 그레인.

워크플로우

  1. 드로잉 파일 설정: 프로젝트에(예: Tools/art/drawings.py) DRAWINGS = {"name": {...}}를 담은 파일을 만드세요. 형식은 paper.py의 독스트링에 있습니다(인수 없이 python3 paper.py를 실행하면 출력됨). references/example_drawings.md의 드로잉 파일에서 시작하세요.
  2. 작성 그리드 선택 및 가능하다면 그 위에 놓인 참조 그림(스케치, 그림, 승인된 이미지)을 준비하세요. 알려진 스케일로 노드 좌표를 읽으세요. h = lambda *p: [(x/2, y/2, *r) for x, y, *r in p]와 같은 작은 람다는 참조의 픽셀을 변환합니다.
  3. 필요시 마스크에서 모양 대략 잡기: 영역의 흑백 마스크(색상 임계값, 손 마스크)를 만들고 python3 paper.py nodes MASK.png [scale]을 실행하세요. 이미 모서리가 찾아진 노드를 출력합니다. 그런 다음 수동으로 얇게 만들고 정리하세요. 수동 과정이 추적된 것처럼 보이지 않고 오려낸 것처럼 보이게 만듭니다.
  4. 렌더링: python3 paper.py path/to/drawings.py OUT_DIR [name …] → OUT_DIR/<name>.png.
  5. 보고, 비교하고, 조정하세요. 결과를 참조(또는 승인된 세트) 옆에 실제로 보일 크기로 놓고(예: ffmpeg -i a.png -i b.png -filter_complex hstack cmp.png), 열어보세요. 한 번에 한 가지씩 수정하세요: 노드, 톤, 클립. 여러 라운드가 필요할 수 있습니다. 소유자가 승인하면 커밋하세요.
  6. 전달: 프로젝트의 크기와 형식으로( Lanczos로 다운스케일; JPEG q≈88 또는 PNG). 이미지는 ≤ 2K로 유지하세요. 프로젝트가 아트에 워터마크를 넣는다면 승인 후, 배송 전에 적용하세요.

기존 세트에 맞추기

이미 스타일이 있는 세트에 새 그림을 추가해야 할 때(승인된 아바타 옆에 새 아바타), 순서는 규칙 먼저, 그린 후, 반복입니다:

  1. 참조를 연구하고 규칙을 기록하세요. 확대하고 측정하세요: 가장자리가 어떻게 구성되는지, 재질당 톤, 그림자 모양의 위치와 두께, 머리 축에서 특징 크기와 위치, 머리가 프레임을 얼마나 차지하는지, 종이 색상과 그레인.
  2. 보정: 브러시로 참조 중 하나를 다시 그리고, 원본 옆에 놓고 일치할 때까지 조정하세요.
  3. 스타일을 전달하는 부품 (눈, 눈썹, 귀 안쪽)을 참조에서 추출하세요: python3 paper.py lift REF.png X Y [tol] --eyes x1,y1,x2,y2는 픽셀 X,Y 아래의 평평한 모양을 그 머리 축 위의 노드로 출력합니다. 겹쳐서 확인하세요. 피부에 떨어지면 시드 위치를 이동하세요.
  4. 소스 위에 그리기: python3 paper.py grid SOURCE.jpg grid.png는 좌표를 읽기 위한 격자 복사본(20px 간격 선, 100px 간격 레이블)을 제공합니다. 모양당 노드는 적게: 얼굴 약 16개, 머리카락 덩어리 20~40개.
  5. 공개 전 혼합 테스트: 새 그림과 참조를 썸네일 크기(약 480px)로 하나의 그리드에 섞어 보여주세요. 새 그림이 눈에 띄면 완료되지 않은 것입니다. 그런 다음 각각을 가장 가까운 참조 옆에 전체 크기로 확인하세요.

통하지 않는 방법: 상상에서 모양을 만드는 것(모든 얼굴이 똑같이 나옴); 컬러로 사실적인 그림을 추적하는 것(덩어리를 복사함); 참조를 자동 벡터화하는 것(얼룩덜룩함); 사실적인 얼굴에서 특징 위치를 그대로 복사하는 것(입이 너무 낮아 얼굴이 길고 늙어 보임); 그림의 어두운 영역에서 그림자 모양을 가져오는 것(얼룩).

머리 축 위의 일반적인 얼굴 배치(자신의 세트를 측정하세요): 눈썹 y 약 −0.8, 눈선과 평행; 코는 먼 쪽의 짧은 갈고리, x −0.3~−0.65, y 0.451.15; 입은 y 1.61.8에서 약 1.1 단위 너비, 눈과 거의 평행하며, 양 끝이 거의 같은 높이(한쪽 끝이 올라가면 비웃는 표정으로 읽힘); 턱 y 2.8~3.1. 각 캐릭터에 고유한 머리카락 실루엣, 눈과 눈썹 모양, 팔레트를 부여하세요. 그렇지 않으면 세트가 한 얼굴로 쏠립니다. 꽉 감긴 컬, 땋은 머리, 털에는 scallop()을 사용하세요. 니트 칼라에는 ribs()를; 렌즈와 버튼에는 oval()을 사용하세요(from paper import scallop, ribs, oval).

얼굴: 재사용 가능한 부품

일치하는 얼굴 세트의 경우 각 드로잉에 "eyes": ((x, y), (x, y))를 부여하세요. 이는 머리의 자체 축(눈선 따라 x, 얼굴 아래로 y, 단위 = 눈 거리의 절반)을 정의하므로, 특징을 한 번 작성하여 모든 머리에 설정할 수 있습니다:

  • {"head": True, "stroke": [...], "w": 0.12, "color": ...} — 노드는 머리 단위(너비도 포함).
  • {"part": ("setname", "eye_l"), "fill": ..., "scale": 1.1, "shift": (0, 0.05), "turn": 4} — 드로잉 파일 옆에 있는 parts.py에서 가져온 부품: PARTS = {"setname": {"eye_l": {"nodes": [...]}, ...}}, 노드는 머리 단위. 승인된 그림에서 한 번 부품을 추출하고(부품의 마스크를 nodes로 추적, 머리 단위로 변환), 그 후 모든 새 얼굴에서 이를 재사용하여 세트가 한 손으로 만든 것처럼 보이게 합니다.
  • "mirror": True는 다시 그리지 않고 얼굴을 반대 방향으로 돌립니다.

주의사항

  • 모양은 순서대로 그려집니다. "clip"은 동일한 "name" 아래 이미 그려진 모양만 봅니다.
  • 동일한 "name"을 가진 여러 레이어는 합쳐집니다(union), 두 조각으로 만든 몸체에 유용합니다.
  • "fade" 포인트는 그리드 좌표에 있습니다: 첫 번째에서 강하게, 두 번째에서 사라집니다.
  • "soft"는 그리드 단위입니다. 볼터치와 광택에만 사용하세요.
  • 드로잉은 from paper import flow, scallop, ribs, oval을 사용할 수 있습니다. 엔진 폴더가 경로에 있습니다.
  • 드로잉이 작은 모양이나 윤곽선으로 흩어지지 않도록 하세요. 세부 사항에 선이 필요하다면, 두 번째 톤 모양이 더 잘 표현할 수 있는지 생각해보세요.

관련 스킬