Struct PboTensor 

pub struct PboTensor<T>
where
    T: Num + Clone + Debug + Send + Sync,
{
    pub name: String,
    pub shape: Vec<usize>,
    /* private fields */
}

A tensor backed by an OpenGL Pixel Buffer Object.

Fields

name: String

shape: Vec<usize>

Implementations

impl<T> PboTensor<T>

where T: Num + Clone + Debug + Send + Sync,

pub fn from_pbo( buffer_id: u32, size: usize, shape: &[usize], name: Option<&str>, ops: Arc<dyn PboOps>, ) -> Result<Self>

Create a new PBO tensor from an already-allocated GL buffer.

Called by the image crate after creating the PBO on the GL thread. Users should not call this directly — use ImageProcessor::create_image().

Errors

Returns Error::ShapeMismatch if size does not equal shape.iter().product::<usize>() * std::mem::size_of::<T>(). Returns Error::InvalidSize if size is zero.

pub fn buffer_id(&self) -> u32

Returns the GL buffer ID for this PBO.

pub fn is_mapped(&self) -> bool

Returns true if the PBO is currently mapped for CPU access.

Trait Implementations

impl<T> Clone for PboTensor<T>

where T: Num + Clone + Debug + Send + Sync,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for PboTensor<T>

where T: Num + Clone + Debug + Send + Sync,

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

Formats the value using the given formatter.

impl<T> Send for PboTensor<T>

where T: Num + Clone + Debug + Send + Sync,

impl<T> Sync for PboTensor<T>

where T: Num + Clone + Debug + Send + Sync,

impl<T> TensorTrait<T> for PboTensor<T>

where T: Num + Clone + Debug + Send + Sync,

fn set_logical_shape(&mut self, shape: &[usize]) -> Result<()>

Capacity-based reconfigure (mirrors Mem/Shm/DMA/IOSurface): allow any shape whose byte size fits the PBO allocation, so an oversized reusable pool can be configure_imaged to a smaller image. Without this PBO fell back to the strict-reshape default and rejected pool reuse.

fn view(&self, offset_bytes: usize, shape: &[usize]) -> Result<Self>

Zero-copy sub-region view sharing this PBO’s GL buffer (via the Arc<PboHandle>) and BufferIdentity, positioned at offset_bytes from this tensor’s own window with logical shape. The GL backend keys the import on the shared identity and addresses the window via glViewport / the staged copy; a CPU map adds view_offset to the mapped base. Mirrors DmaTensor::view.

Errors

• Error::InvalidOperation if offset_bytes is mis-aligned for T.
• Error::InsufficientCapacity if the window exceeds the allocation.

fn new(_shape: &[usize], _name: Option<&str>) -> Result<Self>

Create a new tensor with the given shape and optional name. If no name is given, a random name will be generated.

fn from_fd(_fd: OwnedFd, _shape: &[usize], _name: Option<&str>) -> Result<Self>

Create a new tensor using the given file descriptor, shape, and optional name. If no name is given, a random name will be generated.

fn clone_fd(&self) -> Result<OwnedFd>

Clone the file descriptor associated with this tensor.

fn memory(&self) -> TensorMemory

Get the memory type of this tensor.

fn name(&self) -> String

Get the name of this tensor.

fn shape(&self) -> &[usize]

Get the shape of this tensor.

fn reshape(&mut self, shape: &[usize]) -> Result<()>

Reshape this tensor to the given shape. The total number of elements must remain the same.

fn capacity_bytes(&self) -> usize

Bytes of the underlying allocation (>= the current logical size()). Defaults to the logical size for storages without spare capacity.

fn map(&self) -> Result<TensorMap<T>>

Map the tensor into memory and return a TensorMap for accessing the data.

fn buffer_identity(&self) -> &BufferIdentity

Get the buffer identity for cache keying and liveness tracking.

fn len(&self) -> usize

Get the number of elements in this tensor.

fn is_empty(&self) -> bool

Check if the tensor is empty.

fn size(&self) -> usize

Get the size in bytes of this tensor.