스프라이트 스태킹은(는) 무엇을 하나요?
객체는 평평한 상향식 슬라이스들의 수평 스트립이며, 바닥 슬라이스는 왼쪽에, 지붕은 오른쪽에 있습니다. 아래에서 위로 그리며, 각 슬라이스를 같은 각도로 회전시키고, 카메라 피치를 위해 수직으로 압축하고, 슬라이스당 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톤 색조 이동 램프로 음영 처리하십시오: 차갑고 깊은 그림자, 채도가 높은 중간색, 따뜻한 하이라이트. 그라데이션, 안티앨리어싱이 없습니다.
-
물체를 중앙에 배치하십시오. 스택은 경계 상자의 중간을 중심으로 회전하므로 한쪽으로 더 멀리 뻗은 베이스는 축에서 벗어나 궤도를 돌게 만듭니다.
게이트: 슬라이싱 전에 시트 확인
- 방향: TOP 앞면은 아래를 향합니다. SIDE 앞면은 왼쪽을 향합니다(오른쪽인 경우
--side-nose right전달). - 비율: TOP 길이 = SIDE 길이, TOP 너비 = FRONT/BACK 너비, SIDE 높이 = FRONT/BACK 높이.
- 하드 에지: 평면 채우기, 선명한 외곽선. 부드러운 에어브러시 가장자리 또는 얇은 1px 내부 라인은 슬라이스가 회전하면 번집니다. 복구하지 말고 재생성하거나 다시 그리십시오.
- 구멍: SIDE 뷰에서 빛이 비치는 돌출부(올라간 후방 날개)는 살아남습니다. 네 실루엣 모두에서 숨겨진 공동(트럭 적재함, 속이 빈 아치)은 채워집니다. 조각 후 해당 슬라이스를 손으로 수정하십시오.
- 교훈: 이 파일 끝에 있는 교훈 표를 확인하십시오.
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은 시트의 원시 픽셀 유지 |
--order | auto | auto는 비율 일치(TOP 길이 = SIDE 길이, TOP 너비 = FRONT 너비, SIDE 높이 = FRONT 높이)로 TOP과 SIDE를 선택합니다. 동점일 경우 읽기 순서가 우선합니다. reading은 TOP, SIDE, FRONT, BACK을 강제합니다 |
--round | 끄기 | 탑, 풍선, 화분, 병: 각 슬라이스를 SIDE 및 FRONT 범위가 설명하는 타원으로 자릅니다. 지느러미, 날개 및 상자에는 사용하지 마십시오 |
--side-nose | left | SIDE 뷰가 오른쪽을 향하면 right |
--top-nose | auto | 자동은 자동차 캐빈을 읽습니다. 차량이 아닌 것은 down을 전달하고, 자동차가 뒤집히면 up 또는 down을 전달합니다 |
--shade | 0.2 | 풍부하게 음영 처리된 뷰의 경우 0.12-0.15, 평면 뷰의 경우 0.25, 없음의 경우 0 |
--colours | 24 | 세부 도장의 경우 32-48, 모든 색상을 유지하려면 0 |
--bg-tol | 28 | JPEG 노이즈가 프린지를 남기면 약간 높이십시오 |
--dark-thresh | 70 | 매우 어두운 실루엣의 외곽선을 유지하려면 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 - 1px 높이입니다. - 피치 및 90°: 0.75는 1.0보다 눈에 띄게 짧습니다. 90°에서 너비는
sliceHeight와 같습니다. - 간격: 0은 평평하게(상단 슬라이스만) 그리고, 2.5는 모든 레이어를 깔끔하게 분리합니다.
- 깨끗한 대각선: 45°에서 몸체 내부에 수평 줄무늬나 어두운 반점이 없습니다.
- 방향: 원을 그리며 주행하면 앞면이 경로를 유지합니다. 후진하면 방향을 유지합니다.
- 느린 회전: 작은 스프라이트가 끊겨 보이면 먼저 정수 디스플레이 배율을 높이십시오. 긴 직선 가장자리가 여전히 크롤링되는 경우에만 RotSprite를 시도하고 눈으로 비교하십시오. 아주 작은 스프라이트를 반올림합니다.
- 전체 회전: 네 개가 아닌 모든 각도를 보십시오. 나타났다 사라지는 부분은 교훈 행입니다.
교훈
스택이 잘못 나오면 수정한 다음, 재발하지 않도록 원인을 수정하십시오: 실수가 발생할 수 없도록 슬라이서를 변경하거나, 수정 사항이 포함된 메시지로 경고하도록 만들고, 실제 실수로 빌드된 tests/check.py에 변경 전에 실패하는 케이스를 추가하십시오. 코드가 볼 수 없는 판단 호출만 규칙이 됩니다. 여기에 행을 추가하십시오. 코드가 실수를 불가능하게 만들면 삭제하십시오.
| 날짜 | 실수 | 규칙 | 시행 방법 |
|---|---|---|---|
| 2026-11-20 | 1px 기둥, 로프 및 안테나가 스택이 회전함에 따라 깜박임 | 얇은 부분을 최소 2px 너비로 그리기 | 슬라이서 경고(thin_runs), 확인 케이스 5 |
| 2026-11-20 | 받침대보다 좁은 둥근 부분(탑, 풍선, 화분)이 정사각형으로 조각됨 | --round로 조각; 기둥처럼 간격이 있는 행은 정사각형으로 유지 | --round, 확인 케이스 4 |
| 2026-11-20 | 자동 --top-nose가 차량이 아닌 것을 뒤집음 | --top-nose down 전달 | 규칙 |
| 2026-11-20 | 벽에서 튀어나온 것이 벽 전체를 따라 선반을 조각함 | 작은 돌출부를 평평하게 칠함; 굴뚝에 ... |
…[번역을 위해 잘림]