Struct fontstash::FontStash

pub struct FontStash { /* fields omitted */ }

Shared ownership of font stash

Hack for creation

Renderer needs fixed memory position so that fontstash::sys can call callback methods of it.

1. Create Renderer in a Box with FontStash being uninitialized
2. Call FontStash::init_mut to initialize FontStash

Implementations

impl FontStash

Hack for creation

pub fn uninitialized() -> Self

pub fn init_mut<R: Renderer>(&mut self, w: u32, h: u32, renderer: *mut R)

impl FontStash

pub fn raw(&self) -> *mut FONScontext

pub fn clone(&self) -> Self

impl FontStash

Font storage. Each font is keyed with name string.

pub fn add_font_mem(&self, name: &str, data: &[u8]) -> Result<FontIx>

pub fn set_font(&self, font: FontIx)

pub fn font_ix_by_name(&self, name: &str) -> Option<FontIx>

impl FontStash

Atlas

pub fn atlas_size(&self) -> [u32; 2]

pub fn expand_atlas(&self, w: u32, h: u32) -> Result<()>

Creates fontstash atlas size copying the previous data

pub fn reset_atlas(&self, w: u32, h: u32) -> Result<()>

Creates new fontstash atlas with size without copying the previous data

impl FontStash

States

pub fn set_size(&self, size: f32)

NOTE: DPI scaling?

pub fn set_color(&self, color: u32)

pub fn set_spacing(&self, spacing: f32)

Horizontal space between characters?

pub fn set_blur(&self, blur: f32)

pub fn set_align(&self, align: Align)

Sets alignment of quadliterals returned with FontStash::text_iter

impl FontStash

Texture

pub fn with_pixels(&self, f: impl FnMut(&[u8], u32, u32))

NOTE: Pixel is in one byte (8 bits alpha channel only)

impl FontStash

State stack

pub fn push_state(&mut self)

pub fn pop_state(&mut self)

pub fn clear_state(&mut self)

impl FontStash

Draw

pub fn text_iter(&self, text: &str) -> Result<FonsTextIter>

Iterator of quadliterals aligned with Align

impl FontStash

Measure

pub fn text_bounds_oneline(&self, pos: [f32; 2], text: &str) -> [f32; 4]

Returns [left_x, top_y, right_x, bottom_y]. Note that it doesn’t handle multiple lines of text. You need custom layer for multi-line text!

pub fn text_size_oneline(&self, text: &str) -> [f32; 2]

Returns [width, height]. Note that it doesn’t handle multiple lines of text. You need custom layer for multi-line text!

Trait Implementations

impl Debug for FontStash

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

Formats the value using the given formatter.