Color Widgets
=============

Color2DSlider
-------------
![Color2DSlider](Color2DSlider.png)

This widget allow the user to select 2 HSV color components at the same time,
by default that is Saturation and Value but they can be changed.

ColorDialog
-----------
![ColorDialog](ColorDialog.png)

This is a dialog analogous to <tt>QColorDialog</tt> but with a much nicer and friendlier 
user interface. It uses several of the other widgets.

ColorLineEdit
-------------
![ColorLineEdit](ColorLineEdit.png)
![ColorLineEdit with color preview](ColorLineEdit_with_color.png)

This is a <tt>QLineEdit</tt> intended to be used to edit and display color names.
It accepts several string formats:
* <tt>#f00</tt> (3 hexadecimal rgb digits)
* <tt>#ff0000</tt> (6 hexadecimal rgb digits)
* <tt>rgb(255,0,0)</tt> (function-like)
* <tt>red</tt> (color name)

It can optionally display the color it represents on its background.

ColorListWidget
---------------
![ColorListWidget](ColorListWidget.png)

It allows to display and edit a list of colors.

ColorPaletteWidget and Swatch
-----------------------------
These widgets handle color palettes.

![Swatch](Swatch.png)

**Swatch** only handles a single palette, can be used to just select colors from the 
palette or to modify the palette via drag and drop operations.

**ColorPaletteModel** is a list model that represents palettes with can be used
with the Qt item view widgets, it provides a name and a preview icon for
each of the stored palettes.
It also has functionality to load and save palettes from the filesystem.

![Read-only ColorPaletteWidget](ColorPaletteWidget_readonly.png)
![ColorPaletteWidget](ColorPaletteWidget.png)

**ColorPaletteWidget** manages a list of palettes (via **ColorPaletteModel**).
Has two modes: read-only only allows to select palettes and colors,
otherwise it can be used to modify the list of palettes and the palette itself.

ColorPreview and ColorSelector
------------------------------
![ColorPreview](ColorPreview.png)

**ColorPreview** is a widget that displays a color or compares two colors.

**ColorSelector** is like **ColorPreview** but when clicked it shows a ColorDialog.

GradientSlider and HueSlider
----------------------------
![HueSlider](HueSlider.png)

**GradientSlider** is a <tt>QSlider</tt> which uses a gradient as its background.

**HueSlider** is specifically made to select a hue and has more information
about the represented color.


GradientEditor
--------------
![GradientEditor](GradientEditor.png)

**GradientEditor** is similar in appearance to **GradientSlider** but it's for editing the gradient.


GradientListModel and GradientDelegate
--------------------------------------
![GradientListModel](GradientListModel_combo.png)
![GradientListModel](GradientListModel_view.png)

**GradientListModel** is a <tt>QAbstractListModel</tt> used to list gradients (useful for combo boxes, item views and the like).

**GradientDelegate** is an item delegate to edit gradients in an item view.