`figure`

Cria uma janela de figura ou torna uma figura existente a figura atual.

Categoria: Graphics > Formatting and Annotation

Sintaxe

figure

Cria uma nova figura com o próximo número livre e a torna atual.

figure(n)

Torna a figura de número n atual, criando-a se não existir.

figure(Name, Value)

Cria uma figura com propriedades como 'Name' definidas.

f = figure(___)

Também retorna o objeto da figura.

Descrição

Os comandos de plotagem desenham na figura atual, criando uma se não houver nenhuma. Chamar figure explicitamente permite manter vários gráficos separados: cada chamada sem argumento abre uma nova janela, e figure(n) volta a uma anterior para acrescentar mais conteúdo.

O objeto da figura pode ser guardado e alterado por suas propriedades, que é o modo usual de definir um nome ou uma cor de fundo.

Argumentos de entrada

n: Inteiro positivo, o número da figura.
Name, Value: Propriedades da figura, por exemplo 'Name', 'Color' ou 'Position'.

Argumentos de saída

f: Objeto da figura (classe matlab.ui.Figure). Sua propriedade Number guarda o número da figura.

Exemplo

Figura nomeada e seu número

f = figure('Name', 'Demo');
plot(1:5, (1:5).^2)
f.Name
f.Number

Saída

ans = 'Demo'
ans = 1

Veja também

gcf close clf subplot tiledlayout axes