<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" style="task" id="plugin-color-picker" xml:lang="da">

  <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 its:translate="no">jwcampbell@gmail.com</email>

    </credit>

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

  </info>

  <title>Color Picker</title>

  
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.

  
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>.

  <steps>

    <title>To open and use the color picker:</title>

    <item>

      
Place your cursor at the point in your document where you want to

      insert the color code.

    </item>

    <item>

      
Select <guiseq><gui>Tools</gui><gui>Pick Color…</gui></guiseq>.  The

      color picker dialog will appear.

    </item>

    <item>

      
Click on the desired color in the color picker window.

    </item>

    <item>

      
The appropriate color code will be inserted where you had placed your

      cursor.

    </item>

    <item>

      
To close the <app>color picker</app>, click <gui>Close</gui>.

    </item>

  </steps>

  <note style="tip">

    
You can make fine-grained adjustments to the color by adjusting the

    values for Hue, Saturation, Value, Red, Green, or Blue.

    
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.

  </note>     

</page>