본문 바로가기
FrostK
테마 색상
로그인

읽는 데 7분Cat

safe-sand의 모래는 다음 프레임까지 어디에 남아 있을까요

IT 개발원리 웹개발
safe-sand의 모래는 다음 프레임까지 어디에 남아 있을까요

휴대폰 화면의 모래를 밀어 고랑을 만들면, 다음 순간에도 그 자국이 남아야 해요. safe-sand 소스를 읽어 보니 모래의 위치와 속도는 GPU 텍스처 안에 저장돼 있었어요. 사진을 띄울 때 쓰는 그 텍스처가 여기서는 다음 계산에 쓸 숫자 보관함이에요.

GitHub 사용자 av가 공개한 safe-sand 웹 체험은 WebGL2로 모래를 표현해요. README에 따르면 휴대폰을 기울이거나 손가락으로 밀 수 있고, 데스크톱에서는 마우스·방향키와 흔들기용 Space 키를 써요. 이 글은 조작감을 시험한 후기가 아니라, 상태 저장 코드를 읽고 다른 WebGL2 경로와 비교한 원리 설명이에요.

알갱이의 숫자를 그림 칸에 담아요

먼저 제작자가 공개한 화면을 보면 어떤 결과를 만들려는지 알 수 있어요. 아래는 저장소의 Android 앱 소개용 이미지예요. 어두운 알갱이 사이에 굵은 고랑이 나 있고, 크기와 색이 다른 돌도 보여요. 웹판을 직접 캡처한 결과는 아니에요.

어두운 모래 알갱이 사이에 나선형 고랑과 큰 돌이 보이는 제작자 공개 화면
출처: av/safe-sand의 앱 소개 자료. 표현 결과를 설명하기 위한 한 장 인용.

코드의 STEP_FS는 입자 상태를 A·B라는 텍스처에서 읽어요. A에는 평면 위치와 속도가 들어 있고, B에는 공중에서의 높이·수직 속도 등 다른 상태가 담겨요. 화면 색을 담는 대신 숫자를 담는 거죠.

새 상태를 계산할 때는 지금 읽는 텍스처를 그대로 덮어쓰지 않아요. resize()가 준비한 별도 묶음에 결과를 쓰고, step() 마지막에서 현재 묶음을 가리키는 값을 바꿔요. A·B라는 두 필드와, 현재·다음이라는 두 저장 묶음은 다른 구분이에요.

현재 A·B에서 입자 상태를 읽고 격자를 만든 뒤 GPU에서 다음 상태를 계산해 다른 A·B에 써요. 다음 갱신에는 현재·다음 저장 묶음의 역할을 바꿔요.
입자 상태를 보존하면서 다음 상태를 만드는 고수준 흐름이에요.

주변에 모래가 얼마나 쌓였는지도 계산에 필요해요. splat()은 공간을 바둑판처럼 나눈 칸에 입자 정보를 모으고, 이를 다듬어 높이와 기울기를 계산해요. step()의 셰이더는 입자 상태와 이 격자를 함께 읽어요. 모래 더미의 경사를 각 알갱이의 다음 움직임에 반영하는 연결이에요.

핵심은 화면에 보이는 모래 이미지와 계산용 상태 텍스처를 구분하는 거예요. 화면의 모래 그림을 다시 분석해서 위치를 찾는 방식이 아니라, 이미 보관한 상태 숫자로 다음 계산을 이어 가요.

GPU에 남기는 방법은 하나가 아니에요

WebGL2에는 transform feedback이라는 다른 경로도 있어요. MDN은 정점 처리에서 나온 결과를 보존하고 다시 사용할 수 있는 기능으로 설명해요. 정점은 GPU가 다루는 점·도형의 기본 데이터이고, 이 경로에서는 처리 결과를 버퍼에 남겨요.

