← Back to branch summary

~ubuntu-branches/ubuntu/raring/scilab/raring-proposed

« back to all changes in this revision

Viewing changes to modules/graphics/help/pt_BR/geometric_shapes/arc_properties.xml

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2012-08-30 14:42:38 UTC
  • mfrom: (1.4.7)
  • Revision ID: package-import@ubuntu.com-20120830144238-c1y2og7dbm7m9nig
Tags: 5.4.0-beta-3-1~exp1
* New upstream release
* Update the scirenderer dep
* Get ride of libjhdf5-java dependency

Show diffs side-by-side

added added

removed removed

Lines of Context:
modules/graphics/help/pt_BR/geometric_shapes/arc_properties.xml
12
12
 *
13
13
 -->
14
14
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:id="arc_properties" xml:lang="en">
15
 
  <refnamediv>
16
 
    <refname>arc_properties</refname>
17
 
    <refpurpose>Descrição das propriedades da entidade Arc (arco)</refpurpose>
18
 
  </refnamediv>
19
 
  <refsection>
20
 
    <title>Descrição</title>
21
 
    <para>A entidade Arc é uma folha na hierarquia de entidades gráficas. Esta
22
 
      entidade define parâmetros para elipses e partes de elipses preenchidas ou
23
 
      não.
24
 
    </para>
25
 
    <variablelist>
26
 
      <varlistentry>
27
 
        <term>parent:</term>
28
 
        <listitem>
29
 
          <para>esta propriedade contém o manipulador da raiz. A raiz de uma
30
 
            entidade Arc deve ser do tipo <literal>"Axes"</literal> ou
31
 
            <literal>"Compound"</literal>.
32
 
          </para>
33
 
        </listitem>
34
 
      </varlistentry>
35
 
      <varlistentry>
36
 
        <term>children:</term>
37
 
        <listitem>
38
 
          <para>esta propriedade contém um vetor com os galhos do manipulador.
39
 
            Contudo, manipuladores arc não possuem galhos correntemente. 
40
 
          </para>
41
 
        </listitem>
42
 
      </varlistentry>
43
 
      <varlistentry>
44
 
        <term>thickness:</term>
45
 
        <listitem>
46
 
          <para>este campo contém a propriedade de linha
47
 
            <literal>thickness</literal> (espessura). Deve ser um inteiro
48
 
            positivo. 
49
 
          </para>
50
 
        </listitem>
51
 
      </varlistentry>
52
 
      <varlistentry>
53
 
        <term>line_style:</term>
54
 
        <listitem>
55
 
          <para>
56
 
            o valor da propriedade <literal>line_style</literal> deve ser
57
 
            um inteiro em [1 6]. 1 significa linha sólida e os demais valores
58
 
            significam tipos diferentes de tracejados.
59
 
          </para>
60
 
        </listitem>
61
 
      </varlistentry>
62
 
      <varlistentry>
63
 
        <term>line_mode:</term>
64
 
        <listitem>
65
 
          <para>esta propriedade permite que se exiba ou não a linha
66
 
            representando o arco. O valor pode ser <literal>"on"</literal> ou
67
 
            <literal>"off"</literal>.
68
 
          </para>
69
 
        </listitem>
70
 
      </varlistentry>
71
 
      <varlistentry>
72
 
        <term>fill_mode:</term>
73
 
        <listitem>
74
 
          <para>
75
 
            se o valor da propriedade <literal>fill_mode</literal> é
76
 
            <literal>"on" </literal>, o arco é preenchido com a cor
77
 
            <literal>background</literal> (de plano de fundo). 
78
 
          </para>
79
 
        </listitem>
80
 
      </varlistentry>
81
 
      <varlistentry>
82
 
        <term>foreground:</term>
83
 
        <listitem>
84
 
          <para>este campo contém o valor padrão da propriedade
85
 
            <literal>foreground</literal> (primeiro plano) para desenhar ou
86
 
            preencher o arco. Deve ser um índice de cor (relativo ao mapa de
87
 
            cores corrente). 
88
 
          </para>
89
 
        </listitem>
