<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="flsetcolor">
  <refmeta>
    <refentrytitle>FLsetColor</refentrytitle>
  </refmeta>

  <refnamediv>
    <refname>FLsetColor</refname>
    <refpurpose>
      Sets the primary color of a FLTK widget.
      <indexterm id="IndexFlsetcolor"><primary>FLsetColor</primary></indexterm>
    </refpurpose>
  </refnamediv>
  
  <refsect1>
    <title>Description</title>
    <para>
      <emphasis>FLsetColor</emphasis> sets the primary color of the target widget.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis><command>FLsetColor</command> ired, igreen, iblue, ihandle</synopsis>
  </refsect1>

  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>ired</emphasis> -- The red color of the target widget. The range for each RGB component is 0-255
    </para>

    <para>
      <emphasis>igreen</emphasis> -- The green color of the target widget. The range for each RGB component is 0-255
    </para>

    <para>
      <emphasis>iblue</emphasis> -- The blue color of the target widget. The range for each RGB component is 0-255
    </para>

    <para>
      <emphasis>ihandle</emphasis> -- an integer number (used as unique identifier) taken from the output of a previously located widget opcode (which corresponds to the target widget). It is used to unequivocally identify the widget when modifying its appearance with this class of opcodes. The user must not set the <emphasis>ihandle</emphasis> value directly, otherwise a Csound crash will occur.
    </para>
  </refsect1>

  <refsect1>
    <title>Examples</title>
    <para>
      Here is an example of the flsetcolor opcode. It uses the files <ulink url="examples/flsetcolor.orc"><citetitle>flsetcolor.orc</citetitle></ulink> and <ulink url="examples/flsetcolor.sco"><citetitle>flsetcolor.sco</citetitle></ulink>.

      <example>
        <title>Example of the flsetcolor opcode.</title>

        <programlisting>
<inlinemediaobject>
            <imageobject>
              <imagedata fileref="examples/flsetcolor.orc" format="linespecific">
            </imageobject>
          </inlinemediaobject>
        </programlisting>

        <programlisting>
<inlinemediaobject>
            <imageobject>
              <imagedata fileref="examples/flsetcolor.sco" format="linespecific">
            </imageobject>
          </inlinemediaobject>
        </programlisting>
      </example>
    </para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="flcolor"><citetitle>FLcolor</citetitle></link>, 
      <link linkend="flcolor2"><citetitle>FLcolor2</citetitle></link>, 
      <link linkend="flhide"><citetitle>FLhide</citetitle></link>, 
      <link linkend="fllabel"><citetitle>FLlabel</citetitle></link>, 
      <link linkend="flsetalign"><citetitle>FLsetAlign</citetitle></link>, 
      <link linkend="flsetbox"><citetitle>FLsetBox</citetitle></link>, 
      <link linkend="flsetcolor2"><citetitle>FLsetColor2</citetitle></link>, 
      <link linkend="flsetfont"><citetitle>FLsetFont</citetitle></link>, 
      <link linkend="flsetposition"><citetitle>FLsetPosition</citetitle></link>, 
      <link linkend="flsetsize"><citetitle>FLsetSize</citetitle></link>, 
      <link linkend="flsettext"><citetitle>FLsetText</citetitle></link>, 
      <link linkend="flsettextcolor"><citetitle>FLsetTextColor</citetitle></link>, 
      <link linkend="flsettextsize"><citetitle>FLsetTextSize</citetitle></link>, 
      <link linkend="flsettexttype"><citetitle>FLsetTextType</citetitle></link>, 
      <link linkend="flsetvali"><citetitle>FLsetVal_i</citetitle></link>, 
      <link linkend="flsetval"><citetitle>FLsetVal</citetitle></link>, 
      <link linkend="flshow"><citetitle>FLshow</citetitle></link>
    </para>
  </refsect1>

  <refsect1>
    <title>Credits</title>
    <para>Author: &namegabriel;</para>
    <para>New in version 4.22</para>
    <para>Example written by Iain McCurdy, edited by &namekevin;.</para>
  </refsect1>
</refentry>
