Struct TensorImageRef 

pub struct TensorImageRef<'a> { /* private fields */ }

A borrowed view of an image tensor for zero-copy preprocessing.

TensorImageRef wraps a borrowed &mut Tensor<u8> instead of owning it, enabling zero-copy operations where the HAL writes directly into an external tensor (e.g., a model’s pre-allocated input buffer).

Examples

// Create a borrowed tensor image wrapping the model's input tensor
let mut dst = TensorImageRef::from_borrowed_tensor(
    model.input_tensor(0),
    PLANAR_RGB,
)?;

// Preprocess directly into the model's input buffer
processor.convert(&src_image, &mut dst, Rotation::None, Flip::None, Crop::default())?;

// Run inference - no copy needed!
model.run()?;

Implementations

impl<'a> TensorImageRef<'a>

pub fn from_borrowed_tensor( tensor: &'a mut Tensor<u8>, fourcc: FourCharCode, ) -> Result<Self>

Creates a TensorImageRef from a borrowed tensor reference.

The tensor shape must match the expected format:

• For planar formats (e.g., PLANAR_RGB): shape is [channels, height, width]
• For interleaved formats (e.g., RGB, RGBA): shape is [height, width, channels]

Arguments

• tensor - A mutable reference to the tensor to wrap
• fourcc - The pixel format of the image

Returns

A Result containing the TensorImageRef or an error if the tensor shape doesn’t match the expected format.

pub fn tensor(&self) -> &Tensor<u8>

Returns a reference to the underlying tensor.

pub fn fourcc(&self) -> FourCharCode

Returns the FourCC code representing the image format.

pub fn is_planar(&self) -> bool

Returns whether the image is in planar format.

pub fn width(&self) -> usize

Returns the width of the image in pixels.

pub fn height(&self) -> usize

Returns the height of the image in pixels.

pub fn channels(&self) -> usize

Returns the number of channels in the image.

pub fn row_stride(&self) -> usize

Returns the row stride in bytes.

Trait Implementations

impl<'a> Debug for TensorImageRef<'a>

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

Formats the value using the given formatter.

impl TensorImageDst for TensorImageRef<'_>

fn tensor(&self) -> &Tensor<u8>

Returns a reference to the underlying tensor.

fn tensor_mut(&mut self) -> &mut Tensor<u8>

Returns a mutable reference to the underlying tensor.

fn fourcc(&self) -> FourCharCode

Returns the FourCC code representing the image format.

fn is_planar(&self) -> bool

Returns whether the image is in planar format.

fn width(&self) -> usize

Returns the width of the image in pixels.

fn height(&self) -> usize

Returns the height of the image in pixels.

fn channels(&self) -> usize

Returns the number of channels in the image.

fn row_stride(&self) -> usize

Returns the row stride in bytes.