acadrust 0.3.2

A pure Rust library for reading and writing CAD files in DXF format (ASCII and Binary) and DWG format (Binary).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178

//! Object type constants shared between reader and writer.
//!
//! These match ACadSharp's fixed type codes (ODA spec table 2.12).
//! Fixed types 0–82 use literal codes; non-fixed types use
//! their DXF class number (500+).

// ── Fixed entity types (graphical) ──────────────────────────────────

pub const OBJ_UNUSED: i16 = 0;
pub const OBJ_TEXT: i16 = 1;
pub const OBJ_ATTRIB: i16 = 2;
pub const OBJ_ATTDEF: i16 = 3;
pub const OBJ_BLOCK: i16 = 4;
pub const OBJ_ENDBLK: i16 = 5;
pub const OBJ_SEQEND: i16 = 6;
pub const OBJ_INSERT: i16 = 7;
pub const OBJ_MINSERT: i16 = 8;
// 9 = skipped
pub const OBJ_VERTEX_2D: i16 = 10;
pub const OBJ_VERTEX_3D: i16 = 11;
pub const OBJ_VERTEX_MESH: i16 = 12;
pub const OBJ_VERTEX_PFACE: i16 = 13;
pub const OBJ_VERTEX_PFACE_FACE: i16 = 14;
pub const OBJ_POLYLINE_2D: i16 = 15;
pub const OBJ_POLYLINE_3D: i16 = 16;
pub const OBJ_ARC: i16 = 17;
pub const OBJ_CIRCLE: i16 = 18;
pub const OBJ_LINE: i16 = 19;
pub const OBJ_DIMENSION_ORDINATE: i16 = 20;
pub const OBJ_DIMENSION_LINEAR: i16 = 21;
pub const OBJ_DIMENSION_ALIGNED: i16 = 22;
pub const OBJ_DIMENSION_ANG_3PT: i16 = 23;
pub const OBJ_DIMENSION_ANG_2LN: i16 = 24;
pub const OBJ_DIMENSION_RADIUS: i16 = 25;
pub const OBJ_DIMENSION_DIAMETER: i16 = 26;
pub const OBJ_POINT: i16 = 27;
pub const OBJ_3DFACE: i16 = 28;
pub const OBJ_POLYLINE_PFACE: i16 = 29;
pub const OBJ_POLYLINE_MESH: i16 = 30;
pub const OBJ_SOLID: i16 = 31;
pub const OBJ_TRACE: i16 = 32;
pub const OBJ_SHAPE: i16 = 33;
pub const OBJ_VIEWPORT: i16 = 34;
pub const OBJ_ELLIPSE: i16 = 35;
pub const OBJ_SPLINE: i16 = 36;
pub const OBJ_REGION: i16 = 37;
pub const OBJ_3DSOLID: i16 = 38;
pub const OBJ_BODY: i16 = 39;
pub const OBJ_RAY: i16 = 40;
pub const OBJ_XLINE: i16 = 41;
pub const OBJ_DICTIONARY: i16 = 42;
pub const OBJ_OLEFRAME: i16 = 43;
pub const OBJ_MTEXT: i16 = 44;
pub const OBJ_LEADER: i16 = 45;
pub const OBJ_TOLERANCE: i16 = 46;
pub const OBJ_MLINE: i16 = 47;

// ── Table control / table entry types ───────────────────────────────

pub const OBJ_BLOCK_CONTROL: i16 = 48;
pub const OBJ_BLOCK_HEADER: i16 = 49;
pub const OBJ_LAYER_CONTROL: i16 = 50;
pub const OBJ_LAYER: i16 = 51;
pub const OBJ_STYLE_CONTROL: i16 = 52;
pub const OBJ_STYLE: i16 = 53;
// 54-55 skipped
pub const OBJ_LTYPE_CONTROL: i16 = 56;
pub const OBJ_LTYPE: i16 = 57;
// 58-59 skipped
pub const OBJ_VIEW_CONTROL: i16 = 60;
pub const OBJ_VIEW: i16 = 61;
pub const OBJ_UCS_CONTROL: i16 = 62;
pub const OBJ_UCS: i16 = 63;
pub const OBJ_VPORT_CONTROL: i16 = 64;
pub const OBJ_VPORT: i16 = 65;
pub const OBJ_APPID_CONTROL: i16 = 66;
pub const OBJ_APPID: i16 = 67;
pub const OBJ_DIMSTYLE_CONTROL: i16 = 68;
pub const OBJ_DIMSTYLE: i16 = 69;
pub const OBJ_VPENT_HDR_CONTROL: i16 = 70;
pub const OBJ_VPENT_HDR: i16 = 71;

// ── Non-graphical objects ────────────────────────────────────────────

pub const OBJ_GROUP: i16 = 72;
pub const OBJ_MLINESTYLE: i16 = 73;
pub const OBJ_OLE2FRAME: i16 = 74;

// ── Standard fixed entity/object types (75+) ────────────────────────
//
// These match ACadSharp's ObjectType enum values.  Types 77–82 are
// fixed type codes in the ODA spec; class-based types (MESH, IMAGE,
// MULTILEADER) always use class numbers ≥500 in the binary.

