- <?xml version="1.0" encoding="ISO-8859-1"?>
- <!--
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
* Copyright (C) INRIA
- *
- * 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
+ * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2021 - Samuel GOUGEON
+ *
+ * This file is hereby licensed under the terms of the GNU GPL v2.0,
+ * pursuant to article 5.3.4 of the CeCILL v.2.1.
+ * This file was originally licensed under the terms of the CeCILL v2.1,
+ * and continues to be available under such terms.
+ * For more information, see the COPYING file which you should have received
+ * along with this program.
*
-->
- <refentry 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" xmlns:scilab="http://www.scilab.org" xml:id="getcolor" xml:lang="en">
- <refnamediv>
- <refname>getcolor</refname>
- <refpurpose>abre um diálogo que exibe as cores no mapa de cores
- corrente
- </refpurpose>
- </refnamediv>
- <refsynopsisdiv>
- <title>Seqüência de Chamamento</title>
- <synopsis>c=getcolor(title,[cini])
- c=getcolor()
- </synopsis>
- </refsynopsisdiv>
- <refsection>
- <title>Parâmetros</title>
- <variablelist>
- <varlistentry>
- <term>title</term>
- <listitem>
- <para>string, o título do diálogo</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>cini</term>
- <listitem>
- <para>identificador da cor selecionada inicial. O valor padrão é
- 1.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>c</term>
- <listitem>
- <para>identificador da cor selecionada ou [] se o usuário tiver
- clicado no botão "Cancel" (cancelar).
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsection>
- <refsection>
- <title>Descrição</title>
- <para>
- <literal>getcolor</literal> abre uma janela que exibe o palete do
- mapa de cores corrente. O usuário pode clicar numa cor para exibir seu
- identificador e valores RGB. <literal>getcolor</literal> retorna o
- identificador da cor selecionada ou [] se o usuário clicar no botão
- "Cancel".
- </para>
- </refsection>
- <refsection role="see also">
- <title>Ver Também</title>
- <simplelist type="inline">
- <member>
- <link linkend="color">color</link>
- </member>
- <member>
- <link linkend="colormap">colormap</link>
- </member>
- <member>
- <link linkend="getmark">getmark</link>
- </member>
- <member>
- <link linkend="getfont">getfont</link>
- </member>
- </simplelist>
- </refsection>
- </refentry>
+<refentry 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"
+ xmlns:scilab="http://www.scilab.org" xml:id="getcolor" xml:lang="pt">
+ <refnamediv>
+ <refname>getcolor</refname>
+ <refpurpose>abre um diálogo que exibe as cores no mapa de cores atual ou padrão
+ corrente
+ </refpurpose>
+ </refnamediv>
+ <refsynopsisdiv>
+ <title>Seqüência de Chamamento</title>
+ <synopsis>
+ c = getcolor()
+ c = getcolor(title)
+ c = getcolor(title, cini)
+ </synopsis>
+ </refsynopsisdiv>
+ <refsection>
+ <title>Parâmetros</title>
+ <variablelist>
+ <varlistentry>
+ <term>title</term>
+ <listitem>
+ <para>string, o título do diálogo</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>cini</term>
+ <listitem>
+ <para>número da cor selecionada inicial. O valor padrão é 1.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>c</term>
+ <listitem>
+ <para>número da cor selecionada, ou [] se o usuário tiver
+ clicado no botão "Cancel" (cancelar).
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsection>
+ <refsection>
+ <title>Descrição</title>
+ <para>
+ <literal>getcolor</literal> abre uma janela que exibe o palete do mapa
+ de cores corrente o padrão. O usuário pode clicar numa cor para exibir seu
+ número e valores RGB. <literal>getcolor</literal> retorna o
+ número da cor selecionada, ou [] se o usuário clicar no botão "Cancel".
+ </para>
+ </refsection>
+ <refsection>
+ <title>Exemplos</title>
+ <programlisting role="example"><![CDATA[
+c = getcolor();
+
+c = getcolor("Title foo", color("red")); // preselects the red
+
+c = getcolor("Please choose a color");
+ ]]></programlisting>
+ <para/>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="../../images/getcolor.png"/>
+ </imageobject>
+ </inlinemediaobject>
+ <para/>
+ <screen><![CDATA[
+--> c = getcolor("Please choose a color")
+ c =
+ 28.
+]]></screen>
+ </refsection>
+ <refsection role="see also">
+ <title>Ver Também</title>
+ <simplelist type="inline">
+ <member>
+ <link linkend="uigetcolor">uigetcolor</link>
+ </member>
+ <member>
+ <link linkend="color_list">color_list</link>
+ </member>
+ <member>
+ <link linkend="color">color</link>
+ </member>
+ <member>
+ <link linkend="colormap">colormap</link>
+ </member>
+ </simplelist>
+ </refsection>
+</refentry>