kvex.widgets.color

 1"""Home of `XPickColor` and `XSelectColor`."""
 2
 3from .. import kivy as kv
 4from ..colors import XColor
 5from .layouts import XBox
 6from .label import XLabelClick
 7from .dropdown import XDropDown
 8from .slider import XSliderText
 9
10
11class XPickColor(XBox):
12    """Color picking widget."""
13
14    color = kv.ObjectProperty(XColor(0.5, 0.5, 0.5, 1))
15
16    def __init__(self, **kwargs):
17        """Same keyword arguments for Slider."""
18        super().__init__(orientation="vertical")
19        self.set_size(x=300, y=100)
20        update_color = self._update_from_sliders
21        self.sliders = []
22        for i, c in enumerate("RGBA"):
23            slider_kwargs = {
24                "range": (0, 1),
25                "step": 0.01,
26                "value_track": True,
27                "value_track_color": XColor(**{c.lower(): 0.75}).rgba,
28                "value_track_width": "6dp",
29                "cursor_size": (0, 0),
30            } | kwargs
31            s = XSliderText(**slider_kwargs)
32            s.slider.bind(value=update_color)
33            self.add_widget(s)
34            self.sliders.append(s)
35        self.r, self.g, self.b, self.a = self.sliders
36        self.set_color(self.color)
37
38    def set_color(self, color: XColor):
39        """Set the current color."""
40        self.r.slider.value = color.r
41        self.g.slider.value = color.g
42        self.b.slider.value = color.b
43        self.a.slider.value = color.a
44
45    def _update_from_sliders(self, *a):
46        color = XColor(
47            self.r.slider.value,
48            self.g.slider.value,
49            self.b.slider.value,
50            self.a.slider.value,
51        )
52        is_bright = sum(color.rgb) > 1.5
53        for s in self.sliders:
54            s.label.color = (0, 0, 0, 1) if is_bright else (1, 1, 1, 1)
55        self.make_bg(color)
56        self.color = color
57
58
59class XSelectColor(XLabelClick):
60    """An XPickColor that drops down from an XLabelClick."""
61
62    def __init__(
63        self,
64        prefix: str = "[u]Color:[/u]\n",
65        show_color_values: bool = True,
66        **kwargs,
67    ):
68        """Initialize the class.
69
70        Args:
71            prefix: Text to show before the RGB values.
72            show_color_values: Show the RGB values of the current color.
73            kwargs: Keyword arguments for the XLabelClick.
74        """
75        self.prefix = prefix
76        self.show_color_values = show_color_values
77        super().__init__(**kwargs)
78        self.picker = XPickColor()
79        self.dropdown = XDropDown(auto_width=False, on_dismiss=self._on_color)
80        self.dropdown.set_size(*self.picker.size)
81        self.dropdown.add_widget(self.picker)
82        self.picker.bind(size=lambda w, s: self.dropdown.set_size(*s))
83        self.bind(on_release=self.dropdown.open)
84        self.on_color()
85
86    def _on_color(self, *args):
87        color = self.picker.color
88        self.make_bg(color)
89        text = self.prefix
90        if self.show_color_values:
91            text += " , ".join(str(round(c, 2)) for c in color.rgba)
92        self.text = text
93
94
95__all = (
96    "XPickColor",
97    "XSelectColor",
98)