figure_properties — Descrição das propriedades da entidade gráfica Figure (figura)
A figura é o topo da hierarquia de entidades gráficas. Esta entidade contém um número de propriedades designadas a controlar muitos aspectos da exibição de objetos gráficos do Scilab. Estas propriedades estão dividas em duas categorias. Propriedades que contém informação sobre a própria figura e outras relacionadas a valores padrões para criação de galhos.
estes manipuladores representam o vetor dos galhos da
figura. Note que todos os galhos de figuras são do tipo
"Axes". Também tenha em mente que, ao se
criar uma entidade figura (utilizando o comando scf), uma entidade
Axes (de eixos) é simultaneamente criada.
o valor deste campo determina o estilo da figura. Desde o Scilab 5.0, o modo gráfico antigo foi desabilitado. Esta propriedade é mantida por compatibilidade, mas não pode ser alterada.
este campo contém a posição em pixel da janela de
gráficos na tela. É um vetor [x,y]
definindo a posição do canto superior esquerdo da janela. A
posição [0,0] é o canto superior esquerdo
da tela.
A posição inicial de uma janela de gráficos é tomada a
partir da entidade figura padrão (ver gdf). A única excessão é quando o valor
figure_position da figura padrão é
[-1,-1]. Neste caso, A posição inicial da
janela de gráficos é ajustada automaticamente pelo sistema de
janelamento.
esta propriedade controla o tamanho em pixel da janela
de gráficos da tela. O tamanho é o vetor
[width,height].
usado para especificar o tamanho da janela de gráficos
virtual. O tamanho é o vetor [width,height]
. A janela de gráficos virtual deveria ser maior que
a parte realmente visível na tela. Esta propriedade não
poderia ser alterada se a figura está aportada com outros
elementos.
esta propriedade determina se a janela de gráficos é
redimensionada. Se o valor é "on" então a
propriedade axes_size é igualada a
figure_size e os galhos eixos são ampliados
de modo correspondente. Se o valor é "off",
axes_size não pode ser redimensionado
quando figure_size é modificado.
posição da parte visível do gráfico na janela
este campo contém o nome da figura. O nome é um string
exibido no topo da janela de gráficos. Pode conter um único
substring %d que será substituido por
figure_id. Em nenhum outro caso o caractere
% é permitido dentro do nome.
este campo contém o identificador da figura. É um número inteiro que é ajustado na criação da figura e não pode ser mudado depois.
este string ajusta o texto que será exibido na barra de informações da janela.
propriedade que define o mapa de cores utilizado pela
figura. O mapa de cores é uma matriz m por
3. m é o número de
cores. O número da cor i é dado pela tripla 3-uple
R, G,
B correspondentes respectivamente às
intensidades de vermelho, verde e azul entre 0 e 1.
esta propriedade controla o status de pixmap de uma
janela de gráficos. Se o valor é "off" os
gráficos são diretamente exibidos na tela. Se é
"on" os gráficos são feitos em um pixmap e
são enviados à janela através do comando
show_pixmap().
este campo define a operação bit a bit usada para
desenhar o pixel na tela. O modo padrão é
copy que significa dizer que o pixel é
desenhado como requerido. De modo mais geral, a operação bit a
bit é realizada entre a cor do pixel fonte e a cor do pixel já
presente na tela. As operações são:
"clear", "and",
"andReverse" , "copy",
"andInverted" , "noop" ,
"xor" , "or" ,
"nor" , "equiv" ,
"invert" , "orReverse" ,
"copyInverted" ,
"orInverted" , "nand" ,
"set" ,
esta propriedade controla a exibição da figura. Pode ser
"on" (modo padrão) ou
"off". É utilizada par atrasar uma grande
sucessão de comandos gráficos (implicando vários esboços ou
re-esboços). Note que, ao se utilizar os comandos
drawlater ou drawnow É
utilizada par atrasar uma grande sucessão de comandos gráficos
(implicando vários esboços ou re-esboços). Note que, ao se
utilizar os comandos 'off' ou
'on').
esta propriedade controla a cor de plano de fundo da figura. O valor é um índice de cor correspondente ao mapa de cores corrente.
um string. O nome da função do Scilab que deverá manipular os eventos. Note que definir um string vazio desabilitará o manipulador de eventos. Para mais informações sobre o manipulador de eventos, veja a ajuda event handler functions.
habilita ou desabilita o manipulador de eventos. Seu valor deve ser "on" ou "off".
este campo pode ser utilizado para se armazenar qualquer variável Scilab na estrutura de dados da entidade figura e recuperá-la.
este campo pode ser utilizado para armazenar um string geralmente utilizado para identificar o controle. Ele permite fornecer um "nome". Principalmente utilizado em conjunção a findobj().
este campo determina se o conteúdo da figura deve ser
redesenhado. O valor pode ser "on" ou
"off".
este campo está relacionado ao botão "3D Rot". Toma
unary como valor (padrão) para rotacionar
apenas o esboço 3d selecionado. Em outros casos o valor pode
ser multiple: todos os esboços 3d são
rotacionados.
todas estas propriedades e campos listados herdam
valores de valores padrões armazenados num modelo de figura.
Estes valores padrões podem ser vistos e salvos. Para fazê-lo,
use o comando get("default_figure"): ele
retorna o manipulador gráfico de uma figura. Note que nenhuma
janela de gráficos é criada por este comando. As próximas
figuras criadas herdarão valores deste modelo (ver o exemplo 2
abaixo).
lines(0) // desabilitando paginamento vertical
//Exemplo 1
f=get("current_figure") //obtendo o manipulador da figura corrente:
//se nenhum existir, cria uma figura e retorna o manipulador correspondente
f.figure_position
f.figure_size=[200,200]
f.background=2
f.children // pode-se ver que uma entidade Axes já existe
delete(f);
f=gcf(); // atalho de macro <=> f=get("current_figure")
f.pixmap = "on" // ajusta o status de pixmap para on
plot2d() // nada acontece na tela...
show_pixmap() // ...exibe o pixmap na tela
//Exemplo 2 : configurações de default_figure
df=get("default_figure") // obtendo os valores padrões (o atalho é gdf() )
// vamos mudar os padrões...
df.color_map=hotcolormap(128)
df.background= 110 // ajustando o plano de fundo para um tipo de amarelo (note que estamos utilizando um índice de cor dentro do mapa de cores color_map redefinido previamente)
scf(122); // criando uma nova figura de número122 com o novo padrão
plot2d()
scf(214);
t=-%pi:0.3:%pi;
plot3d(t,t,sin(t)'*cos(t),35,45,'X@Y@Z',[15,2,4]);