Quick search

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.

_images/colorpicker.png

The ColorPicker widget allows a user to select a color from a chromatic wheel where pinch and zoom can be used to change the wheel’s saturation. 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/RobotoMono-Regular.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.