acadrust 0.4.0

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

//! Encode / decode the annotative flag carried in `AcadAnnotative` EED.
//!
//! STYLE / DIMSTYLE / TABLESTYLE records have no native annotative field, so
//! AutoCAD stores it as extended data under the `AcadAnnotative` application,
//! exactly mirroring the DXF XDATA form `AnnotativeData { 1 <flag> }`.
//!
//! These functions produce / parse the raw EED data-item byte block (the bytes
//! that follow the `[length][app handle]` header), per the ODA `.dwg`
//! specification, §28 "Extended Entity Data":
//!   * code `0` string — R2007+: 2-byte char count then UTF-16LE; earlier:
//!     1-byte length, 2-byte codepage, then single-byte chars.
//!   * code `2` control — one byte: `0` = `{`, `1` = `}`.
//!   * code `70` short — 2 bytes little-endian.

const ANNOTATIVE_DATA: &str = "AnnotativeData";

/// Build the `AcadAnnotative` EED data-item bytes for `flag`.
/// `wide` selects the R2007+ UTF-16 string encoding.
pub(crate) fn encode(wide: bool, flag: bool) -> Vec<u8> {
    let mut b = Vec::new();

    // code 0: string "AnnotativeData"
    b.push(0);
    if wide {
        let units: Vec<u16> = ANNOTATIVE_DATA.encode_utf16().collect();
        b.extend_from_slice(&(units.len() as u16).to_le_bytes());
        for u in units {
            b.extend_from_slice(&u.to_le_bytes());
        }
    } else {
        b.push(ANNOTATIVE_DATA.len() as u8);
        b.extend_from_slice(&0u16.to_le_bytes()); // codepage
        b.extend_from_slice(ANNOTATIVE_DATA.as_bytes());
    }

    // code 2: '{'
    b.push(2);
    b.push(0);
    // code 70: class version = 1
    b.push(70);
    b.extend_from_slice(&1i16.to_le_bytes());
    // code 70: annotative flag
    b.push(70);
    b.extend_from_slice(&(flag as i16).to_le_bytes());
    // code 2: '}'
    b.push(2);
    b.push(1);

    b
}

/// Walk an `AcadAnnotative` EED data-item block and return its annotative flag
/// (the last 16-bit short, after the version short). Returns `None` if the
/// bytes don't parse as the expected items.
pub(crate) fn decode_flag(bytes: &[u8], wide: bool) -> Option<bool> {
    let mut i = 0usize;
    let mut last_short: Option<i16> = None;
    while i < bytes.len() {
        let code = bytes[i];
        i += 1;
        match code {
            0 => {
                // string
                if wide {
                    let n = u16::from_le_bytes([*bytes.get(i)?, *bytes.get(i + 1)?]) as usize;
                    i += 2 + n * 2;
                } else {
                    let n = *bytes.get(i)? as usize;
                    i += 1 + 2 + n; // length + codepage + chars
                }
            }
            2 => i += 1,            // control string
            4 => {
                let n = *bytes.get(i)? as usize;
                i += 1 + n;
            }
            3 | 5 => i += 8,        // layer / entity handle
            10..=13 => i += 24,     // points
            40..=42 => i += 8,      // reals
            70 => {
                last_short = Some(i16::from_le_bytes([*bytes.get(i)?, *bytes.get(i + 1)?]));
                i += 2;
            }
            71 => i += 4,
            _ => return None,
        }
        if i > bytes.len() {
            return None;
        }
    }
    last_short.map(|v| v != 0)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn roundtrip_wide() {
        assert_eq!(decode_flag(&encode(true, true), true), Some(true));
        assert_eq!(decode_flag(&encode(true, false), true), Some(false));
    }

    #[test]
    fn roundtrip_narrow() {
        assert_eq!(decode_flag(&encode(false, true), false), Some(true));
        assert_eq!(decode_flag(&encode(false, false), false), Some(false));
    }
}