Struct RgaBuffer 

pub struct RgaBuffer { /* private fields */ }

一个描述 RGA 内存缓冲对象的类型。

Implementations

impl RgaBuffer

pub fn new( rga: Arc<Rga>, width: i32, height: i32, bpp: i32, ) -> Result<Self, Error>

创建一个新的 RGA 内存缓冲对象。

Examples

use rkrga::{Rga, RgaBuffer};
use std::sync::Arc;

let rga = Arc::new(Rga::new().unwrap());
let mut bo = RgaBuffer::new(Arc::clone(&rga), 1920, 1080, 32); // 1920x1080 RGBA8888
bo.map().unwrap();
assert_eq!(bo.len(), 1920 * 1080 * 4);
assert_eq!(bo.as_ptr(), std::ptr::null());
bo.unmap();

pub fn new_mapped( rga: Arc<Rga>, width: i32, height: i32, bpp: i32, ) -> Result<Self, Error>

创建一个新的且已映射到用户空间的 RGA 内存缓冲对象。

pub fn with_rect(rga: Arc<Rga>, rect: &RgaRect) -> Result<Self, Error>

为指定的 RGA 图像区域创建一个 RGA 内存缓冲对象。

pub fn with_rect_mapped(rga: Arc<Rga>, rect: &RgaRect) -> Result<Self, Error>

为指定的 RGA 图像区域创建一个 RGA 内存缓冲对象。

pub fn fd(&self) -> i32

返回文件描述符。

Note

此文件描述符并不能用于 DMA 操作，用于 DMA 操作的请使用 dma_fd 返回值。

pub fn handle(&self) -> u32

返回资源句柄。

pub fn offset(&self) -> usize

返回有效数据的偏移位置。

pub fn pitch(&self) -> usize

返回一行数据的字节跨度。

pub unsafe fn ptr(&self) -> *mut u8

返回映射到用户空间的地址。

Note

当用户未进行映射操作时，会返回 NULL。

Safety

请小心使用此指针。

pub fn size(&self) -> usize

返回已分配的内存块字节数。

pub fn as_bytes(&self) -> &[u8]

返回字节数组。

pub fn as_ptr<T>(&self) -> *const T

返回指定类型的映射到用户空间的只读地址。

pub fn as_mut_ptr<T>(&mut self) -> *mut T

返回指定类型的映射到用户空间的可读写地址。

pub fn as_slice<T>(&self) -> &[T]

返回指定类型的映射到用户空间的只读数组切片。

pub fn as_mut_slice<T>(&mut self) -> &mut [T]

返回指定类型的映射到用户空间的可读写数组切片。

pub fn is_empty(&self) -> bool

当未分配到内存时返回 false。

pub fn len(&self) -> usize

返回有效的字节长度。

pub fn dma_fd(&self) -> Result<i32, Error>

返回用于 DMA 操作的文件描述符。

pub fn map(&mut self) -> Result<(), Error>

映射对象到用户空间。

pub fn unmap(&mut self) -> Result<(), Error>

解除对象到用户空间的映射。

Trait Implementations

impl Debug for RgaBuffer

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

Formats the value using the given formatter.

impl Default for RgaBuffer

fn default() -> RgaBuffer

Returns the “default value” for a type.

impl Drop for RgaBuffer

fn drop(&mut self)

Executes the destructor for this type.