Community이미지github.com

스프라이트 스태킹

네 장의 직교 픽셀 뷰를 돌릴 수 있는 가짜 3D 스택으로 깎고, Canvas, Godot, Unity, Phaser용 또렷한 턴테이블을 렌더한다.

스프라이트 스태킹란 무엇인가요?

스프라이트 스태킹 파이프라인. 왼쪽이 바닥, 오른쪽이 지붕인 탑뷰 슬라이스 띠를 아래에서 위로 그리고, 같은 각도로 돌리고, 카메라 기울기에 맞춰 납작하게 하고, 한 층에 1픽셀씩 올린다. 슬라이스 띠, 4면 시트, 프롬프트에서 시작할 수 있다. 렌더해서 보지 않은 스택은 끝내지 않는다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/danielwh2/sprite-stacking/tree/HEAD/skills/sprite-stacking

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

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

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

문서

스프라이트 스태킹은(는) 무엇을 하나요?

객체는 평평한 상향식 슬라이스들의 수평 스트립이며, 바닥 슬라이스는 왼쪽에, 지붕은 오른쪽에 있습니다. 아래에서 위로 그리며, 각 슬라이스를 같은 각도로 회전시키고, 카메라 피치를 위해 수직으로 압축하고, 슬라이스당 1픽셀씩 들어 올립니다. 하나의 작은 시트로 모든 각도를 선명한 픽셀로 얻을 수 있습니다.

렌더링하고 확인하지 않은 스택은 절대 출시하지 마십시오. 아래 경로는 이 스킬의 폴더를 기준으로 합니다.

0. 경로 선택

무엇을 가지고 계신가요?
├── 슬라이스 스트립 PNG 또는 MagicaVoxel 레이어 내보내기 ──▶ 3단계 (렌더링)
├── 4면 시트 (위, 옆, 앞, 뒤) ────────────────────────▶ 1단계 게이트 ─▶ 2단계 (조각)
└── 프롬프트 또는 아이디어 ──────────────────────────▶ 1단계 ─▶ 2단계 ─▶ 3단계

기존 프로젝트에서는 먼저 렌더러(엔진, 픽셀 스케일, 스프라이트를 그리고 정렬하는 방식, 회전하는 객체)를 읽으십시오. 그 렌더러에 스택을 맞추십시오. 두 번째 캔버스나 렌더 파이프라인을 절대 추가하지 마십시오.

1. 4면 시트 얻기

시트: 순서가 TOP, SIDE, FRONT, BACK인 하나의 1x4 행이며, 평평한 흰색 배경에 뷰 사이에 명확한 간격이 있습니다. TOP은 바로 아래를, 앞면은 아래를 향합니다. SIDE는 앞면이 왼쪽을 향합니다. 네 뷰 모두 동일한 축척입니다.

등급을 선택하십시오:

  • 덩어리진 레트로: 15-20개 슬라이스, 약 25×48 px. 굵은 실루엣, 3-4 px 줄무늬, 8-10배율로 표시.
  • 상세한 하이비트: 26-44개 슬라이스, 36×72 ~ 46×107 px. 통풍구, 로고, 살이 있는 림, 유리 반사, 돌출 스포일러를 담습니다.
  • 쇼케이스 / 1080p 비디오: 36-56개 슬라이스, 30×30 ~ 148×148 px, 4-6배 정수 스케일로 표시. 작은 스프라이트가 HD 비디오에서 7-9배로 확대될 때 발생하는 덩어리진 실루엣 스테핑과 회전 불안정성을 방지합니다. 360°에서 깔끔하게 읽히는 건축적 미세 디테일(셔터, 플라워 박스, 발코니 난간, 지붕 이끼, 수련 잎, 등 기둥, 절벽 덩굴, 폭포)은 팔레트 규율을 깨지 않으면서 디오라마를 한 단계 높여줍니다.

그런 다음 적용되는 첫 번째 소스를 사용하십시오.

a. 이미지 생성 도구가 있습니다. 다음 프롬프트를 사용하십시오. 주제를 바꾸고 나머지는 그대로 유지하십시오:

