Skip to content

Geometry Delete

Deprecated — use core.handles.release, the universal batched release API for every arena handle kind (values, profiles/contours, and brep topology). These methods remain as thin aliases for profile/contour handles.

Geometry deletion — release transient geometry resource handles (all-handle model). Methods here free a handle's backing registry entry and reclaim its share of the plugin's resource quota. This is purely a handle-lifecycle operation: it does NOT tear down or delete any engine-side geometry. Once released, the handle is no longer resolvable and must not be reused. Accessed via snaptrude.core.geom.delete.

Functions

profile(profile)

Free a transient profile resource handle — releases its registry entry and reclaims its share of the plugin's resource quota. This is a handle-lifecycle operation only and does NOT tear down any engine-side geometry.

  • Parameters:
    • profile: ProfileHandle — The transient profile handle to release
  • Returns: void — Nothing
ts
const profile = await snaptrude.core.geom.create.profileFromLinePoints(points);
// ... use the profile ...
await snaptrude.core.geom.delete.profile(profile);

contour(contour)

Free a transient contour resource handle — releases its registry entry and reclaims its share of the plugin's resource quota. Handle-lifecycle only; does NOT tear down engine-side geometry, nor the contour's child profile handles.

  • Parameters:
    • contour: ContourHandle — The transient contour handle to release
  • Returns: void — Nothing
ts
await snaptrude.core.geom.delete.contour(contour);

Errors

Failed calls reject with a typed PluginError — see Error Handling. This namespace adds no conditions of its own: release is idempotent, so releasing an already-released (or never-minted) handle is a no-op rather than an error.