작은 작업실로 돌아가기● ● ●ryu-deco / pixel world editor✦
✎▦◇✦
hello, I'm RyuRim!Building my little pixel world.Next.jsTypeScriptCanvas
All changes savedPNG · GIF Export ↗
WHAT YOU CAN MAKE작은 픽셀에서,
나만의 GitHub 월드로.
소개와 기술 스택을 배치하고, 캐릭터를 직접 그려 움직임을 더합니다. 완성한 장면은 README에 사용할 수 있는 이미지로 가져갑니다.
구현한 기능
- 실시간 Canvas 편집
- 배경 4종과 장식 배치
- 16×16·32×32 픽셀 그리기
- 프레임 애니메이션 편집
- PNG·GIF 내보내기
- 브라우저 자동 저장
사용한 기술
Next.jsTypeScriptTailwind CSSZustandCanvasgifenc
Next.js App Router와 strict TypeScript를 사용하고, 정적 내보내기로 GitHub Pages에 배포할 수 있도록 구성했습니다.
HOW I BUILT IT어떻게 만들었나요?
AI를 활용한 부분과 직접 설계·구현한 부분을 나누어 제작 과정을 기록합니다.
확인된 작업 내용을 정리 중입니다.
확인된 작업 내용을 정리 중입니다.
BEHIND THE PIXELS만들면서 풀어낸 문제들
01미리보기와 내보내기를 같은 그림으로
- 해결할 문제
- 에디터에서 본 장면과 다운로드한 이미지가 다르면, 사용자는 결과물을 예측하기 어렵습니다.
- 구현 방식
- Canvas의 공통 픽셀 렌더러로 미리보기, PNG, GIF 프레임을 그립니다. 선택 테두리는 편집 화면에서만 보여주고 내보낼 때는 제외합니다.
- 기술 선택의 이유
- Canvas를 사용해 픽셀 단위의 배치와 이미지 출력을 하나의 렌더링 경로에서 처리합니다. GIF는 gifenc로 프레임을 인코딩합니다.
02작은 그림이 움직이는 캐릭터가 되도록
- 해결할 문제
- 기본 캐릭터를 고르는 데서 나아가, 사용자가 자기만의 캐릭터와 움직임을 만들 수 있어야 합니다.
- 구현 방식
- 16×16·32×32 그리드, 연필과 지우개, 프레임 추가·복제·삭제를 제공합니다. 최대 8프레임을 편집하고, 그리드 크기를 바꿀 때는 nearest-neighbor 방식으로 픽셀을 변환합니다.
- 기술 선택의 이유
- 픽셀 데이터를 직접 관리해 확대해도 경계가 흐려지지 않게 합니다. 같은 그림을 여러 번 배치해도 원본 수정이 사본에 반영됩니다.
03브라우저를 닫아도 이어지는 작업
- 해결할 문제
- 장면을 꾸미는 중 새로고침하거나 창을 닫아도 편집 내용을 다시 불러올 수 있어야 합니다.
- 구현 방식
- Zustand로 편집 상태를 관리하고 localStorage에 자동 저장합니다. 배경, 효과, 출력 형식과 직접 그린 캐릭터도 저장하며 실행 취소·다시 실행을 지원합니다.
- 기술 선택의 이유
- 별도 로그인 없이 브라우저에서 바로 만들고 이어서 편집할 수 있습니다. 상태 관리와 픽셀 렌더링, 내보내기 코드를 분리했습니다.