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

  <refnamediv>
    <refname>FLcolor</refname>
    <refpurpose>
      A FLTK opcode that sets the primary colors.
      <indexterm id="IndexFlcolor"><primary>FLcolor</primary></indexterm>
    </refpurpose>
  </refnamediv>
  
  <refsect1>
    <title>Description</title>
    <para>
      Sets the primary colors to RGB values given by the user.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis><command>FLcolor</command> ired, igreen, iblue</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>
  </refsect1>

  <refsect1>
    <title>Performance</title>
    <para>
      These opcodes modify the appearance of other widgets. There are two types of such opcodes, those that don't contain the <emphasis>ihandle</emphasis> argument which affect all subsequently declared widgets, and those without <emphasis>ihandle</emphasis> which affect only a target widget previously defined.
    </para>

    <para>
      <emphasis>FLcolor</emphasis> sets the primary colors to RGB values given by the user. This opcode affects the primary color of (almost) all widgets defined next its location. User can put several instances of <emphasis>FLcolor</emphasis> in front of each widget he intend to modify. However, to modify a single widget, it would be better to use the opcode belonging to the second type (i.e. those containing <emphasis>ihandle</emphasis> argument).
    </para>

    <para>
      <emphasis>FLcolor</emphasis> is designed to modify the colors of a group of related widgets that assume the same color. The influence of <emphasis>FLcolor</emphasis> on subsequent widgets can be turned off by using -1 as the only argument of the opcode. Also, using -2 (or -3) as the only value of <emphasis>FLcolor</emphasis> makes all next widget colors randomly selected. The difference is that -2 selects a light random color, while -3 selects a dark random color.
    </para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <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="flsetcolor"><citetitle>FLsetColor</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>
  </refsect1>
</refentry>
