[−][src]Struct glyph_brush::GlyphBrushBuilder
Builder for a GlyphBrush
.
Example
use glyph_brush::{ab_glyph::FontArc, GlyphBrush, GlyphBrushBuilder}; let dejavu = FontArc::try_from_slice(include_bytes!("../../../fonts/DejaVuSans.ttf")).unwrap(); let mut glyph_brush: GlyphBrush<Vertex> = GlyphBrushBuilder::using_font(dejavu).build();
Fields (Non-exhaustive)
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.font_data: Vec<F>
cache_glyph_positioning: bool
cache_redraws: bool
section_hasher: H
draw_cache_builder: DrawCacheBuilder
Implementations
impl GlyphBrushBuilder<()>
[src]
pub fn using_fonts<F: Font>(fonts: Vec<F>) -> GlyphBrushBuilder<F>
[src]
Create a new builder with multiple fonts.
pub fn using_font<F: Font>(font: F) -> GlyphBrushBuilder<F>
[src]
Create a new builder with multiple fonts.
pub fn without_fonts() -> GlyphBrushBuilder<()>
[src]
Create a new builder without any fonts.
impl<F, H> GlyphBrushBuilder<F, H>
[src]
pub fn replace_fonts<F2: Font, V, NF>(
self,
font_fn: NF
) -> GlyphBrushBuilder<F2, H> where
V: Into<Vec<F2>>,
NF: FnOnce(Vec<F>) -> V,
[src]
self,
font_fn: NF
) -> GlyphBrushBuilder<F2, H> where
V: Into<Vec<F2>>,
NF: FnOnce(Vec<F>) -> V,
Consume all builder fonts a replace with new fonts returned by the input function.
Generally only makes sense when wanting to change fonts after calling
GlyphBrush::to_builder
.
Example
let two_font_brush: GlyphBrush<Vertex> = GlyphBrushBuilder::using_fonts(vec![open_sans, deja_vu_sans]).build(); let one_font_brush: GlyphBrush<FontRef<'static>, Vertex> = two_font_brush .to_builder() .replace_fonts(|mut fonts| { // remove open_sans, leaving just deja_vu as FontId(0) fonts.remove(0); fonts }) .build(); assert_eq!(one_font_brush.fonts().len(), 1); assert_eq!(two_font_brush.fonts().len(), 2);
impl<F: Font, H: BuildHasher> GlyphBrushBuilder<F, H>
[src]
pub fn add_font<I: Into<F>>(&mut self, font_data: I) -> FontId
[src]
Adds additional fonts to the one added in using_font
.
Returns a FontId
to reference this font.
pub fn initial_cache_size(self, (w, h): (u32, u32)) -> Self
[src]
Initial size of 2D texture used as a gpu cache, pixels (width, height). The GPU cache will dynamically quadruple in size whenever the current size is insufficient.
Defaults to (256, 256)
pub fn draw_cache_scale_tolerance(self, tolerance: f32) -> Self
[src]
Sets the maximum allowed difference in scale used for judging whether to reuse an existing glyph in the GPU cache.
Defaults to 0.5
See docs for glyph_brush_draw_cache::DrawCache
pub fn draw_cache_position_tolerance(self, tolerance: f32) -> Self
[src]
Sets the maximum allowed difference in subpixel position used for judging whether to reuse an existing glyph in the GPU cache. Anything greater than or equal to 1.0 means "don't care".
Defaults to 0.1
See docs for glyph_brush_draw_cache::DrawCache
pub fn draw_cache_align_4x4(self, align: bool) -> Self
[src]
Align glyphs in texture cache to 4x4 texel boundaries.
If your backend requires texture updates to be aligned to 4x4 texel
boundaries (e.g. WebGL), this should be set to true
.
Defaults to false
See docs for glyph_brush_draw_cache::DrawCache
pub fn cache_glyph_positioning(self, cache: bool) -> Self
[src]
Sets whether perform the calculation of glyph positioning according to the layout
every time, or use a cached result if the input Section
and GlyphPositioner
are the
same hash as a previous call.
Improves performance. Should only disable if using a custom GlyphPositioner that is
impure according to it's inputs, so caching a previous call is not desired. Disabling
also disables cache_redraws
.
Defaults to true
pub fn cache_redraws(self, cache_redraws: bool) -> Self
[src]
Sets optimising vertex drawing by reusing the last draw requesting an identical draw queue.
Will result in the usage of BrushAction::ReDraw
.
Improves performance. Is disabled if
cache_glyph_positioning
is disabled.
Defaults to true
pub fn section_hasher<T: BuildHasher>(
self,
section_hasher: T
) -> GlyphBrushBuilder<F, T>
[src]
self,
section_hasher: T
) -> GlyphBrushBuilder<F, T>
Sets the section hasher. GlyphBrush
cannot handle absolute section hash collisions
so use a good hash algorithm.
This hasher is used to distinguish sections, rather than for hashmap internal use.
Defaults to xxHash.
Example
GlyphBrushBuilder::using_font(some_font) .section_hasher(SomeOtherBuildHasher::default()) // ...
pub fn build<V, X>(self) -> GlyphBrush<V, X, F, H>
[src]
Builds a GlyphBrush
using the input gfx factory
pub fn rebuild<V, X>(self, brush: &mut GlyphBrush<V, X, F, H>)
[src]
Rebuilds an existing GlyphBrush
with this builder's properties. This will clear all
caches and queues.
Example
let mut glyph_brush: GlyphBrush<Vertex> = GlyphBrushBuilder::using_font(sans).build(); assert_eq!(glyph_brush.texture_dimensions(), (256, 256)); // Use a new builder to rebuild the brush with a smaller initial cache size glyph_brush.to_builder().initial_cache_size((64, 64)).rebuild(&mut glyph_brush); assert_eq!(glyph_brush.texture_dimensions(), (64, 64));
Auto Trait Implementations
impl<F, H> RefUnwindSafe for GlyphBrushBuilder<F, H> where
F: RefUnwindSafe,
H: RefUnwindSafe,
F: RefUnwindSafe,
H: RefUnwindSafe,
impl<F, H> Send for GlyphBrushBuilder<F, H> where
F: Send,
H: Send,
F: Send,
H: Send,
impl<F, H> Sync for GlyphBrushBuilder<F, H> where
F: Sync,
H: Sync,
F: Sync,
H: Sync,
impl<F, H> Unpin for GlyphBrushBuilder<F, H> where
F: Unpin,
H: Unpin,
F: Unpin,
H: Unpin,
impl<F, H> UnwindSafe for GlyphBrushBuilder<F, H> where
F: UnwindSafe,
H: UnwindSafe,
F: UnwindSafe,
H: UnwindSafe,
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> Pointable for T
pub const ALIGN: usize
type Init = T
The type for initializers.
pub unsafe fn init(init: <T as Pointable>::Init) -> usize
pub unsafe fn deref<'a>(ptr: usize) -> &'a T
pub unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T
pub unsafe fn drop(ptr: usize)
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
V: MultiLane<T>,