surface_properties — Descrição das propriedades da entidade Surface (superfície)
A entidade Surface é uma folha das hierarquia de entidades gráficas.
Duas classes aparecem sob este tipo de entidade :
Plot3d e Fac3d de acordo com a
função de esboço ou com o modo como os dados foram inseridos. As entidades
Fac3d e Plo3d são semelhantes, mas
Fac3d é mais completa e aceita mais opções que
Plot3d. Para sempre ter entidades
Fac3d simplesmente use genfac3d para
pré-construir matrizes antes de usar os comandos plot3d
ou use o comando surf.
Aqui estão as propriedades contidas em uma entidade superfície:
esta propriedade contém o manipulador da raiz. A raiz de uma
entidade Surface pode ser "Axes" ou
"Compound".
esta propriedade contém um vetor com os galhos do manipulador. Contudo, manipuladores de superfície não possuem galhos correntemente.
este campo contém o valor padrão da propriedade
visible para a entidade. Pode ser "on"
ou "off" . Por padrão, superfícies são
visíveis , o valor da propriedade é "on". Se for
"off" os gráficos 3d não são exibidos na
tela.
este campo contém o valor padrão da propriedade
surface_mode para a superfície. Pode ser
"on" (superfície desenhada) ou
"off" (nenhuma superfície desenhada).
se color_mode >= 0, contém o índice da
cor a ser usada nas bordas. Se não, foreground não é usado. O valor
foreground deve ser um índice inteiro de cor (relativo ao mapa de
cores corrente).
este campo contém o valor de thickness
(espessura) das linhas usadas para desenhar facetas ou contornos.
Deve ser um inteiro positivo.
este campo contém o valor padrão da propriedade
mark_mode para a superfície. Seu valor pode ser
"on" (marcas desenhadas) ou
"off" (marcas não desenhadas).
o valor da propriedade mark_style é usado
para selecionar o tipo de marca usada quando a propriedade
mark_mode é "on". O valor deve
ser um inteiro no intervalo [0 14] que significa: ponto, mais, cruz,
estrela, rombo preenchido, rombo, triângulo para cima, triângulo
para baixo, rombo mais, círculo, asterísco, quadrado, trângulo para
direita, triângulo para esquerda e pentagrama.
este campo contém o valor padrão da propriedade
mark_size_unit. Se
mark_size_unit é ajustado para
"point", então o valor de
mark_size é dado diretamente em pontos. Quando
mark_size_unit é ajustado para
"tabulated", mark_size é
computado de acordo com o array de tamanho de fonte: logo, seu valor
deve ser um inteiro no intervalo [0 5] que significa 8pt, 10pt,
12pt, 14pt, 18pt e 24pt. Note que plot3d e funções puras do Scilab usam o modo
tabulated como padrão; quando se utiliza as
funções surf (ou plot para linhas 2d) o modo
point é automaticamente habilitado.
a propriedade mark_size é utilizada para
selecionar o tamanho de fonte das marcas quando a propriedade
mark_mode está "on". O valor
deve ser um inteiro entre 0 e 5 que significa 8pt, 10pt, 12pt, 14pt,
18pt e 24pt.
este campo contém o valor padrão da propriedade
mark_foreground que é a cor da borda das marcas.
Seu valor deve ser um índice de cor (relativo ao mapa de cores
corrente).
este campo contém o valor padrão da propriedade
mark_background que é a cor da face das marcas.
Seu valor deve ser um índice de cor (relativo ao mapa de cores
corrente).
este campo define uma estrutura de dados
tlist do tipo "3d" composto de índices de uma
linha e uma coluna de cada elemento como as coordenadas x, y e z
contidas respectivamente em
data.x,data.y e
data.z. O campo complementar
data.color está disponível caso um vetor ou
matriz reais de cores seja especificado. Se nenhum for,
data.color não é listado. A superfície é pintada
de acordo com as propriedades color_mode e
color_flag.
um inteiro no intervalo [-size(colormap) ;
size(colormap)] definindo a cor da faceta quando o valor
de color_flag é 0. Como dito
antes, se color_mode > 0, as bordas são
desenhadas usando a cor foreground. Se
color_mode é ajustado para 0,
uma malha das superfície é desenhada: faces da frente não têm cores.
Finalmente, quando color_mode < 0, as faces da
frente são pintadas com a cor -color_mode mas
nenhuma borda é exibida.
este campo é usado para definir o algoritimo usado para
ajustar as cores das facetas. Note que as regras em
color_mode, foreground e
hiddencolor ainda são aplicadas nesse
caso.
color_flag == 0
Todas as facetas são pintadas usando-se o índice de
cores e o método definido por color_mode
(ver acima).
color_flag == 1
Todas as facetas são pintadas utilizando-se um índice
de cor por faceta proporcional a z. O
valor mínimo de z é pintado utilizando-se
o índice 1, enquanto o valor máximo de z
é pintado utilizando-se o índice mais alto. As bordas das
facetas pode ser adicionalmente desenhadas dependendo do
valor de color_mode (ver acima).
Os três casos restantes
(color_flag== 2,3 or 4) só
estão disponíveis para a entidade Fac3d .
Então, o valor de data.color é usado para
ajustar cores para as facetas (índices do mapa de cores
corrente) se existirem. Se não, o color_mode
corrente é utilizado para pintar as facetas.
color_flag == 2 ('flat' shading)
Todas as facetas são pintadas utilizando-se o índice
de cor dado na propriedade data.color
(uma cor por faceta é necessária). Dois são os casos
possíveis:
data.color contém um vetor
color vector : se
color(i) for positivo, fornece a cor da
faceta i e a borda da faceta é desenhada
com o estilo de linha e cor correntes. Se
color(i) for negativo, o a cor de
identificador -color(i) é usado e a borda
da faceta não é desenhada.
data.color contém uma matriz de
cores de tamanho (nf,n) onde n significa
o número de facetas e nf o número de
pontos definindo a faceta poligonal. Para os vértices
nf definindo cada faceta, o algoritmo
computa o valor médio do índice de cores (da matriz de
índices de cores) : os nf vértices da
mesma faceta terão o mesmo valor de índice de cor.
color_flag == 3 ('interpolated'
shading)
Pinta as facetas por interpolação das cores dos
vértices. Os índices das cores dos vértices são dados pela
propriedade data.color (uma cor por
vértice é necessária). Dois são os casos possíveis:
data.color contém um vetor
colors : então há poucos dados para
completar o modo de gradação interpolada. De fato, uma
matriz de cores de tamanho (nf,n) (onde n
é o número de facetas e nf o número de
pontos definindo a faceta poligonal) é necessária para
realizar esta operação. Para cada faceta, o algoritmo copia
o único valor de índice de cor da faceta nos
nf vértices de índices de cores definindo
a borda da faceta.
data.color contém uma matriz de
cores de tamanho (nf,n) (ver acima para definições de
nf e n), o modo de
gradação interpolada pode ser completado normalmente
utilizando-se estes índices de cores.
color_flag == 4 (Matlab-like 'flat'
shading)
É o mesmo que color_flag==2 com uma
pequena diferença quando data.color é uma
matriz. Todas as facetas são pintadas com o índice de cor
fornecido pela propriedade data.color
(uma cor por faceta é necessária). Dois casos são então
possíveis:
data.color contém um vetor
color vector : se
color(i) é positivo, fornece a cor da
faceta i e a borda da faceta é desenhada
com o estilo de linha e cor correntes. Se
color(i) é negativo, a cor de
identificador -color(i) é utilizado e a
borda da faceta não é desenhada.
data.color contém uma matriz de
cores de tamanho (nf,n) onde n é o número
de facetas e nf o número de pontos
definindo a faceta poligonal. Para os nf
vértices definindo cada faceta, o algoritimo toma a cor do
primeiro vértice definindo o retículo (faceta).
específico para manipuladores Fac3d. Um
string definindo um valor 'scaled' ou
'direct'. Se um data.color é
definido, cada dado de índice de cor especifica um valor único para
vértice. cdata_mapping determina se estes índices
estão em escala para serem mapeados linearmente no mapa de cores
corrente (modo 'scaled') ou aponta diretamente
para o mapa de cores (modo 'direct'). Esta
propriedade é útil quando color_flag é igual a
2,3 ou
4.
esta propriedade contém o índice de cor usado para desenhar as faces atrás de uma superfície. Seu valor deve ser um inteiro positivo (índice de cores relativo ao mapa de cores corrente). Se for um inteiro negativo, a mesma cor que a face "visível" é aplicada para a parte traseira.
este campo contém o valor da propriedade
clip_state para a superfície. O valor de
clip_state pode ser:
"off" significa que a superfície não é
recortada.
"clipgrf" significa que a superfície é
recortada fora da caixa dos eixos.
"on" significa que a superfície é
recortada fora do retângulo dado pela propriedade
clip_box.
este campo determina a propriedade
clip_box. Por padrão seu valor é uma matriz vazia
se a propriedade clip_state é "off". Em outros casos, o vetor
[x,y,w,h] (ponto superior esquerdo, largura,
altura) define as porções da poligonal a serem exibidas, contudo o
valor da propriedade clip_state será alterado.
este campo pode ser usado para armazenar qualquer variável Scilab na estrutura de dados da superfície e recuperá-la.
//criando uma figura
t=[0:0.3:2*%pi]'; z=sin(t)*cos(t');
[xx,yy,zz]=genfac3d(t,t,z);
plot3d([xx xx],[yy yy],list([zz zz+4],[4*ones(1,400) 5*ones(1,400)]))
h=get("hdl") //obtendo manipulador da entidade corrente (aqui, é a superfície)
a=gca(); //obtendo eixos correntes
a.rotation_angles=[40,70];
a.grid=[1 1 1];
//criando grides
a.data_bounds=[-6,0,-1;6,6,5];
a.axes_visible="off";
//os eixos estão escondidos a.axes_bounds=[.2 0 1 1];
f=get("current_figure");
//obtendo o manipulador da figura raiz
f.color_map=hotcolormap(64);
//mudando o mapa de cores da figura
h.color_flag=1;
//colorindo de acordo com z
h.color_mode=-2;
//removendo as bordas das facetas
h.color_flag=2;
//colorindo de acordo com as dadas cores
h.data.color=[1+modulo(1:400,64),1+modulo(1:400,64)];
//gradação
h.color_flag=3;
scf(2); // criando segunda janela e utilizando o comando surf
subplot(211)
surf(z,'cdata_mapping','direct','facecol','interp')
subplot(212)
surf(t,t,z,'edgeco','b','marker','d','markersiz',9,'markeredg','red','markerfac','k')
e=gce();
e.color_flag=1 // índice de cor proporcional à altitude (coordenada z)
e.color_flag=2; // de volta ao modo padrão
e.color_flag= 3; // modo de gradação interpolada (baseada na cor azul padrão porque o campo data.color não está preenchido)