[주제]의 덩어리진 픽셀 아트 직교 모델 시트. 풍부한 3톤 색조 이동 픽셀 음영(깊고 차가운 색조의 그림자, 채도가 높은 중간색, 능선과 가장자리를 따라 밝고 따뜻한 상단 하이라이트), 굵은 3-4px 줄무늬/악센트, 유리의 선명한 반사 픽셀. 완전히 평평한 단색 흰색 또는 옅은 회색 배경에 깔끔한 1x4 수평 행(또는 2x2 그리드)의 네 가지 뷰:
1. 바로 아래를 내려다보는 TOP 뷰, 앞면은 아래를 향합니다.
2. SIDE 뷰, 앞면은 왼쪽을 향합니다.
3. FRONT 뷰.
4. BACK 뷰.
엄격한 직교: 원근법, 기울기, 3/4 각도가 전혀 없습니다. 네 뷰 모두 동일한 축척이므로 길이, 너비, 높이가 픽셀 단위로 일치합니다. 각 뷰 주위에 굵은 1px 어두운 외곽선, 단색 평면 색상 클러스터, 선명한 내부 패널 음영, 안티앨리어싱 없음, 부드러운 가장자리 없음, 바닥 그림자 없음, 격자선 없음, 텍스트 없음, 뷰 사이에 넉넉한 빈 공간.

b. 사용자가 시트를 가지고 있습니다. 그것을 사용하십시오.

c. 둘 다 아닙니다. 짧은 Python/PIL 스크립트로 네 가지 뷰를 픽셀 아트로 직접 그리고 기본 해상도에서 아트 픽셀당 한 픽셀(numpy 배열 또는 ImageDraw)로 그리십시오. 각 뷰에 1px 어두운 외곽선을 주고, 길이, 너비, 높이가 모든 뷰에서 동일하게 유지되도록 하고, Image.NEAREST로 8배 확대한 후, 뷰 사이에 최소 40px 간격을 두고 평평한 흰색 배경에 한 행으로 붙여넣으십시오. --slices를 외곽선을 포함한 SIDE 뷰의 기본 높이로 설정하여 조각하면 슬라이스가 픽셀에 다시 맞춰집니다.

슬라이서는 모든 뷰가 덮는 곳에만 복셀을 유지하므로 (c)의 경우:

  • 둥근 물체(화분, 캐노피, 돔, 위에서 본 바퀴)는 TOP 뷰에 픽셀 원이 필요합니다. 정사각형 TOP은 상자를 조각합니다. 둥근 부분이 가장 넓은 부분보다 좁은 경우(넓은 받침대 위의 탑, 바구니 위의 풍선) --round를 사용하여 조각하십시오. 그렇지 않으면 정사각형으로 나옵니다.

  • 지느러미, 잎, 날개 및 불규칙한 평면 모양은 TOP 뷰에 실제 윤곽선이 필요합니다. 그렇지 않으면 블록으로 조각됩니다.

  • SIDE 및 FRONT 실루엣은 프로필을 설정합니다. 직사각형은 원통을 만들므로 공의 경우 둥글게 만드십시오.

  • 벽 디테일(창문, 문, 패널 라인)은 SIDE, FRONT 및 BACK에 들어갑니다. 지붕 디테일은 TOP에 들어갑니다.

  • 벽에서 튀어나온 것(플라워 박스, 현관, 표지판)은 그 벽 전체를 따라 선반을 조각합니다. 작은 돌출부는 평평하게 칠하고, 굴뚝에는 서 있을 평평한 능선 스트립을 제공하십시오.

  • 3-4톤 색조 이동 램프로 음영 처리하십시오: 차갑고 깊은 그림자, 채도가 높은 중간색, 따뜻한 하이라이트. 그라데이션, 안티앨리어싱이 없습니다.

  • 물체를 중앙에 배치하십시오. 스택은 경계 상자의 중간을 중심으로 회전하므로 한쪽으로 더 멀리 뻗은 베이스는 축에서 벗어나 궤도를 돌게 만듭니다.

게이트: 슬라이싱 전에 시트 확인

  1. 방향: TOP 앞면은 아래를 향합니다. SIDE 앞면은 왼쪽을 향합니다(오른쪽인 경우 --side-nose right 전달).
  2. 비율: TOP 길이 = SIDE 길이, TOP 너비 = FRONT/BACK 너비, SIDE 높이 = FRONT/BACK 높이.
  3. 하드 에지: 평면 채우기, 선명한 외곽선. 부드러운 에어브러시 가장자리 또는 얇은 1px 내부 라인은 슬라이스가 회전하면 번집니다. 복구하지 말고 재생성하거나 다시 그리십시오.
  4. 구멍: SIDE 뷰에서 빛이 비치는 돌출부(올라간 후방 날개)는 살아남습니다. 네 실루엣 모두에서 숨겨진 공동(트럭 적재함, 속이 빈 아치)은 채워집니다. 조각 후 해당 슬라이스를 손으로 수정하십시오.
  5. 교훈: 이 파일 끝에 있는 교훈 표를 확인하십시오.

