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_empty(metrics: Metrics) -> Self

Create an empty Buffer with the provided Metrics. This is useful for initializing a Buffer without a FontSystem.

You must populate the Buffer with at least one BufferLine before shaping and layout, for example by calling Buffer::set_text.

If you have a FontSystem in scope, you should use Buffer::new instead.

Panics

Will panic if metrics.line_height is zero.

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<'_>, shaping: Shaping )

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

pub fn set_rich_text<'r, 's, I>( &mut self, font_system: &mut FontSystem, spans: I, shaping: Shaping )where I: IntoIterator<Item = (&'s str, Attrs<'r>)>,

Set text of buffer, using an iterator of styled spans (pairs of text and attributes)

let mut buffer = Buffer::new_empty(Metrics::new(32.0, 44.0));
let attrs = Attrs::new().family(Family::Serif);
buffer.set_rich_text(
    &mut font_system,
    [
        ("hello, ", attrs),
        ("cosmic\ntext", attrs.family(Family::Monospace)),
    ],
    Shaping::Advanced,
);

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

Trait Implementations

impl Debug for Buffer

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

Formats the value using the given formatter.