Struct imgui::draw_list::DrawListMut

pub struct DrawListMut<'ui> { /* fields omitted */ }

Object implementing the custom draw API.

Called from Ui::get_window_draw_list, Ui::get_background_draw_list or Ui::get_foreground_draw_list. No more than one instance of this structure can live in a program at the same time. The program will panic on creating a second instance.

Implementations

impl<'ui> DrawListMut<'ui>

pub fn channels_split<F: FnOnce(&ChannelsSplit<'_>)>(
    &self,
    channels_count: u32,
    f: F
)

Split into channels_count drawing channels. At the end of the closure, the channels are merged. The objects are then drawn in the increasing order of their channel number, and not in the order they were called.

Example

fn custom_drawing(ui: &Ui) {
    let draw_list = ui.get_window_draw_list();
    draw_list.channels_split(2, |channels| {
        channels.set_current(1);
        // ... Draw channel 1
        channels.set_current(0);
        // ... Draw channel 0
    });
}

impl<'ui> DrawListMut<'ui>

Drawing functions

pub fn add_line<C>(&'ui self, p1: [f32; 2], p2: [f32; 2], c: C) -> Line<'ui> where
    C: Into<ImColor32>, 

Returns a line from point p1 to p2 with color c.

pub fn add_rect<C>(&'ui self, p1: [f32; 2], p2: [f32; 2], c: C) -> Rect<'ui> where
    C: Into<ImColor32>, 

Returns a rectangle whose upper-left corner is at point p1 and lower-right corner is at point p2, with color c.

pub fn add_rect_filled_multicolor<C1, C2, C3, C4>(
    &self,
    p1: [f32; 2],
    p2: [f32; 2],
    col_upr_left: C1,
    col_upr_right: C2,
    col_bot_right: C3,
    col_bot_left: C4
) where
    C1: Into<ImColor32>,
    C2: Into<ImColor32>,
    C3: Into<ImColor32>,
    C4: Into<ImColor32>, 

Draw a rectangle whose upper-left corner is at point p1 and lower-right corner is at point p2. The remains parameters are the respective color of the corners in the counter-clockwise starting from the upper-left corner first.

pub fn add_triangle<C>(
    &'ui self,
    p1: [f32; 2],
    p2: [f32; 2],
    p3: [f32; 2],
    c: C
) -> Triangle<'ui> where
    C: Into<ImColor32>, 

Returns a triangle with the given 3 vertices p1, p2 and p3 and color c.

pub fn add_circle<C>(
    &'ui self,
    center: [f32; 2],
    radius: f32,
    color: C
) -> Circle<'ui> where
    C: Into<ImColor32>, 

Returns a circle with the given center, radius and color.

pub fn add_text<C, T>(&self, pos: [f32; 2], col: C, text: T) where
    C: Into<ImColor32>,
    T: AsRef<str>, 

Draw a text whose upper-left corner is at point pos.

pub fn add_bezier_curve<C>(
    &'ui self,
    pos0: [f32; 2],
    cp0: [f32; 2],
    cp1: [f32; 2],
    pos1: [f32; 2],
    color: C
) -> BezierCurve<'ui> where
    C: Into<ImColor32>, 

Returns a Bezier curve stretching from pos0 to pos1, whose curvature is defined by cp0 and cp1.

pub fn with_clip_rect<F>(&self, min: [f32; 2], max: [f32; 2], f: F) where
    F: FnOnce(), 

Push a clipping rectangle on the stack, run f and pop it.

Clip all drawings done within the closure f in the given rectangle.

pub fn with_clip_rect_intersect<F>(&self, min: [f32; 2], max: [f32; 2], f: F) where
    F: FnOnce(), 

Push a clipping rectangle on the stack, run f and pop it.

Clip all drawings done within the closure f in the given rectangle. Intersect with all clipping rectangle previously on the stack.

impl<'ui> DrawListMut<'ui>

Images

pub fn add_image(
    &'ui self,
    texture_id: TextureId,
    p_min: [f32; 2],
    p_max: [f32; 2]
) -> Image<'_>

Draw the specified image in the rect specified by p_min to p_max.

Examples

fn custom_button(ui: &Ui, img_id: TextureId) {
    // Invisible button is good widget to customise with image
    ui.invisible_button(im_str!("custom_button"), [100.0, 20.0]);

    // Get draw list and draw image over invisible button
    let draw_list = ui.get_window_draw_list();
    draw_list
        .add_image(img_id, ui.item_rect_min(), ui.item_rect_max())
        .build();
}

pub fn add_image_quad(
    &'ui self,
    texture_id: TextureId,
    p1: [f32; 2],
    p2: [f32; 2],
    p3: [f32; 2],
    p4: [f32; 2]
) -> ImageQuad<'_>

Draw the specified image to a quad with the specified coordinates. Similar to DrawListMut::add_image but this method is able to draw non-rectangle images.

pub fn add_image_rounded(
    &'ui self,
    texture_id: TextureId,
    p_min: [f32; 2],
    p_max: [f32; 2],
    rounding: f32
) -> ImageRounded<'_>

Draw the speciied image, with rounded corners

Trait Implementations

impl<'ui> Drop for DrawListMut<'ui>

fn drop(&mut self)

Executes the destructor for this type.