90
 
      </varlistentry>
91
 
      <varlistentry>
92
 
        <term>background:</term>
93
 
        <listitem>
94
 
          <para>este campo contém a cor usada para preencher o arco. Deve ser
95
 
            um índice de cor (relativo ao mapa de cores corrente). 
96
 
          </para>
97
 
        </listitem>
98
 
      </varlistentry>
99
 
      <varlistentry>
100
 
        <term>data:</term>
101
 
        <listitem>
102
 
          <para>esta propriedade retorna as coordenadas do ponto superior
103
 
            esquerdo, a largura e a altura do retângulo envolvente bem como os
104
 
            ângulos de froenteira do setor. É a matriz
105
 
            <literal>[xleft,yup,[zup],width,height,a1,a2]</literal> onde
106
 
            <literal>a1</literal> e <literal>a2</literal> são os ângulos de
107
 
            fronteira dados em graus. 
108
 
          </para>
109
 
          <para>
110
 
            <emphasis role="bold">Aviso:</emphasis> nas versões do Scilab
111
 
            até a 4.1.2 <literal>a1</literal> e <literal>a2</literal> são dados
112
 
            em degree/64.
113
 
          </para>
114
 
        </listitem>
115
 
      </varlistentry>
116
 
      <varlistentry>
117
 
        <term>visible:</term>
118
 
        <listitem>
119
 
          <para>este campo contém o valor da propriedade
120
 
            <literal>visible</literal> para a entidade. Pode ser <literal>"on"
121
 
            </literal>
122
 
            ou <literal>"off"</literal>. Se <literal>"on"</literal> o
123
 
            arco é desenhado, se <literal>"off"</literal> o arco não é exibido
124
 
            na tela. 
125
 
          </para>
126
 
        </listitem>
127
 
      </varlistentry>
128
 
      <varlistentry>
129
 
        <term>arc_drawing_method:</term>
130
 
        <listitem>
131
 
          <para>Este campo controla o tipo de discretização utilizado para
132
 
            renderizar o arco. Seu valor deve ser <literal>"nurbs"</literal> ou
133
 
            <literal>"lines"</literal>. Se <literal>"nurbs"</literal> for
134
 
            selecionado, o arco é renderizado utilizando-se superfícies e curvas
135
 
            nurbs. Isto resulta na exibição de uma superfície perfeita, não
136
 
            importa qual o ponto de vista seja. Se <literal>"lines"</literal> é
137
 
            selecionado, então o arco é aproximado com um número constante de
138
 
            linhas. Isto reduz o tempo de desenho, mas pontas agudas podem
139
 
            aparecer em uma ampliação. O uso do valor <literal>"lines"</literal>
140
 
            é desencorajado e só deve ser utilizado se for notada alguma perda
141
 
            na velocidade dos quadros ao se utilizar o valor
142
 
            <literal>"nurbs"</literal>.
143
 
          </para>
144
 
        </listitem>
145
 
      </varlistentry>
146
 
      <varlistentry>
147
 
        <term>clip_state:</term>
148
 
        <listitem>
149
 
          <para>este campo contém o valor da propriedade
150
 
            <literal>clip_state</literal> para o arco. O valor de clip_state
151
 
            pode ser :
152
 
          </para>
153
 
          <itemizedlist>
154
 
            <listitem>
155
 
              <para>
156
 
                <literal>"off"</literal> significa que o arco não é
157
 
                recortado 
158
 
              </para>
159
 
            </listitem>
160
 
            <listitem>
161
 
              <para>
162
 
                <literal>"clipgrf"</literal> significa que o arco é
163
 
                recortado fora da caixa dos eixos. 
164
 
              </para>
165
 
            </listitem>
166
 
            <listitem>
167
 
              <para>
168
 
                <literal>"on"</literal> significa que o arco é recortado
169
 
                fora do arco dado pela propriedade clip_box.
170
 
              </para>
171
 
            </listitem>
172
 
          </itemizedlist>
173
 
        </listitem>
174
 
      </varlistentry>
175
 
      <varlistentry>
176
 
        <term>clip_box:</term>
