forked from 1b-agent/opencadstudio-upstream
Hakan Seven
3385160493
Add the typed document facade and plugin IPC adapter. Prepare bulk edits before mutation, preserve undo and dirty state, keep profile elevations, validate numeric inputs and session bindings, and generate Python constructors with typed results. Reuse existing entity transforms and profile conversion. Compute mass properties and closed-surface bounds in cadkernel; pin its main revision 6a5e6fc2822f6af6b2611cd605b44437b35158f0. Keep plugin API metadata at version 6. Validation: 646 native application tests, 597 kernel tests, 12 document API tests, 91 plugin API tests, 3 Python tests, default/IPC feature builds and wasm32 check passed.
101 lines
3.6 KiB
Rust
101 lines
3.6 KiB
Rust
//! Kernel geometry helpers (host feature, plan §10 code-mapping table). Thin
|
||
//! wrappers over `cadkernel::brep::*` mapping the crate's plain-data DTOs to the
|
||
//! non-serde kernel types. Kernel keys never cross the API (decision #7).
|
||
|
||
use cadkernel::geom2d::Curve as Curve2;
|
||
use cadkernel::space::Plane;
|
||
|
||
use crate::backend::KernelBody;
|
||
use crate::error::{ApiError, ApiResult, GeometryErrorKind};
|
||
use crate::ops::{BoolOp, SolidPrimitive};
|
||
|
||
fn geom_err(kind: GeometryErrorKind, msg: impl Into<String>) -> ApiError {
|
||
ApiError::geometry(kind, msg)
|
||
}
|
||
|
||
/// Signed volume and centroid of a closed triangle mesh via the divergence
|
||
/// theorem: V = Σ v0·(v1×v2)/6, C = Σ (v0+v1+v2)·tetra_vol / (4V). Single source
|
||
/// of truth shared by the host backend and the test/example mock backends.
|
||
pub fn mesh_volume_centroid(mesh: &cadkernel::brep::Mesh) -> (f64, [f64; 3]) {
|
||
mesh.mass_properties().unwrap_or((0.0, [0.0; 3]))
|
||
}
|
||
|
||
pub fn validate_placement(p: &crate::PlacementSpec) -> ApiResult<()> {
|
||
let placement = cadkernel::brep::Placement {
|
||
origin: p.origin,
|
||
x_axis: p.x_axis,
|
||
y_axis: p.y_axis,
|
||
z_axis: p.z_axis,
|
||
};
|
||
if placement.scale().is_none() || p.origin.iter().any(|v| !v.is_finite()) {
|
||
return Err(ApiError::validation(
|
||
"Transform",
|
||
"placement must be a finite, nonzero similarity",
|
||
));
|
||
}
|
||
Ok(())
|
||
}
|
||
|
||
/// Construct a solid primitive.
|
||
pub fn make_solid(p: &SolidPrimitive) -> ApiResult<KernelBody> {
|
||
crate::validation::solid(p)?;
|
||
use cadkernel::brep::make;
|
||
let body = match *p {
|
||
SolidPrimitive::Cuboid { origin, size } => make::cuboid(origin, size),
|
||
SolidPrimitive::Sphere { centre, radius } => make::sphere(centre, radius),
|
||
SolidPrimitive::Cylinder {
|
||
base,
|
||
radius,
|
||
height,
|
||
} => make::cylinder(base, radius, height),
|
||
SolidPrimitive::Cone {
|
||
base,
|
||
radius,
|
||
height,
|
||
} => make::cone(base, radius, height),
|
||
SolidPrimitive::Torus {
|
||
centre,
|
||
major_radius,
|
||
minor_radius,
|
||
} => make::torus(centre, major_radius, minor_radius),
|
||
SolidPrimitive::Wedge { origin, size } => make::wedge(origin, size[0], size[1], size[2]),
|
||
};
|
||
body.ok_or_else(|| {
|
||
geom_err(
|
||
GeometryErrorKind::InvalidInput,
|
||
"kernel make returned empty body",
|
||
)
|
||
})
|
||
}
|
||
|
||
/// Boolean combine (pure): `brep::combine(a, b, op, operation_tolerance(&[&a,&b]))`.
|
||
/// Maps the kernel `Snag` to `ApiError::Geometry`. Does NOT mutate the inputs.
|
||
pub(crate) fn boolean(a: &KernelBody, b: &KernelBody, op: BoolOp) -> ApiResult<KernelBody> {
|
||
let kernel_op = crate::executor::kernel_bool_op(op);
|
||
let tol = cadkernel::brep::operation_tolerance(&[a, b]);
|
||
cadkernel::brep::combine(a.clone(), b.clone(), kernel_op, tol)
|
||
.map_err(|e| geom_err(GeometryErrorKind::BooleanFailed, format!("{e:?}")))
|
||
}
|
||
|
||
/// Extrude a closed 2D profile into a solid (`brep::extrude`).
|
||
pub(crate) fn extrude(
|
||
plane: Plane,
|
||
profile: &[Curve2],
|
||
direction: [f64; 3],
|
||
) -> ApiResult<KernelBody> {
|
||
cadkernel::brep::extrude(plane, profile, direction)
|
||
.ok_or_else(|| geom_err(GeometryErrorKind::InvalidInput, "extrude failed"))
|
||
}
|
||
|
||
/// Revolve a closed 2D profile about an axis into a solid (`brep::revolve`).
|
||
pub(crate) fn revolve(
|
||
plane: Plane,
|
||
profile: &[Curve2],
|
||
pivot: [f64; 3],
|
||
axis: [f64; 3],
|
||
angle: f64,
|
||
) -> ApiResult<KernelBody> {
|
||
cadkernel::brep::revolve(plane, profile, pivot, axis, angle)
|
||
.ok_or_else(|| geom_err(GeometryErrorKind::InvalidInput, "revolve failed"))
|
||
}
|