Struct TensorImage 

pub struct TensorImage { /* private fields */ }

An image represented as a tensor with associated format information.

Implementations

impl TensorImage

pub fn new( width: usize, height: usize, fourcc: FourCharCode, memory: Option<TensorMemory>, ) -> Result<Self>

Creates a new TensorImage with the specified width, height, format, and memory type.

Examples

use edgefirst_image::{RGB, TensorImage};
use edgefirst_tensor::TensorMemory;
let img = TensorImage::new(640, 480, RGB, Some(TensorMemory::Mem))?;
assert_eq!(img.width(), 640);
assert_eq!(img.height(), 480);
assert_eq!(img.fourcc(), RGB);
assert!(!img.is_planar());

pub fn from_tensor(tensor: Tensor<u8>, fourcc: FourCharCode) -> Result<Self>

Creates a new TensorImage from an existing tensor and specified format.

Examples

use edgefirst_image::{RGB, TensorImage};
use edgefirst_tensor::Tensor;
let tensor = Tensor::new(&[720, 1280, 3], None, None)?;
let img = TensorImage::from_tensor(tensor, RGB)?;
assert_eq!(img.width(), 1280);
assert_eq!(img.height(), 720);
assert_eq!(img.fourcc(), RGB);

pub fn load( image: &[u8], format: Option<FourCharCode>, memory: Option<TensorMemory>, ) -> Result<Self>

Loads an image from the given byte slice, attempting to decode it as JPEG or PNG format. Exif orientation is supported. The default format is RGB.

Examples

use edgefirst_image::{RGBA, TensorImage};
use edgefirst_tensor::TensorMemory;
let jpeg_bytes = include_bytes!("../../../testdata/zidane.png");
let img = TensorImage::load(jpeg_bytes, Some(RGBA), Some(TensorMemory::Mem))?;
assert_eq!(img.width(), 1280);
assert_eq!(img.height(), 720);
assert_eq!(img.fourcc(), RGBA);

pub fn load_jpeg( image: &[u8], format: Option<FourCharCode>, memory: Option<TensorMemory>, ) -> Result<Self>

Loads a JPEG image from the given byte slice. Supports EXIF orientation. The default format is RGB.

Examples

use edgefirst_image::{RGB, TensorImage};
use edgefirst_tensor::TensorMemory;
let jpeg_bytes = include_bytes!("../../../testdata/zidane.jpg");
let img = TensorImage::load_jpeg(jpeg_bytes, Some(RGB), Some(TensorMemory::Mem))?;
assert_eq!(img.width(), 1280);
assert_eq!(img.height(), 720);
assert_eq!(img.fourcc(), RGB);

pub fn load_png( image: &[u8], format: Option<FourCharCode>, memory: Option<TensorMemory>, ) -> Result<Self>

Loads a PNG image from the given byte slice. Supports EXIF orientation. The default format is RGB.

Examples

use edgefirst_image::{RGB, TensorImage};
use edgefirst_tensor::TensorMemory;
let png_bytes = include_bytes!("../../../testdata/zidane.png");
let img = TensorImage::load_png(png_bytes, Some(RGB), Some(TensorMemory::Mem))?;
assert_eq!(img.width(), 1280);
assert_eq!(img.height(), 720);
assert_eq!(img.fourcc(), RGB);

pub fn save_jpeg(&self, path: &str, quality: u8) -> Result<()>

Saves the image as a JPEG file at the specified path with the given quality. Only RGB and RGBA formats are supported.

Examples

use edgefirst_image::{RGB, TensorImage};
use edgefirst_tensor::Tensor;
let tensor = Tensor::new(&[720, 1280, 3], None, None)?;
let img = TensorImage::from_tensor(tensor, RGB)?;
let save_path = "/tmp/output.jpg";
img.save_jpeg(save_path, 90)?;

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

Returns a reference to the underlying tensor.

Examples

use edgefirst_image::{RGB, TensorImage};
use edgefirst_tensor::{Tensor, TensorTrait};
let tensor = Tensor::new(&[720, 1280, 3], None, Some("Tensor"))?;
let img = TensorImage::from_tensor(tensor, RGB)?;
let underlying_tensor = img.tensor();
assert_eq!(underlying_tensor.name(), "Tensor");

pub fn fourcc(&self) -> FourCharCode

Returns the FourCC code representing the image format.

Examples

use edgefirst_image::{RGB, TensorImage};
use edgefirst_tensor::{Tensor, TensorTrait};
let tensor = Tensor::new(&[720, 1280, 3], None, Some("Tensor"))?;
let img = TensorImage::from_tensor(tensor, RGB)?;
assert_eq!(img.fourcc(), RGB);

pub fn is_planar(&self) -> bool

Examples

use edgefirst_image::{RGB, TensorImage};
use edgefirst_tensor::{Tensor, TensorTrait};
let tensor = Tensor::new(&[720, 1280, 3], None, Some("Tensor"))?;
let img = TensorImage::from_tensor(tensor, RGB)?;
assert!(!img.is_planar());

pub fn width(&self) -> usize

Examples

use edgefirst_image::{RGB, TensorImage};
use edgefirst_tensor::{Tensor, TensorTrait};
let tensor = Tensor::new(&[720, 1280, 3], None, Some("Tensor"))?;
let img = TensorImage::from_tensor(tensor, RGB)?;
assert_eq!(img.width(), 1280);

pub fn height(&self) -> usize

Examples

use edgefirst_image::{RGB, TensorImage};
use edgefirst_tensor::{Tensor, TensorTrait};
let tensor = Tensor::new(&[720, 1280, 3], None, Some("Tensor"))?;
let img = TensorImage::from_tensor(tensor, RGB)?;
assert_eq!(img.height(), 720);

pub fn channels(&self) -> usize

Examples

use edgefirst_image::{RGB, TensorImage};
use edgefirst_tensor::{Tensor, TensorTrait};
let tensor = Tensor::new(&[720, 1280, 3], None, Some("Tensor"))?;
let img = TensorImage::from_tensor(tensor, RGB)?;
assert_eq!(img.channels(), 3);

pub fn row_stride(&self) -> usize

Examples

use edgefirst_image::{RGB, TensorImage};
use edgefirst_tensor::{Tensor, TensorTrait};
let tensor = Tensor::new(&[720, 1280, 3], None, Some("Tensor"))?;
let img = TensorImage::from_tensor(tensor, RGB)?;
assert_eq!(img.row_stride(), 1280*3);

Trait Implementations

impl Debug for TensorImage

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

Formats the value using the given formatter.

impl TensorImageDst for TensorImage

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.

impl TryFrom<&TensorImage> for G2DSurface

type Error = Error

The type returned in the event of a conversion error.

fn try_from(img: &TensorImage) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&mut TensorImage> for G2DSurface

type Error = Error

The type returned in the event of a conversion error.

fn try_from(img: &mut TensorImage) -> Result<Self, Self::Error>

Performs the conversion.