워프레임 허브
워프레임을 처음 시작한 플레이어가 게임의 시스템과 진행 순서를 이해하도록 돕는 초보자 가이드 사이트. 스타차트와 진행 도구를 만들며 3D·UI·데이터를 함께 공부한다.
초보자의 다음 행동을
안내하는 사이트.
- 복잡한 시스템과 진행 순서를 풀어내는 초보자 가이드
- Next.js로 구성한 정보 화면과 진행 트래커
- Three.js · React Three Fiber로 탐색을 돕는 3D 스타차트와 WebGL을 사용할 수 없을 때 보여 주는 목록 화면
기존 코드에서 확인한 구성입니다. 기초 학습 퀘스트의 완료 여부와는 따로 기록합니다.
상자 → 삼각형 → 행성 하나
완성된 장면을 다시 읽기 전에 작은 예제에서 모양·표면·카메라를 분리해서 배운다.
글 속 행성 예제 열기 ↗등록된 프로젝트 학습 퀘스트 0 / 15 완료
프로젝트 기록
실습을 마칠 때 관찰과 오답 추가JavaScript 배열을 바꿔도 GPU buffer는 그대로다
buffer 생성과 좌표 전달을 구분하고, 배열만 변경한 뒤와 다시 전달한 뒤의 실제 GPU buffer 값을 비교했다.
WebGPU에서 장치 준비와 그리기 구분하기
adapter와 device를 요청해 준비 성공을 확인했다. GPU를 사용할 준비와 실제로 그림을 그리는 작업을 구분했다.
WebGL 삼각형은 세 꼭짓점에서 시작한다
꼭짓점과 shader의 역할을 구분했다. JavaScript의 색 변경과 uniform 전달, 다시 그리기를 나누어 관찰했다.
모양과 표면과 빛을 한꺼번에 바꾸지 않기
Three.js 물체에서 Geometry·Material·Light의 역할을 하나씩 분리했다. Roughness와 Texture도 한 조건씩 바꾸며 Material이 표면을 계산하는 방식을 확인했다.
물체가 돈 건가, 카메라가 옮겨간 건가
Three.js로 빈 장면에 상자 하나를 놓았다. 그리드를 기준으로 물체 회전과 카메라 이동을 구분하고, lookAt이 위치가 아니라 방향을 바꾼다는 것을 확인했다.
워프레임 허브에 3D를 연결하는 공부 순서
스타차트의 코드를 따라가기 전에, 작은 예제에서 이해하고 행성 하나로 돌아가려 한다.
연결된 퀘스트
조건으로 찾아보기 ↗예정 항목은 학습 후보입니다. 하루에 전부 진행하는 목록이 아니며, 다른 분야의 공부는 Graphics와 함께 진행할 수 있습니다.
빈 장면에 상자와 카메라를 놓고 좌표 하나씩 바꿔 본다.
- 마무리할 때 남길 것
- 작은 예제와 함께 물체 회전·카메라 이동의 차이를 내 말로 설명하기.
device·pipeline·command의 관계를 작은 장면에서 살핀다.
- 마무리할 때 남길 것
- WebGL 예제와 설정·명령 제출의 차이를 정리하고 미지원 화면도 준비하기.
학습 때 선택한 vgpu 버전과 API를 확인하고 앞의 예제와 비교한다.
- 마무리할 때 남길 것
- 직접 작성한 코드와 라이브러리에 맡긴 부분을 나눠 기록하기.
기초 예제에서 배운 내용을 기존 스타차트의 행성 하나에 연결한다.
- 마무리할 때 남길 것
- 모양·표면·카메라·대기를 분리해서 설명하고 바꾼 값과 화면을 함께 남기기.
공개 필터 사례를 보고 작은 목록 화면에서 적용해 본다.
- 마무리할 때 남길 것
- 필터 선택 → 새로고침 → 뒤로 가기 후에도 조건이 맞는지 확인하기.
검색 결과가 바뀔 때 포인터와 키보드 선택이 어떻게 달라지는지 재현한다.
- 마무리할 때 남길 것
- 방향키·Enter·Escape와 결과 갱신을 직접 시험하고 선택 기준을 적기.
목록 하나의 로딩·성공·빈 결과·오류 상태를 나란히 설계한다.
- 마무리할 때 남길 것
- 각 상태에서 사용자가 다음에 할 행동과 키보드 포커스를 확인하기.
읽는 글과 클릭하는 3D 예제가 각각 어디에서 실행되는지 구분한다.
- 마무리할 때 남길 것
- 작은 페이지에서 use client가 필요한 부분과 브라우저 전용 코드를 표시하기.
목록·상세 화면에서 데이터를 가져오는 시점과 캐시를 관찰한다.
- 마무리할 때 남길 것
- 설치한 Next.js 버전을 적고 새로고침·화면 이동·갱신 결과를 비교하기.
로딩·성공·오류를 구분 가능한 타입으로 표현한다.
- 마무리할 때 남길 것
- 불가능한 상태 조합을 줄이고 분기 누락을 타입 검사로 찾기.
개인 프로젝트용 작은 응답에서 누락·잘못된 값을 처리한다.
- 마무리할 때 남길 것
- 정상·누락·실패 입력 세 가지와 화면에 전달할 데이터 형태 기록하기.
브라우저 기록을 계정에 저장할 때 데이터 소유권과 충돌을 정한다.
- 마무리할 때 남길 것
- 로그인 전후 흐름과 저장 실패·재시도·다른 기기 충돌 예시 남기기.
작은 3D 예제를 같은 기기·화면 크기·장면 조건으로 반복 측정한다.
- 마무리할 때 남길 것
- 조건·반복 횟수·측정값을 남기고 측정하지 않은 성능은 주장하지 않기.
검색 → 선택 → 돌아오기 중 깨지기 쉬운 동작 하나를 자동으로 확인한다.
- 마무리할 때 남길 것
- 실제로 실패하는 경우를 재현한 뒤 수정 전후 테스트 결과 남기기.