Struct PlaneDescriptor 

pub struct PlaneDescriptor { /* private fields */ }

Per-plane DMA-BUF descriptor for external buffer import.

Owns a duplicated file descriptor plus optional stride and offset metadata. The fd is duplicated eagerly in new() so that a bad fd is caught immediately. import_image consumes the descriptor and takes ownership of the duped fd — no further cleanup is needed by the caller.

Examples

use edgefirst_tensor::PlaneDescriptor;
use std::os::fd::BorrowedFd;

// SAFETY: fd 42 is hypothetical; real code must pass a valid fd.
let pd = unsafe { PlaneDescriptor::new(BorrowedFd::borrow_raw(42)) }
    .unwrap()
    .with_stride(2048)
    .with_offset(0);

Implementations

impl PlaneDescriptor

pub fn new(fd: BorrowedFd<'_>) -> Result<Self>

Create a new plane descriptor by duplicating the given file descriptor.

The fd is duped immediately — a bad fd fails here rather than inside import_image. The caller retains ownership of the original fd.

Errors

Returns an error if the dup() syscall fails (e.g. invalid fd or fd limit reached).

pub fn with_stride(self, stride: usize) -> Self

Set the row stride in bytes (consuming builder).

pub fn with_offset(self, offset: usize) -> Self

Set the plane offset in bytes (consuming builder).

pub fn into_fd(self) -> OwnedFd

Consume the descriptor and return the owned file descriptor.

pub fn stride(&self) -> Option<usize>

Row stride in bytes, if set.

pub fn offset(&self) -> Option<usize>

Plane offset in bytes, if set.