GLB 파일을 가볍게 확인하기 위한 Python 메모

AI로 생성한 3D 모델을 받은 후, 가장 먼저 무엇을 확인할 것인가. 외관 체크는 물론 필요하지만, 파일로서의 기본 정보도 미리 확인해 두면 안심할 수 있습니다.

이 기사에서는 GLB 파일을 Python으로 가볍게 확인하고, 정점 수(Vertex count), 면 수(Face count), 마테리얼(Material), 파일 크기를 CSV로 출력하는 메모를 정리합니다.

Hi3D 등의 3D 모델 생성 AI로부터 출력된 GLB를 하류 공정(downstream process)에 넘기기 전에 대략적으로 확인하는 상황을 가정합니다.

생성된 GLB를 불러올 수 있는지 확인하고 싶다

정점 수나 면 수가 극단적으로 크지 않은지 보고 싶다

여러 파일을 목록으로 비교하고 싶다

에러가 발생한 파일을 빠르게 찾고 싶다

pip install trimesh pandas

from pathlib import Path
import trimesh
path = Path("model.glb")
...

force="scene"로 설정해 두면, 복수의 메쉬(Mesh)를 포함하는 GLB도 scene으로 다루기 쉬워집니다.

from pathlib import Path
import pandas as pd
import trimesh
...

열	확인 내용
status	불러오기에 성공했는지
...

용도에 따라 기준은 달라지지만, 검토용으로 간단한 임계값(Threshold)을 설정해 두면 너무 무거운 모델을 빠르게 찾아낼 수 있습니다.

import pandas as pd
df = pd.read_csv("glb_report.csv")
df["too_large"] = df["size_mb"] > 50
...

수치만으로는 모델 품질을 판단할 수 없습니다. CSV를 통해 무거운 모델이나 에러를 발견했다면, 다음으로는 뷰어(Viewer)로 외관을 확인합니다. 형태의 파손, 텍스처(Texture)의 늘어남, 의도하지 않은 구멍, 스케일감(Scale) 등은 최종적으로 눈으로 확인할 필요가 있습니다.

GLB 확인은 처음부터 엄격한 검증 툴을 만들지 않더라도, 파일 크기, 정점 수, 면 수, 불러오기 가능 여부를 보는 것만으로도 상당히 유용합니다.

AI 생성 3D 모델을 여러 개 다루는 경우에는 CSV로 목록화한 뒤 육안 확인으로 넘어가면, 문제가 있는 파일을 놓치지 않게 됩니다.