basicstroke通过参数定制线条宽度与虚线样式:首参float设宽度(≥0,0f为固定1像素),float[]数组定义虚线实/空段长度(偶数个非负值),dashphase控制起始偏移,cap/join影响端点和拐角效果。

设置线条宽度
宽度由第一个 float 参数决定,单位是像素(逻辑坐标),必须 ≥ 0.0f。
例如:new BasicStroke(2.5f) 表示 2.5 像素宽的实线;new BasicStroke(0.8f) 适合细轮廓或图标描边。
- 值为 0.0f 时,Java 会按“1 像素设备单位”渲染,不随缩放变化,适合 UI 线条
- 大于 0 的值会随 Graphics2D 的 transform 缩放,适合图表类矢量绘制
- 避免使用过小的非零值(如 0.1f),可能被抗锯齿模糊掉或显示异常
定义虚线样式
虚线靠 float[] dashPattern 数组控制,数组元素交替表示“实线段长度”和“空白段长度”。
例如:new float[]{8f, 4f} 是 8 像素实、4 像素空;new float[]{3f, 2f, 1f, 2f} 则生成点划混合模式(实3-空2-实1-空2)。
- 数组长度必须为偶数,否则运行时报
IllegalArgumentException - 所有值必须 ≥ 0;全为 0 视为实线(但不推荐)
-
dashPhase控制起始偏移:设为4f就相当于从第 4 像素处开始匹配图案,可微调对齐效果
端点与连接样式需同步考虑
虚线在拐角或终点处的表现,直接受 cap 和 join 参数影响。
比如尖锐折线用 CAP_BUTT + JOIN_MITER 更利落,圆角路径则更适合 CAP_ROUND + JOIN_ROUND。
- CAP_BUTT:线头平切,不延伸,虚线末端干净利落
- CAP_ROUND:线头加半圆帽,虚线每一段末端都带圆角,视觉更柔和
-
JOIN_MITER:尖角延伸相交,但太锐的角会被截断——这时
miterlimit就起作用(默认 10.0f)
一个典型可用的虚线配置
比如画一个中等粗细、清晰节律的虚线边框:
float width = 2.0f;
float[] pattern = {6f, 4f}; // 实6、空4
float phase = 0f;
BasicStroke stroke = new BasicStroke(
width,
BasicStroke.CAP_SQUARE, // 方头,略显硬朗
BasicStroke.JOIN_MITER, // 折线保持锐利
10.0f, // 默认斜接限制
pattern,
phase
);
设置后调用 g2d.setStroke(stroke) 即可生效,后续所有 drawXXX() 都按此样式绘制。











