Struct Canvas 

pub struct Canvas { /* private fields */ }

Canvas 绘制上下文

提供在图片表面上进行各种绘制操作的能力

Implementations

impl Canvas

pub fn new(width: u32, height: u32) -> Result<Self>

创建新的 Canvas

pub fn new_with_color(width: u32, height: u32, color: Color) -> Result<Self>

创建指定背景色的 Canvas

pub fn from_surface(surface: Surface) -> Self

从已有的 Surface 创建 Canvas

pub fn from_file<P: AsRef<Path>>(path: P) -> Result<Self>

从文件加载图片并创建 Canvas

pub fn width(&self) -> u32

获取 Canvas 宽度

pub fn height(&self) -> u32

获取 Canvas 高度

pub fn dimensions(&self) -> (u32, u32)

获取 Canvas 尺寸

pub fn clear(&mut self, color: Color)

清空 Canvas 为指定颜色

pub fn save<P: AsRef<Path>>(&self, path: P) -> Result<()>

保存到文件

pub fn to_png_bytes(&self) -> Result<Vec<u8>>

导出为 PNG 字节数据

pub fn to_jpeg_bytes(&self, quality: u8) -> Result<Vec<u8>>

导出为 JPEG 字节数据

pub fn surface(&self) -> &Surface

获取底层 Surface

pub fn surface_mut(&mut self) -> &mut Surface

获取可变的底层 Surface

pub fn draw_point(&mut self, point: Point, paint: &Paint)

绘制点

pub fn draw_line(&mut self, start: Point, end: Point, paint: &Paint)

绘制线段

pub fn draw_rect(&mut self, rect: Rect, paint: &Paint)

绘制矩形

pub fn draw_rounded_rect(&mut self, rect: Rect, radius: f32, paint: &Paint)

绘制圆角矩形

pub fn draw_circle(&mut self, center: Point, radius: f32, paint: &Paint)

绘制圆形

pub fn draw_oval(&mut self, rect: Rect, paint: &Paint)

绘制椭圆

pub fn draw_text( &mut self, text: &str, position: Point, text_style: &TextStyle, paint: &Paint, )

绘制文本

pub fn draw_image(&mut self, image: &Surface, position: Point) -> Result<()>

绘制图片

pub fn draw_image_rect( &mut self, image: &Surface, src_rect: Option<Rect>, dst_rect: Rect, ) -> Result<()>

绘制图片的指定区域到指定位置

pub fn draw_image_nine( &mut self, image: &Surface, center: Rect, dst: Rect, ) -> Result<()>

九宫格绘制图片（类似 skia-safe 的 draw_image_nine）

将图片分割成 3x3 的九宫格，智能拉伸以适应目标区域。 四个角落保持不变，边缘单向拉伸，中心区域双向拉伸。

参数

• image - 要绘制的图片
• center - 中心矩形区域，定义九宫格的分割方式
• dst - 目标绘制区域

九宫格分割示例

┌─────────┬──────────┬─────────┐
│  角落1  │  上边缘  │  角落2  │
│ (固定)  │ (水平拉) │ (固定)  │
├─────────┼──────────┼─────────┤
│ 左边缘  │  中心    │ 右边缘  │
│ (垂直拉)│ (双向拉) │ (垂直拉)│
├─────────┼──────────┼─────────┤
│  角落3  │  下边缘  │  角落4  │
│ (固定)  │ (水平拉) │ (固定)  │
└─────────┴──────────┴─────────┘

pub fn measure_text(&self, text: &str, text_style: &TextStyle) -> (u32, u32)

测量文本尺寸

pub fn draw_dashed_line(&mut self, start: Point, end: Point, paint: &Paint)

绘制虚线

根据 Paint 中的虚线样式绘制虚线。如果虚线样式为 Solid，则绘制实线。

参数

• start - 起点
• end - 终点
• paint - 绘制样式（包含虚线模式）

示例

use image_renderer::{Canvas, Color, Paint, Point, paint::DashStyle};

let mut canvas = Canvas::new(400, 300).unwrap();
let mut paint = Paint::stroke(Color::BLUE, 2.0);
paint.set_dash_style(DashStyle::ShortDash);

canvas.draw_dashed_line(
    Point::new(50, 100),
    Point::new(350, 100),
    &paint
);

pub fn draw_dashed_rect(&mut self, rect: Rect, paint: &Paint)

绘制虚线矩形

根据 Paint 中的虚线样式绘制矩形边框。如果虚线样式为 Solid，则绘制实线矩形。

参数

• rect - 矩形区域
• paint - 绘制样式（包含虚线模式）

示例

use image_renderer::{Canvas, Color, Paint, Rect, paint::DashStyle};

let mut canvas = Canvas::new(400, 300).unwrap();
let mut paint = Paint::stroke(Color::RED, 2.0);
paint.set_dash_style(DashStyle::DashDot);

canvas.draw_dashed_rect(
    Rect::new(50, 50, 300, 200),
    &paint
);

pub fn draw_dashed_rounded_rect( &mut self, rect: Rect, radius: f32, paint: &Paint, )

绘制虚线圆角矩形

根据 Paint 中的虚线样式绘制圆角矩形边框。如果虚线样式为 Solid，则绘制实线圆角矩形。

参数

• rect - 矩形区域
• radius - 圆角半径
• paint - 绘制样式（包含虚线模式）

示例

use image_renderer::{Canvas, Color, Paint, Rect, paint::DashStyle};

let mut canvas = Canvas::new(400, 300).unwrap();
let mut paint = Paint::stroke(Color::BLUE, 2.0);
paint.set_dash_style(DashStyle::ShortDash);

canvas.draw_dashed_rounded_rect(
    Rect::new(50, 50, 300, 200),
    20.0,
    &paint
);

pub fn draw_custom_border_rect( &mut self, rect: Rect, border: &Border, radius: &BorderRadius, )

绘制自定义边框的矩形（支持每条边独立配置，每个角独立圆角）

参数

• rect - 矩形区域
• border - 边框配置（每条边可独立设置颜色、线宽、虚线样式）
• radius - 圆角配置（每个角可独立设置圆角半径）

示例

use image_renderer::{Canvas, Color, Border, BorderSide, BorderRadius, DashStyle, Rect};

let mut canvas = Canvas::new(400, 300).unwrap();

// 创建不同样式的边框
let border = Border::new(
    BorderSide::solid(Color::RED, 2.0),           // 上边：红色实线
    BorderSide::dashed(Color::BLUE, 3.0, DashStyle::ShortDash), // 右边：蓝色虚线
    BorderSide::solid(Color::GREEN, 2.0),         // 下边：绿色实线
    BorderSide::dashed(Color::YELLOW, 3.0, DashStyle::Dot),     // 左边：黄色点线
);

// 创建不同的圆角
let radius = BorderRadius::new(20.0, 10.0, 5.0, 15.0);

let rect = Rect::new(50, 50, 300, 200);
canvas.draw_custom_border_rect(rect, &border, &radius);