Struct rutabaga_gfx::gfxstream::Gfxstream

pub struct Gfxstream {
    _cookie: Box<RutabagaCookie>,
}

The virtio-gpu backend state tracker which supports accelerated rendering.

Fields

_cookie: Box<RutabagaCookie>

Cookie used by Gfxstream, should be held as long as the renderer is alive.

Implementations

impl Gfxstream

pub fn init( display_width: u32, display_height: u32, gfxstream_flags: GfxstreamFlags, gfxstream_features: Option<String>, fence_handler: RutabagaFenceHandler, debug_handler: Option<RutabagaDebugHandler> ) -> RutabagaResult<Box<dyn RutabagaComponent>>

fn map_info(&self, resource_id: u32) -> RutabagaResult<u32>

fn vulkan_info(&self, resource_id: u32) -> RutabagaResult<VulkanInfo>

fn export_blob(&self, resource_id: u32) -> RutabagaResult<Arc<RutabagaHandle>>

Trait Implementations

impl Drop for Gfxstream

fn drop(&mut self)

Executes the destructor for this type.

impl RutabagaComponent for Gfxstream

fn get_capset_info(&self, capset_id: u32) -> (u32, u32)

Implementations should return the version and size of the given capset_id. (0, 0) is returned by default.

fn get_capset(&self, capset_id: u32, version: u32) -> Vec<u8>

Implementations should return the capabilites of given a capset_id and version. A zero-sized array is returned by default.

fn create_fence(&mut self, fence: RutabagaFence) -> RutabagaResult<()>

Implementations must create a fence that represents the completion of prior work. This is required for synchronization with the guest kernel.

fn create_3d( &self, resource_id: u32, resource_create_3d: ResourceCreate3D ) -> RutabagaResult<RutabagaResource>

Implementations must create a resource with the given metadata. For 2D rutabaga components, this a system memory allocation. For 3D components, this is typically a GL texture or buffer. Vulkan components should use blob resources instead.

fn attach_backing( &self, resource_id: u32, vecs: &mut Vec<RutabagaIovec> ) -> RutabagaResult<()>

Implementations must attach vecs to the resource.

fn detach_backing(&self, resource_id: u32)

Implementations must detach vecs from the resource.

fn unref_resource(&self, resource_id: u32)

Implementations must release the guest kernel reference on the resource.

fn transfer_write( &self, ctx_id: u32, resource: &mut RutabagaResource, transfer: Transfer3D ) -> RutabagaResult<()>

Implementations must perform the transfer write operation. For 2D rutabaga components, this done via memcpy(). For 3D components, this is typically done via glTexSubImage(..).

fn transfer_read( &self, ctx_id: u32, resource: &mut RutabagaResource, transfer: Transfer3D, buf: Option<IoSliceMut<'_>> ) -> RutabagaResult<()>

Implementations must perform the transfer read operation. For 2D rutabaga components, this done via memcpy(). For 3D components, this is typically done via glReadPixels(..).

fn resource_flush(&self, resource: &mut RutabagaResource) -> RutabagaResult<()>

Implementations must flush the given resource to the display.

fn create_blob( &mut self, ctx_id: u32, resource_id: u32, resource_create_blob: ResourceCreateBlob, iovec_opt: Option<Vec<RutabagaIovec>>, handle_opt: Option<RutabagaHandle> ) -> RutabagaResult<RutabagaResource>

Implementations must create a blob resource on success. The memory parameters, size, and usage of the blob resource is given by resource_create_blob.

fn map(&self, resource_id: u32) -> RutabagaResult<RutabagaMapping>

Implementations must map the blob resource on success. This is typically done by glMapBufferRange(…) or vkMapMemory.

fn unmap(&self, resource_id: u32) -> RutabagaResult<()>

Implementations must unmap the blob resource on success. This is typically done by glUnmapBuffer(…) or vkUnmapMemory.

fn create_context( &self, ctx_id: u32, context_init: u32, context_name: Option<&str>, fence_handler: RutabagaFenceHandler ) -> RutabagaResult<Box<dyn RutabagaContext>>

Implementations must create a context for submitting commands. The command stream of the context is determined by context_init. For virgl contexts, it is a Gallium/TGSI command stream. For gfxstream contexts, it’s an autogenerated Vulkan or GLES streams.

fn force_ctx_0(&self)

Implementations should set their internal context to be the reserved context 0.

fn event_poll(&self)

Used only by VirglRenderer to poll when its poll_descriptor is signaled.

fn poll_descriptor(&self) -> Option<OwnedDescriptor>

Used only by VirglRenderer to return a poll_descriptor that is signaled when a poll() is necessary.

fn import( &self, resource_id: u32, _import_handle: RutabagaHandle, _import_data: RutabagaImportData ) -> RutabagaResult<RutabagaResource>

fn export_fence(&self, _fence_id: u64) -> RutabagaResult<RutabagaHandle>

Implementations must return a RutabagaHandle of the fence on success.

fn suspend(&self) -> RutabagaResult<()>

Implementations should stop workers.

fn snapshot(&self, _directory: &str) -> RutabagaResult<()>

Implementations must snapshot to the specified directory

fn restore(&self, _directory: &str) -> RutabagaResult<()>

Implementations must restore from the specified directory

fn resume(&self) -> RutabagaResult<()>

Implementations should resume workers.

fn wait_sync(&self, _resource: &RutabagaResource) -> RutabagaResult<()>

Implementations must perform a blocking wait-sync on the resource identified by resource_id