2026a

# line 属性

注释线条的外观和行为

line 属性可控制 line 对象的外观和行为。通过更改属性值，您可以修改线图的某些方面。

您可以使用 plt_get 和 plt_set 函数查询和设置属性。

using TyPlot

h = annotation("line");

c = plt_get(h, "color")

plt_set(h, "color", "red")

# 颜色和样式

color - 线条颜色

[0.0, 0.45, 0.74] （默认） | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

线条颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认值 [0, 0, 0] 对应于黑色。对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。

RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4, 0.6, 0.7]；
十六进制颜色代码是字符向量或字符串标量，以井号 (#) 开头，后跟三个或六个十六进制数字，范围可以是 0 到 F。这些值不区分大小写。因此，颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。

颜色名称	短名称	RGB 三元组	十六进制颜色代码	外观
"red"	"r"	[1, 0, 0]	"#FF0000"
"green"	不适用	[0, 0.5019607843137255, 0]	"#008000"
不适用	"g"	[0, 0.5, 0]	"#007F00"
不适用	不适用	[0, 1, 0]	"#00FF00"
"blue"	"b"	[0, 0, 1]	"#0000FF"
"cyan"	不适用	[0, 1, 1]	"#00FFFF"
不适用	"c"	[0, 0.75, 0.75]	"#00BFBF"
"magenta"	不适用	[1, 0, 1]	"#FF00FF"
不适用	"m"	[0.75, 0, 0.75]	"#BF00BF"
"yellow"	不适用	[1, 1, 0]	"#FFFF00"
不适用	"y"	[0.75, 0.75, 0]	"#BFBF00"
"black"	"k"	[0, 0, 0]	"#000000"
"white"	"w"	[1, 1, 1]	"#FFFFFF"
"none"	不适用	不适用	不适用	无颜色

以下是 Syslab 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

linestyle - 线型

"-" （默认） | "--" | ":" | "-." | "none"

线型，指定为下表中列出的选项之一。

linewidth - 线条宽度

1.0 （默认） | 正值

线宽，指定为以磅为单位的正值，其中 1 磅 = 1/72 英寸。如果该线条具有标记，则线条宽度也会影响标记边。

线宽不能小于像素的宽度。如果将线宽设置为小于系统上像素宽度的值，则线条显示为一个像素的宽度。

x - 起点和终点的 x 坐标

[0.3, 0.4] （默认） | 二元素向量

起点和终点的 x 坐标，指定为 [x_begin x_end] 形式的二元素向量。

默认情况下，使用归一化的图窗单位。图窗的左下角映射到 [0,0]，右上角映射到 [1,1]。要更改单位，请使用 units 属性。

示例： [0.2, 0.3]

y - 起点和终点的 y 坐标

[0.3, 0.4] （默认） | 二元素向量

起点和终点的 y 坐标，指定为 [y_begin y_end] 形式的二元素向量。

默认情况下，使用归一化的图窗单位。图窗的左下角映射到 [0,0]，右上角映射到 [1,1]。要更改单位，请使用 units 属性。

示例： [0.2, 0.3]

position - 尺寸和位置

[0.3, 0.3, 0.1, 0.1] （默认） | 四元素向量

尺寸和位置，指定为 [x_begin y_begin dx dy] 形式的四元素向量。前两个元素指定线条起点的坐标。后两个元素指定线条的斜率。

默认情况下，使用归一化的图窗单位。图窗的左下角映射到 [0,0]，右上角映射到 [1,1]。要更改单位，请使用 units 属性。要更改单位，请使用 units 属性。

示例： [0.2, 0.2, 0.3, 0.3]

units - 位置单位

"normalized" （默认） | "inches" | "pixels"

位置单位，指定为此表中的一个值。

units	说明
"normalized"	针对包含注释的图窗、uipanel 或 uitab 进行归一化。容器的左下角映射到 [0,0]，右上角映射到 [1,1]。
"inches"	英寸。
"pixels"	像素。在 Windows 系统上，一个像素是 1/96 英寸。在 Linux 系统上，一个像素的大小由系统分辨率确定。

所有单位都是从图窗窗口左下角进行测量的。

此属性会影响 position 属性。如果您更改单位，则比较好的做法是在完成计算后将其恢复为默认值，以便不影响其他假定 units 设置为默认值的函数。

如果您在创建对象时以 key,value 对组的形式指定 position 和 units 属性，则指定顺序很重要。如果想用特定单位定义位置，则必须在设置 position 属性之前先设置 units 属性。