Table Of Contents
Color Picker¶
New in version 1.7.0.
Warning
This widget is experimental. Its use and API can change at any time until this warning is removed.
The ColorPicker widget allows a user to select a color from a chromatic wheel where pinch and zoom can be used to change the selected color. Sliders and TextInputs are also provided for entering the RGBA/HSV/HEX values directly.
Usage:
clr_picker = ColorPicker()
parent.add_widget(clr_picker)
# To monitor changes, we can bind to color property changes
def on_color(instance, value):
print "RGBA = ", str(value) # or instance.color
print "HSV = ", str(instance.hsv)
print "HEX = ", str(instance.hex_color)
clr_picker.bind(color=on_color)
- class kivy.uix.colorpicker.ColorPicker(**kwargs)[source]¶
Bases: kivy.uix.relativelayout.RelativeLayout
See module documentation.
- color¶
The color holds the color currently selected in rgba format.
color is a ListProperty and defaults to (1, 1, 1, 1).
- font_name¶
Specifies the font used on the ColorPicker.
font_name is a StringProperty and defaults to ‘data/fonts/DroidSansMono.ttf’.
- hex_color¶
The hex_color holds the currently selected color in hex.
hex_color is an AliasProperty and defaults to #ffffffff.
- hsv¶
The hsv holds the color currently selected in hsv format.
hsv is a ListProperty and defaults to (1, 1, 1).
- wheel¶
The wheel holds the color wheel.
wheel is an ObjectProperty and defaults to None.
- class kivy.uix.colorpicker.ColorWheel(**kwargs)[source]¶
Bases: kivy.uix.widget.Widget
Chromatic wheel for the ColorPicker.
Changed in version 1.7.1: font_size, font_name and foreground_color have been removed. The sizing is now the same as others widget, based on ‘sp’. Orientation is also automatically determined according to the width/height ratio.
- a¶
The Alpha value of the color currently selected.
a is a BoundedNumericProperty and can be a value from 0 to 1.
- b¶
The Blue value of the color currently selected.
b is a BoundedNumericProperty and can be a value from 0 to 1.
- color¶
The holds the color currently selected.
color is a ReferenceListProperty and contains a list of r, g, b, a values.
- g¶
The Green value of the color currently selected.
g is a BoundedNumericProperty and can be a value from 0 to 1.
- r¶
The Red value of the color currently selected.
r is a BoundedNumericProperty and can be a value from 0 to 1. It defaults to 0.