jDwgParser

Java로 구현한 AutoCAD DWG 파일 파서 라이브러리.

OpenDesign Specification v5.4.1을 기반으로 R13부터 R2018까지의 DWG 파일 읽기 및 쓰기를 지원합니다.

src/
├── io/dwg/
│   ├── core/          # 저수준 I/O, 버전 감지, 유틸리티
│   │   ├── io/        # BitStream 읽기/쓰기
│   │   ├── type/      # DwgHandle, Point3D 등
│   │   ├── util/      # LZ77, CRC, 문자열 인코딩
│   │   └── version/   # DwgVersion, 버전 감지
│   │
│   ├── format/        # 버전별 파일 구조 핸들러
│   │   ├── common/    # 공통 인터페이스
│   │   ├── r13/       # R13-R15 구현
│   │   ├── r2004/     # R2004 구현
│   │   └── r2007/     # R2007-R2010 구현
│   │
│   ├── sections/      # 섹션 파서/라이터
│   │   ├── header/    # Header 변수
│   │   ├── classes/   # 클래스 정의
│   │   ├── handles/   # 핸들 맵
│   │   └── objects/   # 엔티티/객체
│   │
│   ├── entities/      # 도메인 모델 (순수 데이터)
│   │   ├── concrete/  # Line, Circle, Arc, Text 등
│   │   └── ...
│   │
│   ├── api/           # 고수준 공개 API
│   │   ├── DwgReader
│   │   ├── DwgWriter
│   │   └── DwgDocument
│   │
│   └── test/          # 테스트
│       └── DwgParsingStageTest

dwg-core → dwg-format → dwg-sections → dwg-entities → dwg-api

• Strategy: DwgFileStructureHandler — 버전별 파싱 전략
• Factory: DwgFileStructureHandlerFactory — 버전에 맞는 핸들러 선택
• Registry: SectionParserRegistry — 섹션 이름 → 파서 매핑
• Builder: DwgReader, DwgDocument — Fluent API

Phase 2: 기초 구현 ✓

• BitStream I/O (읽기/쓰기), DWG 타입, 버전 감지, LZ77/CRC

Phase 4: R2000 지원 ✓

• R2000 HeaderVariables, 섹션 파싱 (22개 샘플 파일 100% 통과)

Phase 5: R2004 엔티티 해석 ✓

• Objects 섹션 비트 단위 파싱, 64개 엔티티 리더 구현

Phase 6A: R2007/R2010/R2013/R2018 기초 ✓

• R2007 Reed-Solomon 헤더, PageMap/SectionMap 추출
• R2010+ 파일 구조 인식

Phase 6B: Objects 섹션 추출 ✓

• R2007 RS(255,239) 복호화 및 LZ77 해제
• Objects 섹션 197KB+ 추출 (18개 샘플 100%)

Phase 7: 완전 통합 및 검증 ✓

• Handles 오프셋 계산 수정 (blockCount 8바이트 정렬)
• 순차 파싱 폴백 구현
• 4,816 엔티티 추출 (+42% 개선)

Phase 8: 엔티티 타입 확장 ✓

• 74개 엔티티 타입 구현 (완전 커버리지)
• 19개 신규 타입 추가 (MLINE, MTEXT, WIPEOUT, IMAGE 등)

Phase 9 Tier 1: R2004 LZ77 수정 ✓

• R2004 전용 LZ77 디컴프레서 구현 (+42% 개선, 645개 추가 엔티티)

Phase 9 Tier 3: R2010+ 라우팅 수정 ✓

• 아키텍처 버그 발견: R2010/R2013/R2018은 R2004 파일 구조 사용
• R2007 핸들러 대신 R2004 핸들러로 라우팅 변경
• Reed-Solomon 디코더 단순화 (deinterleave만, BM 에러정정 제거)
• 엔티티 추출 6,825 → 12,756 (+87%)

• 성능 최적화 (일부 R2018 파일 순차 파싱 폴백)
• R13/R14 완전 지원
• 보조 섹션 파서 확장 (AppInfo, Preview, XData)
• 쓰기 기능 (Phase 3)

• Java 16+
• Maven 3.6+

mvn clean compile

# Windows
run_test.bat path/to/sample.dwg

# macOS/Linux
./run_test.sh path/to/sample.dwg

