Skip to main content

GeometryHandle

Struct GeometryHandle 

Source
pub struct GeometryHandle<T> { /* private fields */ }
Expand description

An app-owned, versioned handle to one batch of geometry.

Cheap to clone (Arc bump). See the module docs for the upload/caching contract. Type aliases MeshHandle, PointsHandle, and LinesHandle name the concrete instantiations used by the marks.

Implementations§

Source§

impl<T: GeometryData> GeometryHandle<T>

Source

pub fn new(data: T) -> Self

Create a handle, allocating a fresh GeometryId and computing bounds. Revision starts at 1.

Source

pub fn set(&self, data: T)

Replace the geometry and advance the revision, recomputing bounds. The backend re-uploads on its next draw because the revision moved.

This is the baseline update path: it re-uploads the whole buffer. Finer-grained update_range / append paths are designed to slot in later (the handle is the stable surface) without breaking callers of set.

Source

pub fn id(&self) -> GeometryId

Stable identity for backend buffer caches.

Source

pub fn revision(&self) -> u64

Monotonic revision; advances on every GeometryHandle::set.

Source

pub fn bounds(&self) -> Aabb

Cached bounds of the current geometry.

Source

pub fn snapshot(&self) -> (Arc<T>, u64)

Snapshot the current data and revision for upload. Returns an Arc clone (no geometry copy) plus the revision it corresponds to, so the backend can cache by (id, revision).

Trait Implementations§

Source§

impl<T: Clone> Clone for GeometryHandle<T>

Source§

fn clone(&self) -> GeometryHandle<T>

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl<T: GeometryData> Debug for GeometryHandle<T>

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<T> Freeze for GeometryHandle<T>

§

impl<T> RefUnwindSafe for GeometryHandle<T>

§

impl<T> Send for GeometryHandle<T>
where T: Sync + Send,

§

impl<T> Sync for GeometryHandle<T>
where T: Sync + Send,

§

impl<T> Unpin for GeometryHandle<T>

§

impl<T> UnsafeUnpin for GeometryHandle<T>

§

impl<T> UnwindSafe for GeometryHandle<T>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<SS, SP> SupersetOf<SS> for SP
where SS: SubsetOf<SP>,

Source§

fn to_subset(&self) -> Option<SS>

The inverse inclusion map: attempts to construct self from the equivalent element of its superset. Read more
Source§

fn is_in_subset(&self) -> bool

Checks if self is actually part of its subset T (and can be converted to it).
Source§

fn to_subset_unchecked(&self) -> SS

Use with care! Same as self.to_subset but without any property checks. Always succeeds.
Source§

fn from_subset(element: &SS) -> SP

The inclusion map: converts self to the equivalent element of its superset.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.