# GlobalProperty

Customização de aparência dos objetos (curvas, superfícies...) num comando plot ou surf.

## Seqüência de Chamamento

        Nenhuma. GlobalProperty é um argumento opcional que pode ser utilizado dentro de um comando plot ou surf. Permite uma customização global de todas as novas linhas esboçadas (respectivamente superfícies). Deve ser fornecido como o par{PropertyName, PropertyValue}. Vários pares podem ser ajustados ao mesmo tempo.
                PropertyName deve ser um string definido a propriedade a ser ajustada. PropertyValue pode ser um real, um inteiro ou um string (um escalar, ou matriz de) dependendo do tipo de propriedade usada. Por exemplo, para especificar um (estilo de linha) traço longo vermelho (cor) com marca diamante (marca), a seqüência deve ser : 'Colo','red','LineSt','-.','Marker','diam'.
                Como você pode ver, uma escrita completa dos nomes e valores das propriedades não é necessária mas os argumentos, especificados em qualquer ordem, não podem ser ambíguos. Além disso, a especificação dos strings não diferencia letras minúsculas de maiúsculas. GlobalProperty é predominante em todos os LineSpec anteriormente citados.

## Descrição

Aqui está uma lista completa dos `PropertyName` que você pode especificar (utilizando plot ou surf) e seus associados disponíveis `PropertyValue`. Se não forem especificadas, estas propriedades estão disponíveis para ambos objetos `Polyline` e `Fac3d` (criados respectivamente por plot e surf) e, como dito anteriormente, eles são aplicados aos novos objetos criados (linhas ou superfícies).

Algumas vezes, você pode ter dois PropertyName correspondentes a uma propriedade: o primeiro é o nome Matlab equivalente, O segundo é o nome padrão utilizado pelo Scilab(i.e.: `Color ou Foreground` para uma linha, ver abaixo).

CData or ColorData:

  uma matriz de reais especificando as cores em todos os pontos definidos pela matriz `Z`. TEsta propriedade esta ligada à propriedade `data.color` do objeto (ver surface_properties). Note que esta propriedade está disponível para superfícies apenas.

