<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" style="task" id="gedit-plugins-color-picker" xml:lang="te">
  <info>
    <link type="guide" xref="gedit-plugin-guide#gedit-additional-plugins"/> 
    <revision version="3.4" date="2013-02-24" status="review"/>

    <credit type="author">
      <name>Jim Campbell</name>
      <email>jwcampbell@gmail.com</email>
    </credit>

    <desc>Pick a color from a dialog and insert its hexadecimal representation
    </desc>
  </info>

  <title>Color picker</title>

  <p>The <app>color picker</app> plugin helps you to insert the character 
  codes that represent a certain color. This can make it easier to choose
  and use the correct color in your programs.</p>
  
  <p>To enable the color picker plugin, select <guiseq>
  <gui style="menu">gedit</gui><gui style="menuitem">Preferences</gui>
  <gui>Plugins</gui><gui>Color Picker</gui></guiseq>.</p>
  
  <p>To open and use the color picker:</p>
  <steps>
      <item><p>Place your cursor at the point in your document where you want
      to insert the color code.</p></item>
      <item><p>Select <guiseq><gui>Tools</gui><gui>Pick Color...</gui></guiseq>.
       The color picker dialog will appear.</p></item>
      <item><p>Click on the desired color in the color picker window.</p>
      </item>
      <item><p>The appropriate color code will be inserted where you had placed 
      your cursor.</p></item>
      <item><p>To close the <app>color picker</app>, click <gui>Close</gui>.
      </p></item>
  </steps>
  
  <!--TODO: Update this section for the "Custom" values -->
  <note style="tip"><p>You can make fine-grained adjustments to the color by
  adjusting the values for Hue, Saturation, Value, Red, Green, or Blue.</p>
  <p>Additionally, you can save colors by right-clicking on any of the colored 
  boxes in the color picker, and selecting <gui>Save color here</gui>. This 
  will make it easier to insert commonly-used colors later.</p>
  </note>     
</page>