2. 조각 및 검사

scripts/views_to_slices.py는 Pillow 및 NumPy가 있는 Python 3이 필요합니다. 배경(투명 또는 평면)을 제거하고, 1px 뷰 외곽선을 제거하고, 하나의 공유 팔레트로 양자화하고, 슬라이스를 조각한 다음, 검사 시트와 독립 실행형 뷰어를 작성합니다.

python3 scripts/views_to_slices.py views.png slices.png \
  --slices 36 --shade 0.2 --preview check.png --html viewer.html
플래그기본값변경 시기
--slices N자동 (SIDE 뷰가 64px보다 높으면 36, 그렇지 않으면 기본값)15-20 덩어리짐, 32-48 하이비트, 그려진 시트의 기본 높이, 0은 시트의 원시 픽셀 유지
--orderautoauto는 비율 일치(TOP 길이 = SIDE 길이, TOP 너비 = FRONT 너비, SIDE 높이 = FRONT 높이)로 TOP과 SIDE를 선택합니다. 동점일 경우 읽기 순서가 우선합니다. reading은 TOP, SIDE, FRONT, BACK을 강제합니다
--round끄기탑, 풍선, 화분, 병: 각 슬라이스를 SIDE 및 FRONT 범위가 설명하는 타원으로 자릅니다. 지느러미, 날개 및 상자에는 사용하지 마십시오
--side-noseleftSIDE 뷰가 오른쪽을 향하면 right
--top-noseauto자동은 자동차 캐빈을 읽습니다. 차량이 아닌 것은 down을 전달하고, 자동차가 뒤집히면 up 또는 down을 전달합니다
--shade0.2풍부하게 음영 처리된 뷰의 경우 0.12-0.15, 평면 뷰의 경우 0.25, 없음의 경우 0
--colours24세부 도장의 경우 32-48, 모든 색상을 유지하려면 0
--bg-tol28JPEG 노이즈가 프린지를 남기면 약간 높이십시오
--dark-thresh70매우 어두운 실루엣의 외곽선을 유지하려면 0
--normals(없음)일치하는 3D 법선 맵 슬라이스 스트립 PNG 저장
--emissive(없음)자동 감지된 방출 마스크 스트립 PNG 저장

조각 직후 check.png를 열어 확인하십시오: 추출된 네 개의 뷰, 네 개의 턴테이블 각도 및 분해도. 통합 코드를 작성하기 전에 이 작업을 수행하십시오. viewer.html은 브라우저에서 턴테이블, 씬(리빙 디오라마: 네온 스트리트 / 메도우 아일랜드(절차적 스택 소품 + 다중 PNG 소품 드롭 포함)), 슬라이스 스캔, 분해도 및 재생 모드(무한 스트리트/메도우/그리드 월드 드라이브 스루, 바람, 산산조각), 실시간 시간대(낮 → 일몰 → 밤(자동 방출 광선 및 투영된 3D 그림자 포함)), 날씨(비(물결치는 젖은 반사 및 잔물결 포함), 눈(normZ 적설 축적 포함)) 및 16방향 PNG 내보내기를 지원합니다.

3. 렌더링: 루프와 숫자

모든 렌더러는 아래에서 위로 동일한 루프를 실행합니다:

// sheet: `count`개의 슬라이스로 구성된 수평 스트립. 각각 w × h, 바닥 슬라이스는 z = 0
// pos: 지면 접촉 중심, 전체 픽셀로 반올림됨
for (let z = 0; z < count; z++) {
  // 1. 슬라이스를 중심(-floor(w/2), -floor(h/2))을 기준으로 `turn`만큼 회전
  // 2. y를 `squash`(카메라 피치)로 확대/축소
  // 3. -round(z * spacing)만큼 들어 올림
  // 4. 전체 픽셀 `pos`로 변환, 가장 가까운 필터링으로 그리기
}

