//! Other CAD formats read through [cadmpeg](https://github.com/cadmpeg/cadmpeg): FreeCAD //! `.FCStd` and Rhino `.3dm`. cadmpeg decodes the file into its neutral model and writes that as //! STEP, which the Import feature then reads and keeps like any STEP file. //! //! Only codecs for open formats are compiled in (the workspace enables cadmpeg-registry's //! `fcstd`, `rhino` and `step` features alone). cadmpeg's codecs for commercial formats, and its //! `sat` codec (a ShapeManager stream decoder that reads ACIS as one dialect), are not built. //! //! This module is the importer seam: the one place cadmpeg is called, returning STEP text plus //! warnings. A cadmpeg-based STEP reader could be added here later and chosen by a setting, to //! compare with our own STEP reader, without changing that reader. //! //! cadmpeg is not built for the browser (it compiles the zstd C library); there these formats //! return "not supported in the browser yet". /// File extensions read through cadmpeg (lower case). pub const NATIVE_CAD_EXTS: [&str; 2] = ["fcstd", "3dm"]; /// Is this a FreeCAD or Rhino file name (any case)? pub fn is_native_cad_path(path: &str) -> bool { std::path::Path::new(path).extension().and_then(|e| e.to_str()).is_some_and(|e| NATIVE_CAD_EXTS.iter().any(|x| e.eq_ignore_ascii_case(x))) } /// Restate a FreeCAD or Rhino file (`file` is its name) as STEP text, with the losses /// and warnings cadmpeg reported. Panics inside cadmpeg become errors. #[cfg(not(target_arch = "wasm32"))] pub fn native_cad_to_step(bytes: &[u8], file: &str) -> Result<(String, Vec), String> { let name = std::path::Path::new(file).file_name().map(|s| s.to_string_lossy().to_string()).unwrap_or_else(|| file.to_string()); solidcraft_kernel::guard("cadmpeg import", || convert::to_step(&name, bytes).map_err(solidcraft_kernel::KernelError::Invalid)).map_err( |e| match e { solidcraft_kernel::KernelError::Invalid(m) => m, e => e.to_string(), }, ) } /// Restate a FreeCAD or Rhino file as STEP: not available in the browser yet. #[cfg(target_arch = "wasm32")] pub fn native_cad_to_step(_bytes: &[u8], file: &str) -> Result<(String, Vec), String> { Err(format!("{file}: not supported in the browser yet (FreeCAD and Rhino files open in the desktop app)")) } #[cfg(not(target_arch = "wasm32"))] mod convert { use std::io::Cursor; use cadmpeg_core::decode::{DecodeArena, DecodeContext, DecodeMode, DecodePolicy, ResourceLimits, View}; use cadmpeg_ir::codec::write::{EncodeInput, target::TargetRequest}; use cadmpeg_ir::codec::{DecodeFailure, DecodeOptions, DecodeResult}; use cadmpeg_ir::validate::validate_neutral_for_decode; use cadmpeg_registry::{DETECTION_PREFIX_LEN, Format, InputCatalog, ResolveSourceError, ResolvedSource, build_encoder, forced_input}; /// The codecs we accept (cadmpeg codec ids), whatever else the registry recognises. const ACCEPTED: [&str; 2] = ["fcstd", "rhino"]; /// Caps for hostile input: cadmpeg's tight `service` profile, with our STEP size limit. pub(super) fn policy() -> DecodePolicy { DecodePolicy { mode: DecodeMode::Salvage, limits: ResourceLimits { max_input_bytes: crate::MAX_STEP_BYTES as u64, ..ResourceLimits::service() }, } } /// Decode `bytes` (a file called `name`, extension `ext`) with the codec cadmpeg detects from /// the bytes, else the one the extension names, if it is one of `accepted`. Returns the codec id /// and the decoded model. pub(super) fn decode(name: &str, ext: &str, bytes: &[u8], accepted: &[&str]) -> Result<(String, DecodeResult), String> { let policy = policy(); let catalog = InputCatalog::with_builtins(); let codec = { let arena = DecodeArena::new(); let (ctx, _) = DecodeContext::from_root_bytes(&[], &arena, &policy).map_err(|e| e.to_string())?; let prefix = bytes.get(..DETECTION_PREFIX_LEN).unwrap_or(bytes); let resolved = catalog.resolve_seekable_source(&ctx, View::over_retained(prefix), &mut Cursor::new(bytes), None); let resolved = match resolved { Ok(ResolvedSource::Unrecognized | ResolvedSource::Cadir) | Err(ResolveSourceError::Ambiguous(_)) => { match forced_input(ext).map_err(|e| e.to_string())? { Some(forced) => catalog.resolve_source(&ctx, View::over_retained(prefix), Some(forced)), None => Ok(ResolvedSource::Unrecognized), } } other => other, }; ctx.finish_session().map_err(|e| e.to_string())?; match resolved.map_err(|e| format!("{name}: {e}"))? { ResolvedSource::Native { codec, .. } => codec, _ => return Err(format!("{name}: unrecognised file contents")), } }; let format = codec.id().as_str().to_string(); if !accepted.contains(&format.as_str()) { return Err(format!("{name}: {format} files are not supported (FreeCAD .FCStd and Rhino .3dm only)")); } // Decode in memory under the caps. let options = DecodeOptions { container_only: false, policy }; let decoded = codec.decode(&mut Cursor::new(bytes), &options).map_err(|e| match e { DecodeFailure::Codec(e) => format!("{name}: could not read this {format} file: {e}"), other => format!("{name}: {other}"), })?; Ok((format, decoded)) } pub(super) fn to_step(name: &str, bytes: &[u8]) -> Result<(String, Vec), String> { let ext = name.rsplit_once('.').map(|(_, e)| e.to_ascii_lowercase()).unwrap_or_default(); if !super::NATIVE_CAD_EXTS.contains(&ext.as_str()) { return Err(format!("{name}: not supported (FreeCAD .FCStd and Rhino .3dm only)")); } let (format, decoded) = decode(name, &ext, bytes, &ACCEPTED)?; let policy = policy(); let (ir, report, fidelity) = decoded.into_parts(); if !report.geometry_transferred() { return Err(format!("{name}: no geometry could be read from this {format} file")); } let mut warnings: Vec = report.losses.iter().map(|l| format!("{}: {}", l.code, l.message)).collect(); // Validate the neutral model, as cadmpeg's own conversion does. let arena = DecodeArena::new(); let ctx = DecodeContext::for_loaded_input(&arena, &policy, bytes.len() as u64).map_err(|e| e.to_string())?; let validation = validate_neutral_for_decode(&ctx, &ir, Vec::new()).map_err(|e| e.to_string())?; ctx.finish_session().map_err(|e| e.to_string())?; warnings.extend(validation.findings.iter().map(|f| format!("{}: {}", f.severity, f.message))); if !validation.is_ok() { return Err(format!("{name}: the {format} model is invalid ({} errors)", validation.error_count())); } // Write it as STEP AP214. let plan = build_encoder(Format::Step) .plan(EncodeInput::new(&ir, Some(&fidelity)), TargetRequest::Explicit("ap214")) .map_err(|e| format!("{name}: could not restate as STEP: {e}"))?; let losses = &plan.report().losses; if losses.iter().any(|l| l.code.to_string() == "step/export.no-exportable-solids") { return Err(format!("{name}: this {format} file has no solids that can be imported")); } warnings.extend(losses.iter().map(|l| format!("{}: {}", l.code, l.message))); let mut out = Vec::new(); plan.write_to(&mut out).map_err(|e| e.to_string())?; let step = String::from_utf8(out).map_err(|e| e.to_string())?; Ok((super::name_unnamed_products(step, name), warnings)) } } /// cadmpeg's STEP writer calls a product it has no name for `cadmpeg_model`; name it after the /// file instead (as plain STEP text: letters, digits, spaces, `-`, `_` and `.` only). #[cfg(not(target_arch = "wasm32"))] fn name_unnamed_products(step: String, file: &str) -> String { const PLACEHOLDER: &str = "'cadmpeg_model'"; let stem: String = std::path::Path::new(file) .file_stem() .map(|s| s.to_string_lossy().chars().filter(|c| c.is_ascii_alphanumeric() || matches!(c, ' ' | '-' | '_' | '.')).collect()) .unwrap_or_default(); if stem.trim().is_empty() || !step.contains(PLACEHOLDER) { step } else { step.replace(PLACEHOLDER, &format!("'{stem}'")) } } #[cfg(test)] mod tests;