vcad 0.1.0

Parametric CAD in Rust — CSG modeling with multi-format export
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

//! STEP file export
//!
//! STEP export requires the `step` feature and OpenCASCADE (OCCT) installed.
//!
//! ```bash
//! # macOS
//! brew install cmake opencascade
//!
//! # Ubuntu/Debian
//! sudo apt install cmake libocct-dev
//!
//! # Build with STEP support
//! cargo build --features step
//! ```
//!
//! For now, use STL export (always available) or export STL and convert
//! using FreeCAD, Blender, or online converters.

/// Check if STEP export is available
pub fn is_available() -> bool {
    cfg!(feature = "step")
}

/// Error returned when STEP export is not available
#[derive(Debug)]
pub struct StepNotAvailable;

impl std::fmt::Display for StepNotAvailable {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(
            f,
            "STEP export requires the 'step' feature. Build with: cargo build --features step"
        )
    }
}

impl std::error::Error for StepNotAvailable {}

#[cfg(feature = "step")]
mod occt_impl {
    use opencascade::primitives::Shape;
    use std::path::Path;

    /// Export a shape to STEP format
    pub fn write_step(shape: &Shape, path: impl AsRef<Path>) -> Result<(), std::io::Error> {
        shape
            .write_step(path.as_ref())
            .map_err(|e| std::io::Error::new(std::io::ErrorKind::Other, e.to_string()))
    }
}

#[cfg(feature = "step")]
pub use occt_impl::write_step;