이것들을 추측하지 마십시오:

  • spacing = 1.0 아트 픽셀 스케일의 화면 px.
  • squash = 0.75 경사진 상향식 카메라의 경우. 1.0은 바로 아래를 봅니다. 0.6 미만이면 지붕이 얇은 조각으로 평평해집니다. 기울어지는 카메라의 경우 squash = sin(elevation), spacing = cos(elevation).
  • 대칭 회전 중심. 소프트웨어/픽셀 버퍼 래스터라이저에서는 Math.round(...) 가장 가까운 샘플링으로 (w - 1) * 0.5, (h - 1) * 0.5 주변을 샘플링합니다. 짝수 크기 슬라이스에서 Math.floor(... + w / 2)를 사용하면 중심이 0.5 아트 픽셀만큼 이동하여 90°/180°/270° 회전에서 눈에 띄는 회전 불안정성이 생성됩니다.
  • 부드러운 60fps 배치. 연속 모션(보빙, 부유, 궤도, 부모-자식 투영)을 부동 소수점 화면 픽셀로 유지하고 정수 디스플레이 scale로 최종 1-화면-픽셀 블릿(Math.round(dx), Math.round(dy))에서만 한 번 스냅합니다. 모션을 아트 픽셀 단계(Math.round(...) * scale)로 양자화하거나 자식 투영을 독립적으로 반올림하지 마십시오. 둘 다 거친 다중 픽셀 점프와 소품 대 지면 지터를 유발합니다.
  • 로드 시 스트립 개수 확인. 스트립을 슬라이싱할 때 sheet.width % count === 0(및 예상 슬라이스 치수)을 어설션하여 스트립의 슬라이스 개수를 업그레이드해도 조용히 중간 프레임이 슬라이싱되지 않도록 하십시오.
  • 최근접 이웃 필터링. 웹에서는 imageSmoothingEnabled = false 및 image-rendering: pixelated, 엔진에서는 Nearest/Point 필터.
  • 바닥 그림자: 차량의 경우 z = 0에서의 합집합 발자국, 오프셋 +2, +3 아트 px, 슬라이스 0 앞에 그려짐. 키가 큰 소품의 경우, 일반적인 타원이 아닌 Bayer 4×4 디더링된 가장자리로 레이어당 태양 벡터를 따라 쌓인 슬라이스를 투영합니다.
  • 완성된 스택을 한 번, 절대 슬라이스별로 외곽선을 그리지 마십시오. 슬라이스별 외곽선은 몸체를 통해 이음새와 반점을 그립니다. 1x 아트 픽셀 버퍼로 렌더링하고, 알파 주위에 1px 외곽선을 추적한 다음 확대합니다.
  • 방향: 시트의 앞면은 아래쪽(+y)을 가리키므로 turn = atan2(vy, vx) - PI / 2입니다. 반전되는 항목의 경우 원시 속도가 아닌 저장된 방향에서 turn을 구동하십시오.
  • 전체 스택을 지면 지점으로 Y-정렬하십시오. 두 객체의 슬라이스를 절대 인터리브하지 마십시오.
  • 정적 스택을 로드 시 일반 스프라이트로 구우십시오. 나무 200개 × 슬라이스 30개는 프레임당 6,000번의 드로우입니다.
  • 슬라이스로 입장을 애니메이션 처리하고 불투명도 페이드는 사용하지 마십시오. 공중에서 스택을 페이딩하면 평평해 보입니다. 바닥에 고정된 소품을 슬라이스별 lifts(부드러운 스프링 안착 및 지면 링이 있는 슬라이스 블룸)를 통해 아래에서 위로 성장시키고, 공중/수중 스택(구름, 보트)을 이동 궤적을 따라 미끄러지듯 안착시킵니다. lifts 공개 범위를 count 너머로 슬라이스별 블렌드 너비(mix(start, count + width, ...))만큼 확장하여 상단 슬라이스가 lifts를 null로 다시 전환하기 전에 전체 spacing에 도달하도록 하십시오. 그렇지 않으면 상단 슬라이스가 한 프레임에 스냅됩니다. 비디오에서 defocus 컷으로 선명한 스택을 흐리게 하지 마십시오. 대신 연속적인 카메라 움직임을 사용하십시오.
  • 슬라이스별 오프셋을 통한 유기적 흔들림, 3D 피치 기울기 및 몸체 물결. 고정된 유연한 소품(다시마, 잔디, 배너)의 경우 각 슬라이스를 sin(t * freq - z * wave + phase) * amp * (z / (count - 1))²만큼 수평으로 오프셋하여 z = 0은 고정되고 끝은 부드럽게 흔들리도록 합니다. 도약하는 생물(돌고래가 돌진 시 코를 위로 → 정점에서 수평 → 재진입 시 코를 아래로) 또는 구르는 선박의 경우 몸체 축을 따라 (z - centerZ) * sin(pitchAngle)에 비례하는 슬라이스별 종/횡 방향 기울기 오프셋 (xOffsets, yOffsets)을 적용하여 피치와 롤이 평평한 수직 리프트가 아닌 실제 3D 기울기로 읽히도록 합니다.
  • 기본 코 축을 확인하고 수중 스택을 깊이 감쇠 처리하십시오. turn = atan2(vy, vx)를 바인딩하기 전에 각 스트립의 코가 +x, +y 또는 -y를 향하는지 확인하여 선박과 생물이 코부터 이동하도록 합니다. 물에 잠긴 스택(해저 소품, 심해 만타, 수중 돌고래 단계)의 경우 Beer-Lambert 깊이 착색(빨간색을 수생 색조로 탈색)을 적용하고 단단한 외부 외곽선을 부드럽게 하거나 생략합니다. 부유하는 스택의 히브, 피치 및 롤을 공유 파동장(순간 파고가 아님)에 대한 감쇠된 스프링-질량 응답에서 구동합니다.

