painting library
与 K 线无关的绘制原语: 异形边框、带缓存的标签与图片绘制、代码绘制的小图标、跨帧资源管理。
只依赖 Flutter, 不需要 K 线时 import 本入口即可; flexi_kline.dart 已包含这里的全部导出。
Classes
- AnchoredBorder
- 外延在 body 之外、且依赖锚点的形状(带箭头的气泡、单侧收口的价格标签等)。
- BellImage
- 铃铛(钟身 + 顶钮 + 铃舌), 按 size 比例绘制; 细节较多, 宜 12 以上使用。
- BubbleBorder
- 带箭头的圆角矩形。路径一次成型, 不用 Path.combine(union): union 的接缝会被描边画出来。
- ChevronImage
-
折线箭头
›, 尖端朝 direction; thickness 为线宽, 默认取短边的 1/5。 - CircleImage
- 实心圆点, 直径取 size 的短边并居中。
- CrossImage
- 叉号, 两条对角线; thickness 为线宽, 默认取短边的 1/5, 笔画不会画出 size。
- DiamondImage
- 实心菱形, 四个顶点落在 size 各边中点; radius 为圆角半径。
- GradientRoundedRectangleBorder
- 描边用 gradient 着色的圆角矩形; 形状、填充与描边位置同 RoundedRectangleBorder。
- ImagePainter
- 带背景与边框的图片绘制器。
- ImageSpan
- 行内图片。排版时占一个 size 的框, 由 LabelPainter 在框内补画。
- ImageStyle
- 单张图片的完整外观: 显示尺寸 + 内边距 + 装饰 + 图片绘制参数。不可变, 按值比较。
- LabelPainter
- 带背景与边框的标签绘制器, 跨帧持有排版结果。
- LabelStyle
- 标签的完整外观: 排版参数 + 内边距 + 装饰。不可变, 按值比较。
- MinusImage
- 减号, 贯穿 size 宽度的横杠; thickness 为杠高, 默认取短边的 1/3。
- PaintResource
- 绘制对象跨帧持有的资源。
- PlusImage
- 加号, 两臂贯穿 size; thickness 为臂宽, 默认取短边的 1/3。
- PointBuffer
- 同一画笔的点 / 线段批次, 每帧攒坐标、一次 drawRawPoints 画完。
- ShapeImage
- 程序绘制的单色小图标, 用作行内 ImageSpan; 子类只实现 draw, 缓存与释放由本类负责。
- SquareImage
- 实心矩形色块, 填满 size; radius 为圆角半径, 默认 0。常用于指标图例。
- StarImage
- 实心五角星, 外接圆直径取 size 的短边, 在盒内居中。
- TextLayoutCache
- 一份排版参数下的 TextPainter 池, 按 key 复用排版结果。
- TooltipPainter
- 两列 tooltip 卡片: label 左对齐、value 右对齐, 返回卡片与逐行命中区。
- TriangleImage
- 实心三角, 尖端朝 direction, 填满 size; radius 为圆角半径, 默认 0.5 让小箭头不显尖锐。
Mixins
- PaintResourceOwner
- 持有 PaintResource; 何时 reset / dispose 由混入者决定。
Extensions
Functions
-
placeAround(
Rect target, Size size, {required AxisDirection side, double spacing = 0, bool flip = true, Rect? bounds}) → AnchorPlacement -
在
target的side一侧摆放尺寸为 size的标签: 锚点是该边中点向外spacing。
Typedefs
- AnchorPlacement = ({Alignment align, Offset anchor, AxisDirection side})
- placeAround 的结果: 实际所在侧、锚点与绘制用的对齐方式。
- TooltipRow = ({String label, TextStyle? labelStyle, String value, TextStyle? valueStyle})
- tooltip 的一行; 行样式为 null 时沿用列样式。