Canvas 模块
Canvas 模块提供了一组简洁的 API，用于在 DQL 脚本中实现绘图功能。
下面是一个简单的例子，绘制一个圆形图案。
dc = canvas.Context(1000, 1000) # 创建画布对象，指定大小为1000x1000
dc.draw_circle(500, 500, 400) # 在画布上绘制一个圆形，圆心为(500, 500)，半径为400
dc.set_hex_color("#FF0000") # 设置颜色为红色
dc.fill() # 填充圆形
return dc.get_data_uri() # 返回图像的 Data URI
图片效果为：
提示
Canvas API 基于 https://github.com/fogleman/gg 实现，更多详细信息请参考 https://github.com/fogleman/gg。
API
# 创建一个 Context 对象，需要指定画布的大小
canvas.NewContext(width: int, height: int)
# 角度转为弧度
canvas.radians(degrees float64) float64
# 弧度转为角度
canvas.degrees(radians float64) float64
Context
context 类似 HTML Canvas API 的 Context2D，用于提供绘制相关的函数。
画图
draw_point(x, y, r float64) # 绘制一个点
draw_line(x1, y1, x2, y2 float64) # 绘制一条线段
draw_rectangle(x, y, w, h float64) # 绘制矩形
draw_rounded_rectangle(x, y, w, h, r float64) # 绘制圆角矩形
draw_circle(x, y, r float64) # 绘制圆形
draw_arc(x, y, r, angle1, angle2 float64) # 绘制圆弧
draw_ellipse(x, y, rx, ry float64) # 绘制椭圆
draw_elliptical_arc(x, y, rx, ry, angle1, angle2 float64) # 绘制椭圆弧
draw_regular_polygon(n int, x, y, r, rotation float64) # 绘制正多边形
set_pixel(x, y int) # 设置像素点
move_to(x, y float64) # 移动到指定坐标
line_to(x, y float64) # 绘制一条线到指定坐标
quadratic_to(x1, y1, x2, y2 float64) # 绘制二次贝塞尔曲线
cubic_to(x1, y1, x2, y2, x3, y3 float64) # 绘制三次贝塞尔曲线
close_path() # 关闭路径
clear_path() # 清除路径
new_sub_path() # 新建子路径
clear() # 清除画布
stroke() # 描边
fill() # 填充
stroke_preserve() # 描边并保持路径
fill_preserve() # 填充并保持路径
通常希望将图像居中于一点。
使用 draw_image_anchored 并将 ax 和 ay 设置为 0.5 来执行此操作。
使用 0 左对齐或上对齐。
使用 1 右对齐或下对齐。
draw_string_anchored 对文本执行相同的操作，因此您无需自己调用 measure_string。
文本
draw_string(s string, x, y float64) # 绘制文本
draw_string_anchored(s string, x, y, ax, ay float64) # 绘制锚定位置的文本
draw_string_wrapped(s string, x, y, ax, ay, width, lineSpacing float64, align Align) # 换行文本
measure_string(s string) (w, h float64) # 测量字符串的宽度和高度
measure_multiline_string(s string, lineSpacing float64) (w, h float64) # 测量多行字符串的宽度和高度
word_wrap(s string, w float64) []string # 将文本按宽度换行
颜色
set_rgb(r, g, b float64) # 设置RGB颜色
set_rgba(r, g, b, a float64) # 设置RGBA颜色
set_rgb255(r, g, b int) # 设置RGB颜色（255范围）
set_rgba255(r, g, b, a int) # 设置RGBA颜色（255范围）
set_hex_color(x string) # 设置十六进制颜色
描边和填充
set_line_width(lineWidth float64) # 设置线条宽度
set_line_cap(lineCap LineCap) # 设置线条端点样式
set_line_join(lineJoin LineJoin) # 设置线条连接样式
set_dash(dashes ...float64) # 设置虚线样式
set_dash_offset(offset float64) # 设置虚线的偏移
set_fill_rule(fillRule FillRule) # 设置填充规则
渐变和图案
new_linear_gradient(x0, y0, x1, y1 float64) # 创建线性渐变
new_radial_gradient(x0, y0, r0, x1, y1, r1 float64) # 创建径向渐变
new_conic_gradient(cx, cy, deg float64) # 创建圆锥渐变
变形
identity() # 恢复默认变换
translate(x, y float64) # 平移变换
scale(x, y float64) # 缩放变换
rotate(angle float64) # 旋转变换
shear(x, y float64) # 剪切变换
scale_about(sx, sy, x, y float64) # 绕点缩放
rotate_about(angle, x, y float64) # 绕点旋转
shear_about(sx, sy, x, y float64) # 绕点剪切
transform_point(x, y float64) (tx, ty float64) # 变换点坐标
invert_y() # 反转Y轴方向
经常需要围绕一个非原点的点进行旋转或缩放。为了方便起见，我们提供了旋转（RotateAbout）、缩放（ScaleAbout）和剪切（ShearAbout）函数。
InvertY 是为了防止 Y 应从下到上增加而不是默认的从上到下增加。
状态保存恢复
保存和恢复上下文的状态。这些可以嵌套。
push() # 保存当前状态
pop() # 恢复上一个状态
裁剪
使用裁剪区域可将绘图操作限制在使用路径定义的区域内。
clip() # 启用裁剪
clip_preserve() # 启用裁剪并保持当前路径
reset_clip() # 重置裁剪区域
invert_mask() # 反转掩码
例子
这是另外一个例子，绘制旋转的椭圆：
S = 1024 # 设置画布大小
dc = canvas.Context(S, S) # 创建画布对象
dc.set_rgba(10, 250, 10, 0.1) # 设置颜色
for i in range(0, 360, 15): # 循环绘制多个旋转的椭圆
dc.push() # 保存当前状态
dc.rotate_about(canvas.radians(i), S/2, S/2) # 绕画布中心旋转
dc.draw_ellipse(S/2, S/2, S*7/16, S/8) # 绘制椭圆
dc.fill() # 填充颜色
dc.pop() # 恢复到之前的状态
return dc.get_data_uri() # 返回图像的 Data URI
呈现方式
使用 DQL 语言进行 Canvas 画图，需要通过表格方式在具体表格内呈现具体图像。
