Module cosmic::iced_widget::canvas
source · Expand description
Canvases can be leveraged to draw interactive 2D graphics.
§Example: Drawing a Simple Circle
use iced::mouse;
use iced::widget::canvas;
use iced::{Color, Rectangle, Renderer, Theme};
// First, we define the data we need for drawing
#[derive(Debug)]
struct Circle {
radius: f32,
}
// Then, we implement the `Program` trait
impl<Message> canvas::Program<Message> for Circle {
// No internal state
type State = ();
fn draw(
&self,
_state: &(),
renderer: &Renderer,
_theme: &Theme,
bounds: Rectangle,
_cursor: mouse::Cursor
) -> Vec<canvas::Geometry> {
// We prepare a new `Frame`
let mut frame = canvas::Frame::new(renderer, bounds.size());
// We create a `Path` representing a simple circle
let circle = canvas::Path::circle(frame.center(), self.radius);
// And fill it with some color
frame.fill(&circle, Color::BLACK);
// Then, we produce the geometry
vec![frame.into_geometry()]
}
}
// Finally, we simply use our `Circle` to create the `Canvas`!
fn view<'a, Message: 'a>(_state: &'a State) -> Element<'a, Message> {
canvas(Circle { radius: 50.0 }).into()
}
Modules§
- Handle events of a canvas.
- Fill
Geometry
with a certain style. - A gradient that can be used as a fill for some geometry.
- Build different kinds of 2D shapes.
- Create lines from a
Path
and assigns them various attributes/styles.
Structs§
- A widget capable of drawing 2D graphics.
- The style used to fill geometry.
- A cache group.
- A raster image that can be drawn.
- The dash pattern used when stroking the line.
- An immutable set of points that may or may not be connected.
- The style of a stroke.
- A bunch of text that can be drawn to a canvas
Enums§
- A
Canvas
event. - A fill which linearly interpolates colors along a direction.
- The shape used at the end of open subpaths when they are stroked.
- The shape used at the corners of paths or basic shapes when they are stroked.
- The coloring style of some drawing.
Traits§
- The state and logic of a
Canvas
.
Type Aliases§
- A simple cache that stores generated
Geometry
to avoid recomputation. - The frame supported by a renderer.
- The geometry supported by a renderer.