.off 파일이란? Geomview 메시, ModelNet, 그리고 Mac

화면 하나에 담기는 형식 전체

다음은 모서리 길이가 10단위인 정육면체입니다.

OFF
8 6 0
0 0 0
10 0 0
10 10 0
0 10 0
0 0 10
10 0 10
10 10 10
0 10 10
4 0 3 2 1
4 4 5 6 7
4 0 1 5 4
4 1 2 6 5
4 2 3 7 6
4 3 0 4 7

Geomview 매뉴얼에 따르면 맨 앞의 OFF라는 단어는 권장 사항일 뿐 필수가 아니어서, 이 단어가 없는 파일이 많습니다. 두 번째 줄에는 개수가 들어 있습니다. 꼭짓점 8개, 면 6개, 그리고 모서리 개수입니다. 마지막 값은 쓰이지도 검사되지도 않지만 반드시 있어야 하며, 보통 0입니다. 그 뒤에 꼭짓점 좌표가 한 줄에 하나씩 옵니다. 각 면은 꼭짓점 개수로 시작하고, 이어서 0부터 센 꼭짓점 번호가 옵니다. OBJ는 1부터 세므로 손으로 변환할 때는 주의하세요. 면은 오목해도 되지만 구멍이 있으면 안 됩니다. 주석은 #으로 시작합니다.

꼭짓점 번호 뒤에 면의 색이 올 수 있습니다. 0부터 255까지의 정수 세 개나 네 개, 또는 0부터 1까지의 소수입니다. Antiprism은 이것이 모호하다고 지적합니다. 1 0 0은 소수로 보면 빨간색이지만, 정수로 보면 거의 검은색입니다.

접두사: COFF, NOFF, STOFF 등

키워드 앞에는 각 꼭짓점에 데이터를 더하는 접두사가 붙을 수 있습니다.

바이너리 변형인 OFF BINARY도 있습니다. OFF에는 단위도 재질도 없으며, 파일 하나에 객체는 하나뿐입니다.

OFF를 만나는 곳

• 머신러닝 데이터셋. Princeton의 ModelNet10과 ModelNet40(CVPR 2015)은 CAD 모델을 OFF로 저장합니다. ModelNet40의 일부 파일은 OFF6586 5534 0처럼 개수가 OFF라는 단어와 같은 줄에 붙은 깨진 헤더를 가지고 있어서, 더 엄격한 프로그램은 이를 거부합니다.
• Princeton Shape Benchmark. 파일은 항상 텍스트이고, 항상 OFF로 시작하며, 모서리 개수는 항상 0입니다. 예전 버전의 모델에는 변환 오류 때문에 −1 인덱스가 들어 있었습니다.
• 기하학과 다면체. CGAL 라이브러리는 OFF를 읽고 쓰며, Antiprism 툴킷은 다면체를 이 형식으로 기술하고, Geomview는 4차원 객체까지 이 형식으로 기술합니다.

OFF의 기원

형식의 이름과 최초의 설명은 Digital Equipment Corporation에서 나왔습니다. 지금 paulbourke.net에 있는 설명은 머리말에 Randi J. Rost라는 이름이 적혀 있으며, 이 형식을 3D 객체를 텍스트나 바이너리로 교환하고 보관하기 위한 것으로 소개합니다. 하지만 오늘날 대부분의 프로그램이 읽는 것은 Geomview 매뉴얼에 설명된 방식입니다. Geomview는 University of Minnesota의 Geometry Center에서 나왔습니다. 1988년 여름 MinneView 뷰어(Pat Hanrahan 작)에서 시작되었고, Geomview의 첫 버전은 1992년 1월에 완성되었습니다. Geomview는 지금도 GNU LGPL로 받을 수 있습니다.

Mac에서 OFF를 여는 방법

macOS는 OFF를 모릅니다. macOS 27.0.1에는 이 형식의 파일 유형이 없고, 미리보기, 훑어보기, Finder 모두 이를 보여주지 않습니다. 텍스트 편집기로는 형상이 아니라 숫자만 보입니다.

• MeshLab은 무료이며, Apple 실리콘용과 Intel용이 있고, OFF를 엽니다.
• Python과 MATLAB. 연구자들을 위한 라이브러리가 있으며, Princeton은 ModelNet과 함께 MATLAB 함수를 제공합니다.
• 제 앱 Preview3D는 Mac에서 .off 파일을 창에서, 훑어보기에서, Finder 미리보기 이미지로 보여줍니다. iPad, iPhone, Apple Vision Pro에서도 됩니다. 그래서 코드를 한 줄도 쓰지 않고 데이터셋 폴더를 미리보기 이미지로 훑어볼 수 있습니다.

