Name

polyline_properties — Descrição das propriedades da entidade Polyline (poligonal)

Descrição

A entidade Polyline uma folha na hierarquia de entidades gráficas. Esta entidade define parâmetros para poligonais.

parent:

esta propriedade contém o manipulador para a raiz. A raiz de uma entidade Polyline deve ser do tipo "Axes" ou "Compound".

children:

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

visible:

este campo contém o valor da propriedade visible para a entidade. Pode ser "on" ou "off" . Por padrão, a poligonal é visível, o valor da propriedade é "on" . Se "off" a poligonal não é impressa na tela.

data:

esta propriedade contém o valor os valores para as coordenadas x e y. O componente z deve ser adicionado no caso de eixos 3d. é uma matriz de duas (três) colunas [x,y,[z]] determinando os pontos.

closed:

este valor determina se a poligonal é fechada ou não: o valor pode ser "on" ou "off" (o valor padrão depende da primitiva utilizada para criar a poligonal).

line_mode:

este campo contém o valor padrão da propriedade line_mode para a poligonal. O valor pode ser "on" (linha desenhada) ou "off" (nenhuma linha desenhada).

fill_mode:

se o campo polyline_style é diferente de 5, preenche o plano de fundo da curva com a cor definida pela propriedade background.

line_style:

o valor da propriedade line_style deve ser um inteiro em [1 6]. 1 significa linha sólida e os demais valores tipos diferentes de tracejados. (ver getlinestyle).

thickness:

este campo contém a propriedade de linha thickness (espessura). Deve ser um inteiro positivo.

arrow_size_factor:

este inteiro permite ajustar o tamanho das flechas desenhadas na poligonal. O tamanho real das flechas é o produto entre a propriedade thickness e o fator de tamanho (size factor).

polyline_style:

esta propriedade ajusta vários modos de desenho de poligonais:

  • Se o valor é 0 ou 1 linhas são desenhadas utilizando-se dois pontos consecutivos.

  • Se o valor é 2 a poligonal produz um esboço escada. Dois pontos consecutivos são ligados por uma linha horizontal seguida de uma vertical.

  • Se o valor é 3 a poligonal produz um esboço de barras. Para cada ponto (x,y) dado, uma linha vertical é desenhada de (x,y) a (x,0).

  • Se o valor é 4 flechas são desenhadas entre dois pontos consecutivos.

  • Se o valor é 5 a poligonal é preenchida (remendos).

  • Se o valor é 6 a poligonal é um objeto barra como no Matlab. As propriedades bar_shift e bar_width comandam sua aparência.

foreground:

este campo contém o valor padrão da propriedade foreground (primeiro plano) utilizada para desenhar a poligonal. O valor deve ser um índice de cor (realtivo ao mapa de cores corrente).

background:

este campo contém a cor usada para preencher o plano de fundo da poligonal. Deve ser um índice de cor (relativo ao mapa de cores corrente).

interp_color_vector:

este campo contém os índices das cores utilizadas para preencher a poligonal quando a propriedade interp_color_mode é ajustada para "on". Define os intervalos dos índices do mapa de cores a serem utilizados para preencher cada segmento. Por exemplo, o primeiro segmento será preenchido por todas as cores cujo índice está entre os dois primeiros elementos do vetor. Só é aplicável se a poligonal é definida por 3 ou 4 pontos. Logo, o tamanho do vetor deve coincidir com esta dimensão.

interp_color_mode:

este modo determina se é utilizada gradação interpolada par preencher a poligonal: o valor pode ser "on" ou "off". Note que interp_color_vector deve ser definido antes e ajustar esta propriedade para "on" (ver acima).

mark_mode:

este campo contém o valor padrão da propriedade mark_mode. Deve ser "on" (marcas desenhadas) ou "off" (nenhuma marca desenhada).

mark_style:

A propriedade mark_style é utilizada para selecionar o tipo de marca utilizada quando a propriedade mark_mode é "on". O valor é um inteiro em [0 14] que significa: ponto, sinal de mais, cruz, estrela, rombo preenchido, rombo, triângulo para cima, triângulo para baixo, rombo mais, círculo, asterísco, quadrado, triâ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 property value. Se mark_size_unit for ajustado para "point", então o valor de mark_size é diretamente dado em pontos. Quando mark_size_unit é ajustado para "tabulated", mark_size é computado em relação ao array de tamanho de fonte: logo, seu valor deve ser um inteiro em [0 5] que significa 8pt, 10pt, 12pt, 14pt, 18pt e 24pt. Note que plot2d e funções puras do Scilab utilizam o modo tabulated como padrão; quando se utiliza a função plot, o modo point é automaticamente habilitado.

mark_size:

a propriedade mark_size é utilizada para selecionar o tipo de tamanho das marcas quando a propriedade mark_mode é "on". O valor deve ser um inteiro entre 0 e 5 signficando 8pt, 10pt, 12pt, 14pt, 18pt e 24pt.

mark_foreground:

este campo contém o valor da propriedade mark_foreground que é a cor da borda das marcas. O valor deve ser um índice de cor (relativo ao mapa de cores corrente).

mark_background:

este campo contém o valor da propriedade mark_background que é a cor da face das marcas. O valor deve ser um índice de cor (relativo ao mapa de cores corrente).

x_shift:

este campo contém a compensação computada por uma chamada à função bar (ou recomputada por uma chamada à função barhomogenize) e é usada para realizar uma boa representação de barras verticais. Note que esta compensação é levada em conta para todos os outros polyline_style. A unidade é expressa nas coordenadas do usuário.

y_shift:

este campo contém a compensação computada por uma chamada à função bar (ou recomputada por uma chamada à função barhomogenize) e é usada para realizar uma boa representação de barras verticais. Note que esta compensação é levada em conta para todos os outros polyline_style. TA unidade é expressa nas coordenadas do usuário.

z_shift:

este campo contém a compensação que o usuário pode especificar. Note que esta compensação é levada em conta para todos os polyline_style. A unidade é expressa nas coordenadas do usuário.

bar_width:

este campo determina a largura da poligonal selecionada quando sua propriedade polyline_style é ajustada para modo de barra (caso 6) : a unidade é expressa nas coordenadas do usuário.

clip_state:

este campo contém o valor da propriedade clip_state para a poligonal. O valor de clip_state pode ser :

  • "off" significa que a poligonal não é recortada.

  • "clipgrf" significa que a poligonal é recortada fora da caixa dos eixos.

  • "on" significa que a poligonal é 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 utilizado para armazenar qualquer variável Scilab na estrutura de dados da entidade poligonal e recuperá-la.

Exemplos

 
a=get("current_axes")//obtendo o manipulador dos novos eixos criados
a.data_bounds=[-2,-2;2,2];

xpoly(sin(2*%pi*(0:5)/5),cos(2*%pi*(0:5)/5),"lines",0)
p=get("hdl"); //obtendo o manipulador da entidade corrente (aqui é a entidade poligonal)
p.foreground=2;
p.thickness=3;
p.mark_style=9;
d=p.data;d(1,:)=[0 0];p.data=d;
a.rotation_angles=[0 45];
   
p.data=[(-2:0.1:2)' sin((-2:0.1:2)*%pi)']
p.mark_mode="off";
p.polyline_style=3;
p.line_style=4;
 

Ver Também

set, get, delete, xpoly, xfpoly, xpolys, xfpolys, graphics_entities

Autor

Djalel ABDEMOUCHE