177
 
        <listitem>
178
 
          <para>
179
 
            este campo determina a propriedade <literal>clip_box</literal>
180
 
            property. Por padrão seu valor é uma matriz vazia se a propriedade
181
 
            clip_state é "off". Em outros casos, o vetor
182
 
            <literal>[x,y,w,h]</literal> (ponto superior esquerdo, largura e
183
 
            altura) define as porções do arco a serem exibidas, contudo o valor
184
 
            da propriedade <literal>clip_state</literal> será alterado.
185
 
          </para>
186
 
        </listitem>
187
 
      </varlistentry>
188
 
      <varlistentry>
189
 
        <term>user_data:</term>
190
 
        <listitem>
191
 
          <para>este campo pode ser utilizado para armazenar qualquer variável
192
 
            Scilab na estrutura de dados da entidade arco e recuperá-la.
193
 
          </para>
194
 
        </listitem>
195
 
      </varlistentry>
196
 
    </variablelist>
197
 
  </refsection>
198
 
  <refsection>
199
 
    <title>Exemplos</title>
200
 
    <programlisting role="example"><![CDATA[ 
 
15
    <refnamediv>
 
16
        <refname>arc_properties</refname>
 
17
        <refpurpose>Descrição das propriedades da entidade Arc (arco)</refpurpose>
 
18
    </refnamediv>
 
19
    <refsection>
 
20
        <title>Descrição</title>
 
21
        <para>A entidade Arc é uma folha na hierarquia de entidades gráficas. Esta
 
22
            entidade define parâmetros para elipses e partes de elipses preenchidas ou
 
23
            não.
 
24
        </para>
 
25
        <variablelist>
 
26
            <varlistentry>
 
27
                <term>parent:</term>
 
28
                <listitem>
 
29
                    <para>esta propriedade contém o manipulador da raiz. A raiz de uma
 
30
                        entidade Arc deve ser do tipo <literal>"Axes"</literal> ou
 
31
                        <literal>"Compound"</literal>.
 
32
                    </para>
 
33
                </listitem>
 
34
            </varlistentry>
 
35
            <varlistentry>
 
36
                <term>children:</term>
 
37
                <listitem>
 
38
                    <para>esta propriedade contém um vetor com os galhos do manipulador.
 
39
                        Contudo, manipuladores arc não possuem galhos correntemente. 
 
40
                    </para>
 
41
                </listitem>
 
42
            </varlistentry>
 
43
            <varlistentry>
 
44
                <term>thickness:</term>
 
45
                <listitem>
 
46
                    <para>este campo contém a propriedade de linha
 
47
                        <literal>thickness</literal> (espessura). Deve ser um inteiro
 
48
                        positivo. 
 
49
                    </para>
 
50
                </listitem>
 
51
            </varlistentry>
 
52
            <varlistentry>
 
53
                <term>line_style:</term>
 
54
                <listitem>
 
55
                    <para>
 
56
                        o valor da propriedade <literal>line_style</literal> deve ser
 
57
                        um inteiro em [1 6]. 1 significa linha sólida e os demais valores
 
58
                        significam tipos diferentes de tracejados.
 
59
                    </para>
 
60
                </listitem>
 
61
            </varlistentry>
 
62
            <varlistentry>
 
63
                <term>line_mode:</term>
 
64
                <listitem>
 
65
                    <para>esta propriedade permite que se exiba ou não a linha
 
66
                        representando o arco. O valor pode ser <literal>"on"</literal> ou
 
67
                        <literal>"off"</literal>.
 
68
                    </para>
 
69
                </listitem>
 
70
            </varlistentry>
 
71
            <varlistentry>
 
72
                <term>fill_mode:</term>
 
73
                <listitem>
 
74
                    <para>
 
75
                        se o valor da propriedade <literal>fill_mode</literal> é
 
76
                        <literal>"on" </literal>, o arco é preenchido com a cor
 
77
                        <literal>background</literal> (de plano de fundo). 
 
78
                    </para>
 
79
                </listitem>
 
80
            </varlistentry>
 
81
            <varlistentry>
 
82
                <term>foreground:</term>
 
83
                <listitem>
 
84
                    <para>este campo contém o valor padrão da propriedade
 
85
                        <literal>foreground</literal> (primeiro plano) para desenhar ou
 
86
                        preencher o arco. Deve ser um índice de cor (relativo ao mapa de
 
87
                        cores corrente). 
 
88
                    </para>
 
89
                </listitem>
 
90
            </varlistentry>
 
91
            <varlistentry>
 
92
                <term>background:</term>
 
93
                <listitem>
 
94
                    <para>este campo contém a cor usada para preencher o arco. Deve ser
 
95
                        um índice de cor (relativo ao mapa de cores corrente). 
 
96
                    </para>
 
97
                </listitem>
 
98
            </varlistentry>
 
99
            <varlistentry>
 
100
                <term>data:</term>
 
101
                <listitem>
 
102
                    <para>esta propriedade retorna as coordenadas do ponto superior
 
103
                        esquerdo, a largura e a altura do retângulo envolvente bem como os
 
104
                        ângulos de froenteira do setor. É a matriz
 
105
                        <literal>[xleft,yup,[zup],width,height,a1,a2]</literal> onde
 
106
                        <literal>a1</literal> e <literal>a2</literal> são os ângulos de
 
107
                        fronteira dados em graus. 
 
108
                    </para>
 
109
                    <para>
 
110
                        <emphasis role="bold">Aviso:</emphasis> nas versões do Scilab
 
111
                        até a 4.1.2 <literal>a1</literal> e <literal>a2</literal> são dados
 
112
                        em degree/64.
 
113
                    </para>
 
114
                </listitem>
 
115
            </varlistentry>
 
116
            <varlistentry>
 
117
                <term>visible:</term>
 
118
                <listitem>
 
119
                    <para>este campo contém o valor da propriedade
 
120
                        <literal>visible</literal> para a entidade. Pode ser <literal>"on"
 
121
                        </literal>
 
122
                        ou <literal>"off"</literal>. Se <literal>"on"</literal> o
 
123
                        arco é desenhado, se <literal>"off"</literal> o arco não é exibido
 
124
                        na tela. 
 
125
                    </para>
 
126
                </listitem>
 
127
            </varlistentry>
 
128
            <varlistentry>
 
129
                <term>arc_drawing_method:</term>
 
130
                <listitem>
 
131
                    <para>Este campo controla o tipo de discretização utilizado para
 
132
                        renderizar o arco. Seu valor deve ser <literal>"nurbs"</literal> ou
 
133
                        <literal>"lines"</literal>. Se <literal>"nurbs"</literal> for
 
134
                        selecionado, o arco é renderizado utilizando-se superfícies e curvas
 
135
                        nurbs. Isto resulta na exibição de uma superfície perfeita, não
 
136
                        importa qual o ponto de vista seja. Se <literal>"lines"</literal> é
 
137
                        selecionado, então o arco é aproximado com um número constante de
 
138
                        linhas. Isto reduz o tempo de desenho, mas pontas agudas podem
 
139
                        aparecer em uma ampliação. O uso do valor <literal>"lines"</literal>
 
140
                        é desencorajado e só deve ser utilizado se for notada alguma perda
 
141
                        na velocidade dos quadros ao se utilizar o valor
 
142
                        <literal>"nurbs"</literal>.
 
143
                    </para>
 
144
                </listitem>
 
145
            </varlistentry>
 
146
            <varlistentry>
 
147
                <term>clip_state:</term>
 
148
                <listitem>
 
149
                    <para>este campo contém o valor da propriedade
 
150
                        <literal>clip_state</literal> para o arco. O valor de clip_state
 
151
                        pode ser :
 
152
                    </para>
 
153
                    <itemizedlist>
 
154
                        <listitem>
 
155
                            <para>
 
156
                                <literal>"off"</literal> significa que o arco não é
 
157
                                recortado 
 
158
                            </para>
 
159
                        </listitem>
 
160
                        <listitem>
 
161
                            <para>
 
162
                                <literal>"clipgrf"</literal> significa que o arco é
 
163
                                recortado fora da caixa dos eixos. 
 
164
                            </para>
 
165
                        </listitem>
 
166
                        <listitem>
 
167
                            <para>
 
168
                                <literal>"on"</literal> significa que o arco é recortado
 
169
                                fora do arco dado pela propriedade clip_box.
 
170
                            </para>
 
171
                        </listitem>
 
172
                    </itemizedlist>
 
173
                </listitem>
 
174
            </varlistentry>
 
175
            <varlistentry>
 
176
                <term>clip_box:</term>
 
177
                <listitem>
 
178
                    <para>
 
179
                        este campo determina a propriedade <literal>clip_box</literal>
 
180
                        property. Por padrão seu valor é uma matriz vazia se a propriedade
 
181
                        clip_state é "off". Em outros casos, o vetor
 
182
                        <literal>[x,y,w,h]</literal> (ponto superior esquerdo, largura e
 
183
                        altura) define as porções do arco a serem exibidas, contudo o valor
 
184
                        da propriedade <literal>clip_state</literal> será alterado.
 
185
                    </para>
 
186
                </listitem>
 
187
            </varlistentry>
 
188
            <varlistentry>
 
189
                <term>user_data:</term>
 
190
                <listitem>
 
191
                    <para>este campo pode ser utilizado para armazenar qualquer variável
 
192
                        Scilab na estrutura de dados da entidade arco e recuperá-la.
 
193
                    </para>
 
194
                </listitem>
 
195
            </varlistentry>
 
196
        </variablelist>
 
197
    </refsection>
 
198
    <refsection>
 
199
        <title>Exemplos</title>
 
200
        <programlisting role="example"><![CDATA[ 
201
201
a=get("current_axes");//obtendo o manipulador dos novos eixos criados
202
202
a.data_bounds=[-2,-2;2,2];
203
203
 
210
210
xfarc(-.5,1,.4,.6,0,360*64);
211
211
arc.visible="off";
212
212
 ]]></programlisting>
213
 
  </refsection>
214
 
  <refsection>
215
 
    <title>Ver Também </title>
216
 
    <simplelist type="inline">
217
 
      <member>
218
 
        <link linkend="set">set</link>
219
 
      </member>
220
 
      <member>
221
 
        <link linkend="get">get</link>
222
 
      </member>
223
 
      <member>
224
 
        <link linkend="delete">delete</link>
225
 
      </member>
226
 
      <member>
227
 
        <link linkend="xarc">xarc</link>
228
 
      </member>
229
 
      <member>
230
 
        <link linkend="xarcs">xarcs</link>
231
 
      </member>
232
 
      <member>
233
 
        <link linkend="xfarc">xfarc</link>
234
 
      </member>
235
 
      <member>
236
 
        <link linkend="xfarcs">xfarcs</link>
237
 
      </member>
238
 
      <member>
239
 
        <link linkend="graphics_entities">graphics_entities</link>
240
 
      </member>
241
 
    </simplelist>
242
 
  </refsection>
 
213
    </refsection>
 
214
    <refsection>
 
215
        <title>Ver Também </title>
 
216
        <simplelist type="inline">
 
217
            <member>
 
218
                <link linkend="set">set</link>
 
219
            </member>
 
220
            <member>
 
221
                <link linkend="get">get</link>
 
222
            </member>
 
223
            <member>
 
224
                <link linkend="delete">delete</link>
 
225
            </member>
 
226
            <member>
 
227
                <link linkend="xarc">xarc</link>
 
228
            </member>
 
229
            <member>
 
230
                <link linkend="xarcs">xarcs</link>
 
231
            </member>
 
232
            <member>
 
233
                <link linkend="xfarc">xfarc</link>
 
234
            </member>
 
235
            <member>
 
236
                <link linkend="xfarcs">xfarcs</link>
 
237
            </member>
 
238
            <member>
 
239
                <link linkend="graphics_entities">graphics_entities</link>
 
240
            </member>
 
241
        </simplelist>
 
242
    </refsection>
243
243
</refentry>