pbaspect

控制每个轴的相对长度

全页折叠

语法

pbaspect(ratio)

pb = pbaspect

pbaspect auto

pbaspect manual

m = pbaspect('mode')

___ = pbaspect(ax,___)

说明

示例

pbaspect(ratio) 设置当前坐标区的图框纵横比。图框纵横比是 x 轴、y 轴和 z 轴的相对长度。将 ratio 指定为由正值组成的三元素向量，以表示 x 轴、y 轴和 z 轴长度的比率。例如，[3 1 1] 指定 x 轴的长度等于 y 轴和 z 轴长度的三倍。如需轴长度在所有方向上都相等，请使用 [1 1 1]。

示例

pb = pbaspect 返回当前坐标区的图框纵横比。

示例

pbaspect auto 设置自动模式，从而允许坐标区选择适当的图框纵横比。模式必须为自动，才能启用坐标区的“伸展填充”功能。

pbaspect manual 设置手动模式，并使用 Axes 对象的 PlotBoxAspectRatio 属性中存储的比率。当模式为手动时，它会禁用坐标区的伸展填充功能。指定图框纵横比的值会将模式设置为手动。

示例

m = pbaspect('mode') 返回当前模式，即 'auto' 或 'manual'。默认情况下，该模式为自动，除非您指定图框纵横比或将模式设置为手动。

示例

___ = pbaspect(ax,___) 使用 ax 指定的坐标区，而不是使用当前坐标区。指定坐标区作为以上任何语法的第一个输入参量。使用单引号将 'auto' 和 'manual' 输入引起来。

示例

全部折叠

使用相等的轴长度

打开实时脚本

创建一个简单的线图。使 x 轴、y 轴和 z 轴（不显示）长度相等。

x = linspace(0,10);
y = sin(x);
plot(x,y)
pbaspect([1 1 1])

使用不同的轴长度

打开实时脚本

绘制一个曲面，并使 x 轴的长度是 y 轴和 z 轴的两倍。

[x,y] = meshgrid(-2:.2:2);
z = x.*exp(-x.^2 - y.^2);
surf(x,y,z)
pbaspect([2 1 1])

当您指定图框纵横比时，相关联的模式将更改为手动。查询当前图框纵横比模式。

m = pbaspect('mode')

m = 
'manual'

还原为默认图框纵横比

打开实时脚本

创建随机数据的三维散点图并设置图框纵横比。然后还原为默认图框纵横比。

X = rand(100,1);
Y = rand(100,1);
Z = rand(100,1);
scatter3(X,Y,Z)
pbaspect([3 2 1])

pbaspect auto

查询图框纵横比

打开实时脚本

创建一个曲面图。

[x,y] = meshgrid(-2:.2:2);
z = x.*exp(-x.^2 - y.^2);
surf(x,y,z)

查询图框纵横比。这些值指示 x 轴长度、y 轴长度与 z 轴长度的比率。

pb = pbaspect

pb = 1×3

    1.0000    0.9411    0.8496

为特定坐标区设置图框纵横比

打开实时脚本

从 R2019b 开始，您可以使用 tiledlayout 和 nexttile 函数显示分块图。调用 tiledlayout 函数以创建一个 2×1 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1 和 ax2。在每个坐标区中绘制。然后通过将 ax2 指定为 pbaspect 函数的第一个输入参量，设置下部图的图框纵横比。

tiledlayout(2,1)
ax1 = nexttile;
mesh(peaks(20))

ax2 = nexttile;
mesh(peaks(20))
pbaspect(ax2,[2 2 1])

输入参数

全部折叠

`ratio` — 图框纵横比
三元素向量

图框纵横比，指定为由正值组成的三元素向量。例如，pbaspect([3 2 1]) 指定 x 轴长度、y 轴长度和 z 轴长度的比率为 3:2:1。因此，x 轴最长，z 轴最短。

指定比率可将 Axes 对象的 PlotBoxAspectRatio 属性设置为指定的值。PlotBoxAspectRatio 属性与 DataAspectAspectRatio、XLim、YLim 和 ZLim 属性交互作用，以控制 x 轴、y 轴和 z 轴的长度和缩放。