# arc_properties

Descrição das propriedades da entidade Arc (arco)

## Descrição

A entidade Arc é uma folha na hierarquia de entidades gráficas. Esta entidade define parâmetros para elipses e partes de elipses preenchidas ou não.

parent:

  esta propriedade contém o manipulador da raiz. A raiz de uma entidade Arc deve ser do tipo `"Axes"` ou `"Compound"`.

children:

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

thickness:

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

line_style:

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

line_mode:

  esta propriedade permite que se exiba ou não a linha representando o arco. O valor pode ser `"on"` ou `"off"`.

fill_mode:

  se o valor da propriedade `fill_mode` é `"on"` , o arco é preenchido com a cor `background` (de plano de fundo).

foreground:

  este campo contém o valor padrão da propriedade `foreground` (primeiro plano) para desenhar ou preencher o arco. Deve ser um índice de cor (relativo ao mapa de cores corrente).

background:

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

data:

  esta propriedade retorna as coordenadas do ponto superior esquerdo, a largura e a altura do retângulo envolvente bem como os ângulos de froenteira do setor. É a matriz `[xleft,yup,[zup],width,height,a1,a2]` onde `a1` e `a2` são os ângulos de fronteira dados em graus.

  Aviso: nas versões do Scilab até a 4.1.2 `a1` e `a2` são dados em degree/64.

visible:

  este campo contém o valor da propriedade `visible` para a entidade. Pode ser `"on"` ou `"off"`. Se `"on"` o arco é desenhado, se `"off"` o arco não é exibido na tela.

arc_drawing_method:

  Este campo controla o tipo de discretização utilizado para renderizar o arco. Seu valor deve ser `"nurbs"` ou `"lines"`. Se `"nurbs"` for selecionado, o arco é renderizado utilizando-se superfícies e curvas nurbs. Isto resulta na exibição de uma superfície perfeita, não importa qual o ponto de vista seja. Se `"lines"` é selecionado, então o arco é aproximado com um número constante de linhas. Isto reduz o tempo de desenho, mas pontas agudas podem aparecer em uma ampliação. O uso do valor `"lines"` é desencorajado e só deve ser utilizado se for notada alguma perda na velocidade dos quadros ao se utilizar o valor `"nurbs"`.

clip_state:

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

  - `"off"` significa que o arco não é recortado

  - `"clipgrf"` significa que o arco é recortado fora da caixa dos eixos.

  - `"on"` significa que o arco é recortado fora do arco dado pela propriedade clip_box.

clip_box:

  este campo determina a propriedade `clip_box` property. 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 e altura) define as porções do arco 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 arco e recuperá-la.

## Exemplos

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

    xarc(-1.5,1.5,3,3,0,360*64)

    arc=get("hdl"); //obtendo o manipulador da entidade corrente (aqui é a entidade Arc)
    arc.fill_mode="on";
    arc.foreground=5;
    arc.data(:,[3 6])=[2 270*64];
    xfarc(-.5,1,.4,.6,0,360*64);
    arc.visible="off";

## Ver Também

- set
- get
- delete
- xarc
- xarcs
- xfarc
- xfarcs
- graphics_entities