Prima::...rDialog(3)

💖 NAME 💖

Prima::Dialog::ColorDialog — standard color selection facilities. also known as the Prima::...rDialog(3) manual page, which is the manual name and is now folded in near the top like a cute little bow 🎀. The header also labels this as User Contributed Perl Documentation, so there you go, bestie.

🌈 SYNOPSIS 🌈

        use Prima qw(Dialog::ColorDialog Application);

        my $p = Prima::Dialog::ColorDialog-> new(
                quality => 1,
        );
        printf "color: %06x", $p-> value if $p-> execute == mb::OK;

✨ DESCRIPTION ✨

Okay so this module contains two packages, Prima::Dialog::ColorDialog and Prima::ColorComboBox, used as standard tools for the interactive color selection. Prima::ColorComboBox is a modified combo widget that provides selecting colors from a predefined palette, but also can invoke a Prima::Dialog::ColorDialog window. Slay. 💅

🎨 Prima::Dialog::ColorDialog 🎨

💅 Properties 💅

• grayscale BOOLEAN — if set, allows only gray colors. monochrome moment, honestly.
• quality BOOLEAN — the setting can increase the visual quality of the dialog if run on paletted displays.

Default value: 0

• value COLOR — selects the color represented by the color wheel and other dialog controls.

Default value: cl::White

🛠️ Methods 🛠️

• hsv2rgb HUE, SATURATION, LUMINOSITY — converts a color from HSV to RGB format and returns three 8-bit integer values, red, green, and blue components. math but make it cute.
• rgb2hsv RED, GREEN, BLUE — converts color from RGB to HSV format and returns three numerical values, hue, saturation, and luminosity components. the reverse pipeline, bestie.
• xy2hs X, Y, RADIUS — maps X and Y coordinate values onto a color wheel with RADIUS in pixels. The code uses RADIUS = 119 for mouse position coordinate mapping. Returns three values: hue, saturation, and an error flag. If the error flag is set, the conversion is failed. watch the flag, it's giving warning energy.
• hs2xy HUE, SATURATION — maps hue and saturation onto a 256-pixel wide color wheel, and returns X and Y coordinates of the corresponding point. coordinate girlies rise.
• create_wheel SHADES, BACK_COLOR — creates a color wheel with the number of SHADES given, drawn on a BACK_COLOR background. Returns a Prima::DeviceBitmap object. wheel creation station ✨
• create_wheel_shape SHADES — creates a circular 1-bit mask with a radius derived from SHAPES. SHAPES must be the same as passed to create_wheel. Returns a Prima::Image object. yes, SHADES in the signature and SHAPES in the prose — that's literally what the page says, no cap.

🎉 Events 🎉

• BeginDragColor $PROPERTY — called when the user starts dragging a color from the color wheel by the left mouse button and an optional combination of Alt, Ctrl, and Shift keys. $PROPERTY is one of the Prima::Widget color properties, and depends on a combination of the following keys:

Alt              backColor
Ctrl             color
Alt+Shift        hiliteBackColor
Ctrl+Shift       hiliteColor
Ctrl+Alt         disabledColor
Ctrl+Alt+Shift   disabledBackColor

The default action reflects the property to be changed in the dialog title. title glow-up behavior.

• Change — the notification is called when the value property is changed, either interactively or as a result of a direct call. every change gets a little announcement, periodt.
• EndDragColor $PROPERTY, $WIDGET — called when the user releases the mouse button over a Prima widget. The default action sets $WIDGET->$PROPERTY to the selected color value. drop it like it's hot 🫶

🧸 Variables 🧸

• $colorWheel — contains the cached result of the create_wheel method. cache queen.
• $colorWheelShape — contains the cached result of the create_wheel_shape method. shape cache, iconic.

🦋 Prima::ColorComboBox 🦋

🎉 Events 🎉

• Colorify INDEX, COLOR_PTR — nt::Action callback, designed to map combo palette index into an RGB color. INDEX is an integer from 0 to colors - 1, COLOR_PTR is a reference to the result scalar where the notification is expected to store the resulting color. callback with a mission.

💅 Properties 💅

• colors INTEGER — defines the amount of colors in the fixed palette of the combo box. palette headcount, literally.
• grayscale BOOLEAN — if set, allows only gray colors. again with the gray-only era, we respect it.
• value COLOR — contains the color selection as a 24-bit integer value. 24 bits of pure main-character color energy.

🌟 SEE ALSO 🌟

Prima, Prima::ComboBox, examples/cv.pl.

👑 AUTHOR 👑

Dmitry Karasik, <dmitry@karasik.eu.org>.

---

and that's the whole page, bestie — footer says perl v5.42.0 and 2024-08-20, so you know exactly what timeline this manual came from 💖✨👑