Name

surface_properties — Descrição das propriedades da entidade Surface (superfície)

Descrição

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:

parent:

esta propriedade contém o manipulador da raiz. A raiz de uma entidade Surface pode ser "Axes" ou "Compound".

children:

esta propriedade contém um vetor com os galhos do manipulador. Contudo, manipuladores de superfície não possuem galhos correntemente.

visible:

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.

surface_mode:

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

foreground:

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

thickness:

este campo contém o valor de thickness (espessura) das linhas usadas para desenhar facetas ou contornos. Deve ser um inteiro positivo.

mark_mode:

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

mark_style:

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.

mark_size_unit:

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.

mark_size:

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.

mark_foreground:

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

mark_background:

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

data:

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.

color_mode:

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.

color_flag:

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

cdata_mapping:

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.

hiddencolor:

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.

clip_state:

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.

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.

user_data:

este campo pode ser usado para armazenar qualquer variável Scilab na estrutura de dados da superfície e recuperá-la.

Exemplos

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

Ver Também

set, get, delete, plot3d, plot3d1, plot3d2, surf, graphics_entities

Autores

Djalel ABDEMOUCHE & F.Leray