README.md

ColorPicker

Table of Contents

1. About The Project
   • Built With
   • Prerequisites
   • Optional Prerequisites
2. How to Build
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

Simple Color Picker made with QtQuick

Features

• Color Wheel
• Color Eyedrop Tool
• Color History
• RGBA Slider
• HSVA Slider
• Hex Color field
• Drag and Drop

(back to top)

Built With

Prerequisites

• Qt 6.8.X +
• CMake 3.16 +

Optional Prerequisites

• Ninja 1.10.X +

(back to top)

How to Build

Include the project as a subdirectory in your CMakeLists.txt file and link it to your target. You can use the Sandbox project as a reference.

add_subdirectory(ColorPicker)

target_link_libraries(sandbox PRIVATE Qt6::Quick ColorPickerplugin)

(back to top)

Usage

• Shortcuts
  • Enable Eyedrop Tool " p "
• Change Value
  • The "+" key increases the current value by 0.1. For more precise adjustments, you can combine it with Shift to change by 0.01 or Ctrl+Shift to change by 0.001.
  • The "-" key decreases the current value by 0.1. Similarly, combine it with Shift for 0.01 precision or Ctrl+Shift for 0.001 precision.

(back to top)

Roadmap

• Remove QCursor dependency
• Add Wayland support
• Add OpenColorIO to manager color spaces
• Add HSL Slider
• Add support to choose between 8Bits [0-255] and 32Bits [0-1] range
• Add Color Swatches
  • Add new swatch
  • Edit current Selected
  • Save swatch palette
  • Open swatch palette
• Multi-language Support
  • Portuguese (PT/BR)
  • Spanish
  • Franch

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

André Agenor

Project Link: https://github.com/andreagen0r/ColorPicker

(back to top)