Struct draw2d::graphics::Graphics

pub struct Graphics {
    pub texture_atlas: GpuAtlas,
    pub clear_color: [f32; 4],
    pub device: Arc<Device>,
    // some fields omitted
}

The application’s graphics subsystem.

Fields

texture_atlas: GpuAtlas

The graphics subsystem’s texture atlas.

clear_color: [f32; 4]

the color used to clear the screen

device: Arc<Device>

The vulkan device used by all resources in the graphics subsystem.

Implementations

impl Graphics

pub fn new(window_surface: &dyn WindowSurface) -> Result<Self>

Instantiate the graphics subsystem.

pub fn add_layer_to_top(&mut self) -> LayerHandle

Add a new graphics layer to the top of the rendering stack.

This layer will be rendered above all other existing layers.

pub fn add_layer_to_bottom(&mut self) -> LayerHandle

Add a new graphics layer to the bottom of the rendering stack.

This layer will be rendered below all other existing layers.

pub fn get_layer_mut(&mut self, layer_handle: &LayerHandle) -> &mut Layer

Return a mutable reference to the layer referenced by the handle

PANICs if the layer handle doesn’t refer to an actual layer.

pub fn render(&mut self, window_surface: &dyn WindowSurface) -> Result<()>

Render a single frame to the screen.

pub fn rebuild_swapchain(
    &mut self,
    window_surface: &dyn WindowSurface
) -> Result<()>

Replace the swapchain and all dependent resources in the Triangle subsystem.

Trait Implementations

impl Drop for Graphics

fn drop(&mut self)

Block until the vulkan device idles.

impl SamplerFactory for Graphics

unsafe fn create_sampler(
    &self,
    debug_name: impl Into<String>,
    sampler_create_info: SamplerCreateInfo
) -> Result<Sampler>

Create a new sampler using the Graphics subsystem’s logical device.

unsafe fn destroy_sampler(&self, sampler: Sampler)

Destroy a sampler.

impl Texture2dFactory for Graphics

fn create_empty_2d_texture(
    &self,
    name: impl Into<String>,
    width: u32,
    height: u32,
    mip_levels: u32
) -> Result<TextureImage>

Create an empty 2d texture object using the Graphic subsystem’s logical device.

impl TextureAtlas for Graphics

unsafe fn take_texture(
    &mut self,
    texture_handle: TextureHandle
) -> Result<TextureImage>

This implementation is generally SAFE because it forces the device to idle prior to removing the texture.

fn version(&self) -> AtlasVersion

The atlas’s current version.

fn build_descriptor_image_info(&self) -> Vec<DescriptorImageInfo>

Build the array of descriptor image info objects which can be used to write all of this atlas’s textures into a descriptor set.

fn add_sampler(&mut self, sampler: Sampler) -> Result<SamplerHandle>

Add a named sampler to the atlas. Samplers can be persistently bound to individual textures.

fn bind_sampler_to_texture(
    &mut self,
    sampler_handle: SamplerHandle,
    texture_handle: TextureHandle
) -> Result<()>

Bind a sampler to a texture. Binding are persistent - they do not change until this method is called again.

fn add_texture(&mut self, texture: TextureImage) -> Result<TextureHandle>

Add a texture to the atlas. The atlas owns the texture and will destroy it when the atlas is dropped.

impl TextureLoader for Graphics

fn read_texture_file(
    &self,
    file_path: impl Into<String>
) -> Result<TextureImage>

Read a file from the local filesystem into memory as a usable texture.