本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

getframe

捕获坐标区或图窗作为影片帧

说明

示例

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

示例

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

示例

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

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

示例

全部折叠

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

plot(rand(5))
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')

将坐标区单位更改为像素并存储坐标区的 PositionTightInset 属性值。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)

创建带有两个子图的图窗。在上部子图中,绘制一个蓝色线条。在下部子图中,绘制一个红色线条。

ax1 = subplot(2,1,1);
plot(1:10,'b')
ax2 = subplot(2,1,2);
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)

输入参数

全部折叠

要捕获的坐标区,指定为坐标区对象。如果您要捕获并非当前坐标区的坐标区,请使用此选项。

getframe 捕获包围坐标区轮廓的最小矩形中的内容。如果您要捕获所有刻度值和标签,则改用 fig 输入参数。

示例: F = getframe(ax);

要捕获的图窗,指定为图窗对象。使用 gcf 可捕获当前图窗。

示例: F = getframe(gcf);

要捕获的矩形区域,指定为 [left bottom width height] 形式的四元素向量(以像素为单位)。leftbottom 元素定义矩形左下角的位置。该位置相对于指定为 getframe 的第一个输入参数的图窗或坐标区。widthheight 元素定义矩形的维度。

指定完全包含在图窗窗口中的矩形。

示例: F = getframe(gcf,[0 0 560 420]);

输出参数

全部折叠

影片帧,以包含下列两个字段的结构体形式返回:

  • cdata - 存储为 uint8 值数组的图像数据。图像数据数组的大小取决于您的屏幕分辨率。

  • colormap - 颜色图。在真彩色系统中,此字段为空。

注意

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

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

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

详细信息

全部折叠

像素

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

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

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

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

提示

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

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

另请参阅

| | | | |

在 R2006a 之前推出