2026a

# animatedline 属性


线条动画的外观和行为

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

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

using TyPlot
a = animatedline(1:10,1:10);
c = plt_get(a, "color")
plt_set(a, "color", "red");

# 颜色和样式

color - 线条颜色
RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

线条颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。 对于自定义颜色,请指定 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 三元组和十六进制颜色代码。

RGB 三元组 十六进制颜色代码 外观
[0, 0.4470, 0.7410] "#0072BD"
[0.8500, 0.3250, 0.0980] "#D95319"
[0.9290, 0.6940, 0.1250] "#EDB120"
[0.4940, 0.1840, 0.5560] "#7E2F8E"
[0.4660, 0.6740, 0.1880] "#77AC30"
[0.3010, 0.7450, 0.9330] "#4DBEEE"
[0.6350, 0.0780, 0.1840] "#A2142F"
linestyle - 线型
"-" (默认) | "--" | ":" | "-." | "none"

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

线型 说明 表示的线条
"-" 实线
"--" 虚线
":" 点线
"-." 点划线
"none" 无线条 无线条
linewidth - 线条宽度
1.0(默认)| 正值

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

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

maximumnumpoints - 存储并显示的最大点数
1000000(默认)| 正值 | Inf

存储并显示为线条的一部分的点的最大数目,指定为正值或 Inf。默认情况下,该值是一百万个点。如果点数超过允许的最大值,则动画线条会保留最近添加的点并丢弃该线条起始处的点。这些放弃的点不再显示在屏幕上。

使用该属性可限制在任何给定时间显示在屏幕上的点数,或限制使用的内存量。如果将值指定为 Inf,则动态线条不放弃任何点,但存储的点数受可用内存量的限制。

# 标记

marker - 标记符号
"none" (默认) | "o" | "+" | "*" | "." | ...

标记符号,指定为下表中列出的值之一。默认情况下,对象不显示标记。指定标记符号可在每个数据点或顶点添加标记。

说明
"o" 圆圈
"+" 加号
"*" 星号
"."
"x" 叉号
"_" 水平线条
"|" 垂直线条
"square" 或 "s" 方形
"diamond" 或 "d" 菱形
"^" 上三角
"v" 下三角
">" 右三角
"<" 左三角
"pentagram" 或 "p" 五角星(五角形)
"hexagram" 或 "h" 六角星(六角形)
"none" 无标记
markersize - 标记大小
6 (默认) | 正值

标记大小,指定为以磅为单位的正值,其中 1 磅 = 1/72 英寸。

markeredgecolor - 标记轮廓颜色
"auto" (默认) | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

标记轮廓颜色,指定为 "auto"、RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认值 "auto" 使用与 Color 属性相同的颜色。 对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

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

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

RGB 三元组 十六进制颜色代码 外观
[0, 0.4470, 0.7410] "#0072BD"
[0.8500, 0.3250, 0.0980] "#D95319"
[0.9290, 0.6940, 0.1250] "#EDB120"
[0.4940, 0.1840, 0.5560] "#7E2F8E"
[0.4660, 0.6740, 0.1880] "#77AC30"
[0.3010, 0.7450, 0.9330] "#4DBEEE"
[0.6350, 0.0780, 0.1840] "#A2142F"
markerfacecolor - 标记填充颜色
"none" (默认) | "auto" |RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

标记填充颜色,指定为 "auto"、RGB 三元组、十六进制颜色代码、颜色名称或短名称。"auto" 选项使用与父坐标区的 Color 属性相同的颜色。如果您指定 'auto',并且坐标区图框不可见,则标记填充颜色为图窗的颜色。 对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

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

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

RGB 三元组 十六进制颜色代码 外观
[0, 0.4470, 0.7410] "#0072BD"
[0.8500, 0.3250, 0.0980] "#D95319"
[0.9290, 0.6940, 0.1250] "#EDB120"
[0.4940, 0.1840, 0.5560] "#7E2F8E"
[0.4660, 0.6740, 0.1880] "#77AC30"
[0.3010, 0.7450, 0.9330] "#4DBEEE"
[0.6350, 0.0780, 0.1840] "#A2142F"

# 图例

displayname - 图例标签
"data1"(默认) | 字符向量 | 字符串标量

图例标签,指定为字符向量或字符串标量。只有调用 legend 命令之后,才会显示图例。如果未指定文本,则 legend 使用 "dataN" 形式设置标签。

# 交互性

visible - 可见性状态
"on" (默认) | "on"/"off"

可见性状态,指定为 "on" 或 "off"。

  • "on" - 显示对象;

  • "off" - 隐藏对象而不删除它。您仍然可以访问不可见对象的属性。

selected - 选择状态
"off" (默认) | "on"/"off"

选择状态,指定为 "on" 或 "off"

  • "on" - 已选择。如果您在绘图编辑模式下点击对象,则 SYSLAB 会将其 selected 属性设置为 "on";

  • "off" - 未选择。

clipping - 按照坐标区范围裁剪对象
"on" (默认) | "on"/"off"

按照坐标区范围裁剪对象,指定为 "on" 或 "off"

  • 值为 "on" 会裁剪对象超出坐标区范围的部分;

  • 值为 "off" 会显示整个对象,即使对象的某些部分超出坐标区范围。

# 标识符

type - 图形对象的类型
"animatedline"

此属性为只读

图形对象的类型,以 "animatedline" 形式返回。