# zticklabels

设置或查询 z 轴刻度标签

函数库: TyPlot

# 语法

zticklabels(labels)
zl = zticklabels()

zticklabels("auto")
zticklabels("manual")

___ = zticklabels(ax,___)
zticklabels(___,Key=Value)

# 说明

zticklabels(labels)设置当前坐标区的z轴刻度标签。可将labels指定为字符串数组，例如["January","February","March"]。如果指定标签，则z轴刻度值和刻度标签不会再基于坐标区的更改而自动更新。示例

zl = zticklabels() 返回当前坐标区的 z 轴刻度标签。

zticklabels("auto") 设置自动模式，使坐标区确定 z 轴刻度标签。如果您设置了标签，然后又想将它们设置回默认值，则可以使用此选项。示例

zticklabels("manual") 设置手动模式，将 z 轴刻度标签冻结在当前值。

___ = zticklabels(ax,___)使用ax指定的坐标区，而不是使用当前坐标区。指定ax作为上述任何语法的第一个输入参数。示例

zticklabels(___,Key=Value) 使用一个或多个名称-值对组参数来设置标签属性。

# 示例

指定 z 轴刻度值和标签

创建一个 surf 图。在值 -8、0 和 8 处显示 z 轴的刻度线。然后为每个刻度线指定一个标签。

using TyPlot
x,y,z = peaks();
surf(x,y,z)
zticks([-8 0 8])
zticklabels(["z = -8","z = 0","z = 8"])

指定特定坐标区的 z 轴刻度标签

调用 subplot 函数以创建一个 2×1 分块图布局和一个坐标区对象，并将该对象返回为 ax1。通过将 ax1 传递给 stem3 函数来创建顶部绘图。重复该过程以创建底部绘图。在每个坐标区中绘制数据。将随机数据绘制到每个坐标区中。然后通过将 ax2 指定为第一个输入参数，设置第二个图的 z 轴刻度值和标签。

using TyPlot
ax1 = subplot(2,1,1,projection="3d")
stem3(ax1, 4*rand(5,5))
zticks(ax1,[0 2 4])
zticklabels(ax1,["z = 0","z = 2","z = 4"])

ax2 = subplot(2,1,2,projection="3d")
stem3(ax2, 4*rand(5,5))

将 z 轴刻度标签设置回默认标签

创建一个 surf 图并指定 z 轴刻度值和对应的标签。然后将 z 轴刻度值和标签设置回默认值。

using TyPlot
x,y,z = peaks();
surf(x,y,z)
zticks([-8 0 8])
zticklabels(["z = -8","z = 0","z = 8"])

zticks("auto")
zticklabels("auto")

删除 z 轴刻度标签

通过将刻度值指定为空数组来删除沿 z 轴的刻度线。

using TyPlot
x,y,z = peaks();
surf(x,y,z)
zticklabels([])

自定义 Z 坐标轴的标签

创建一个 surf 图。在值 -8、0 和 8 处显示 z 轴的刻度线。然后为每个刻度线指定一个标签，设置标签字体的名称、大小、样式及粗细。

using TyPlot
x,y,z = peaks();
surf(x,y,z)
zticks([-8 0 8])
zticklabels(["z = -8","z = 0","z = 8"];
    fontfamily="Arial",
    fontsize=20,
    fontstyle="italic",
    fontweight="bold",
)

# 输入参数

labels - 刻度标签

字符串数组

刻度标签，指定为字符串数组。如果您不希望显示刻度标签，请指定空字符串数组 []。刻度标签支持 TeX 和 LaTeX 标记。

示例： zticklabels(["0",raw"",raw"2"])

示例： zticklabels(["January","Febrary","March"])

示例： zticklabels([])

注意

要指定刻度值，请使用 zticks 函数。

ax - 目标坐标区

Axes 对象 | Axes 对象的数组

目标坐标区，指定为 Axes 对象或 Axes 对象数组。

如果不指定此参数，则 zticklabels 会修改当前坐标区。

# 名称-值对组参数

指定可选的、以逗号分隔的 Key=Value 对组参数。Key 为参数名称，Value 为对应的值。您可采用任意顺序指定多个名称-值对组参数，如 Key1=Value1,...,KeyN=ValueN 所示。

alpha - 透明度

1 （默认） | 范围 [0,1] 中的标量

透明度，指定为下列值之一：

范围 [0,1] 中的标量 - 在所有图形对象上使用统一的透明度。值为 1 时完全不透明，值为 0 时完全透明。介于 0 和 1 之间的值表示半透明。

示例： zticklabels(["z = -8", "z = 0", "z = 8"]; alpha=0.2)

color - 标签颜色

[0, 0.4470, 0.7410] （默认） | 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"