Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
5.3.3 - Português

Change language to:
English - Français - 日本語 -

Please note that the recommended version of Scilab is 2025.0.0. This page might be outdated.
See the recommended documentation of this function

Ajuda Scilab >> Biblioteca de Gráficos > GlobalProperty

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 1x3 (ou 3x1) 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 Foregroundexiste 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 1x3 (or 3x1) 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 1x3 (ou 3x1) 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 1x3 (ou 3x1) 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 dadosZ 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 — Customização rápida de linhas que aparecem em um esboço
  • plot — Esboço 2d
  • surf — Esboço de superfície 3d
  • clf — Limpa ou reajusta a (janela da) figura gráfica corrente para valores padrões
  • polyline_properties — description of the Polyline entity properties
  • surface_properties — description of the 3D entities properties

Autor

F.Leray

<< Datatips Biblioteca de Gráficos Graphics >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Wed Oct 05 12:11:53 CEST 2011