Struct cros_libva::Image

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

Wrapper around VAImage that is tied to the lifetime of a given Picture.

An image is used to either get the surface data to client memory, or to copy image data in client memory to a surface.

Implementations

impl<'a> Image<'a>

pub fn derive_from<D: SurfaceMemoryDescriptor>( surface: &'a Surface<D>, visible_rect: (u32, u32), ) -> Result<Self, VaError>

Create a new derived image from this surface using vaDeriveImage.

Derived images are a direct view (i.e. without any copy) on the buffer content of surface. On the other hand, not all Surfaces can be derived.

visible_rect is the visible rectangle inside surface that we want to access.

pub fn create_from<D: SurfaceMemoryDescriptor>( surface: &'a Surface<D>, format: VAImageFormat, coded_resolution: (u32, u32), visible_rect: (u32, u32), ) -> Result<Image<'_>, VaError>

Create new image from surface using vaCreateImage and vaGetImage.

visible_rect is the visible rectangle inside surface that we want to access.

The image will contain a copy of surface‘s data’ in the desired format and coded_resolution, meaning the data can be scaled if coded_resolution and visible_rect differ.

pub fn image(&self) -> &_VAImage

Get a reference to the underlying VAImage that describes this image.

pub fn is_derived(&self) -> bool

Returns whether this image is directly derived from its underlying Picture, as opposed to being a view/copy of said Picture in a guaranteed pixel format.

pub fn display_resolution(&self) -> (u32, u32)

Returns the display resolution as passed in by the client. This is a value that is less than or equal to the coded resolution.

pub fn coded_resolution(&self) -> (u32, u32)

Returns the coded resolution. This value can be larger than the value passed in when the image was created if the driver needs to.

Trait Implementations

impl<'a> AsMut<[u8]> for Image<'a>

fn as_mut(&mut self) -> &mut [u8]

Converts this type into a mutable reference of the (usually inferred) input type.

impl<'a> AsRef<[u8]> for Image<'a>

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl<'a> Drop for Image<'a>

fn drop(&mut self)

Executes the destructor for this type.