Struct cosmic_text::Buffer

pub struct Buffer {
    pub lines: Vec<BufferLine>,
    /* private fields */
}

A buffer of text that is shaped and laid out

Fields

lines: Vec<BufferLine>

BufferLines (or paragraphs) of text in the buffer

Implementations

impl Buffer

pub fn new(font_system: &mut FontSystem, metrics: Metrics) -> Self

Create a new Buffer with the provided FontSystem and Metrics

Panics

Will panic if metrics.line_height is zero.

pub fn borrow_with<'a>( &'a mut self, font_system: &'a mut FontSystem ) -> BorrowedWithFontSystem<'a, Buffer>

Mutably borrows the buffer together with an FontSystem for more convenient methods

pub fn shape_until(&mut self, font_system: &mut FontSystem, lines: i32) -> i32

Pre-shape lines in the buffer, up to lines, return actual number of layout lines

pub fn shape_until_cursor( &mut self, font_system: &mut FontSystem, cursor: Cursor )

Shape lines until cursor, also scrolling to include cursor in view

pub fn shape_until_scroll(&mut self, font_system: &mut FontSystem)

Shape lines until scroll

pub fn layout_cursor(&self, cursor: &Cursor) -> LayoutCursor

pub fn line_shape( &mut self, font_system: &mut FontSystem, line_i: usize ) -> Option<&ShapeLine>

Shape the provided line index and return the result

pub fn line_layout( &mut self, font_system: &mut FontSystem, line_i: usize ) -> Option<&[LayoutLine]>

Lay out the provided line index and return the result

pub fn metrics(&self) -> Metrics

Get the current Metrics

pub fn set_metrics(&mut self, font_system: &mut FontSystem, metrics: Metrics)

Set the current Metrics

Panics

Will panic if metrics.font_size is zero.

pub fn wrap(&self) -> Wrap

Get the current Wrap

pub fn set_wrap(&mut self, font_system: &mut FontSystem, wrap: Wrap)

Set the current Wrap

pub fn size(&self) -> (f32, f32)

Get the current buffer dimensions (width, height)

pub fn set_size( &mut self, font_system: &mut FontSystem, width: f32, height: f32 )

Set the current buffer dimensions

pub fn scroll(&self) -> i32

Get the current scroll location

pub fn set_scroll(&mut self, scroll: i32)

Set the current scroll location

pub fn visible_lines(&self) -> i32

Get the number of lines that can be viewed in the buffer

pub fn set_text( &mut self, font_system: &mut FontSystem, text: &str, attrs: Attrs<'_> )

Set text of buffer, using provided attributes for each line by default

pub fn redraw(&self) -> bool

True if a redraw is needed

pub fn set_redraw(&mut self, redraw: bool)

Set redraw needed flag

pub fn layout_runs(&self) -> LayoutRunIter<'_>

Get the visible layout runs for rendering and other tasks

pub fn hit(&self, x: f32, y: f32) -> Option<Cursor>

Convert x, y position to Cursor (hit detection)

pub fn draw<F>( &self, font_system: &mut FontSystem, cache: &mut SwashCache, color: Color, f: F )where F: FnMut(i32, i32, u32, u32, Color),

Draw the buffer