# 직접 실행
mvn compile
java -cp target/classes:target/dependency/* \
  io.dwg.test.DwgParsingStageTest path/to/sample.dwg

자세한 테스트 가이드는 TESTING.md 참조.

문제: R2010, R2013, R2018 파일이 0개 엔티티 추출 (완전 실패)

근본 원인: libredwg를 참고한 결과, 파일 구조 라우팅에서 중대한 아키텍처 차이 발견

// libredwg/src/decode.c:222-226
VERSIONS (R_2007a, R_2007)  { return decode_R2007 (dat, dwg); }
SINCE (R_2010b)             { return decode_R2004 (dat, dwg); }

발견: R2010, R2013, R2018은 R2004 파일 구조 사용

• R2007은 유일하게 Reed-Solomon(255,239) 헤더 암호화 사용
• R2010+는 R2004 방식 (XOR 암호화 + LZ77)

해결: 파일 라우팅 변경

// Before: R2010/R2013/R2018 → R2007FileStructureHandler (XOR 구조로 RS 읽으려다 실패)
// After: R2010/R2013/R2018 → R2004FileStructureHandler (올바른 구조)

case R2004: case R2010: case R2013: case R2018:
    return new R2004FileStructureHandler();
case R2007:
    return new R2007FileStructureHandler();

보너스 발견: Reed-Solomon 디코더 단순화

• libredwg는 RS 에러 정정 호출을 주석 처리
• 디코더를 deinterleave 전용으로 단순화
• 이전 Berlekamp-Massey 에러 정정 제거

결과:

• R2010+ 성공률: 7% → 100%
• 추출 엔티티: 6,825 → 12,756 (+87%)

알고리즘 버그로 보이는 문제를 조사할 때는 먼저 알고리즘이 올바른 입력을 받는지 확인하세요. 이 경우 알고리즘 자체는 정상이었지만 잘못된 파일 구조로 라우팅되어 있었습니다.

import io.dwg.api.DwgReader;
import io.dwg.api.DwgDocument;
import io.dwg.entities.DwgEntity;
import java.nio.file.Paths;

// DWG 파일 읽기
DwgDocument doc = DwgReader.defaultReader()
    .open(Paths.get("drawing.dwg"));

// 문서 정보
System.out.println("버전: " + doc.version());
System.out.println("객체 수: " + doc.objectMap().size());

// 레이어 조회
doc.layer("0")
    .ifPresent(layer -> System.out.println("0 레이어 색상: " + layer.color()));

// 엔티티 조회
List<DwgEntity> entities = doc.entities();
for (DwgEntity e : entities) {
    System.out.println(e.objectType() + " at handle 0x" + Long.toHexString(e.handle()));
}

범례: 🟢 완성 / 🟡 기본/폴백 / ❌ 미구현

기하학 엔티티 (30개)

• 2D: LINE, CIRCLE, ARC, POLYLINE, LWPOLYLINE, SPLINE, ELLIPSE, TEXT, MTEXT
• 3D: 3DFACE, 3DPOLYLINE, REGION, SOLID, TRACE, SHAPE, MULTILEADER, ARC_DIMENSION
• 특수: HATCH, IMAGE, UNDERLAY, WIPEOUT, SURFACE, MESH, MLINE

객체 및 제어 (44개)

• LAYER, LINETYPE, STYLE, DIMSTYLE, APPID, UCS, VIEW, VPORT
• 제어 객체: BLOCK_CONTROL, ENDBLK, INSERT
• 속성: XREF, ATTRIB, ATTDEF
• 테이블: TABLE, SCALE_LIST, TABLESTYLE, CELLSTYLE, PLOTSTYLE
• 데이터: DICTIONARY, DICTIONARYVAR, LAYOUT, MATERIAL, DATASOURCE
• 기타: TOLERANCE, LEADER, OLE2FRAME, PROXY, PERSSUBENTMANAGER

[파일 읽기] → [버전 감지] → [헤더 파싱] → [섹션 추출] 
    ↓              ↓               ↓            ↓
 1단계         2단계          3단계        4단계

[섹션 파싱] → [객체 생성] → [DwgDocument] → [API 사용]
    ↓              ↓            ↓            ↓
  5단계         5단계        6단계        최종

각 단계는 독립적으로 테스트 가능합니다 (DwgParsingStageTest 참고).

• DwgReader — 파일 읽기
• DwgWriter — 파일 쓰기
• DwgDocument — 파싱된 문서

• DwgObject — 모든 객체의 기본 인터페이스
• DwgEntity — 도형 엔티티
• DwgVersion — 버전 열거 및 버전 비교
• HeaderVariables — 헤더 변수 (500+개)
• HandleRegistry — 핸들 → 오프셋 매핑

• BitStreamReader — 비트 단위 읽기
• BitStreamWriter — 비트 단위 쓰기
• ByteBufferBitInput — 버퍼 기반 입력
• ByteBufferBitOutput — 버퍼 기반 출력

MIT License

• OpenDesign Specification — 공식 스펙
• AutoCAD DWG 포맷 위키
• Autodesk 공식 문서

이슈 및 PR을 환영합니다.

• Initial design: ebandal
• Contributors: 커뮤니티 (현재)