Struct CuDepthMap 

pub struct CuDepthMap<A, E = CuDepthLength>
where
    E: CuDepthEncoding,
    A: ArrayLike<Element = E::Sample> + Send + Sync + 'static,
{
    pub format: CuDepthMapFormat,
    pub buffer_handle: CuHandle<A>,
    /* private fields */
}

Standard depth-map payload backed by a Copper handle.

The default encoding stores Length directly. Alternate encodings can retain a sensor’s compact native representation without a producer-side conversion or copy.

Fields

format: CuDepthMapFormat

buffer_handle: CuHandle<A>

Implementations

impl<A, E> CuDepthMap<A, E>

where E: CuDepthEncoding, A: ArrayLike<Element = E::Sample> + Send + Sync + 'static,

pub const fn encoding_descriptor() -> CuDepthEncodingDescriptor

pub fn new_encoded(format: CuDepthMapFormat, buffer_handle: CuHandle<A>) -> Self

pub fn get_raw(&self, x: u32, y: u32) -> Option<E::Sample>

Returns the native encoded sample at (x, y).

pub fn decode_sample(sample: E::Sample) -> Option<Length>

Converts a native sample into a physical length.

pub fn get(&self, x: u32, y: u32) -> Option<Length>

Returns the physical depth sample at (x, y).

Returns None for out-of-bounds coordinates and encoded invalid values.

pub fn get_meters(&self, x: u32, y: u32) -> Option<f32>

Returns the sample at (x, y) converted to meters.

pub fn convert_into<B, F>(&self, target: &mut CuDepthMap<B, F>) -> CuResult<()>

where F: CuDepthEncoding, B: ArrayLike<Element = F::Sample> + Send + Sync + 'static,

Converts this map into a caller-provided target map.

Only logical pixels are written; target row padding is left untouched. This performs one source lock, one target lock, and no allocation.

pub fn with_samples<R>( &self, f: impl FnOnce(&[E::Sample], CuDepthMapFormat) -> R, ) -> R

Accesses all samples under a single buffer lock.

The slice covers exactly CuDepthMapFormat::required_elements, including any row padding described by CuDepthMapFormat::stride.

pub fn with_samples_mut<R>( &mut self, f: impl FnOnce(&mut [E::Sample], CuDepthMapFormat) -> R, ) -> R

Mutably accesses all samples under a single buffer lock.

The slice covers exactly CuDepthMapFormat::required_elements, including any row padding described by CuDepthMapFormat::stride.

pub fn payload_should_log(&self) -> bool

pub fn apply_handle_content_policy(&self, mode: HandleContent)

pub fn mark_touched(&self)

impl<A> CuDepthMap<A, CuDepthLength>

where A: ArrayLike<Element = Length> + Send + Sync + 'static,

pub fn new(format: CuDepthMapFormat, buffer_handle: CuHandle<A>) -> Self

impl<A, T, S> CuDepthMap<A, CuDepthInteger<T, S>>

where T: CuDepthIntegerSample, S: CuDepthScale, A: ArrayLike<Element = T> + Send + Sync + 'static,

pub fn from_integer( format: CuDepthMapFormat, buffer_handle: CuHandle<A>, ) -> Self

Trait Implementations

impl<A, E> Clone for CuDepthMap<A, E>

where E: CuDepthEncoding + Clone, A: ArrayLike<Element = E::Sample> + Send + Sync + 'static + Clone,

fn clone(&self) -> CuDepthMap<A, E>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<A, E> Debug for CuDepthMap<A, E>

where E: CuDepthEncoding + Debug, A: ArrayLike<Element = E::Sample> + Send + Sync + 'static + Debug,

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

Formats the value using the given formatter.

impl<A, E> Decode<()> for CuDepthMap<A, E>

where E: CuDepthEncoding, A: ArrayLike<Element = E::Sample> + Send + Sync + 'static, CuHandle<A>: Decode<()>,

fn decode<D: Decoder<Context = ()>>( decoder: &mut D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given Decode.

impl<A, E> Default for CuDepthMap<A, E>

where E: CuDepthEncoding + Default, A: ArrayLike<Element = E::Sample> + Send + Sync + 'static + Default,

fn default() -> CuDepthMap<A, E>

Returns the “default value” for a type.

impl<'de, A, E> Deserialize<'de> for CuDepthMap<A, E>

where E: CuDepthEncoding, A: ArrayLike<Element = E::Sample> + Send + Sync + 'static, CuHandle<A>: Deserialize<'de>,

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<A, E> Encode for CuDepthMap<A, E>

where E: CuDepthEncoding, A: ArrayLike<Element = E::Sample> + Send + Sync + 'static, CuHandle<A>: Encode,

fn encode<Enc: Encoder>(&self, encoder: &mut Enc) -> Result<(), EncodeError>

Encode a given type.

impl<A, E> HandleContentAware for CuDepthMap<A, E>

where E: CuDepthEncoding, A: ArrayLike<Element = E::Sample> + Send + Sync + 'static,

impl<A, E> Serialize for CuDepthMap<A, E>

where E: CuDepthEncoding, A: ArrayLike<Element = E::Sample> + Send + Sync + 'static, CuHandle<A>: Serialize,

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<A, E> TypePath for CuDepthMap<A, E>

where E: CuDepthEncoding, A: ArrayLike<Element = E::Sample> + Send + Sync + 'static,

fn type_path() -> &'static str

fn short_type_path() -> &'static str

fn type_ident() -> Option<&'static str>

fn crate_name() -> Option<&'static str>

fn module_path() -> Option<&'static str>