https://github.com/nlfmt/pyqt-colorpicker-widget
A custom Color Picker widget for PyQt5/PyQt6 applications.
https://github.com/nlfmt/pyqt-colorpicker-widget
color-picker pyqt5 pyqt6 python3
Last synced: about 1 year ago
JSON representation
A custom Color Picker widget for PyQt5/PyQt6 applications.
- Host: GitHub
- URL: https://github.com/nlfmt/pyqt-colorpicker-widget
- Owner: nlfmt
- License: mit
- Created: 2020-10-04T19:14:39.000Z (almost 6 years ago)
- Default Branch: main
- Last Pushed: 2021-05-22T23:20:16.000Z (about 5 years ago)
- Last Synced: 2023-03-09T05:36:46.686Z (over 3 years ago)
- Topics: color-picker, pyqt5, pyqt6, python3
- Language: Python
- Homepage:
- Size: 84 KB
- Stars: 8
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PyQt Color Picker
Simple Color Picker Widget created with PyQt to easily get color input from the user.
## Usage
1. To use the Color Picker Widget in a PyQt project make sure you have the `PyQt5` or `PyQt6` library:
```
pip install PyQt5
```
```
pip install PyQt6
```
then add the `colorpicker` folder of your PyQt version into your project folder and import `ColorPicker`
```python
from colorpicker import ColorPicker
```
2. To add the widget to your app, create a `360x200` placeholder widget in your ui and add the colorpicker to it.
When initializing the Color Picker you have the option to pass an initial color to it.
```python
colorpicker = ColorPicker(my_placeholder) # initial color is black
colorpicker = ColorPicker(my_placeholder, rgb=(255,127,0)) # Use RGB
colorpicker = ColorPicker(my_placeholder, hsv=(90,80,20)) # Use HSV
colorpicker = ColorPicker(my_placeholder, hex="33ff88") # Use Hex
```
You can then run `getRGB`/`getHSV`/`getHex` method to get the currently selected color:
```python
current_color = colorpicker.getRGB()
```
* `getRGB` returns a rgb tuple with values from 0-255,
* `getHSV` returns a hsv tuple with values from 0-100,
* `getHex` returns a string without hashtag.
* You can customize the ranges easily:
```python
hsv = colorpicker.getHSV(360,1) # hue in degrees, saturation & value from 0 to 1
rgb = colorpicker.getRGB(100) # rgb in percent
hex = colorpicker.getHex(True) # use hashtag in string
```
* You can also set the current color:
```python
colorpicker.setHSV((50,20,80)) # 0-100
colorpicker.setRGB((221,34,21)) # 0-255
colorpicker.setHex("dd3322") # no hashtag
```
* Use ColorPicker's `colorChanged` signal to update directly when the user changes the color:
```python
colorpicker.colorChanged.connect(my_function)
def my_function():
print(colorpicker.getColor())
```
* For an example with a bigger application based on a main class, look at the `example.py` file.
**[Why should you consider using Qt6 | Scaling Issues?](https://imgur.com/a/8mGuCiJ)**