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 unless the PBO is fully unmapped.

That covers an exclusive map, one or more read-only holders, AND a map or unmap another thread currently has in flight — during those windows the GL buffer is (or is about to be) mapped, and no other mapping may begin, so reporting false would be misleading. Use it as “is this buffer free for GL operations?”, not as “does a CPU pointer exist right now”.

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>

Import an existing buffer as a tensor, taking ownership of its file descriptor. The buffer is adopted in place — no bytes are copied.

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_with<'a>(&self, access: CpuAccess) -> Result<HostView<'a, T>>

where T: 'a,

Map the tensor into memory with the given access direction 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.

fn map<'a>(&self) -> Result<HostView<'a, T>>

where T: 'a,

Map the tensor read-write (equivalent to map_with(CpuAccess::ReadWrite) — the historical map() behavior).

fn map_read<'a>(&self) -> Result<HostView<'a, T>>

where T: 'a,

Map the tensor for CPU reading only. The returned map rejects as_mut_slice; on macOS this takes the read-only IOSurface lock (skips the unlock flush), on Linux the dma-buf read-direction sync.

fn map_write<'a>(&self) -> Result<HostView<'a, T>>

where T: 'a,

Map the tensor for CPU writing (fill-only: reading through a write map may see write-combined memory — do not read the slice).

fn map_mut<'a>(&self) -> Result<HostView<'a, T>>

where T: 'a,

Map the tensor read-write (alias of map with the intent spelled out).