Preview3D는 Assimp 라이브러리로 OFF를 읽습니다. 앱이 쓰는 것과 같은 빌드로, Geomview 매뉴얼을 보고 작성한 파일로 시험해 봤습니다. 키워드가 있는 OFF와 없는 OFF, COFF, NOFF, STOFF, 4OFF 변형, 깨진 ModelNet40 헤더, 꼭짓점이 다섯 개인 면이 열렸습니다. 바이너리 OFF는 열지 못합니다. 앱은 파일의 색을 쓰지 않고, 지오메트리를 단색으로 보여줍니다.

한 가지 주의할 점은 주석입니다. Assimp는 주석을 읽을 때 # 문자에서 멈춥니다. 제 테스트에서는 개수 줄 앞이나 그 줄에 주석이 있는 파일이 불러와지지 않았습니다. 읽기가 멈춰 버렸습니다. 꼭짓점과 면 사이의 주석은 대신 면 하나를 삼켜 버렸습니다. 그러니 지금은 열기 전에 주석을 지우세요.

sed -e 's/#.*//' -e '/^[[:space:]]*$/d' model.off > no-comments.off

이 명령은 #부터 줄 끝까지의 모든 내용과 빈 줄을 지웁니다. 그러자 제 테스트 파일이 모두 완전히 불러와졌습니다.

모델 정보에는 파일 단위로 된 치수와 삼각형 개수, 그리고 메시 검사가 있습니다. iPad와 iPhone에서는 OFF에 단위가 없으므로 모델을 책상 크기에 맞춰 AR로 책상 위에 세워 보여줍니다.

OFF를 STL, OBJ, PLY로 변환하기

Mac에서 Preview3D는 파일 → 다른 이름으로 모델 내보내기…(⌥⌘E)에서 아무것도 업로드하지 않고 STL, OBJ, PLY로 변환합니다. 폴리곤은 삼각형으로 나뉘고 색은 빠집니다. OFF에는 단위가 없으므로 슬라이서에서 크기를 확인하세요.

자주 묻는 질문

.off 파일은 무엇인가요?

폴리곤 메시를 담은 텍스트 파일로, 개수, 꼭짓점 목록, 면 목록으로 이루어집니다. Geomview 뷰어에서 나왔으며 주로 연구에서 쓰입니다.

세 번째 숫자는 쓰이지 않는데 왜 헤더에 숫자가 세 개 있나요?

세 번째 숫자는 모서리 개수입니다. Geomview 매뉴얼에 따르면 쓰이지도 검사되지도 않지만 반드시 있어야 하며, 보통 0입니다.

Mac에서 ModelNet 파일을 어떻게 훑어볼 수 있나요?

Preview3D에서 Finder 미리보기 이미지로, 또는 MeshLab에서 볼 수 있습니다. Preview3D는 OFF6586 5534 0 같은 깨진 헤더도 처리합니다.

OFF는 OBJ와 어떻게 다른가요?

OFF는 꼭짓점을 0부터, OBJ는 1부터 셉니다. OFF는 색을 면이나 꼭짓점에 바로 두고 파일 하나에 메시 하나를 담습니다. OBJ는 재질을 .mtl 파일에 두고 여러 객체를 담을 수 있습니다.

Mac은 다른 앱 없이 .off를 여나요?

아니요. macOS 27에는 OFF용 파일 유형이 없고, 미리보기도 훑어보기도 이를 보여주지 않습니다.

OFF를 STL이나 OBJ로 어떻게 변환하나요?

Mac에서 Preview3D의 파일 → 다른 이름으로 모델 내보내기…로, 또는 MeshLab에서 변환합니다. 그런 다음 크기를 확인하세요.

관련 페이지

• .obj 파일 – 재질이 있는 텍스트 메시 형식
• .ply 파일 – 스캔과 포인트 클라우드를 위한 또 다른 연구용 형식
• .stl 파일 – 출력용 형식

출처

• Geomview 매뉴얼: OFF – 구문, 접두사, 색, 바이너리 변형
• Geomview 매뉴얼: 역사 및 라이선스
• Paul Bourke: OFF – Digital Equipment Corporation의 최초 설명
• Princeton Shape Benchmark: OFF 형식
• Princeton ModelNet
• ModelNet40 헤더 고치기(GitHub gist)
• Antiprism: OFF 형식 – 모호한 색
• Assimp: OFF 읽기 및 줄 건너뛰기 – 주석
• MeshLab

ModelNet이나 다른 OFF 데이터셋으로 작업하면서 Mac에서 빠르게 훑어볼 방법이 필요하신가요? 무엇이 도움이 될지 apps@xfanta.com으로 알려 주세요.