README.md 2.5 KB

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.

Documentation

See https://mattbas.gitlab.io/Qt-Color-Widgets/

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:

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.

Copyright (C) 2013-2020 Mattia Basaglia dev@dragon.best