Name

figure_properties — Descrição das propriedades da entidade gráfica Figure (figura)

Descrição

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.

Figure properties:
children:

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.

figure_style:

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.

figure_position:

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.

figure_size:

esta propriedade controla o tamanho em pixel da janela de gráficos da tela. O tamanho é o vetor [width,height].

axes_size:

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.

auto_resize:

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.

viewport:

posição da parte visível do gráfico na janela

figure_name:

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.

figure_id:

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.

info_message:

este string ajusta o texto que será exibido na barra de informações da janela.

color_map:

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.

pixmap:

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().

pixel_drawing_mode:

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" ,

immediate_drawing:

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').

background:

esta propriedade controla a cor de plano de fundo da figura. O valor é um índice de cor correspondente ao mapa de cores corrente.

event_handler

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.

event_handler_enable

habilita ou desabilita o manipulador de eventos. Seu valor deve ser "on" ou "off".

user_data:

este campo pode ser utilizado para se armazenar qualquer variável Scilab na estrutura de dados da entidade figura e recuperá-la.

tag:

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().

Valores padrões para galhos:
visible:

este campo determina se o conteúdo da figura deve ser redesenhado. O valor pode ser "on" ou "off".

rotation_style:

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.

Nota sobre valores padrões:

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).

Exemplos

 
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]);
 

Ver Também

lines, set, get, scf, gcf, gdf, gca, gda, axes_properties, show_pixmap, clear_pixmap, hotcolormap, event handler functions

Autor

Djalel ABDEMOUCHE