forked from 1b-agent/opencadstudio-upstream
Sebastian
e41086b058
New crate crates/ocs_doc_api: object-centric facade (DocApi -> Document -> collections -> typed handles), transport-agnostic wire layer (DocApiEnvelope = single op | read-only query batch), per-op autocommit (no write transactions), bulk ops with upfront-validation all-or-nothing, structured ApiError, and build-time codegen (spec/entities.toml -> ops/query enums, api_reference.md, binding_schema.json). ocs_plugin_api: append-only PluginRequest::DocApiRequest / PluginResponse:: DocApiResponse (serde_bytes payload) + defaulted HostApi::doc_api_dispatch. Host: DocApiBackend impl for HostSession (src/app/doc_api.rs) mapping to scene primitives (solid_models lift-on-miss, register_prepared_solid_model, meshes metrics), entity conversions (doc_api_convert.rs), HostSession accessors + doc_api_dispatch override. Tests: 592 host lib (incl. 7 DocApi integration tests: create/boolean/query, unknown-id, transform-many all-or-nothing, query-batch cap, 2D/geometric/DWG roundtrips), 8 crate unit tests. Examples + README/ARCHITECTURE/IMPLEMENTATION docs.
44 lines
1.5 KiB
Rust
44 lines
1.5 KiB
Rust
//! Example 1 — Create solid primitives and query their geometry.
|
|
//!
|
|
//! Run: `cargo run --example e1_primitives_and_queries --features host`
|
|
//!
|
|
//! Shows: `doc.solids().create_*` for the supported primitives, and the read
|
|
//! queries `bounds()` / `volume()` / `centroid()` on a `Solid`.
|
|
|
|
mod common;
|
|
|
|
use ocs_doc_api::DocApi;
|
|
|
|
fn main() -> ocs_doc_api::ApiResult<()> {
|
|
// In-process document over the mock backend (no host binary needed).
|
|
let api = DocApi::in_process(common::MockBackend::default(), 0);
|
|
let doc = api.document(api.active_tab());
|
|
|
|
// The supported solid primitives.
|
|
let block = doc.solids().create_cuboid([0.0, 0.0, 0.0], [10.0, 10.0, 10.0])?;
|
|
let ball = doc.solids().create_sphere([5.0, 5.0, 5.0], 6.0)?;
|
|
let cyl = doc.solids().create_cylinder([0.0, 0.0, 0.0], 4.0, 12.0)?;
|
|
|
|
// Geometric queries are entity methods — one host call each.
|
|
let bb = block.bounds()?;
|
|
let vol = ball.volume()?;
|
|
let cg = cyl.centroid()?;
|
|
|
|
println!("cuboid bounds : {bb:?}");
|
|
println!("sphere volume : {vol:.2} (analytic ~904.78)");
|
|
println!("cylinder centroid: {cg:?}");
|
|
|
|
// Read-only batching: same queries, ONE round-trip.
|
|
let res = doc.query_batch(|q| {
|
|
q.bounds(&block);
|
|
q.volume(&ball);
|
|
q.centroid(&cyl);
|
|
})?;
|
|
let (bb2, vol2, cg2) = (res.bounds(0)?, res.volume(1)?, res.centroid(2)?);
|
|
assert_eq!(bb, bb2);
|
|
assert!((vol - vol2).abs() < 1e-9);
|
|
assert_eq!(cg, cg2);
|
|
println!("query_batch matches the per-call results");
|
|
Ok(())
|
|
}
|