--- /dev/null
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) INRIA - Djalel Abdemouche
+ *
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution. The terms
+ * are also available at
+ * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
+ *
+ -->
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:lang="en" xml:id="param3d_properties">
+ <info>
+ <pubdate>$LastChangedDate$</pubdate>
+ </info>
+ <refnamediv>
+ <refname>param3d_properties</refname>
+ <refpurpose>description of the 3D curves
+ entities properties</refpurpose>
+ </refnamediv>
+ <refsection>
+ <title>Description</title>
+ <para>The Param3d entity is a leaf of the graphics entities hierarchy.</para>
+ <variablelist>
+ <varlistentry>
+ <term>visible: </term>
+ <listitem>
+ <para>This field contains the <literal>visible</literal> property value for
+ the entity . It should be <literal>"on" </literal> or <literal>"off"</literal> .
+ By default, the curves are visibles, the value's property is
+ <literal>"on" </literal>. If <literal>"off"</literal> the curves are not drawn on
+ the screen.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>data: </term>
+ <listitem>
+ <para>This field contains the coordinates of the 3d curves. it is the
+ matrix <literal>[X,Y,Z]</literal> such as <literal>X(:,i)</literal>,
+ <literal>Y(:,i)</literal>, <literal>Z(:,i)</literal> contain the 3D coordinates of
+ the <literal>i</literal>'th curve. This field contains the default
+ <literal>line_style</literal> property value for Segs, Arcs, Rectangle and
+ Polyline objects.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>line_mode: </term>
+ <listitem>
+ <para>This field contains the default <literal>line_mode</literal> property
+ value for the polyline. Its value should be <literal>"on" </literal>(line
+ drawn) or <literal>"off"</literal> (no line drawn).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>line_style: </term>
+ <listitem>
+ <para>This field selects the type of line to be used to draw lines . Its
+ value should be an integer in [0 6]. 0 stands for solid, the other
+ values stand for a selection of dashes (see
+ <link linkend="getlinestyle">getlinestyle</link>).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>polyline_style: </term>
+ <listitem>
+ <para>This field selects the way curve are drawn: interpolated
+ (default), staircase, barplot, arrowed and filled modes are available
+ through integer index [1:5].</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>mark_mode: </term>
+ <listitem>
+ <para>This field contains the default <literal>mark_mode</literal> property
+ value. Its value should be <literal>"on"</literal> or <literal>"off"</literal>
+ (default value).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>mark_style: </term>
+ <listitem>
+ <para>This field contains the default <literal>mark_style</literal> property
+ value. The <literal>mark_style</literal> selects the type of mark to be
+ displayed. Its value should be an integer in [0 9] which stands for:
+ dot, plus, cross, star, filled diamond, diamond, triangle up, triangle
+ down, trefle and circle. The figure below shows the aspects of the marks
+ depending on the <literal>mark_style</literal> and the
+ <literal>mark_foreground</literal> and
+ <literal>mark_background</literal> properties.</para>
+ <para>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="../images/marks.svg"/>
+ </imageobject>
+ </mediaobject>
+ </para>
+
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>mark_size_unit: </term>
+ <listitem>
+ <para>This field contains the default <literal>mark_size_unit</literal>
+ property value. If <literal>mark_size_unit</literal> is set to
+ <literal>"point"</literal>, then the <literal>mark_size</literal> value is
+ directly given in points. When <literal>mark_size_unit</literal> is set to
+ <literal>"tabulated"</literal>, <literal>mark_size</literal> is computed relative
+ to the font size array: therefore, its value should be an integer in
+ [0 5] whith stands for 8pt, 10pt, 12pt, 14pt, 18pt and 24pt. Note that
+ <link linkend="param3d">param3d</link> and pure scilab functions use
+ <literal>tabulated</literal> mode as default ; when using <link linkend="plot">plot</link>
+ function, the <literal>point</literal> mode is automatically enabled.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>mark_size: </term>
+ <listitem>
+ <para>This field contains the default <literal>mark_size</literal> property
+ value</para>
+ <para>. The <literal>mark_size</literal> selects the font size of the mark to
+ be displayed. Its value should be an integer in [0 5] whith stands for
+ 8pt, 10pt, 12pt, 14pt, 18pt and 24pt (see <link linkend="getmark">getmark</link>).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>mark_foreground: </term>
+ <listitem>
+ <para>This field contains the <literal>mark_foreground</literal> property
+ value which is the marks' edge color. Its value should be a color
+ index (relative to the current color_map).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>mark_background: </term>
+ <listitem>
+ <para>This field contains the <literal>mark_background</literal> property
+ value which is the marks' face color. Its value should be a color
+ index (relative to the current color_map).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>thickness: </term>
+ <listitem>
+ <para>This field contains the default <literal>thickness</literal> value of
+ the lines used to draw the axes and the curves. It should be a
+ positive integer.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>foreground: </term>
+ <listitem>
+ <para>This field contains the color index used to draw the curves. Its
+ value should be a color index (relative to the current colormap).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>clip_state: </term>
+ <listitem>
+ <para>This field contains the default <literal>clip_state</literal> property
+ value. Its value should be :</para>
+ <itemizedlist>
+ <listitem>
+ <para><literal>"off"</literal> this means that all curves created after
+ that are not clipped (default value).</para>
+ </listitem>
+ <listitem>
+ <para><literal>"clipgrf"</literal> this means that all curves created
+ after that are clipped outside the Axes boundaries.</para>
+ </listitem>
+ <listitem>
+ <para><literal>"on"</literal> this means that all curves created after
+ that are clipped outside the rectangle given by property
+ clip_box.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>clip_box: </term>
+ <listitem>
+ <para>This field contains the default <literal>clip_box</literal> property
+ value. Its value should be an empty matrix if clip_state is
+ <literal>"off"</literal>. Other case the clipping is given by the vector
+ <literal>[x,y,w,h]</literal> (upper-left point width height).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>user_data: </term>
+ <listitem>
+ <para>This field can be use to store any scilab variable in the
+ param3d data structure, and to retreive it.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>parent: </term>
+ <listitem>
+ <para>This property contains the handle of the parent. The parent of the
+ 3D curves entity should be of type <literal>"Axes"</literal> or
+ <literal>"Compound"</literal>.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsection>
+ <refsection>
+ <title>Examples</title>
+ <programlisting role="example"><![CDATA[
+
+ a=get("current_axes");//get the handle of the newly created axes
+ t=[0:0.1:5*%pi]';
+ param3d1([sin(t),sin(2*t)],[cos(t),cos(2*t)],[t/10,sin(t)])
+
+ a.rotation_angles=[65,75];
+ a.data_bounds=[-1,-1,-1;1,1,2]; //boundaries given by data_bounds
+ a.thickness = 2;
+ h=a.children //get the handle of the param3d entity: an Compound composed of 2 curves
+ h.children(1).foreground = 3 // first curve
+ curve2 = h.children(2);
+ curve2.foreground = 6;
+ curve2.mark_style = 2;
+
+
+ ]]></programlisting>
+ </refsection>
+ <refsection>
+ <title>See Also</title>
+ <simplelist type="inline">
+ <member>
+ <link linkend="set">set</link>
+ </member>
+ <member>
+ <link linkend="get">get</link>
+ </member>
+ <member>
+ <link linkend="delete">delete</link>
+ </member>
+ <member>
+ <link linkend="param3d">param3d</link>
+ </member>
+ <member>
+ <link linkend="param3d1">param3d1</link>
+ </member>
+ <member>
+ <link linkend="graphics_entities">graphics_entities</link>
+ </member>
+ </simplelist>
+ </refsection>
+ <refsection>
+ <title>Authors</title>
+ <para>Djalel ABDEMOUCHE</para>
+ </refsection>
+</refentry>
<mediaobject>
<imageobject>
- <imagedata align="center" fileref="../images/plot3d_patch.png" />
+ <imagedata align="center" fileref="../../images/plot3d_patch.png" />
</imageobject>
</mediaobject>
<mediaobject>
<imageobject>
- <imagedata align="center" fileref="../images/plot3d_patch_vertex.png" />
+ <imagedata align="center" fileref="../../images/plot3d_patch_vertex.png" />
</imageobject>
</mediaobject>
<pubdate>$LastChangedDate$</pubdate>
</info>
<refnamediv>
- <refname>Graphics</refname>
+ <refname>Graphics: Getting started</refname>
<refpurpose> graphics library overview</refpurpose>
</refnamediv>
<refsection>
<para>
<inlinemediaobject>
<imageobject>
- <imagedata fileref="../images/marks.svg"/>
+ <imagedata fileref="../../images/marks.svg"/>
</imageobject>
</inlinemediaobject>
</para>
<mediaobject>
<imageobject>
- <imagedata align="center" fileref="../images/plot3d_patch.png" />
+ <imagedata align="center" fileref="../../images/plot3d_patch.png" />
</imageobject>
</mediaobject>
<mediaobject>
<imageobject>
- <imagedata align="center" fileref="../images/plot3d_patch_vertex.png" />
+ <imagedata align="center" fileref="../../images/plot3d_patch_vertex.png" />
</imageobject>
</mediaobject>
+++ /dev/null
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!--
- * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
- * Copyright (C) INRIA - Djalel Abdemouche
- *
- * This file must be used under the terms of the CeCILL.
- * This source file is licensed as described in the file COPYING, which
- * you should have received as part of this distribution. The terms
- * are also available at
- * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
- *
- -->
-<refentry version="5.0-subset Scilab" xml:id="Compound_properties"
- xml:lang="en" xmlns="http://docbook.org/ns/docbook"
- xmlns:xlink="http://www.w3.org/1999/xlink"
- xmlns:svg="http://www.w3.org/2000/svg"
- xmlns:ns5="http://www.w3.org/1999/xhtml"
- xmlns:mml="http://www.w3.org/1998/Math/MathML"
- xmlns:db="http://docbook.org/ns/docbook">
- <info>
- <pubdate>$LastChangedDate$</pubdate>
- </info>
-
- <refnamediv>
- <refname>Compound_properties</refname>
-
- <refpurpose>Descrição das propriedades da entidade compound</refpurpose>
- </refnamediv>
-
- <refsection>
- <title>Descrição</title>
-
- <para>A entidade Compound é uma entidade de terceiro nível na hierarquia
- de entidades gráficas. Esta entidade define interdependências entre várias
- entidades gráficas e suas propriedades de visibilidade global.</para>
-
- <variablelist>
- <varlistentry>
- <term>parent:</term>
-
- <listitem>
- <para>esta propriedade contém o manipulador da raiz. A raiz de uma
- entidade Text deve ser do tipo <literal>"Axes"</literal> ou
- <literal>"Compound"</literal>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>children:</term>
-
- <listitem>
- <para>um vetor contendo manipuladores para os objetos gráficos
- galhos do Compound. Estes objetos gráficos podem ser do tipo
- <literal>"Compound"</literal>, <literal>"Rectangle"</literal>,
- <literal>"Polyline"</literal>, <literal>"Patch"</literal>,
- <literal>"Segs"</literal>, <literal>"Arc"</literal>,
- <literal>"Grayplot"</literal>,..</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>visible:</term>
-
- <listitem>
- <para>este campo contém o valor da propriedade visible para a
- entidade . Pode ser <literal>"on" </literal> ou
- <literal>"off"</literal>. Por padrão, o valor é <literal>"on"
- </literal> onde as entidades gráficas galhos do Compound são
- desenhadas. Se <literal>"off"</literal> nenhum dos galhos do
- Compound é desenhado na tela. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>user_data:</term>
-
- <listitem>
- <para>este campo pode ser utilizado para armazenar qualquer variável
- Scilab na estrutura de dados da figura e recuperá-la.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsection>
-
- <refsection>
- <title>Ver Também</title>
-
- <simplelist type="inline">
- <member><link linkend="glue">glue</link></member>
-
- <member><link linkend="unglue">unglue</link></member>
-
- <member><link
- linkend="graphics_entities">graphics_entities</link></member>
- </simplelist>
- </refsection>
-
- <refsection>
- <title>Autor</title>
-
- <para>Djalel ABDEMOUCHE</para>
- </refsection>
-</refentry>
+++ /dev/null
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!--
- * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
- * Copyright (C) INRIA - Djalel Abdemouche
- *
- * This file must be used under the terms of the CeCILL.
- * This source file is licensed as described in the file COPYING, which
- * you should have received as part of this distribution. The terms
- * are also available at
- * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
- *
- -->
-<refentry version="5.0-subset Scilab" xml:id="fec_properties" xml:lang="en"
- xmlns="http://docbook.org/ns/docbook"
- xmlns:xlink="http://www.w3.org/1999/xlink"
- xmlns:svg="http://www.w3.org/2000/svg"
- xmlns:ns5="http://www.w3.org/1999/xhtml"
- xmlns:mml="http://www.w3.org/1998/Math/MathML"
- xmlns:db="http://docbook.org/ns/docbook">
- <info>
- <pubdate>$LastChangedDate$</pubdate>
- </info>
-
- <refnamediv>
- <refname>fec_properties</refname>
-
- <refpurpose>Descrição das propriedades da entidade Fec</refpurpose>
- </refnamediv>
-
- <refsection>
- <title>Descrição</title>
-
- <para>A entidade Fec é uma folha na hierarquia de entidade gráficas.
- Representa um esboço 2d de elementos finitos (ver <literal>fec</literal>,
- <literal>Sgrayplot</literal>).</para>
-
- <variablelist>
- <varlistentry>
- <term>parent:</term>
-
- <listitem>
- <para>esta propriedade contém o manipulador para a raiz. A raiz da
- entidade Fec deve ser do tipo <literal>"Axes"</literal> ou
- <literal>"Compound"</literal>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>children:</term>
-
- <listitem>
- <para>esta propriedade contém um vetor com os galhos do manipulador
- . Contudo, manipuladores <literal>Fec</literal> correntemente não
- possuem galhos.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>visible:</term>
-
- <listitem>
- <para>este campo contém o valor da propriedade
- <literal>visible</literal> para a entidade . Pode ser <literal>"on"
- </literal> ou <literal>"off"</literal> . Por padrão, o esboço é
- visível, a propriedade é <literal>"on"</literal>. Se
- <literal>"off"</literal> o esboço não é exibido na tela.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>data:</term>
-
- <listitem>
- <para>uma matriz de três colunas <literal>[x,y,f]</literal>, onde
- <literal>x(i)</literal> e <literal>y(i)</literal> são as coordenadas
- do i-ésimo nó. <literal>f(i)</literal> é o valor associado ao nó
- <literal>i</literal>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>triangles:</term>
-
- <listitem>
- <para>uma matriz de cinco colunas
- <literal>[tn,n1,n2,n3,flag]</literal>. <literal>tn(j)</literal> é o
- número do triângulo. <literal>n1(j)</literal>,
- <literal>n2(j)</literal> e <literal>n3(j)</literal> são índices dos
- nós que constituem o triângulo. (<literal>flag(j)</literal> não é
- usado).</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>z_bounds:</term>
-
- <listitem>
- <para>este vetor de tamanho 2, <literal>[zmin,zmax]</literal>,
- fornece os valores z associados às primeira e última cores (do mapa
- de cores corrente). Mais exatamente, se o mapa de cores possui nc
- cores e se notarmos <literal>dz = (zmax-zmin)/nc</literal>, então a
- parte da triângularização onde <literal>zmin + (i-1)dz <= z <
- zmin + i dz</literal> é preenchida com a cor <literal>i</literal>).
- Por padrão o valor da propriedade <literal>z_bounds</literal> é
- <literal>[0,0]</literal>. Neste caso, <literal>zmin</literal> e
- <literal>zmax</literal> são automaticamente ajustados para os
- valores mínimo e máximo do argumento <literal>func</literal>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>outside_color:</term>
-
- <listitem>
- <para>este vetor de tamanho 2, <literal>[cmin, cmax]</literal>,
- define a cor utilizada quando os valores dos nós estão fora do
- intervalo <literal>z_bounds = [zmin,zmax]</literal>. Quando os
- valores dos nós são menores do que <literal>zmin</literal>, a cor
- com índice <literal>cmin</literal> é utilizada. Quando os valores
- dos nós são menores do que <literal>zmax</literal> a cor com índice
- <literal>cmax</literal> é utilizada. Por padrão, o valor da
- propriedade <literal>outside_color</literal> é
- <literal>[0,0]</literal>. Neste caso, <literal>cmin</literal> e
- <literal>cmax</literal> são automaticamente ajustados para os
- limites do mapa de cores. Se <literal>cmin</literal> ou
- <literal>cmax</literal> são negativos, então os valores fora do
- intervalo z_bounds não são exibidos, eles aparecem
- transparentes.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>color_range:</term>
-
- <listitem>
- <para>este vetor de tamanho 2, <literal>[rmin, rmax]</literal>,
- permite utilizar apenas uma parte do mapa de cores para a exibição.
- <literal>rmin</literal> e <literal>rmax</literal> são os índices do
- mapa de cores. Se ambos forem maiores do que 1, então o mapa de
- cores utilizados para exibir a entidade fec é
- <literal>colormap(rmin:rmax)</literal> onde
- <literal>colormap</literal> é o mapa de cores da figura raiz. Por
- padrão, O valor da propriedade <literal>color_range</literal> é
- <literal>[0,0]</literal>. Neste caso, todo o mapa de cores é
- utilizado.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>line_mode:</term>
-
- <listitem>
- <para>Se <literal>"on"</literal>, o wireframe (esqueleto) encerrando
- os triângulos é desenhado. Se <literal>"off"</literal>, apenas os
- triângulos de dentro são desenhados.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>foreground:</term>
-
- <listitem>
- <para>este índice de cor especifica a cor da malha. Se a propriedade
- <literal>line_mode</literal> for <literal>"on"</literal>, o
- wireframe é desenhado utilizando-se esta cor.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>clip_state:</term>
-
- <listitem>
- <para>este campo contém o valor da propriedade
- <literal>clip_state</literal> para o fec. o valor de clip_state pode
- ser :</para>
-
- <itemizedlist>
- <listitem>
- <para><literal>"off"</literal> significa que o fec não é
- recortado. </para>
- </listitem>
-
- <listitem>
- <para><literal>"clipgrf"</literal> significa que o fec é
- recortado fora da caixa dos eixos. </para>
- </listitem>
-
- <listitem>
- <para><literal>"on"</literal> significa que o fec é recortado
- fora do retângulo dado pela propriedade clip_box.</para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>clip_box:</term>
-
- <listitem>
- <para>este campo determina a propriedade
- <literal>clip_box</literal>. Por padrão seu valor é uma matriz vazia
- se a propriedade clip_state é "off". Em outros casos, o vetor
- <literal>[x,y,w,h]</literal> (ponto superior esquerdo, largura,
- altura) define as porções do retângulo a ser exibido, contudo o
- valor da propriedade <literal>clip_state</literal> será alterado.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>user_data:</term>
-
- <listitem>
- <para>este campo pode ser utilizado para armazenar qualquer variável
- Scilab na estrutura de dados da entidade Fec e recuperá-la.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsection>
-
- <refsection>
- <title>Exemplos</title>
-
- <programlisting role="example"><![CDATA[
-x=-10:10; y=-10:10;m =rand(21,21);
-Sgrayplot(x,y,m);
-a=get("current_axes");
-f=a.children.children(1)
-f.data(:,3)=(1:size(f.data,1))';
-a.parent.color_map=hotcolormap(64);
- ]]></programlisting>
- </refsection>
-
- <refsection>
- <title>Ver Também</title>
-
- <simplelist type="inline">
- <member><link linkend="set">set</link></member>
-
- <member><link linkend="get">get</link></member>
-
- <member><link linkend="delete">delete</link></member>
-
- <member><link linkend="fec">fec</link></member>
-
- <member><link linkend="Sgrayplot">Sgrayplot</link></member>
-
- <member><link
- linkend="graphics_entities">graphics_entities</link></member>
- </simplelist>
- </refsection>
-
- <refsection>
- <title>Autor</title>
-
- <para>Djalel ABDEMOUCHE</para>
- </refsection>
-</refentry>
+++ /dev/null
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!--
- * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
- * Copyright (C) INRIA - Djalel Abdemouche
- *
- * This file must be used under the terms of the CeCILL.
- * This source file is licensed as described in the file COPYING, which
- * you should have received as part of this distribution. The terms
- * are also available at
- * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
- *
- -->
-<refentry version="5.0-subset Scilab" xml:id="figure_properties" xml:lang="en"
- xmlns="http://docbook.org/ns/docbook"
- xmlns:xlink="http://www.w3.org/1999/xlink"
- xmlns:svg="http://www.w3.org/2000/svg"
- xmlns:ns4="http://www.w3.org/1999/xhtml"
- xmlns:mml="http://www.w3.org/1998/Math/MathML"
- xmlns:db="http://docbook.org/ns/docbook">
- <info>
- <pubdate>$LastChangedDate$</pubdate>
- </info>
-
- <refnamediv>
- <refname>figure_properties</refname>
-
- <refpurpose>Descrição das propriedades da entidade gráfica Figure
- (figura)</refpurpose>
- </refnamediv>
-
- <refsection>
- <title>Descrição</title>
-
- <para>A figura é o topo da hierarquia de entidades gráficas. Esta entidade
- contém um número de propriedades designadas a controlar muitos aspectos da
- exibição de objetos gráficos do Scilab. Estas propriedades estão dividas
- em duas categorias. Propriedades que contém informação sobre a própria
- figura e outras relacionadas a valores padrões para criação de
- galhos.</para>
-
- <variablelist>
- <varlistentry>
- <term>Figure properties:</term>
-
- <listitem>
- <variablelist>
- <varlistentry>
- <term>children:</term>
-
- <listitem>
- <para> estes manipuladores representam o vetor dos galhos da
- figura. Note que todos os galhos de figuras são do tipo
- <literal>"Axes"</literal>. Também tenha em mente que, ao se
- criar uma entidade figura (utilizando o comando <link
- linkend="scf">scf</link>), uma entidade
- <literal>Axes</literal> (de eixos) é simultaneamente criada.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>figure_style:</term>
-
- <listitem>
- <para>o valor deste campo determina o estilo da figura. Desde
- o Scilab 5.0, o modo gráfico antigo foi desabilitado. Esta
- propriedade é mantida por compatibilidade, mas não pode ser
- alterada.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>figure_position:</term>
-
- <listitem>
- <para> este campo contém a posição em pixel da janela de
- gráficos na tela. É um vetor <literal>[x,y]</literal>
- definindo a posição do canto superior esquerdo da janela. A
- posição <literal>[0,0]</literal> é o canto superior esquerdo
- da tela.</para>
-
- <para>A posição inicial de uma janela de gráficos é tomada a
- partir da entidade figura padrão (ver <link
- linkend="gdf">gdf</link>). A única excessão é quando o valor
- <literal>figure_position</literal> da figura padrão é
- <literal>[-1,-1]</literal>. Neste caso, A posição inicial da
- janela de gráficos é ajustada automaticamente pelo sistema de
- janelamento.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>figure_size:</term>
-
- <listitem>
- <para>esta propriedade controla o tamanho em pixel da janela
- de gráficos da tela. O tamanho é o vetor
- <literal>[width,height]</literal>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>axes_size:</term>
-
- <listitem>
- <para>usado para especificar o tamanho da janela de gráficos
- virtual. O tamanho é o vetor <literal>[width,height]
- </literal>. A janela de gráficos virtual deveria ser maior que
- a parte realmente visível na tela. Esta propriedade não
- poderia ser alterada se a figura está aportada com outros
- elementos.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>auto_resize:</term>
-
- <listitem>
- <para>esta propriedade determina se a janela de gráficos é
- redimensionada. Se o valor é <literal>"on"</literal> então a
- propriedade <literal>axes_size</literal> é igualada a
- <literal>figure_size</literal> e os galhos eixos são ampliados
- de modo correspondente. Se o valor é <literal>"off"</literal>,
- <literal>axes_size</literal> não pode ser redimensionado
- quando <literal>figure_size</literal> é modificado. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>viewport:</term>
-
- <listitem>
- <para>posição da parte visível do gráfico na janela</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>figure_name:</term>
-
- <listitem>
- <para>este campo contém o nome da figura. O nome é um string
- exibido no topo da janela de gráficos. Pode conter um único
- substring <literal>%d</literal> que será substituido por
- <literal>figure_id</literal>. Em nenhum outro caso o caractere
- % é permitido dentro do nome.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>figure_id:</term>
-
- <listitem>
- <para>este campo contém o identificador da figura. É um número
- inteiro que é ajustado na criação da figura e não pode ser
- mudado depois. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>info_message:</term>
-
- <listitem>
- <para>este string ajusta o texto que será exibido na barra de
- informações da janela.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>color_map:</term>
-
- <listitem>
- <para>propriedade que define o mapa de cores utilizado pela
- figura. O mapa de cores é uma matriz <literal>m</literal> por
- <literal>3</literal>. <literal>m</literal> é o número de
- cores. O número da cor i é dado pela tripla 3-uple
- <literal>R</literal>, <literal>G</literal>,
- <literal>B</literal> correspondentes respectivamente às
- intensidades de vermelho, verde e azul entre 0 e 1.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>pixmap:</term>
-
- <listitem>
- <para>esta propriedade controla o status de pixmap de uma
- janela de gráficos. Se o valor é <literal>"off"</literal> os
- gráficos são diretamente exibidos na tela. Se é
- <literal>"on"</literal> os gráficos são feitos em um pixmap e
- são enviados à janela através do comando
- <literal>show_pixmap()</literal>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>pixel_drawing_mode:</term>
-
- <listitem>
- <para>este campo define a operação bit a bit usada para
- desenhar o pixel na tela. O modo padrão é
- <literal>copy</literal> que significa dizer que o pixel é
- desenhado como requerido. De modo mais geral, a operação bit a
- bit é realizada entre a cor do pixel fonte e a cor do pixel já
- presente na tela. As operações são:
- <literal>"clear"</literal>, <literal>"and"</literal>,
- <literal>"andReverse"</literal> , <literal>"copy"</literal>,
- <literal>"andInverted"</literal> , <literal>"noop"</literal> ,
- <literal>"xor"</literal> , <literal>"or"</literal> ,
- <literal>"nor"</literal> , <literal>"equiv"</literal> ,
- <literal>"invert"</literal> , <literal>"orReverse"</literal> ,
- <literal>"copyInverted"</literal> ,
- <literal>"orInverted"</literal> , <literal>"nand"</literal> ,
- <literal>"set"</literal> ,</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>immediate_drawing:</term>
-
- <listitem>
- <para>esta propriedade controla a exibição da figura. Pode ser
- <literal>"on"</literal> (modo padrão) ou
- <literal>"off"</literal>. É utilizada par atrasar uma grande
- sucessão de comandos gráficos (implicando vários esboços ou
- re-esboços). Note que, ao se utilizar os comandos
- <literal>drawlater</literal> ou <literal>drawnow</literal> É
- utilizada par atrasar uma grande sucessão de comandos gráficos
- (implicando vários esboços ou re-esboços). Note que, ao se
- utilizar os comandos <literal>'off'</literal> ou
- <literal>'on'</literal>).</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>background:</term>
-
- <listitem>
- <para>esta propriedade controla a cor de plano de fundo da
- figura. O valor é um índice de cor correspondente ao mapa de
- cores corrente. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>event_handler</term>
-
- <listitem>
- <para>um string. O nome da função do Scilab que deverá
- manipular os eventos. Note que definir um string vazio
- desabilitará o manipulador de eventos. Para mais informações
- sobre o manipulador de eventos, veja a ajuda <link
- linkend="eventhandlerfunctions">event handler
- functions</link>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>event_handler_enable</term>
-
- <listitem>
- <para>habilita ou desabilita o manipulador de eventos. Seu
- valor deve ser "on" ou "off".</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>user_data:</term>
-
- <listitem>
- <para>este campo pode ser utilizado para se armazenar qualquer
- variável Scilab na estrutura de dados da entidade figura e
- recuperá-la.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>tag:</term>
-
- <listitem>
- <para>este campo pode ser utilizado para armazenar um string
- geralmente utilizado para identificar o controle. Ele permite
- fornecer um "nome". Principalmente utilizado em conjunção a
- findobj().</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- </variablelist>
-
- <variablelist>
- <varlistentry>
- <term>Valores padrões para galhos: </term>
-
- <listitem>
- <variablelist>
- <varlistentry>
- <term>visible:</term>
-
- <listitem>
- <para>este campo determina se o conteúdo da figura deve ser
- redesenhado. O valor pode ser <literal>"on"</literal> ou
- <literal>"off"</literal>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>rotation_style:</term>
-
- <listitem>
- <para>este campo está relacionado ao botão "3D Rot". Toma
- <literal>unary</literal> como valor (padrão) para rotacionar
- apenas o esboço 3d selecionado. Em outros casos o valor pode
- ser <literal>multiple</literal>: todos os esboços 3d são
- rotacionados.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>Nota sobre valores padrões:</term>
-
- <listitem>
- <para>todas estas propriedades e campos listados herdam
- valores de valores padrões armazenados num modelo de figura.
- Estes valores padrões podem ser vistos e salvos. Para fazê-lo,
- use o comando <literal>get("default_figure")</literal>: ele
- retorna o manipulador gráfico de uma figura. Note que nenhuma
- janela de gráficos é criada por este comando. As próximas
- figuras criadas herdarão valores deste modelo (ver o exemplo 2
- abaixo).</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsection>
-
- <refsection>
- <title>Exemplos</title>
-
- <programlisting role="example"><![CDATA[
-lines(0) // desabilitando paginamento vertical
-//Exemplo 1
-f=get("current_figure") //obtendo o manipulador da figura corrente:
- //se nenhum existir, cria uma figura e retorna o manipulador correspondente
-f.figure_position
-f.figure_size=[200,200]
-f.background=2
-f.children // pode-se ver que uma entidade Axes já existe
-delete(f);
-f=gcf(); // atalho de macro <=> f=get("current_figure")
-f.pixmap = "on" // ajusta o status de pixmap para on
-plot2d() // nada acontece na tela...
-show_pixmap() // ...exibe o pixmap na tela
-//Exemplo 2 : configurações de default_figure
-df=get("default_figure") // obtendo os valores padrões (o atalho é gdf() )
-// vamos mudar os padrões...
-df.color_map=hotcolormap(128)
-df.background= 110 // ajustando o plano de fundo para um tipo de amarelo (note que estamos utilizando um índice de cor dentro do mapa de cores color_map redefinido previamente)
-scf(122); // criando uma nova figura de número122 com o novo padrão
-plot2d()
-scf(214);
-t=-%pi:0.3:%pi;
-plot3d(t,t,sin(t)'*cos(t),35,45,'X@Y@Z',[15,2,4]);
- ]]></programlisting>
- </refsection>
-
- <refsection>
- <title>Ver Também</title>
-
- <simplelist type="inline">
- <member><link linkend="lines">lines</link></member>
-
- <member><link linkend="set">set</link></member>
-
- <member><link linkend="get">get</link></member>
-
- <member><link linkend="scf">scf</link></member>
-
- <member><link linkend="gcf">gcf</link></member>
-
- <member><link linkend="gdf">gdf</link></member>
-
- <member><link linkend="gca">gca</link></member>
-
- <member><link linkend="gda">gda</link></member>
-
- <member><link linkend="axes_properties">axes_properties</link></member>
-
- <member><link linkend="show_pixmap">show_pixmap</link></member>
-
- <member><link linkend="clear_pixmap">clear_pixmap</link></member>
-
- <member><link linkend="hotcolormap">hotcolormap</link></member>
-
- <member><link linkend="eventhandlerfunctions">event handler
- functions</link></member>
- </simplelist>
- </refsection>
-
- <refsection>
- <title>Autor</title>
-
- <para>Djalel ABDEMOUCHE</para>
- </refsection>
-</refentry>
+++ /dev/null
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!--
- * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
- * Copyright (C) INRIA - Djalel Abdemouche
- *
- * This file must be used under the terms of the CeCILL.
- * This source file is licensed as described in the file COPYING, which
- * you should have received as part of this distribution. The terms
- * are also available at
- * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
- *
- -->
-<refentry version="5.0-subset Scilab" xml:id="polyline_properties"
- xml:lang="en" 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">
- <info>
- <pubdate>$LastChangedDate$</pubdate>
- </info>
-
- <refnamediv>
- <refname>polyline_properties</refname>
-
- <refpurpose>Descrição das propriedades da entidade Polyline
- (poligonal)</refpurpose>
- </refnamediv>
-
- <refsection>
- <title>Descrição</title>
-
- <para>A entidade Polyline uma folha na hierarquia de entidades gráficas.
- Esta entidade define parâmetros para poligonais.</para>
-
- <variablelist>
- <varlistentry>
- <term>parent:</term>
-
- <listitem>
- <para>esta propriedade contém o manipulador para a raiz. A raiz de
- uma entidade Polyline deve ser do tipo <literal>"Axes"</literal> ou
- <literal>"Compound"</literal>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>children:</term>
-
- <listitem>
- <para>esta propriedade contém um vetor com os galhos do manipulador.
- Contudo, manipuladores poligonais não possuem galhos correntemente.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>visible:</term>
-
- <listitem>
- <para>este campo contém o valor da propriedade
- <literal>visible</literal> para a entidade. Pode ser <literal>"on"
- </literal> ou <literal>"off"</literal> . Por padrão, a poligonal é
- visível, o valor da propriedade é <literal>"on" </literal>. Se
- <literal>"off"</literal> a poligonal não é impressa na tela.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>data:</term>
-
- <listitem>
- <para>esta propriedade contém o valor os valores para as coordenadas
- x e y. O componente z deve ser adicionado no caso de eixos 3d. é uma
- matriz de duas (três) colunas <literal>[x,y,[z]]</literal>
- determinando os pontos. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>closed:</term>
-
- <listitem>
- <para>este valor determina se a poligonal é fechada ou não: o valor
- pode ser <literal>"on"</literal> ou <literal>"off"</literal> (o
- valor padrão depende da primitiva utilizada para criar a poligonal).
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>line_mode:</term>
-
- <listitem>
- <para>este campo contém o valor padrão da propriedade
- <literal>line_mode</literal> para a poligonal. O valor pode ser
- <literal>"on" </literal>(linha desenhada) ou
- <literal>"off"</literal> (nenhuma linha desenhada). </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>fill_mode:</term>
-
- <listitem>
- <para>se o campo <literal>polyline_style</literal> é diferente de 5,
- preenche o plano de fundo da curva com a cor definida pela
- propriedade <literal>background</literal>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>line_style:</term>
-
- <listitem>
- <para>o valor da propriedade <literal>line_style</literal> deve ser
- um inteiro em [1 6]. 1 significa linha sólida e os demais valores
- tipos diferentes de tracejados. (ver <link
- linkend="getlinestyle">getlinestyle</link>).</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>thickness:</term>
-
- <listitem>
- <para>este campo contém a propriedade de linha
- <literal>thickness</literal> (espessura). Deve ser um inteiro
- positivo.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>arrow_size_factor:</term>
-
- <listitem>
- <para>este inteiro permite ajustar o tamanho das flechas desenhadas
- na poligonal. O tamanho real das flechas é o produto entre a
- propriedade <literal>thickness</literal> e o fator de tamanho (size
- factor). </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>polyline_style:</term>
-
- <listitem>
- <para>esta propriedade ajusta vários modos de desenho de
- poligonais:</para>
-
- <itemizedlist>
- <listitem>
- <para>Se o valor é 0 ou 1 linhas são desenhadas utilizando-se
- dois pontos consecutivos. </para>
- </listitem>
-
- <listitem>
- <para>Se o valor é 2 a poligonal produz um esboço escada. Dois
- pontos consecutivos são ligados por uma linha horizontal seguida
- de uma vertical. </para>
- </listitem>
-
- <listitem>
- <para>Se o valor é 3 a poligonal produz um esboço de barras.
- Para cada ponto (x,y) dado, uma linha vertical é desenhada de
- (x,y) a (x,0). </para>
- </listitem>
-
- <listitem>
- <para>Se o valor é 4 flechas são desenhadas entre dois pontos
- consecutivos. </para>
- </listitem>
-
- <listitem>
- <para>Se o valor é 5 a poligonal é preenchida (remendos).
- </para>
- </listitem>
-
- <listitem>
- <para>Se o valor é 6 a poligonal é um objeto barra como no
- Matlab. As propriedades <literal>bar_shift</literal> e
- <literal>bar_width</literal> comandam sua aparência.</para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>foreground:</term>
-
- <listitem>
- <para>este campo contém o valor padrão da propriedade
- <literal>foreground</literal> (primeiro plano) utilizada para
- desenhar a poligonal. O valor deve ser um índice de cor (realtivo ao
- mapa de cores corrente). </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>background:</term>
-
- <listitem>
- <para>este campo contém a cor usada para preencher o plano de fundo
- da poligonal. Deve ser um índice de cor (relativo ao mapa de cores
- corrente). </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>interp_color_vector:</term>
-
- <listitem>
- <para>este campo contém os índices das cores utilizadas para
- preencher a poligonal quando a propriedade
- <literal>interp_color_mode</literal> é ajustada para
- <literal>"on"</literal>. Define os intervalos dos índices do mapa de
- cores a serem utilizados para preencher cada segmento. Por exemplo,
- o primeiro segmento será preenchido por todas as cores cujo índice
- está entre os dois primeiros elementos do vetor. Só é aplicável se a
- poligonal é definida por 3 ou 4 pontos. Logo, o tamanho do vetor
- deve coincidir com esta dimensão. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>interp_color_mode:</term>
-
- <listitem>
- <para> este modo determina se é utilizada gradação interpolada par
- preencher a poligonal: o valor pode ser <literal>"on"</literal> ou
- <literal>"off"</literal>. Note que
- <literal>interp_color_vector</literal> deve ser definido antes e
- ajustar esta propriedade para "on" (ver acima). </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_mode:</term>
-
- <listitem>
- <para>este campo contém o valor padrão da propriedade
- <literal>mark_mode</literal>. Deve ser <literal>"on"</literal>
- (marcas desenhadas) ou <literal>"off"</literal> (nenhuma marca
- desenhada). </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_style:</term>
-
- <listitem>
- <para>A propriedade <literal>mark_style</literal> é utilizada para
- selecionar o tipo de marca utilizada quando a propriedade
- <literal>mark_mode</literal> é <literal>"on"</literal>. 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. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_size_unit:</term>
-
- <listitem>
- <para>este campo contém o valor padrão da propriedade
- <literal>mark_size_unit</literal> property value. Se
- <literal>mark_size_unit</literal> for ajustado para
- <literal>"point"</literal>, então o valor de
- <literal>mark_size</literal> é diretamente dado em pontos. Quando
- <literal>mark_size_unit</literal> é ajustado para
- <literal>"tabulated"</literal>, <literal>mark_size</literal> é
- 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 <link linkend="plot2d">plot2d</link> e funções
- puras do Scilab utilizam o modo <literal>tabulated</literal> como
- padrão; quando se utiliza a função <link linkend="plot">plot</link>,
- o modo <literal>point</literal> é automaticamente habilitado.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_size:</term>
-
- <listitem>
- <para>a propriedade <literal>mark_size</literal> é utilizada para
- selecionar o tipo de tamanho das marcas quando a propriedade
- <literal>mark_mode</literal> é <literal>"on"</literal>. O valor deve
- ser um inteiro entre 0 e 5 signficando 8pt, 10pt, 12pt, 14pt, 18pt e
- 24pt. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_foreground:</term>
-
- <listitem>
- <para>este campo contém o valor da propriedade
- <literal>mark_foreground</literal> que é a cor da borda das marcas.
- O valor deve ser um índice de cor (relativo ao mapa de cores
- corrente). </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_background:</term>
-
- <listitem>
- <para>este campo contém o valor da propriedade
- <literal>mark_background</literal> que é a cor da face das marcas. O
- valor deve ser um índice de cor (relativo ao mapa de cores
- corrente). </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>x_shift:</term>
-
- <listitem>
- <para>este campo contém a compensação computada por uma chamada à
- função <link linkend="bar">bar</link> (ou recomputada por uma
- chamada à função <link linkend="barhomogenize">barhomogenize</link>)
- e é usada para realizar uma boa representação de barras verticais.
- Note que esta compensação é levada em conta para todos os outros
- <literal>polyline_style</literal>. A unidade é expressa nas
- coordenadas do usuário. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>y_shift:</term>
-
- <listitem>
- <para>este campo contém a compensação computada por uma chamada à
- função <link linkend="bar">bar</link> (ou recomputada por uma
- chamada à função <link linkend="barhomogenize">barhomogenize</link>)
- e é usada para realizar uma boa representação de barras verticais.
- Note que esta compensação é levada em conta para todos os outros
- <literal>polyline_style</literal>. TA unidade é expressa nas
- coordenadas do usuário.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>z_shift:</term>
-
- <listitem>
- <para>este campo contém a compensação que o usuário pode
- especificar. Note que esta compensação é levada em conta para todos
- os <literal>polyline_style</literal>. A unidade é expressa nas
- coordenadas do usuário. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>bar_width:</term>
-
- <listitem>
- <para>este campo determina a largura da poligonal selecionada quando
- sua propriedade <literal>polyline_style</literal> é ajustada para
- modo de barra (caso 6) : a unidade é expressa nas coordenadas do
- usuário. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>clip_state:</term>
-
- <listitem>
- <para>este campo contém o valor da propriedade
- <literal>clip_state</literal> para a poligonal. O valor de
- clip_state pode ser :</para>
-
- <itemizedlist>
- <listitem>
- <para><literal>"off"</literal> significa que a poligonal não é
- recortada. </para>
- </listitem>
-
- <listitem>
- <para><literal>"clipgrf"</literal> significa que a poligonal é
- recortada fora da caixa dos eixos.</para>
- </listitem>
-
- <listitem>
- <para><literal>"on"</literal> significa que a poligonal é
- recortada fora do retângulo dado pela propriedade
- clip_box.</para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>clip_box:</term>
-
- <listitem>
- <para>este campo determina a propriedade
- <literal>clip_box</literal>. Por padrão seu valor é uma matriz vazia
- se a propriedade clip_state é "off". Em outros casos, o vetor
- <literal>[x,y,w,h]</literal> (ponto superior esquerdo, largura,
- altura) define as porções da poligonal a serem exibidas, contudo o
- valor da propriedade <literal>clip_state</literal> será alterado.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>user_data:</term>
-
- <listitem>
- <para>este campo pode ser utilizado para armazenar qualquer variável
- Scilab na estrutura de dados da entidade poligonal e
- recuperá-la.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsection>
-
- <refsection>
- <title>Exemplos</title>
-
- <programlisting role="example"><![CDATA[
-a=get("current_axes")//obtendo o manipulador dos novos eixos criados
-a.data_bounds=[-2,-2;2,2];
-
-xpoly(sin(2*%pi*(0:5)/5),cos(2*%pi*(0:5)/5),"lines",0)
-p=get("hdl"); //obtendo o manipulador da entidade corrente (aqui é a entidade poligonal)
-p.foreground=2;
-p.thickness=3;
-p.mark_style=9;
-d=p.data;d(1,:)=[0 0];p.data=d;
-a.rotation_angles=[0 45];
-
-p.data=[(-2:0.1:2)' sin((-2:0.1:2)*%pi)']
-p.mark_mode="off";
-p.polyline_style=3;
-p.line_style=4;
- ]]></programlisting>
- </refsection>
-
- <refsection>
- <title>Ver Também</title>
-
- <simplelist type="inline">
- <member><link linkend="set">set</link></member>
-
- <member><link linkend="get">get</link></member>
-
- <member><link linkend="delete">delete</link></member>
-
- <member><link linkend="xpoly">xpoly</link></member>
-
- <member><link linkend="xfpoly">xfpoly</link></member>
-
- <member><link linkend="xpolys">xpolys</link></member>
-
- <member><link linkend="xfpolys">xfpolys</link></member>
-
- <member><link
- linkend="graphics_entities">graphics_entities</link></member>
- </simplelist>
- </refsection>
-
- <refsection>
- <title>Autor</title>
-
- <para>Djalel ABDEMOUCHE</para>
- </refsection>
-</refentry>
+++ /dev/null
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!--
- * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
- * Copyright (C) INRIA - Djalel Abdemouche
- *
- * This file must be used under the terms of the CeCILL.
- * This source file is licensed as described in the file COPYING, which
- * you should have received as part of this distribution. The terms
- * are also available at
- * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
- *
- -->
-<refentry version="5.0-subset Scilab" xml:id="segs_properties" xml:lang="en"
- 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">
- <info>
- <pubdate>$LastChangedDate: 2006-08-03 16:16:36 +0200 (jeu, 03 aoû
- 2006)$</pubdate>
- </info>
-
- <refnamediv>
- <refname>segs_properties</refname>
-
- <refpurpose>Descrição das propriedades da entidade Segments (de
- segmentos)</refpurpose>
- </refnamediv>
-
- <refsection>
- <title>Descrição</title>
-
- <para>A entidade Segments é uma folha na hierarquia de entidades gráficas.
- Esta entidade define parâmetros para um conjunto de segmentos ou setas
- coloridas.</para>
-
- <variablelist>
- <varlistentry>
- <term>parent:</term>
-
- <listitem>
- <para>esta propriedade contém o manipulador da raiz. A raiz de uma
- entidade de Segments deve ser do tipo <literal>"Axes"</literal> ou
- <literal>"Compound"</literal>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>children:</term>
-
- <listitem>
- <para>esta propriedade contém um vetor com os galhos do manipulador.
- Contudo, manipuladores Segs não possuem galhos correntemente.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>visible:</term>
-
- <listitem>
- <para>este campo contém o valor da propriedade
- <literal>visible</literal> para a entidade. Pode ser <literal>"on"
- </literal> ou <literal>"off"</literal> . Por padrão, o os segmentos
- são visíveis, a propriedade é <literal>"on"</literal>. Se
- <literal>"off"</literal> os segmentos não são exibidos na tela.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>data:</term>
-
- <listitem>
- <para>este campo é uma matriz de duas (três)
- <literal>[x,y,[z]]</literal> que fornece as coordenadas das
- extremidades dos segmentos. Se <literal>xv=matrix(x,2,-1)</literal>
- e <literal>yv=matrix(y,2,-1)</literal> então
- <literal>xv(:,k)</literal> e <literal>yv(:,k)</literal> são as
- extremidades dos segmentos de número <literal>k</literal>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>line_mode:</term>
-
- <listitem>
- <para>este campo contém o valor padrão da propriedade
- <literal>line_mode</literal> para os segmentos. O valor pode ser
- <literal>"on" </literal>(linha desenhada) ou
- <literal>"off"</literal> (nenhuma linha desenhada). </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>line_style:</term>
-
- <listitem>
- <para>O valor da propriedade <literal>line_style</literal> deve ser
- um inteiro em [0 6]. 0 significa linha sólida, o restante seleciona
- tracejados. Esta propriedade se aplica a todos os segmentos. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>thickness:</term>
-
- <listitem>
- <para>este campo contém o valor da propriedade
- <literal>thickness</literal> (espessura) para todos os segmentos.
- Seu valor deve ser um inteiro não-negativo. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>arrow_size:</term>
-
- <listitem>
- <para>fator que especifica o tamanho das cabeças das setas. Com um
- valor negativo, o tamanho também depende do comprimento da seta.
- Para desenhar um segmento, o valor deve ser ajustado para 0.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>segs_color:</term>
-
- <listitem>
- <para>este campo especifica a cor a ser utilizada para desenhar cada
- segmento. Cada elemento é um índice de cor relativo ao mapa de cores
- corrente. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_mode:</term>
-
- <listitem>
- <para>este campo contém o valor padrão da propriedade
- <literal>mark_mode</literal> para a poligonal. Deve ser
- <literal>"on"</literal> (marcas desenhadas) ou
- <literal>"off"</literal> (nenhuma marca desenhada) </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_style:</term>
-
- <listitem>
- <para> a propriedade <literal>mark_style</literal> é utilizada para
- selecionar o tipo de marca utilizada quando a propriedade
- <literal>mark_mode</literal> é <literal>"on"</literal>. 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. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_size_unit:</term>
-
- <listitem>
- <para>este campo contém o valor padrão da propriedade
- <literal>mark_size_unit</literal>. Se
- <literal>mark_size_unit</literal> for ajustado para
- <literal>"point"</literal>, então o valor de
- <literal>mark_size</literal> é diretamente dado em pontos. Quando
- <literal>mark_size_unit</literal> é ajustado para
- <literal>"tabulated"</literal>, <literal>mark_size</literal> é
- 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 <link linkend="plot2d">plot2d</link> e funções
- puras do Scilab utilizam o modo <literal>tabulated</literal> como
- padrão; quando se utiliza a função <link linkend="plot">plot</link>,
- o modo <literal>point</literal> é automaticamente habilitado.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_size:</term>
-
- <listitem>
- <para>a propriedade <literal>mark_size</literal> é utilizada para
- selecionar o tipo de tamanho das marcas quando a propriedade
- <literal>mark_mode</literal> é <literal>"on"</literal>. O valor deve
- ser um inteiro entre 0 e 5 signficando 8pt, 10pt, 12pt, 14pt, 18pt e
- 24pt. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_foreground:</term>
-
- <listitem>
- <para>este campo contém o valor da propriedade
- <literal>mark_foreground</literal> que é a cor da borda das marcas.
- O valor deve ser um índice de cor (relativo ao mapa de cores
- corrente). </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_background:</term>
-
- <listitem>
- <para>este campo contém o valor da propriedade
- <literal>mark_background</literal> que é a cor da face das marcas. O
- valor deve ser um índice de cor (relativo ao mapa de cores
- corrente). </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>clip_state:</term>
-
- <listitem>
- <para>este campo contém o valor da propriedade
- <literal>clip_state</literal> para os segmentos. O valor de
- clip_state pode ser:</para>
-
- <itemizedlist>
- <listitem>
- <para><literal>"off"</literal> significa que os segmentos não
- são recortados. </para>
- </listitem>
-
- <listitem>
- <para><literal>"clipgrf"</literal> significa que os segmentos
- são recortados fora da caixa dos eixos.</para>
- </listitem>
-
- <listitem>
- <para><literal>"on"</literal> significa que os sementos são
- recortada fora do retângulo dado pela propriedade
- <literal>clip_box</literal>.</para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>clip_box:</term>
-
- <listitem>
- <para>este campo determina a propriedade
- <literal>clip_box</literal>. Por padrão seu valor é uma matriz vazia
- se a propriedade clip_state é "off". Em outros casos, o vetor
- <literal>[x,y,w,h]</literal> (ponto superior esquerdo, largura,
- altura) define as porções dos segmentos a serem exibidas, contudo o
- valor da propriedade <literal>clip_state</literal> será alterado.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>user_data:</term>
-
- <listitem>
- <para>este campo pode ser utilizado para armazenar qualquer variável
- Scilab na estrutura de dados da entidade de segmentos e
- recuperá-la.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsection>
-
- <refsection>
- <title>Exemplos</title>
-
- <programlisting role="example"><![CDATA[
-a=get("current_axes");//obtendo o manipulador dos novos eixos criados
-a.data_bounds=[-10,-10;10,10];
-x=2*%pi*(0:7)/8;
-xv=[2*sin(x);9*sin(x)];
-yv=[2*cos(x);9*cos(x)];
-xsegs(xv,yv,1:8)
-
-s=a.children
-s.arrow_size=1;
-s.segs_color=15:22;
-for j=1:2
- for i=1:8
- h=s.data(i*2,j);
- s.data(i*2,j)=s.data(i*2-1,j);
- s.data(i*2-1,j)= h;
- end
-end
-
-s.segs_color=5; //ajustando todas as cores para 5
-
-s.clip_box=[-4,4,8,8];
-a.thickness=4;
-xrect(s.clip_box);
- ]]></programlisting>
- </refsection>
-
- <refsection>
- <title>Ver Também</title>
-
- <simplelist type="inline">
- <member><link linkend="set">set</link></member>
-
- <member><link linkend="get">get</link></member>
-
- <member><link linkend="delete">delete</link></member>
-
- <member><link linkend="xsegs">xsegs</link></member>
-
- <member><link
- linkend="graphics_entities">graphics_entities</link></member>
- </simplelist>
- </refsection>
-
- <refsection>
- <title>Autor</title>
-
- <para>Djalel ABDMOUCHE</para>
- </refsection>
-</refentry>
+++ /dev/null
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!--
- * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
- * Copyright (C) INRIA - Djalel Abdemouche
- * Copyright (C) INRIA - Fabrice Leray
- *
- * This file must be used under the terms of the CeCILL.
- * This source file is licensed as described in the file COPYING, which
- * you should have received as part of this distribution. The terms
- * are also available at
- * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
- *
- -->
-<refentry version="5.0-subset Scilab" xml:id="surface_properties"
- xml:lang="en" xmlns="http://docbook.org/ns/docbook"
- xmlns:xlink="http://www.w3.org/1999/xlink"
- xmlns:svg="http://www.w3.org/2000/svg"
- xmlns:ns4="http://www.w3.org/1999/xhtml"
- xmlns:mml="http://www.w3.org/1998/Math/MathML"
- xmlns:db="http://docbook.org/ns/docbook">
- <info>
- <pubdate>$LastChangedDate$</pubdate>
- </info>
-
- <refnamediv>
- <refname>surface_properties</refname>
-
- <refpurpose>Descrição das propriedades da entidade Surface
- (superfície)</refpurpose>
- </refnamediv>
-
- <refsection>
- <title>Descrição</title>
-
- <para>A entidade Surface é uma folha das hierarquia de entidades gráficas.
- Duas classes aparecem sob este tipo de entidade :
- <literal>Plot3d</literal> e <literal>Fac3d</literal> de acordo com a
- função de esboço ou com o modo como os dados foram inseridos. As entidades
- <literal>Fac3d</literal> e <literal>Plo3d</literal> são semelhantes, mas
- <literal>Fac3d</literal> é mais completa e aceita mais opções que
- <literal>Plot3d</literal>. Para sempre ter entidades
- <literal>Fac3d</literal> simplesmente use <literal>genfac3d</literal> para
- pré-construir matrizes antes de usar os comandos <literal>plot3d</literal>
- ou use o comando <literal>surf</literal>.</para>
-
- <para>Aqui estão as propriedades contidas em uma entidade
- superfície:</para>
-
- <variablelist>
- <varlistentry>
- <term>parent:</term>
-
- <listitem>
- <para>esta propriedade contém o manipulador da raiz. A raiz de uma
- entidade Surface pode ser <literal>"Axes"</literal> ou
- <literal>"Compound"</literal>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>children:</term>
-
- <listitem>
- <para>esta propriedade contém um vetor com os galhos do manipulador.
- Contudo, manipuladores de superfície não possuem galhos
- correntemente. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>visible:</term>
-
- <listitem>
- <para>este campo contém o valor padrão da propriedade
- <literal>visible</literal> para a entidade. Pode ser <literal>"on"
- </literal> ou <literal>"off"</literal> . Por padrão, superfícies são
- visíveis , o valor da propriedade é <literal>"on"</literal>. Se for
- <literal>"off"</literal> os gráficos 3d não são exibidos na
- tela.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>surface_mode:</term>
-
- <listitem>
- <para> este campo contém o valor padrão da propriedade
- <literal>surface_mode</literal> para a superfície. Pode ser
- <literal>"on" </literal> (superfície desenhada) ou
- <literal>"off"</literal> (nenhuma superfície desenhada). </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>foreground:</term>
-
- <listitem>
- <para>se <literal>color_mode >= 0</literal>, contém o índice da
- cor a ser usada nas bordas. Se não, foreground não é usado. O valor
- foreground deve ser um índice inteiro de cor (relativo ao mapa de
- cores corrente).</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>thickness:</term>
-
- <listitem>
- <para>este campo contém o valor de <literal>thickness</literal>
- (espessura) das linhas usadas para desenhar facetas ou contornos.
- Deve ser um inteiro positivo. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_mode:</term>
-
- <listitem>
- <para>este campo contém o valor padrão da propriedade
- <literal>mark_mode</literal> para a superfície. Seu valor pode ser
- <literal>"on"</literal> (marcas desenhadas) ou
- <literal>"off"</literal> (marcas não desenhadas).</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_style:</term>
-
- <listitem>
- <para>o valor da propriedade <literal>mark_style</literal> é usado
- para selecionar o tipo de marca usada quando a propriedade
- <literal>mark_mode</literal> é <literal>"on"</literal>. O valor deve
- ser um inteiro no intervalo [0 14] que significa: ponto, mais, cruz,
- estrela, rombo preenchido, rombo, triângulo para cima, triângulo
- para baixo, rombo mais, círculo, asterísco, quadrado, trângulo para
- direita, triângulo para esquerda e pentagrama.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_size_unit:</term>
-
- <listitem>
- <para>este campo contém o valor padrão da propriedade
- <literal>mark_size_unit</literal>. Se
- <literal>mark_size_unit</literal> é ajustado para
- <literal>"point"</literal>, então o valor de
- <literal>mark_size</literal> é dado diretamente em pontos. Quando
- <literal>mark_size_unit</literal> é ajustado para
- <literal>"tabulated"</literal>, <literal>mark_size</literal> é
- computado de acordo com o array de tamanho de fonte: logo, seu valor
- deve ser um inteiro no intervalo [0 5] que significa 8pt, 10pt,
- 12pt, 14pt, 18pt e 24pt. Note que <link
- linkend="plot3d">plot3d</link> e funções puras do Scilab usam o modo
- <literal>tabulated</literal> como padrão; quando se utiliza as
- funções <link linkend="surf">surf</link> (ou <link
- linkend="plot">plot</link> para linhas 2d) o modo
- <literal>point</literal> é automaticamente habilitado. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_size:</term>
-
- <listitem>
- <para>a propriedade <literal>mark_size</literal> é utilizada para
- selecionar o tamanho de fonte das marcas quando a propriedade
- <literal>mark_mode</literal> está <literal>"on"</literal>. O valor
- deve ser um inteiro entre 0 e 5 que significa 8pt, 10pt, 12pt, 14pt,
- 18pt e 24pt. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_foreground:</term>
-
- <listitem>
- <para>este campo contém o valor padrão da propriedade
- <literal>mark_foreground</literal> que é a cor da borda das marcas.
- Seu valor deve ser um índice de cor (relativo ao mapa de cores
- corrente). </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>mark_background:</term>
-
- <listitem>
- <para>este campo contém o valor padrão da propriedade
- <literal>mark_background</literal> que é a cor da face das marcas.
- Seu valor deve ser um índice de cor (relativo ao mapa de cores
- corrente). </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>data:</term>
-
- <listitem>
- <para>este campo define uma estrutura de dados
- <literal>tlist</literal> do tipo "3d" composto de índices de uma
- linha e uma coluna de cada elemento como as coordenadas x, y e z
- contidas respectivamente em
- <literal>data.x</literal>,<literal>data.y</literal> e
- <literal>data.z</literal>. O campo complementar
- <literal>data.color</literal> está disponível caso um vetor ou
- matriz reais de cores seja especificado. Se nenhum for,
- <literal>data.color</literal> não é listado. A superfície é pintada
- de acordo com as propriedades <literal>color_mode </literal>e
- <literal>color_flag</literal>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>color_mode:</term>
-
- <listitem>
- <para>um inteiro no intervalo <literal>[-size(colormap) ;
- size(colormap)]</literal> definindo a cor da faceta quando o valor
- de <literal>color_flag</literal> é <literal>0</literal>. Como dito
- antes, se<literal> color_mode > 0</literal>, as bordas são
- desenhadas usando a cor <literal>foreground</literal>. Se
- <literal>color_mode</literal> é ajustado para <literal>0</literal>,
- uma malha das superfície é desenhada: faces da frente não têm cores.
- Finalmente, quando <literal>color_mode < 0</literal>, as faces da
- frente são pintadas com a cor <literal>-color_mode</literal> mas
- nenhuma borda é exibida. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>color_flag:</term>
-
- <listitem>
- <para>este campo é usado para definir o algoritimo usado para
- ajustar as cores das facetas. Note que as regras em
- <literal>color_mode</literal>, <literal>foreground</literal> e
- <literal>hiddencolor</literal> ainda são aplicadas nesse
- caso.</para>
-
- <itemizedlist>
- <listitem>
- <para><literal>color_flag == 0</literal></para>
-
- <itemizedlist>
- <listitem>
- <para>Todas as facetas são pintadas usando-se o índice de
- cores e o método definido por <literal>color_mode</literal>
- (ver acima).</para>
- </listitem>
- </itemizedlist>
- </listitem>
-
- <listitem>
- <para><literal>color_flag == 1</literal></para>
-
- <itemizedlist>
- <listitem>
- <para>Todas as facetas são pintadas utilizando-se um índice
- de cor por faceta proporcional a <literal>z</literal>. O
- valor mínimo de <literal>z</literal> é pintado utilizando-se
- o índice 1, enquanto o valor máximo de <literal>z</literal>
- é pintado utilizando-se o índice mais alto. As bordas das
- facetas pode ser adicionalmente desenhadas dependendo do
- valor de <literal>color_mode</literal> (ver acima).</para>
- </listitem>
- </itemizedlist>
- </listitem>
-
- <listitem>
- <para>Os três casos restantes
- (<literal>color_flag</literal><literal>== 2,3 or 4</literal>) só
- estão disponíveis para a entidade <literal>Fac3d</literal> .
- Então, o valor de <literal>data.color</literal> é usado para
- ajustar cores para as facetas (índices do mapa de cores
- corrente) se existirem. Se não, o <literal>color_mode</literal>
- corrente é utilizado para pintar as facetas.</para>
- </listitem>
-
- <listitem>
- <para><literal>color_flag == 2 ('flat' shading)</literal></para>
-
- <itemizedlist>
- <listitem>
- <para>Todas as facetas são pintadas utilizando-se o índice
- de cor dado na propriedade <literal>data.color</literal>
- (uma cor por faceta é necessária). Dois são os casos
- possíveis:</para>
- </listitem>
-
- <listitem>
- <para><literal>data.color</literal> contém um vetor
- <literal>color</literal> vector : se
- <literal>color(i)</literal> for positivo, fornece a cor da
- faceta <literal>i</literal> e a borda da faceta é desenhada
- com o estilo de linha e cor correntes. Se
- <literal>color(i)</literal> for negativo, o a cor de
- identificador <literal>-color(i)</literal> é usado e a borda
- da faceta não é desenhada.</para>
-
- <para><literal>data.color</literal> contém uma matriz de
- cores de tamanho (nf,n) onde <literal>n</literal> significa
- o número de facetas e <literal>nf</literal> o número de
- pontos definindo a faceta poligonal. Para os vértices
- <literal>nf</literal> definindo cada faceta, o algoritmo
- computa o valor médio do índice de cores (da matriz de
- índices de cores) : os <literal>nf</literal> vértices da
- mesma faceta terão o mesmo valor de índice de cor.</para>
- </listitem>
- </itemizedlist>
- </listitem>
-
- <listitem>
- <para><literal>color_flag == 3 ('interpolated'
- shading)</literal></para>
-
- <itemizedlist>
- <listitem>
- <para>Pinta as facetas por interpolação das cores dos
- vértices. Os índices das cores dos vértices são dados pela
- propriedade <literal>data.color</literal> (uma cor por
- vértice é necessária). Dois são os casos possíveis:</para>
- </listitem>
-
- <listitem>
- <para><literal>data.color</literal> contém um vetor
- <literal>colors</literal> : então há poucos dados para
- completar o modo de gradação interpolada. De fato, uma
- matriz de cores de tamanho (nf,n) (onde <literal>n</literal>
- é o número de facetas e <literal>nf</literal> o número de
- pontos definindo a faceta poligonal) é necessária para
- realizar esta operação. Para cada faceta, o algoritmo copia
- o único valor de índice de cor da faceta nos
- <literal>nf</literal> vértices de índices de cores definindo
- a borda da faceta.</para>
-
- <para><literal>data.color</literal> contém uma matriz de
- cores de tamanho (nf,n) (ver acima para definições de
- <literal>nf</literal> e <literal>n</literal>), o modo de
- gradação interpolada pode ser completado normalmente
- utilizando-se estes índices de cores.</para>
- </listitem>
- </itemizedlist>
- </listitem>
-
- <listitem>
- <para><literal>color_flag == 4 (Matlab-like 'flat'
- shading)</literal></para>
-
- <itemizedlist>
- <listitem>
- <para>É o mesmo que <literal>color_flag==2</literal> com uma
- pequena diferença quando <literal>data.color</literal> é uma
- matriz. Todas as facetas são pintadas com o índice de cor
- fornecido pela propriedade <literal>data.color</literal>
- (uma cor por faceta é necessária). Dois casos são então
- possíveis:</para>
- </listitem>
-
- <listitem>
- <para><literal>data.color</literal> contém um vetor
- <literal>color</literal> vector : se
- <literal>color(i)</literal> é positivo, fornece a cor da
- faceta <literal>i</literal> e a borda da faceta é desenhada
- com o estilo de linha e cor correntes. Se
- <literal>color(i)</literal> é negativo, a cor de
- identificador <literal>-color(i)</literal> é utilizado e a
- borda da faceta não é desenhada.</para>
-
- <para><literal>data.color</literal> contém uma matriz de
- cores de tamanho (nf,n) onde <literal>n</literal> é o número
- de facetas e <literal>nf</literal> o número de pontos
- definindo a faceta poligonal. Para os <literal>nf</literal>
- vértices definindo cada faceta, o algoritimo toma a cor do
- primeiro vértice definindo o retículo (faceta).</para>
- </listitem>
- </itemizedlist>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>cdata_mapping:</term>
-
- <listitem>
- <para><literal>específico para manipuladores Fac3d</literal>. Um
- string definindo um valor <literal>'scaled'</literal> ou
- <literal>'direct'</literal>. Se um <literal>data.color</literal> é
- definido, cada dado de índice de cor especifica um valor único para
- vértice. <literal>cdata_mapping</literal> determina se estes índices
- estão em escala para serem mapeados linearmente no mapa de cores
- corrente (modo<literal> 'scaled'</literal>) ou aponta diretamente
- para o mapa de cores (modo <literal>'direct</literal>'). Esta
- propriedade é útil quando <literal>color_flag</literal> é igual a
- <literal>2</literal>,<literal>3</literal> ou
- <literal>4</literal>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>hiddencolor:</term>
-
- <listitem>
- <para>esta propriedade contém o índice de cor usado para desenhar as
- faces atrás de uma superfície. Seu valor deve ser um inteiro
- positivo (índice de cores relativo ao mapa de cores corrente). Se
- for um inteiro negativo, a mesma cor que a face "visível" é aplicada
- para a parte traseira. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>clip_state:</term>
-
- <listitem>
- <para>este campo contém o valor da propriedade
- <literal>clip_state</literal> para a superfície. O valor de
- clip_state pode ser:</para>
-
- <itemizedlist>
- <listitem>
- <para><literal>"off"</literal> significa que a superfície não é
- recortada. </para>
- </listitem>
-
- <listitem>
- <para><literal>"clipgrf"</literal> significa que a superfície é
- recortada fora da caixa dos eixos. </para>
- </listitem>
-
- <listitem>
- <para><literal>"on"</literal> significa que a superfície é
- recortada fora do retângulo dado pela propriedade
- clip_box.</para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>clip_box:</term>
-
- <listitem>
- <para>este campo determina a propriedade
- <literal>clip_box</literal>. Por padrão seu valor é uma matriz vazia
- se a propriedade clip_state é "off". Em outros casos, o vetor
- <literal>[x,y,w,h]</literal> (ponto superior esquerdo, largura,
- altura) define as porções da poligonal a serem exibidas, contudo o
- valor da propriedade <literal>clip_state</literal> será alterado.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>user_data:</term>
-
- <listitem>
- <para>este campo pode ser usado para armazenar qualquer variável
- Scilab na estrutura de dados da superfície e recuperá-la.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsection>
-
- <refsection>
- <title>Exemplos</title>
-
- <programlisting role="example"><![CDATA[
-//criando uma figura
-t=[0:0.3:2*%pi]'; z=sin(t)*cos(t');
-[xx,yy,zz]=genfac3d(t,t,z);
-plot3d([xx xx],[yy yy],list([zz zz+4],[4*ones(1,400) 5*ones(1,400)]))
-h=get("hdl") //obtendo manipulador da entidade corrente (aqui, é a superfície)
-a=gca(); //obtendo eixos correntes
-a.rotation_angles=[40,70];
-a.grid=[1 1 1];
-//criando grides
-a.data_bounds=[-6,0,-1;6,6,5];
-a.axes_visible="off";
-//os eixos estão escondidos a.axes_bounds=[.2 0 1 1];
-f=get("current_figure");
-//obtendo o manipulador da figura raiz
-f.color_map=hotcolormap(64);
-//mudando o mapa de cores da figura
-h.color_flag=1;
-//colorindo de acordo com z
-h.color_mode=-2;
-//removendo as bordas das facetas
-h.color_flag=2;
-//colorindo de acordo com as dadas cores
-h.data.color=[1+modulo(1:400,64),1+modulo(1:400,64)];
-//gradação
-h.color_flag=3;
-
-scf(2); // criando segunda janela e utilizando o comando surf
-subplot(211)
-surf(z,'cdata_mapping','direct','facecol','interp')
-
-subplot(212)
-surf(t,t,z,'edgeco','b','marker','d','markersiz',9,'markeredg','red','markerfac','k')
-e=gce();
-e.color_flag=1 // índice de cor proporcional à altitude (coordenada z)
-e.color_flag=2; // de volta ao modo padrão
-e.color_flag= 3; // modo de gradação interpolada (baseada na cor azul padrão porque o campo data.color não está preenchido)
- ]]></programlisting>
- </refsection>
-
- <refsection>
- <title>Ver Também</title>
-
- <simplelist type="inline">
- <member><link linkend="set">set</link></member>
-
- <member><link linkend="get">get</link></member>
-
- <member><link linkend="delete">delete</link></member>
-
- <member><link linkend="plot3d">plot3d</link></member>
-
- <member><link linkend="plot3d1">plot3d1</link></member>
-
- <member><link linkend="plot3d2">plot3d2</link></member>
-
- <member><link linkend="surf">surf</link></member>
-
- <member><link
- linkend="graphics_entities">graphics_entities</link></member>
- </simplelist>
- </refsection>
-
- <refsection>
- <title>Autores</title>
-
- <para>Djalel ABDEMOUCHE & F.Leray</para>
- </refsection>
-</refentry>
+++ /dev/null
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!--
- * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
- * Copyright (C) INRIA - Djalel Abdemouche
- * Copyright (C) INRIA - Jean-Baptiste silvy
- *
- * This file must be used under the terms of the CeCILL.
- * This source file is licensed as described in the file COPYING, which
- * you should have received as part of this distribution. The terms
- * are also available at
- * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
- *
- -->
-<refentry version="5.0-subset Scilab" xml:id="text_properties" xml:lang="en"
- xmlns="http://docbook.org/ns/docbook"
- xmlns:xlink="http://www.w3.org/1999/xlink"
- xmlns:svg="http://www.w3.org/2000/svg"
- xmlns:ns4="http://www.w3.org/1999/xhtml"
- xmlns:mml="http://www.w3.org/1998/Math/MathML"
- xmlns:db="http://docbook.org/ns/docbook">
- <info>
- <pubdate>$LastChangedDate$</pubdate>
- </info>
-
- <refnamediv>
- <refname>text_properties</refname>
-
- <refpurpose>Descrição das propriedades da entidade Text
- (texto)</refpurpose>
- </refnamediv>
-
- <refsection>
- <title>Descrição</title>
-
- <para>A entidade Text é uma folha na hierarquia de entidades gráficas.
- Esta entidade define parâmetros para escrita de strings.</para>
-
- <variablelist>
- <varlistentry>
- <term>parent:</term>
-
- <listitem>
- <para>esta propriedade contém o manipulador da raiz. A raiz de uma
- entidade Text deve ser do tipo <literal>"Axes"</literal> ou
- <literal>"Compound"</literal>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>children:</term>
-
- <listitem>
- <para>esta propriedade contém um vetor com os galhos do manipulador.
- Contudo, manipuladores text não possuem galhos correntemente.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>visible:</term>
-
- <listitem>
- <para>este campo contém o valor da propriedade
- <literal>visible</literal> para a entidade. Pode ser <literal>"on"
- </literal> ou <literal>"off"</literal> . Por padrão, o texto é
- visível, a propriedade é <literal>"on"</literal>. Se
- <literal>"off"</literal>, o texto não é exibido na tela. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>text:</term>
-
- <listitem>
- <para>a matriz contendo os strings do objeto. As linhas da matriz
- são exibidas horizontalmente, e as colunas verticalmente.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>alignment:</term>
-
- <listitem>
- <para>especifica como os strings serão alinhados em suas colunas. o
- valor deve ser <emphasis role="bold">'left'</emphasis>,<emphasis
- role="bold"> 'center' </emphasis>ou <emphasis
- role="bold">'right'</emphasis>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>data:</term>
-
- <listitem>
- <para>este campo é o vetor <literal>[x,y,[z]]</literal> da origem do
- texto na unidade de dados dos eixos. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>box:</term>
-
- <listitem>
- <para>o valor deste campo pode ser <literal>"on"</literal> ou
- <literal>"off"</literal>. Se <literal>"on"</literal> uma caixa é
- desenhada ao redor do texto com uma linha em sua borda e um plano de
- fundo. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>line_mode:</term>
-
- <listitem>
- <para>esta propriedade booleana permite desenhar apenas o plano de
- fundo da caixa quando a propriedade <literal>box</literal> é
- <literal>"on"</literal>. Se <literal>line_mode</literal> é
- <literal>"off"</literal> , a linha da caixa não é desenhada. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>fill_mode:</term>
-
- <listitem>
- <para>esta propriedade booleana permite desenhar ou não o plano de
- fundo da caixa quando a propriedade <literal>box</literal> é
- <literal>"on"</literal>. Se <literal>fill_mode</literal> for
- <literal>"off"</literal>, o plano de fundo da caixa não é
- transparente. </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>text_box:</term>
-
- <listitem>
- <para>um vetor bidimensional especificando o tamanho do retângulo em
- coordenadas do usuário. O retângulo é utilizado quando a propriedade
- text_box_mode está ajustada pára <emphasis
- role="bold">'centered'</emphasis> ou <emphasis
- role="bold">'filled'</emphasis>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>text_box_mode:</term>
-
- <listitem>
- <para>Pode ter três valores diferentes : <emphasis
- role="bold">'off'</emphasis>, <emphasis
- role="bold">'centered'</emphasis> ou <emphasis
- role="bold">'filled'</emphasis>. Se <emphasis
- role="bold">'off'</emphasis>, os strings são exibidos utilizando-se
- a dada fonte e o campo data especifica a posição do ponto inferior
- esquerdo do texto. Se <emphasis role="bold">'centered'</emphasis>, o
- texto é exibido no meio do retângulo cujo tamanho é fornecido por
- text_box. Se <emphasis role="bold">'filled'</emphasis>, o tamanho de
- fonte dos strings será expandido para se preencher o
- retângulo.</para>
-
- <para>Ao se utilizar os modos <emphasis role="bold">'off'</emphasis>
- ou <emphasis role="bold">'centered'</emphasis> , o tamanho dos
- textos se mantém constante sob ampliação. Eles são os melhores modos
- para se criar anotações em um gráfico. Por outro lado, ao se
- utilizar o modo <emphasis role="bold">'filled'</emphasis>, o tamanho
- do texto segue a escala gráfica. É então possível ampliar objetos
- textos.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>font_foreground:</term>
-
- <listitem>
- <para>este campo contém a cor utilizada para exibir os caracteres do
- texto. O valor deve ser um índice de cor (relativo ao mapa d