TECH 으로 돌아가기
TECH HACKER NEWS 10분 읽기 54 READS

파이썬 500줄로 3D 모델러 만들기: 씬 그래프와 마우스 피킹의 원리

'500 Lines or Less'라는 책이 있어요. 숙련된 개발자들이 웹 서버, 데이터베이스, 템플릿 엔진 같은 걸 각각 500줄 안팎의 코드로 직접 만들어 보이면서 설계 결정을 설명하는 오픈소스 책인데요, 오늘은 그중 에릭 드랜치(Erick Dransch)가 쓴 「A 3D Modeller」 챕터를 소개해 볼게요. 블렌더 같은 3D 편집 도구의 뼈대를 파이썬 500줄로 만들어 보는 글이에요.

요즘은 AI에게 'three.js로 3D 뷰어 만들어 줘' 하면 코드가 뚝딱 나오잖아요. 그럴수록 그 코드가 왜 그렇게 생겼는지 아는 게 중요해지는데, 이 챕터는 그 '왜'를 가장 작은 크기로 보여줘요. 화면에 도형을 띄우고, 마우스로 골라서, 옮기고, 키우는 것. 딱 거기까지만 하는데 3D 프로그램의 핵심 개념이 거의 다 들어 있어요.

무엇을 만드나

완성품은 단순해요. 창이 하나 뜨고, 키보드로 구나 정육면체를 놓을 수 있어요. 마우스로 클릭하면 도형이 선택돼 살짝 빛나고, 드래그하면 따라 움직이고, 방향키로 크기와 색을 바꿔요. 장면 전체를 마우스로 돌려 볼 수도 있고요. 파이썬과 PyOpenGL, 그리고 창을 띄워 주는 GLUT만 써요.

글쓴이는 일부러 옛날 방식 OpenGL(고정 기능 파이프라인)을 골랐다고 밝혀요. 요즘 방식은 셰이더라는 작은 프로그램을 직접 짜야 해서 첫 도형 하나 띄우는 데도 코드가 길어지거든요. 여기서는 그래픽 API가 아니라 설계를 배우는 게 목적이라 단순한 쪽을 택한 거예요.

핵심 1: 씬 그래프, 그리고 눈사람

코드의 중심에는 Scene과 Node가 있어요. Scene은 화면에 있는 물체 목록을 들고 있고, Node는 물체 하나예요. 모든 노드는 자기 위치와 크기를 행렬로 기억하고, 그리는 순서는 항상 같아요. 색상 처리를 빼고 핵심만 간추리면 이래요.

class Node(object):
def render(self):
glPushMatrix()
glMultMatrixf(numpy.transpose(self.translation_matrix))
glMultMatrixf(self.scaling_matrix)
self.render_self()
glPopMatrix()

여기서 행렬이 뭐냐면, '이 물체를 어디로 옮기고 얼마나 키울지'를 숫자 16개로 적어 둔 메모예요. glPushMatrix는 지금 좌표 상태를 저장해 두는 거고 glPopMatrix는 되돌리는 거예요. 책갈피를 꽂아 두고 다른 페이지를 읽다가 돌아오는 것과 같아요. 실제로 무엇을 그릴지는 render_self에 맡기는데, 구는 구를, 정육면체는 정육면체를 그리죠.

이 구조의 진가는 눈사람에서 드러나요. 눈사람은 크기가 다른 구 세 개를 쌓은 건데, 코드에서는 '자식 노드를 가진 노드'로 표현해요.

class HierarchicalNode(Node):
def render_self(self):
for child in self.child_nodes:
child.render()

단 세 줄이에요. 부모가 자기 행렬을 적용한 상태에서 자식들을 그리니까, 눈사람을 옮기면 구 세 개가 한꺼번에 따라와요. 이게 바로 씬 그래프예요. 자동차를 옮기면 바퀴가 따라오고, 캐릭터 팔을 돌리면 손이 따라오는 원리가 전부 이거예요. 유니티의 GameObject 계층, three.js의 Object3D.add(), 블렌더의 부모-자식 관계가 모두 같은 생각 위에 서 있어요.

핵심 2: 2D 클릭으로 3D 물체 고르기

제일 재미있는 부분은 피킹(picking)이에요. 마우스는 평면 위의 점 하나를 가리킬 뿐인데, 그걸로 입체 공간 속 물체를 어떻게 골라낼까요?