CDataMapping ou ColorDataMapping:

  um string com valor `'scaled'` ou `'direct'`. Se um `data.color` estiver ajustado, cada índice de cor especifica um único valor para cada 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 este mapa de cores (modo `'direct`'). Esta propriedade é útil quando `color_flag` é igual a `2`,`3` ou `4`. Note que esta propriedade só existe em entidades `Fac3d`. Note também que `plot3d` tem modo `'direct'` por padrão e `surf` tem modo`'scaled'` por padrão.

Clipping:

  um string `"on"` ou `"off"` definindo o modo de recorte (`"on"` por padrão). É equivalente à propriedade `clip_state` property. Este campo contém a propriedade (ver polyline_properties). Note que esta propriedade ainda não está disponível para entidades de superfícies.

Color ou Foreground:

  um string definindo uma cor conhecida (ver color_list) ou um vetor `1`x`3` (ou `3`x`1`) RGB defindo um número de cor. O número de cor é dado como uma tripla `R`, `G`, `B` correspondendo respectivamente a to às intensidades de vermelho, verde e azul entre 0 e 1. Esta propriedade está ligada à propriedade `foreground` do objeto (ver polyline_properties). `Aviso:` Color não está disponível para objetos superfícies. A propriedade `Foreground`existe para objetos superfícies mas está ligada à propriedade do Matlab `EdgeColor` (ver surface_properties).

EdgeColor or Foreground:

  um string definindo uma cor conhecida (ver color_list) ou um vetor `1`x`3` (or `3`x`1`) RGB definindo um número de cor. O número de cor é dado pela tripla `R`, `G`, `B` correspondendo respectivamente a to às intensidades de vermelho, verde e azul entre 0 e 1. Esta propriedade está ligada à propriedade `foreground` da superfície (ver surface_properties). `Aviso` `:` para poligonais a propriedade `Foreground` existe com um signficado diferente (ver acima) e `EdgeColor` não existe.

FaceColor:

  um string com valor `'none'`, `'flat'` ou `'interp'` especificando o modo como as cores das facetas são renderizadas. Quando`'none'` é selecionado, uma malha da superfície é desenhada; se `'flat'` (modo padrão) é selecionado, os valores `Fac3d` `color.data` determinam uma cor por faceta utilizando a cor do vértice da faceta. Se o valor é `'interp'`, uma gradação interpolada é feita na faceta utilizando `color.data` para determinar a cor em cada vértice da faceta.

LineStyle:

  esta propriedade deve ser um string definindo um estilo de linha. Esta propriedade está ligada à propriedade `line_style` do objeto (ver polyline_properties ou surface_properties).

  `Especificador` | `Estilo de linha`
  `-` | linha sólida (padrão)
  `--` | linha tracejada
  `:` | linha pontilhada
  `-.` | linha tracejada-pontilhada
  `none` | nenhuma linha

Marker or MarkStyle:

  um string definindo um tipo de marca. Note que se você especificar uma marca sem um estilo de linha, ambas linhas (com valor padrão sólido hablitado) e marcas são desenhadas . Esta propriedade está ligada às propriedades `mark_style` e `mark_mode` do objeto (ver polyline_properties ou surface_properties).

  `Especificador` | `Tipo de marca`
  `+` | sinal de mais
  `o` | círculo
  `*` | asterísco
  `.` | ponto
  `x` | cruz
  `'square'` or `'s'` | quadrado
  `'diamond'` or `'d'` | rombo (diamante)
  `^` | triângulo para cima
  `v` | triângulo para baixo
  `>` | triângulo para direita
  `<` | triângulo para esquerda
  `'pentagram'` | estrela de cinco pontas (pentagrama)
  `'none'` | sem marca (padrão)

MarkerEdgeColor ou MarkForeground:

  um string definindo uma cor conhecida(ver color_list) ou um vetor `1`x`3` (ou `3`x`1`) RGB definindo um número de cor. O número de cor é dado pela tripla `R`, `G`, `B` correspondendo respectivamente às intensidades de vermelho, verde e azul entre 0 e 1. esta propriedade está ligada à propriedade `mark_foreground` do objeto (ver polyline_properties ou surface_properties).

MarkerFaceColor ou MarkBackground:

  um string definindo uma cor conhecida (ver color_list) ou um vetor `1`x`3` (ou `3`x`1`) RGB definindo um número de cor. O número de cor é dado pela tripla `R`, `G`, `B` correspondendo respectivamente às intensidades de vermelho, verde e azul entre 0 e 1. Esta propriedade esta ligada à propriedade `mark_background` do objeto (ver polyline_properties ou surface_properties).

MarkerSize ou MarkSize:

  um escalar definindo o tamanho do marcador em unidade `point`. Esta propriedade está ligada a propriedade `mark_size` do objeto com `mark_size_unit` habilitado para `"point"` (ver polyline_properties ou surface_properties).

Visible:

  um string `"on"` ou `"off"` definindo o modo de visibilidade (`"on"` por padrão). Esta propriedade está ligada à propriedade `visible` do objeto (ver polyline_properties ou surface_properties).

X data:

  um vetor ou matriz de reais (re-)definindo os dados fornecidos para todas as linhas ou superfícies esboçadas. A respeito das dimensões, note que estes novos dados devem corresponder a todos os anteriores especificados por `X` isto é, todas as matrizes devem ter as mesmas dimensões. Esta propriedade está ligada à propriedade `data.x` do objeto (ver polyline_properties ou surface_properties).

Y data:

  um vetor ou matriz de reais (re-)definindo os dados fornecidos para todas as linhas ou superfícies esboçadas. A respeito das dimensões, note que estes novos dados devem corresponder a todos os anteriores especificados por `Y` data , isto é, todas as matrizes devem ter as mesmas dimensões. Esta propriedade está ligada à propriedade `data.y` do objeto (ver polyline_properties ou surface_properties).

Z data:

  quando usado com `plot`, um vetor ou matriz de reais adicionando dados`Z` para todas as linhas esboçadas; com `surf`, uma matriz de reais (re-)definindo os dados fornecidos para todas as superfícies. A respeito das dimensões, note que estes novos dados devem corresponder a todos os anteriores especificados por `X` e `Y` data. Esta propriedade está ligada à propriedade `data.z` do objeto (ver polyline_properties ou surface_properties).

## Exemplos

    // --------------------
    // com o comando plot:
    // --------------------
    x=1:10; // Init.
    plot(x,sin(x),'colo','red','linest','-.','marker','<','markeredg','cyan','markerFace','yellow','markersize',5)
    clf();

    // a ordem das combinações e, {PropertyName,PropertyValue} não importa
    plot(x,sin(x),'marker','p','markerfac','cyan','markersiz',10)
    clf();

    // a combinação de LineSpec com GlobalProperty mostra a predominância de Global Property
    plot(x,x.*x,'*cya--','color','gr','linestyle','-','marker','sq','markersize',6,'markforegroun','red','markbackgro',[0.2 0.5 0.6])
    clf();

    //múltiplos esboços com diferentes LineSpecs e finalmente alguns GlobalProperty
    clf();
    t=0:%pi/20:2*%pi;
    plot(t,sin(t),'ro-.',t,cos(t),'cya+',t,abs(sin(t)),'--mo','markstyl','diam')

    // --------------------
    // com o comando surf:
    // --------------------

    Z= [   0.0001    0.0013    0.0053   -0.0299   -0.1809   -0.2465   -0.1100   -0.0168   -0.0008   -0.0000
        0.0005    0.0089    0.0259   -0.3673   -1.8670   -2.4736   -1.0866   -0.1602   -0.0067    0.0000
        0.0004    0.0214    0.1739   -0.3147   -4.0919   -6.4101   -2.7589   -0.2779    0.0131    0.0020
       -0.0088   -0.0871    0.0364    1.8559    1.4995   -2.2171   -0.2729    0.8368    0.2016    0.0130
       -0.0308   -0.4313   -1.7334   -0.1148    3.0731    0.4444    2.6145    2.4410    0.4877    0.0301
       -0.0336   -0.4990   -2.3552   -2.1722    0.8856   -0.0531    2.6416    2.4064    0.4771    0.0294
       -0.0137   -0.1967   -0.8083    0.2289    3.3983    3.1955    2.4338    1.2129    0.2108    0.0125
       -0.0014   -0.0017    0.3189    2.7414    7.1622    7.1361    3.1242    0.6633    0.0674    0.0030
        0.0002    0.0104    0.1733    1.0852    2.6741    2.6725    1.1119    0.1973    0.0152    0.0005
        0.0000    0.0012    0.0183    0.1099    0.2684    0.2683    0.1107    0.0190    0.0014    0.0000];

    clf();
    f=gcf();
    f.figure_size = [610,724];
    subplot(211)
    surf(Z,'facecol','interp','ydat',101:110,'edgecol','mage')
    subplot(212)
    surf(Z,'edgeco','b','marker','d','markersiz',9,'markerfac','k','xdata',-50:-41)

## Ver Também

- LineSpec
- plot
- surf
- clf
- polyline_properties
- surface_properties