进化树绘制的配置项:布局样式、画布与留白、字体、颜色与线宽、显示开关、 圆形布局的起止角参数以及缩放策略。
TreeDrawingOptions
00 Remarks
该类只描述「画什么、怎么画」的参数,不参与几何计算与绘制本身; 与之配套的几何计算见 TreeLayoutEngine,绘制见 TreeRenderer。 字体类型为 Font。
01 Syntax
SMRUCC.genomics.Interops.Visualize.Phylip.Evolview.Drawing.TreeDrawingOptions
02 Methods
| Name | Overloads | Summary |
|---|---|---|
| EffectiveAngleSpan | 1 | 按布局样式取实际使用的角度跨度。 |
| Defaults | 1 | 返回指定样式的默认配置。 |
| Clone | 1 | 复制当前配置。 |
03 Properties
| Name | Overloads | Summary |
|---|---|---|
| Mode | 1 | 布局样式(对应 TreePlotMode 的 8 种取值) |
| CanvasSize | 1 | 输出画布尺寸(像素) |
| MarginLeft | 1 | 左留白(像素) |
| MarginTop | 1 | 上留白(像素) |
| MarginRight | 1 | 右留白(像素) |
| MarginBottom | 1 | 下留白(像素) |
| MarginHorizontal | 1 | 水平方向留白合计 |
| MarginVertical | 1 | 垂直方向留白合计 |
| Dpi | 1 | 画布 DPI |
| Background | 1 | 背景色;设置为 Color.Transparent 可输出透明背景 |
| LeafFont | 1 | 叶标签字体;为空时使用默认字体 |
| BootstrapFont | 1 | bootstrap 支持度字体;为空时使用默认字体 |
| BranchLengthFont | 1 | 分支长度字体;为空时使用默认字体 |
| TitleFont | 1 | 标题字体;为空时使用默认字体 |
| BranchColor | 1 | 默认分支颜色 |
| LeafColor | 1 | 默认叶标签颜色 |
| NodeColor | 1 | 节点标记颜色 |
| TitleColor | 1 | 标题文字颜色 |
| UseNodeColors | 1 | 是否使用 PhyloNode 上通过颜色集设置的分支色 / 叶文字色 / 叶背景色。 为 False 时全部使用本配置的默认色。 |
| ActiveColorSetID | 1 | 颜色集 ID;对应 PhyloNode.getBranchColorByColorsetID(id) 等 API 的 key |
| BranchWidth | 1 | 分支线宽 |
| NodeRadius | 1 | 节点标记半径(像素) |
| LabelGap | 1 | 标签与树骨架之间的间距(像素) |
| AlignLeafLabels | 1 | 是否把所有叶标签对齐到同一列(仅矩形/斜线布局有效) |
| ScaleBarLength | 1 | 比例尺长度(分支长度单位);<= 0 表示自动选取 |
| AngleSpan | 1 | 角度跨度(度);<= 0 时按布局样式取默认值(圆形 350,辐射 360) |
| AngleStart | 1 | 起始角度(度) |
| Clockwise | 1 | 是否按顺时针方向排布 |
| UnitSize | 1 | 显式的单位像素(矩形布局为「每水平单位 X 像素 / 每垂直层 Y 像素」, 圆形布局取两者的平均值作为「每半径单位像素」)。 为空时按画布大小自适应缩放。 |
04 Members
EffectiveAngleSpan
按布局样式取实际使用的角度跨度。
Defaults(
TreePlotMode)返回指定样式的默认配置。
Clone
复制当前配置。
Mode
布局样式(对应 TreePlotMode 的 8 种取值)
CanvasSize
输出画布尺寸(像素)
MarginLeft
左留白(像素)
MarginTop
上留白(像素)
MarginRight
右留白(像素)
MarginBottom
下留白(像素)
MarginHorizontal
水平方向留白合计
MarginVertical
垂直方向留白合计
Dpi
画布 DPI
Background
背景色;设置为 Color.Transparent 可输出透明背景
LeafFont
叶标签字体;为空时使用默认字体
BootstrapFont
bootstrap 支持度字体;为空时使用默认字体
BranchLengthFont
分支长度字体;为空时使用默认字体
TitleFont
标题字体;为空时使用默认字体
BranchColor
默认分支颜色
LeafColor
默认叶标签颜色
NodeColor
节点标记颜色
TitleColor
标题文字颜色
UseNodeColors
是否使用 PhyloNode 上通过颜色集设置的分支色 / 叶文字色 / 叶背景色。 为 False 时全部使用本配置的默认色。
ActiveColorSetID
颜色集 ID;对应 PhyloNode.getBranchColorByColorsetID(id) 等 API 的 key
BranchWidth
分支线宽
NodeRadius
节点标记半径(像素)
LabelGap
标签与树骨架之间的间距(像素)
AlignLeafLabels
是否把所有叶标签对齐到同一列(仅矩形/斜线布局有效)
ScaleBarLength
比例尺长度(分支长度单位);<= 0 表示自动选取
AngleSpan
角度跨度(度);<= 0 时按布局样式取默认值(圆形 350,辐射 360)
AngleStart
起始角度(度)
Clockwise
是否按顺时针方向排布
UnitSize
显式的单位像素(矩形布局为「每水平单位 X 像素 / 每垂直层 Y 像素」, 圆形布局取两者的平均值作为「每半径单位像素」)。 为空时按画布大小自适应缩放。