History

huxingyi d6f6fb6cdf Add metallic and roughness settings for part Part deform painter got removed. Experiment color painter introduced, but not enabled yet.		2020-10-18 14:33:15 +09:30
..
cmake	Add metallic and roughness settings for part	2020-10-18 14:33:15 +09:30
color_widgets_designer_plugin	Add metallic and roughness settings for part	2020-10-18 14:33:15 +09:30
gallery	Add metallic and roughness settings for part	2020-10-18 14:33:15 +09:30
include/QtColorWidgets	Add metallic and roughness settings for part	2020-10-18 14:33:15 +09:30
resources/QtColorWidgets	Add metallic and roughness settings for part	2020-10-18 14:33:15 +09:30
src/QtColorWidgets	Add metallic and roughness settings for part	2020-10-18 14:33:15 +09:30
.gitignore	Add metallic and roughness settings for part	2020-10-18 14:33:15 +09:30
CMakeLists.txt	Add metallic and roughness settings for part	2020-10-18 14:33:15 +09:30
COPYING	Add metallic and roughness settings for part	2020-10-18 14:33:15 +09:30
LICENSE-EXCEPTION	Add metallic and roughness settings for part	2020-10-18 14:33:15 +09:30
QtColorWidgets.pc.in	Add metallic and roughness settings for part	2020-10-18 14:33:15 +09:30
README.md	Add metallic and roughness settings for part	2020-10-18 14:33:15 +09:30
color_widgets.pri	Add metallic and roughness settings for part	2020-10-18 14:33:15 +09:30
color_widgets.pro	Add metallic and roughness settings for part	2020-10-18 14:33:15 +09:30
refactor.sh	Add metallic and roughness settings for part	2020-10-18 14:33:15 +09:30

README.md

Color Widgets

Here is a color dialog that is more user-friendly than the default QColorDialog and several other color-related widgets

The provided widgets are:

ColorWheel, An analog widget used to select a color
ColorPreview, A simple widget that displays a color
GradientSlider, A slider that has a gradient background
HueSlider, A variant of GradientSlider that has a rainbow background
ColorSelector, A ColorPreview that shows a ColorDialog when clicked
ColorDialog, A dialog that uses the above widgets to provide a better user experience than QColorDialog
ColorListWidget, A widget to edit a list of colors
Swatch, A widget to display a color palette
ColorPaletteWidget, A widget to use and manage a list of palettes
Color2DSlider, An analog widget used to select 2 color components
ColorLineEdit, A widget to manipulate a string representing a color
HarmonyColorWheel, A ColorWheel which allows defining multiple colors, separated by hue
GradientListModel, A QAbstractListModel used to list gradients (useful for combo boxes, list views and the like)

they are all in the color_widgets namespace.

See the gallery for more information and screenshots.

Using it in a project

For QMake-based projects, include color_widgets.pri in the QMake project file. For CMake-based projects, add this as subdirectory, it will be compiled as a library and you can link the required targets to ColorWidgets. All the required files are in ./src and ./include.

Installing as a Qt Designer/Creator Plugin

The sources for the designer plugin are in ./color_widgets_designer_plugin

Compile the library and install in (Qt SDK)/Tools/QtCreator/bin/designer/ (Qt SDK)/(Qt Version)/(Toolchain)/plugins/designer

mkdir build && cd build && cmake .. && make QtColorWidgetsPlugin && make install

Latest Version

The latest version of the sources can be found at the following locations:

https://gitlab.com/mattia.basaglia/Qt-Color-Widgets
git://gitlab.com/mattia.basaglia/Qt-Color-Widgets.git

License

LGPLv3+, See COPYING. As a special exception, this library can be included in any project under the terms of any of the GNU liceses, distributing the whole project under a different GNU license, see LICENSE-EXCEPTION for details.