<?xml version="1.0" encoding="UTF-8"?>
<!--
 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) INRIA - Serge Steer
 *
 * Copyright (C) 2012 - 2016 - Scilab Enterprises
 *
 * 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:ns3="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="hsv2rgb" xml:lang="pt">
    <refnamediv>
        <refname>hsv2rgb</refname>
        <refpurpose>Converte cores HSV para RGB</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>Seqüência de Chamamento</title>
        <synopsis>[r,g,b] = hsv2rgb(h,s,v)
            rgb = hsv2rgb(h,s,v)
            [r,g,b] = hsv2rgb(hsv)
            rgb = hsv2rgb(hsv)
        </synopsis>
    </refsynopsisdiv>
    <refsection role="parameters">
        <title>Parâmetros</title>
        <variablelist>
            <varlistentry>
                <term>h</term>
                <listitem>
                    <para>um vetor de tamanho n. Os valores "hue" (de matiz) </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>s</term>
                <listitem>
                    <para>um vetor de tamanho n. Os valores "saturation" (de saturação)
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>v</term>
                <listitem>
                    <para>um vetor de tamanho n. Os valores "value" (de valor). </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>hsv</term>
                <listitem>
                    <para>uma matriz n x 3. Cada linha contém uma tripla [hue saturation
                        value].
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>r</term>
                <listitem>
                    <para>um vetor coluna de tamanho n. Os valores "red" (de vermelho).
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>g</term>
                <listitem>
                    <para>um vetor coluna de tamanho n. Os valores "green" (de verde).
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>b</term>
                <listitem>
                    <para>um vetor coluna de tamanho n. Os valores "blue" (de azul).
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>rgb</term>
                <listitem>
                    <para>uma matriz n x 3. Cada linha contém uma tripla [red green
                        blue].
                    </para>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
    <refsection role="description">
        <title>Descrição</title>
        <para>A função hsv2rgb converte mapas de cores entre os espaços de cores
            RGB e HSV. Como a matiz varia de 0 a 1.0 , as cores correspondentes podem
            variar partindo do vermelho entre amarelo, verde, ciano, azul, magenta, e
            preto, até vermelho novamente, de modo que há na verdade valores de
            vermelho tanto em 0 quanto em 1.0 . À medida em que a saturação varia de 0
            a 1.0, as cores correspondentes (matizes) variam de insaturadas (gradações
            de cinza) a completamente saturadas (nenhum componente branco). à medida
            em que o valor, ou brilho, varia de 0 a 1.0, as cores correspondentes vão
            se tornando mais brilhantes.
        </para>
    </refsection>
    <refsection role="examples">
        <title>Exemplos</title>
        <programlisting role="example"><![CDATA[
t = [0:0.3:2*%pi]';
z = sin(t)*cos(t');
plot3d1(t,t,z)
f = gcf();
for h = 0:0.1:1
  hsv = [h*ones(32,1) linspace(0,1,32)' 0.7*ones(32,1)];
  f.color_map = hsv2rgb(hsv);
  sleep(10)
end
for v = 0:0.1:1
  hsv = [ones(32,1) linspace(0,1,32)' v*ones(32,1)];
  f.color_map = hsv2rgb(hsv);
  sleep(10)
end
 ]]></programlisting>
        <scilab:image>
            t=[0:0.3:2*%pi]'; z=sin(t)*cos(t');
            plot3d1(t,t,z)
            f=gcf();
            for h=0:0.1:1
            hsv=[h*ones(32,1) linspace(0,1,32)' 0.7*ones(32,1)];
            f.color_map=hsv2rgb(hsv);
            end
            for v=0:0.1:1
            hsv=[ones(32,1) linspace(0,1,32)' v*ones(32,1)];
            f.color_map=hsv2rgb(hsv);
            end
        </scilab:image>
    </refsection>
</refentry>

