# rectangle_properties

Descrição de propriedades da entidade Rectangle (retângulo)

## Descrição

A entidade Rectangle é uma folha na hierarquia de entidades gráficas. Esta entidade define parâmetros para retângulos preenchidos ou não.

parent:

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

children:

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

mark_mode:

  este campo contém o valor padrão da propriedade `mark_mode` para a poligonal. 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 xrect como padrão; quando se utiliza a função `tabulated` como padrão; quando se utiliza a função plot o modo `point` é automaticamente habilitado.

mark_size:

  A propriedade `mark_size` é utilizada para escolher o tamanho das marcas quando a propriedade `mark_mode` é `"on"`. Deve ser um valor inteiro em [0 5] que significa 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).

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 valor da propriedade `fill_mode` é `"on"`, o retângulo é preenchido com a cor de primeiro plano, `mark_mode` também deve ter valor `"off"`. Senão, o valor da propriedade é `"off"` apenas a forma o contorno do retângulo é desenhado utilizando-se a cor de primeiro plano.

line_style:

  a propriedade `line_style` deve ser um inteiro em [1 6]. 1 stands significa linha sólida, o restante seleciona tracejados.

thickness:

  este campo contém o valor padrão da propriedade `thickness` (espessura) da linha. Deve ser um inteiro positivo.

foreground:

  este campo contém a cor utilizada para desenhar a linha de contorno do retângulo. Seu valor deve ser um índice de cor (relativo ao mapa de cores corrente).

background:

  este campo contém a cor utilizada para preencher a parte interna do retângulo. Seu valor deve ser um índice de cor (relativo ao mapa de cores corrente).

data:

  esta propriedade retorna as coordenadas do ponto superior esquerdo do retângulo, sua altura e largura em unidades de dados dos eixos. O resultado é uma matriz `[xleft,yup,[zup],width,height]`

visible:

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

clip_state:

  este campo contém o valor da propriedade `clip_state` para o retângulo. o valor de clip_state pode ser :

  - `"off"` ignifica que o retângulo não é recortado.

  - `"clipgrf"` significa que o retângulo é recortado fora da caixa dos eixos.

  - `"on"` significa que o retângulo é recortado fora do retângulo 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, altura) define as porções do retângulo a ser exibido, 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 retângulo e recuperá-la.

## Exemplos

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

    xrect(-1,1,2,2)

    r=get("hdl");//obtendo o manipulador da entidade corrente (aqui, a entidade Rectangle)
    r.type
    r.parent.type
    r.foreground=13;
    r.line_style=2;
    r.fill_mode="on";
    r.background=color('red');
    r.clip_box=[-1 1;1 1];
    r.data(:,[3 4])=[1/2 1/2];
    r.data(:,[1 2])=[1/2 1/2];
    r.clip_state="off"

## Ver Também

- set
- get
- delete
- xrect
- xfrect
- xrects
- graphics_entities