답은 광선이에요. 내 눈에서 출발해 마우스 커서가 찍힌 화면 위의 점을 지나 장면 안쪽으로 뻗어 나가는 직선을 하나 계산해요. 레이저 포인터를 화면에 대고 쏜다고 생각하면 돼요. 그다음 장면의 모든 노드에게 '이 광선이 너랑 부딪히니?' 하고 물어보고, 부딪힌 것 중 가장 가까운 걸 선택해요.

구나 눈사람과 직선의 충돌을 정확히 계산하려면 복잡하니까 여기서는 AABB를 써요. 이게 뭐냐면, 물체를 딱 감싸는 '축에 나란한 상자'예요. 택배 상자에 물건을 넣는 것과 같아요. 물건 모양이 어떻든 상자와 직선이 만나는지만 보면 계산이 아주 쉬워지죠. 정밀도는 조금 떨어지지만 클릭으로 물체를 고르는 용도로는 충분해요. 게임 엔진의 충돌 판정이나 레이 트레이싱의 가속 구조도 같은 아이디어에서 출발해요.

핵심 3: 입력과 동작을 떼어 놓기

설계 면에서 눈여겨볼 건 Interaction 클래스예요. 마우스와 키보드 이벤트를 받는 일은 이 클래스가 전담하고, '선택하기', '옮기기', '놓기', '크기 바꾸기' 같은 의미 있는 사건으로 번역해 콜백으로 알려 줘요. 화면을 그리는 Viewer는 '왼쪽 버튼이 눌렸다'가 아니라 '선택 요청이 왔다'만 알면 되는 거죠. 나중에 키 배치를 바꾸거나 터치 입력을 붙여도 장면을 다루는 코드는 손댈 필요가 없어요. 프런트엔드에서 이벤트 핸들러와 상태 변경 로직을 분리하는 것과 똑같은 원칙이에요.

지금 시점에서 보면

솔직히 기술 자체는 오래됐어요. 고정 기능 OpenGL은 오래전에 폐기 예정이 됐고, 애플은 macOS에서 OpenGL 자체를 지원 중단 대상으로 분류했어요. 요즘 새로 시작한다면 Vulkan이나 Metal, 브라우저라면 WebGPU를 쓰겠죠. 코드도 2016년 무렵 스타일이라 최신 파이썬 환경에서는 조금 손봐야 할 수 있어요.

그런데 개념은 하나도 낡지 않았어요. 블렌더든 언리얼이든 three.js든, 안을 들여다보면 씬 그래프가 있고, 변환 행렬이 있고, 광선으로 물체를 고르고, 경계 상자로 계산을 줄여요. 수십만 줄짜리 엔진 소스는 엄두가 안 나지만 500줄은 한두 시간이면 읽어요. 지도를 먼저 보고 숲에 들어가는 셈이에요.

한국 개발자에게 주는 시사점

웹에서 3D를 다루는 일이 늘고 있어요. 제품 3D 뷰어, 인테리어 시뮬레이터, 디지털 트윈 같은 프로젝트에서 three.js나 React Three Fiber를 쓰다 보면 '왜 자식 메시가 엉뚱한 데 가 있지?', '레이캐스터가 왜 안 맞지?' 같은 문제를 꼭 만나거든요. 대부분 좌표계와 행렬 순서 문제인데, 이 챕터를 한 번 따라가 보면 그런 버그가 왜 생기는지 감이 잡혀요.

공부법으로는 그대로 따라 치기보다 옮겨 짜 보기를 추천해요. Node, Scene, Interaction을 나눈 설계는 그대로 두고 그리는 부분만 three.js나 WebGPU로 바꿔 보는 거예요. 설계와 API를 분리해서 보는 눈이 생기고, 주니어라면 포트폴리오 주제로도 괜찮아요.

마무리

한 줄로 정리하면, 3D 편집 도구의 본질은 트리 구조의 물체들, 행렬, 그리고 광선 하나예요.

여러분은 큰 시스템을 이해하려고 작은 버전을 직접 만들어 본 경험이 있나요? 어떤 걸 만들어 봤고, 그게 실무에 어떻게 도움이 됐는지 궁금해요.


🔗 출처: Hacker News

SOURCE · HACKER NEWS
원문 전체 보기 → https://aosabook.org/en/500L/a-3d-modeller.html
SHARE
NEXT · CHOOSE

변화를 읽었다면,
내가 만들 수익 구조를 고릅니다.

정보를 더 모으는 데서 멈추지 않고, 광고·외주·판매·중개·구독 중 내 상황에 맞는 출발점을 정해보세요.

21가지 수익 구조 살펴보기 →
처리 중...