web Canvas, React, Godot, Unity 또는 Phaser에 연결할 때 references/engines.md를 여십시오. scripts/viewer.html은 완전한 웹 참조입니다: 버퍼, 외곽선, 궤도, 스캔, 분해도, 내보내기.

4. 완료 조건

  • 바로 아래: squash = 1, turn = 0에서 렌더링은 슬라이스 하나 너비이고 sliceHeight + count - 1 px 높이입니다.
  • 피치 및 90°: 0.75는 1.0보다 눈에 띄게 짧습니다. 90°에서 너비는 sliceHeight와 같습니다.
  • 간격: 0은 평평하게(상단 슬라이스만) 그리고, 2.5는 모든 레이어를 깔끔하게 분리합니다.
  • 깨끗한 대각선: 45°에서 몸체 내부에 수평 줄무늬나 어두운 반점이 없습니다.
  • 방향: 원을 그리며 주행하면 앞면이 경로를 유지합니다. 후진하면 방향을 유지합니다.
  • 느린 회전: 작은 스프라이트가 끊겨 보이면 먼저 정수 디스플레이 배율을 높이십시오. 긴 직선 가장자리가 여전히 크롤링되는 경우에만 RotSprite를 시도하고 눈으로 비교하십시오. 아주 작은 스프라이트를 반올림합니다.
  • 전체 회전: 네 개가 아닌 모든 각도를 보십시오. 나타났다 사라지는 부분은 교훈 행입니다.

교훈

스택이 잘못 나오면 수정한 다음, 재발하지 않도록 원인을 수정하십시오: 실수가 발생할 수 없도록 슬라이서를 변경하거나, 수정 사항이 포함된 메시지로 경고하도록 만들고, 실제 실수로 빌드된 tests/check.py에 변경 전에 실패하는 케이스를 추가하십시오. 코드가 볼 수 없는 판단 호출만 규칙이 됩니다. 여기에 행을 추가하십시오. 코드가 실수를 불가능하게 만들면 삭제하십시오.

날짜실수규칙시행 방법
2026-11-201px 기둥, 로프 및 안테나가 스택이 회전함에 따라 깜박임얇은 부분을 최소 2px 너비로 그리기슬라이서 경고(thin_runs), 확인 케이스 5
2026-11-20받침대보다 좁은 둥근 부분(탑, 풍선, 화분)이 정사각형으로 조각됨--round로 조각; 기둥처럼 간격이 있는 행은 정사각형으로 유지--round, 확인 케이스 4
2026-11-20자동 --top-nose가 차량이 아닌 것을 뒤집음--top-nose down 전달규칙
2026-11-20벽에서 튀어나온 것이 벽 전체를 따라 선반을 조각함작은 돌출부를 평평하게 칠함; 굴뚝에 ...

…[번역을 위해 잘림]

관련 스킬