Matlab中getframe函数用法

目录

语法

说明

示例

捕获当前坐标区的内容

捕获图窗内容

指定要捕获的矩形区域

计算要包含标题和标签的区域

捕获特定坐标区

记录帧并播放影片

---

        getframe函数的功能是捕获坐标区或图窗作为影片帧。

语法

F = getframe
F = getframe(ax)
F = getframe(fig)
F = getframe(___,rect)

注意：

        以下是有关 cdata 的大小的一些重要注意事项：

• 如果查询 getframe 捕获的区域（图窗、坐标区或由 rect 指定的区域）的大小，则以像素为单位的大小可能与 cdata 中的元素数不匹配。这种差异是因为 cdata 中的元素数取决于屏幕分辨率（以及操作系统设置），而 MATLAB® 中的像素数可能不对应于屏幕上的实际像素数。

• 从 R2015b 开始，如果使用高分辨率系统，则cdata的大小可能大于在以前版本中或在其他系统上的大小。

说明

F= getframe 捕获显示在屏幕上的当前坐标区作为影片帧。F 是一个包含图像数据的结构体。getframe 按照屏幕上显示的大小捕获这些坐标区。它并不捕获坐标区轮廓外部的刻度标签或其他内容。

F= getframe(ax) 捕获 ax 标识的坐标区而非当前坐标区。

F= getframe(fig) 捕获由 fig 标识的图窗。如果您需要捕获图窗窗口的整个内部区域（包括坐标区标题、标签和刻度线），则指定一个图窗。捕获的影片帧不包括图窗菜单和工具栏。

F= getframe(___,rect ) 捕获 rect 定义的矩形内的区域。指定 rect 作为 [left bottom width height] 形式的四元素向量。将此选项用于上一语法中的 ax 或 fig 输入参数。

示例

捕获当前坐标区的内容

        创建一个随机数据图。捕获坐标区并返回图像数据。getframe捕获坐标区的内部区域和坐标区轮廓。它并不捕获延伸到坐标区轮廓之外的内容。

plot(rand(10))
F = getframe;

如图所示：

        F是一个结构体，其中包含的cdata字段中包含捕获的图像数据。使用imshow显示捕获的图像数据。

figure
imshow(F.cdata)

如图所示：

捕获图窗内容

        创建一个曲面图。捕获图窗窗口的内部区域，不包括菜单和工具栏。

surf(peaks)
F = getframe(gcf);

        如图所示：

        F是一个结构体，其中包含的cdata字段中包含捕获的图像数据。使用imshow显示捕获的图像数据。

figure
imshow(F.cdata)

如图所示：

指定要捕获的矩形区域

        捕获坐标区内部区域以及每个方向上 30 像素的边距。需要添加边距捕获帧中才能包括刻度标签。根据刻度标签的大小，可能需要调整边距。创建一个随机数据图。

plot(rand(5))

如图所示：

        将坐标区单位更改为像素并返回当前坐标区位置。位置向量的第三和第四个元素指定坐标区宽度和高度（以像素为单位）。

drawnow
ax = gca;
ax.Units = 'pixels';
pos = ax.Position
pos =

   73.8000   47.2000  434.0000  342.3000

        创建一个四元素向量 rect，以定义涵盖坐标区以及所需边距的矩形区域。rect 的前两个元素相对于坐标区左下角指定矩形左下角。rect 的最后两个元素指定矩形的宽度和高度。将坐标区单位重置为 'normalized' 的默认值。

marg = 30;
rect = [-marg, -marg, pos(3)+2*marg, pos(4)+2*marg];
F = getframe(gca,rect);
ax.Units = 'normalized';

        使用 imshow 显示捕获的图像数据。

figure
imshow(F.cdata)

如图所示：

计算要包含标题和标签的区域

        计算坐标区周围的边距，以使捕获的图像数据包括标题、坐标区标签和刻度标签。创建一个带有标题和 x 轴标签的绘图。

plot(rand(5))
xlabel('x values')
title('Plot of Random Data')

如图所示：

        将坐标区单位更改为像素并存储坐标区的Position 和 TightInset 属性值。TighInset属性是一个 [left bottom right top]形式的四元素向量。这些值是坐标区周围用于刻度值和文本标签的边距。

drawnow
ax = gca;
ax.Units = 'pixels';
pos = ax.Position;
ti = ax.TightInset;

        创建一个四元素向量rect，以定义涵盖坐标区以及自动计算的边距的矩形区域。rect的前两个元素相对于坐标区左下角指定矩形左下角。rect的最后两个元素指定矩形的宽度和高度。

rect = [-ti(1), -ti(2), pos(3)+ti(1)+ti(3), pos(4)+ti(2)+ti(4)];
F = getframe(ax,rect);

        使用 imshow 显示捕获的图像数据。

figure
imshow(F.cdata)

如图所示：

捕获特定坐标区

        从 R2019b开始，可以使用tiledlayout和nexttile函数显示分块图。调用tiledlayout函数以创建一个 2×1 分块图布局。调用nexttile函数以创建坐标区对象 ax1 和 ax2。在每个坐标区中绘制一个线条。

tiledlayout(2,1)
ax1 = nexttile;
plot(1:10,'b')
ax2 = nexttile;
plot(1:10,'r')

        ​​​​捕获下坐标区的内容。getframe捕获绘图的内部区域和边框。它并不捕获延伸到绘图轮廓外部的刻度值或标签。

F = getframe(ax2);

        使用 imshow 显示捕获的图像数据。

figure
imshow(F.cdata)

如图所示：

记录帧并播放影片

        通过循环使用getframe记录peaks函数振荡的帧。预分配一个数组以存储影片帧。

Z = peaks;
surf(Z)
axis tight manual
ax = gca;
ax.NextPlot = 'replaceChildren';

loops = 40;
F(loops) = struct('cdata',[],'colormap',[]);
for j = 1:loops
    X = sin(j*pi/10)*Z;
    surf(X,Z)
    drawnow
    F(j) = getframe(gcf);
end

        播放影片两次。

fig = figure;
movie(fig,F,2)

像素

        以像素为单位的距离不依赖 Windows® 和 Macintosh 系统上的系统分辨率：

• 在 Windows 系统上，一个像素是 1/96 英寸。

• 在 Macintosh 系统上，一个像素是 1/72 英寸。

        在 Linux® 系统上，一个像素的大小由系统分辨率确定。

提示

• 为了在使用 getframe 值获得最快的性能，请确保图窗在屏幕上可见。如果图窗不可见，getframe仍可捕获该图窗，但性能可能会减慢。

• 为了更好地控制图像数据的分辨率，请改用print函数。带有 print 的cdata输出参数返回图像数据。resolution输入参数控制图像的分辨率。