safe-sand의 입자 갱신은 다른 쪽을 써요. STEP_FS라는 프래그먼트 셰이더가 텍스처에서 현재 값을 읽고, 다음 A·B로 내보내요. 프래그먼트 셰이더는 보통 화면의 각 조각을 칠하는 프로그램이지만, 여기서는 계산용 저장 칸을 채워요.

비교할 것 safe-sand의 입자 갱신 transform feedback
결과를 남기는 경로 프래그먼트 출력 → 텍스처 정점 처리 출력 → 버퍼
다음 계산에 쓸 데이터 현재 입자 텍스처와 주변 격자 보존한 정점 처리 결과
이 글에서 확인한 것 실제 코드의 읽기·출력·묶음 교체 MDN의 기능 정의

이 비교에서 얻을 선택 기준은 ‘GPU로 계산한다’는 이름보다 어느 단계의 결과를 어디에 저장할지예요. safe-sand는 이미 주변 높이·기울기를 텍스처로 만들고, 입자 갱신도 그것을 읽는 구조예요. 어느 방식이 더 빠른지는 이 자료만으로 정하지 않았어요.

또 ‘GPU에서 계산한다’고 CPU와 데이터를 전혀 주고받지 않는 것도 아니에요. 이 코드에는 초기 상태를 올리는 부분과 작은 통계를 읽어 오는 부분도 있어요. 입자 갱신의 저장 경로와 프로그램 전체의 역할을 나눠 보는 게 정확해요.

WebGL2만 지원하면 충분할까요

컨텍스트 생성 코드에는 별도 조건이 하나 더 있어요. WebGL2를 얻은 뒤 EXT_color_buffer_float 확장을 검사하고, 없으면 오류를 내요. 소수 값을 담은 텍스처에 렌더링 결과를 쓸 수 있는지 보는 조건이에요.

이어서 검사하는 EXT_float_blend는 다르게 취급돼요. 이 확장이 있는지에 따라 입자를 격자에 누적하는 텍스처의 형식을 바꾸고, 없다는 이유만으로 같은 즉시 오류를 내지는 않아요. 두 확장을 모두 ‘필수 WebGL2 기능’으로 묶으면 코드의 판단을 놓쳐요.

코드에서 검사하는 것 처리
WebGL2 컨텍스트 얻지 못하면 중단
EXT_color_buffer_float 없으면 중단
EXT_float_blend 유무에 따라 누적용 텍스처 형식 선택

따라서 이 구현을 참고해 브라우저 실험을 만들 때는 WebGL2 지원 여부뿐 아니라, 실제로 쓰는 숫자 텍스처·출력·누적 조건까지 확인해야 해요. 휴대폰별 성능이나 모션 권한 동작은 이 코드 대조와는 별도로 시험할 부분이에요.

확인한 범위

  • 기준일: 2026-11-14
  • 직접 한 것: 고정 커밋의 gl.js, sim.js, sim-shaders.js를 읽어 상태 읽기·다음 출력·저장 묶음 교체를 연결했어요. MDN의 transform feedback 경로와 비교하고, 필수 float 출력 확장과 별도 누적 확장을 구분했어요.
  • 읽은 것: 프로젝트 README, 공개 앱 화면, 구현 코드, MDN WebGLTransformFeedback, GeekNews 한국어 소개.
  • 확인하지 못한 것: 실제 조작감, 모바일별 성능·모션 권한, 물리 정확성과 두 저장 경로의 성능 차이.

출처

safe-sand/README.md at main · av/safe-sand
Hyper-realistic sand on your phone screen (WebGL2) - av/safe-sand
WebGLTransformFeedback - Web APIs | MDN
The WebGLTransformFeedback interface is part of the WebGL 2 API and enables transform feedback, which is the process of capturing primitives generated by vertex processing. It allows you to preserve the post-transform rendering state of an object and resubmit this data multiple times.

상태 저장·갱신 코드 · 입자 갱신 셰이더 · 확장 검사