Struct nannou::draw::renderer::Builder

pub struct Builder {
    pub depth_format: TextureFormat,
    pub glyph_cache_size: [u32; 2],
    pub glyph_cache_scale_tolerance: f32,
    pub glyph_cache_position_tolerance: f32,
}

A type aimed at simplifying construction of a draw::Renderer.

Fields

depth_format: TextureFormat

glyph_cache_size: [u32; 2]

glyph_cache_scale_tolerance: f32

glyph_cache_position_tolerance: f32

Implementations

impl Builder

pub const DEFAULT_DEPTH_FORMAT: TextureFormat = Renderer::DEFAULT_DEPTH_FORMAT

The default depth format

pub const DEFAULT_GLYPH_CACHE_SIZE: [u32; 2] = Renderer::DEFAULT_GLYPH_CACHE_SIZE

The default size for the inner glyph cache.

pub const DEFAULT_GLYPH_CACHE_SCALE_TOLERANCE: f32 = 0.100000001f32

The default scale tolerance for the glyph cache.

pub const DEFAULT_GLYPH_CACHE_POSITION_TOLERANCE: f32 = 0.100000001f32

The default position tolerance for the glyph cache.

pub fn new() -> Self

Begin building a new draw::Renderer.

pub fn depth_format(self, format: TextureFormat) -> Self

Specify the texture format that should be used to represent depth data in the renderer’s inner depth_texture.

pub fn glyph_cache_size(self, size: [u32; 2]) -> Self

The dimensions of the texture used to cache glyphs.

Some text-heavy apps may require a text cache larger than the default size in order to run efficiently without text glitching. If the texture is insufficiently large for all text currently appearing within the output attachment, artifacts will appear in the text.

pub fn glyph_cache_scale_tolerance(self, tolerance: f32) -> Self

Specifies the tolerances (maximum allowed difference) for judging whether an existing glyph in the cache is close enough to the requested glyph in scale to be used in its place.

Due to floating point inaccuracies a min value of 0.001 is enforced.

pub fn glyph_cache_position_tolerance(self, tolerance: f32) -> Self

Specifies the tolerances (maximum allowed difference) for judging whether an existing glyph in the cache is close enough to the requested glyph in subpixel offset to be used in its place.

Due to floating point inaccuracies a min value of 0.001 is enforced.

pub fn build_from_texture_descriptor( self, device: &Device, descriptor: &TextureDescriptor<'_> ) -> Renderer

Build the draw::Renderer ready to target an output attachment of the given descriptor.

pub fn build( self, device: &Device, output_attachment_size: [u32; 2], output_scale_factor: f32, sample_count: u32, output_color_format: TextureFormat ) -> Renderer

Build the draw::Renderer ready to target an output attachment with the given size, sample count and format.

Trait Implementations

impl Clone for Builder

fn clone(&self) -> Builder

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Builder

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

Formats the value using the given formatter.

impl Default for Builder

fn default() -> Self

Returns the “default value” for a type.