pub const OBJ_LWPOLYLINE: i16 = 77;         // 0x4D — fixed entity
pub const OBJ_HATCH: i16 = 78;              // 0x4E — fixed entity
pub const OBJ_XRECORD: i16 = 79;            // 0x4F — fixed non-entity
pub const OBJ_PLACEHOLDER: i16 = 80;        // 0x50 — fixed non-entity
pub const OBJ_LAYOUT: i16 = 82;             // 0x52 — fixed non-entity

// Class-based (UNLISTED) entity types — always use class number (500+)
// in the binary stream.  Matched via dxf_name → type_code translation.
pub const OBJ_IMAGE: i16 = -1;
pub const OBJ_MESH: i16 = -2;
pub const OBJ_MULTILEADER: i16 = -3;
pub const OBJ_WIPEOUT: i16 = -4;

// Class-based non-entity objects — also resolved via class mapping for
// portable type codes.  The values here match ACadSharp's ObjectType.
pub const OBJ_DICTIONARYWDFLT: i16 = 0x78;  // 120
pub const OBJ_DICTIONARYVAR: i16 = 0x79;    // 121
pub const OBJ_PLOTSETTINGS: i16 = 0x7A;     // 122
pub const OBJ_MLEADERSTYLE: i16 = 0x7B;     // 123
pub const OBJ_IMAGEDEF: i16 = 0x7C;         // 124
pub const OBJ_IMAGEDEFREACTOR: i16 = 0x7D;  // 125
pub const OBJ_SCALE: i16 = 0x7E;            // 126
pub const OBJ_SORTENTSTABLE: i16 = 0x7F;    // 127
pub const OBJ_RASTERVARIABLES: i16 = 0x80;  // 128
pub const OBJ_DBCOLOR: i16 = 0x81;          // 129
pub const OBJ_WIPEOUTVARIABLES: i16 = 0x82; // 130
pub const OBJ_TABLECONTENT: i16 = 0x69;     // 105
pub const OBJ_TABLESTYLE: i16 = 0x6A;       // 106

/// Returns true if the type code is a graphical entity (not a table / object).
pub fn is_entity_type(type_code: i16) -> bool {
    // Fixed entity types: 1–47, 74 (OLE2FRAME), 77 (LWPOLYLINE), 78 (HATCH)
    // EXCEPT: 42 (OBJ_DICTIONARY) is a non-graphical object, not an entity.
    // Class-based entity sentinels: -4..-1 (WIPEOUT, MULTILEADER, MESH, IMAGE)
    // Class-based entity types (≥500) are NOT included here; the builder
    // checks the class's is_an_entity flag directly.
    matches!(type_code, -4..=-1 | 1..=41 | 43..=47 | 74 | 77 | 78)
}

/// Returns true if the type code is a table control or entry.
pub fn is_table_type(type_code: i16) -> bool {
    matches!(type_code, 48..=71)
}

/// Map a DXF class name to the internal OBJ_* type code constant.
///
/// This is used to translate class-based type codes (500+) read from the
/// binary stream into the internal constants used by the document builder.
pub fn dxf_name_to_type_code(dxf_name: &str) -> Option<i16> {
    match dxf_name.to_uppercase().as_str() {
        // Entities
        "LWPOLYLINE" => Some(OBJ_LWPOLYLINE),
        "HATCH" => Some(OBJ_HATCH),
        "IMAGE" => Some(OBJ_IMAGE),
        "WIPEOUT" => Some(OBJ_WIPEOUT),
        "MESH" => Some(OBJ_MESH),
        "MULTILEADER" => Some(OBJ_MULTILEADER),
        "OLE2FRAME" => Some(OBJ_OLE2FRAME),
        // Non-entity objects
        "ACDBDICTIONARYWDFLT" => Some(OBJ_DICTIONARYWDFLT),
        "DICTIONARYVAR" => Some(OBJ_DICTIONARYVAR),
        "LAYOUT" => Some(OBJ_LAYOUT),
        "XRECORD" => Some(OBJ_XRECORD),
        "ACDBPLACEHOLDER" => Some(OBJ_PLACEHOLDER),
        "PLOTSETTINGS" => Some(OBJ_PLOTSETTINGS),
        "MLEADERSTYLE" => Some(OBJ_MLEADERSTYLE),
        "IMAGEDEF" => Some(OBJ_IMAGEDEF),
        "IMAGEDEF_REACTOR" => Some(OBJ_IMAGEDEFREACTOR),
        "SCALE" => Some(OBJ_SCALE),
        "SORTENTSTABLE" => Some(OBJ_SORTENTSTABLE),
        "RASTERVARIABLES" => Some(OBJ_RASTERVARIABLES),
        "DBCOLOR" => Some(OBJ_DBCOLOR),
        "WIPEOUTVARIABLES" => Some(OBJ_WIPEOUTVARIABLES),
        "TABLECONTENT" => Some(OBJ_TABLECONTENT),
        "TABLESTYLE" => Some(OBJ_TABLESTYLE),
        _ => None,
    }
}

/// Returns true if the given class represents a graphical entity based
/// on its `is_an_entity` flag.
pub fn is_class_entity(is_an_entity: bool) -> bool {
    is_an_entity
}