Struct kas_core::theme::DrawMgr

source · [−]

pub struct DrawMgr<'a> { /* private fields */ }

Expand description

Draw interface

This interface is provided to widgets in crate::Layout::draw. Lower-level interfaces may be accessed through Self::draw_device.

DrawMgr is not a Copy or Clone type; instead it may be “reborrowed” via Self::re_id or Self::re_clone.

draw.check_box(&*self, self.state); — note &*self to convert from to &W from &mut W, since the latter would cause borrow conflicts

Implementations

source

impl<'a> DrawMgr<'a>

source

pub fn re_id<'b>(&'b mut self, id: WidgetId) -> DrawMgr<'b>where
'a: 'b,

Reborrow with a new lifetime and new id

Rust allows references like &T or &mut T to be “reborrowed” through coercion: essentially, the pointer is copied under a new, shorter, lifetime. Until rfcs#1403 lands, reborrows on user types require a method call.

source

pub fn re_clone<'b>(&'b mut self) -> DrawMgr<'b>where
'a: 'b,

Reborrow with a new lifetime and same id

Rust allows references like &T or &mut T to be “reborrowed” through coercion: essentially, the pointer is copied under a new, shorter, lifetime. Until rfcs#1403 lands, reborrows on user types require a method call.

source

pub fn recurse(&mut self, child: &mut dyn Widget)

Recurse drawing to a child

source

pub fn ev_state(&mut self) -> &EventState

Access event-management state

source

pub fn draw_device(&mut self) -> &mut dyn Draw

Access the low-level draw device

Note: this drawing API is modular, with limited functionality in the base trait Draw. To access further functionality, it is necessary to downcast with crate::draw::DrawIface::downcast_from.

source

pub fn with_pass<F: FnOnce(DrawMgr<'_>)>(&mut self, f: F)

Draw to a new pass

Adds a new draw pass for purposes of enforcing draw order. Content of the new pass will be drawn after content in the parent pass.

source

pub fn with_clip_region<F: FnOnce(DrawMgr<'_>)>(
 &mut self,
 rect: Rect,
 offset: Offset,
 f: F
)

Draw to a new pass with clipping and offset (e.g. for scrolling)

Adds a new draw pass of type PassType::Clip, with draw operations clipped to rect and translated by `offset.

source

pub fn with_overlay<F: FnOnce(DrawMgr<'_>)>(&mut self, rect: Rect, f: F)

Draw to a new pass as an overlay (e.g. for pop-up menus)

Adds a new draw pass of type PassType::Overlay, with draw operations clipped to rect.

The theme is permitted to enlarge the rect for the purpose of drawing a frame or shadow around this overlay, thus the Self::get_clip_rect may be larger than expected.

source

pub fn get_clip_rect(&mut self) -> Rect

Target area for drawing

Drawing is restricted to this Rect, which may be the whole window, a clip region or an overlay. This may be used to cull hidden items from lists inside a scrollable view.

source

pub fn frame(&mut self, rect: Rect, style: FrameStyle, bg: Background)

Draw a frame inside the given rect

The frame dimensions are given by SizeMgr::frame.

source

pub fn separator(&mut self, rect: Rect)

Draw a separator in the given rect

source

pub fn selection_box(&mut self, rect: Rect)

Draw a selection box

This appears as a dashed box or similar around this rect. Note that the selection indicator is drawn outside of this rect, within a margin of size SizeMgr::inner_margins that is expected to be present around this box.

source

pub fn text(&mut self, rect: Rect, text: impl AsRef<TextDisplay>, class: TextClass)

Draw text

Text is drawn from rect.pos and clipped to rect. If the text scrolls, rect should be the size of the whole text, not the window.

ConfigMgr::text_set_size should be called prior to this method to select a font, font size and wrap options (based on the TextClass).

source

pub fn text_effects(&mut self, rect: Rect, text: &dyn TextApi, class: TextClass)

Draw text with effects

Text is drawn from rect.pos and clipped to rect. If the text scrolls, rect should be the size of the whole text, not the window.

Self::text already supports font effects: bold, emphasis, text size. In addition, this method supports underline and strikethrough effects.

ConfigMgr::text_set_size should be called prior to this method to select a font, font size and wrap options (based on the TextClass).

source

pub fn text_selected<R: RangeBounds<usize>>(
 &mut self,
 rect: Rect,
 text: impl AsRef<TextDisplay>,
 range: R,
 class: TextClass
)

Draw some text using the standard font, with a subset selected

Other than visually highlighting the selection, this method behaves identically to Self::text. It is likely to be replaced in the future by a higher-level API.

source

pub fn text_cursor(
 &mut self,
 rect: Rect,
 text: impl AsRef<TextDisplay>,
 class: TextClass,
 byte: usize
)

Draw an edit marker at the given byte index on this text

The text cursor is draw from rect.pos and clipped to rect. If the text scrolls, rect should be the size of the whole text, not the window.

ConfigMgr::text_set_size should be called prior to this method to select a font, font size and wrap options (based on the TextClass).

source

pub fn check_box(
 &mut self,
 rect: Rect,
 checked: bool,
 last_change: Option<Instant>
)

Draw UI element: check box (without label)

The check box is a small visual element, typically a distinctive square box with or without a “check” selection mark.

The theme may animate transitions. To achieve this, last_change should be the time of the last state change caused by the user, or none when the last state change was programmatic.

source

pub fn radio_box(
 &mut self,
 rect: Rect,
 checked: bool,
 last_change: Option<Instant>
)

Draw UI element: radio box (without label)

The radio box is a small visual element, typically a disinctive circular box with or without a “radio” selection mark.

The theme may animate transitions. To achieve this, last_change should be the time of the last state change caused by the user, or none when the last state change was programmatic.

source