MeshRepair

프로그램 소개

MeshRepair는 3D 프린팅 과정에서 발생할 수 있는 모델 파일의 오류를 해결하기 위해 설계된 강력한 명령줄 도구입니다. 이 프로그램은 STL, OBJ, STEP 등 다양한 3D 파일 형식을 입력받아 PrinterSlicer를 통해 3MF 형식으로 변환하고, 변환된 파일의 구조적 결함을 자동으로 탐지하여 복구합니다.

주요 기능

• 자동 모델 복구: 3D 프린팅에 적합하지 않은 파일을 자동으로 분석하고 수정합니다.
• 일괄 처리 지원: 단일 파일뿐만 아니라 특정 폴더 내의 모든 모델 파일을 한 번에 처리할 수 있습니다.
• 유연한 출력 설정: 복구된 파일을 원본 폴더 구조 그대로 유지하거나 새로운 경로에 저장할 수 있는 다양한 옵션을 제공합니다.
• 다양한 형식 지원: PrusaSlicer와 호환되는 .stl, .step, .stp, .3mf, .obj, .amf 등 광범위한 파일 형식을 처리합니다.

사용법 및 명령어

MeshRepair는 효율적인 자동화를 위해 명령줄 인터페이스(CLI)를 기반으로 동작합니다. 실행 파일(MeshRepair.exe)과 함께 다음 주요 옵션들을 사용할 수 있습니다.

• –inputFilePath: (필수) 수정할 단일 파일이나 전체 폴더의 경로를 지정합니다. 폴더를 지정하면 해당 폴더와 하위 폴더에 있는 모든 호환 파일이 처리됩니다.
• –outputFilePath: (선택) 복구된 파일을 저장할 대상 디렉토리를 지정합니다. 지정하지 않으면 원본 파일 옆에 저장됩니다.
• –cloneFolderHierarchy [true|false]: (선택, 기본값: true) 폴더를 입력으로 받았을 때 출력 디렉토리에 원본의 폴더 구조를 그대로 복제할지 여부를 설정합니다.
• –timeoutSeconds [number]: (선택, 기본값: 600) 파일 하나를 수정하는 데 걸리는 최대 시간(초)을 설정합니다.

명령어 실행 예시

단일 파일을 수정하고 싶을 때는 다음과 같이 입력합니다.

MeshRepair.exe –inputFilePath “C:/Folder/model.stl”

특정 출력 폴더를 지정하여 파일을 저장하려면 아래 명령어를 사용합니다.

MeshRepair.exe –inputFilePath “C:/Folder/model.stl” –outputFilePath “C:/Folder/Repaired”

폴더 내 모든 모델을 수정할 때는 다음과 같이 폴더 경로를 지정합니다.

MeshRepair.exe –inputFilePath “C:/Folder/Models”

이런 경우에 유용합니다

• 3D 프린팅을 준비하면서 STL이나 OBJ 파일에 뚫린 면이나 비정상적인 경로 같은 오류가 발생했을 때
• 대량의 3D 모델 파일을 한꺼번에 검사하고 일괄적으로 수정해야 할 때
• CI/CD 파이프라인이나 자동화 스크립트에 3D 모델 검증 및 복구 과정을 통합하고자 할 때

최신 버전·업데이트

현재 제공되는 최신 공식 릴리스 버전은 3.1.1입니다. 더 자른 변경 사항이나 신규 기능에 대한 정보는 공식 GitHub 저장소의 릴리스 페이지에서 확인할 수 있습니다.

제한 사항·확인 사항

이 프로그램은 Windows 환경에서 C#으로 개발되어 동작합니다. 입력 파일은 3D 프린팅과 관련된 특정 모델 형식이어야 하며, 사용자는 이를 처리할 수 있는 적절한 시스템 환경이 갖춰져 있어야 합니다.

화면으로 보는 주요 기능

MeshRepair 실행 중

Windows PowerShell 창에서 MeshRepair.exe를 실행 중이며, 명령줄 인터페이스를 통해 입력 폴더 또는 파일 경로를 지정하고, STL로 변환 여부, 폴더 계층 구조 복제 여부, 그리고 파일당 타임아웃 시간을 설정하는 프롬프트가 표시되어 있다.