getframe

Captura os eixos ou a figura atuais como um quadro de filme.

Categoria: Graphics > 2-D and 3-D Plots

Sintaxe

F = getframe

Captura os eixos atuais.

F = getframe(ax)

Captura os eixos ax.

F = getframe(fig)

Captura a figura inteira fig.

Descrição

getframe renderiza o que está na tela em pixels. Reúna os quadros de uma animação em um array de structs e depois reproduza-os com movie ou converta um deles em imagem com frame2im.

Argumentos de entrada

ax
Handle dos eixos a capturar.
fig
Handle da figura a capturar.

Argumentos de saída

F
Estrutura com os campos cdata, os pixels capturados como array uint8 m-por-n-por-3, e colormap, que é vazio.

Exemplo

Capturar um gráfico

plot(1:5, [2 4 1 5 3])
try
    F = getframe;
    disp(fieldnames(F))
catch
end

No app, os nomes de campo cdata e colormap são listados.

Observações

Precisa do renderizador do app MatLivre. No executor de linha de comando, sem interface, não há renderizador, e getframe falha com erro.

Veja também

frame2im im2frame movie print exportgraphics