Color Picker for Ren'Py

Overview

Click and drag around a colour picker to easily select a colour for use in Ren'Py. Useful for character creators, dev tools, UI customization and accessibility, and more!

You can also find this code on GitHub.

Description

There are two main ways to use this colour picker tool: the first is for a traditional colour picker, with a hue slider and one main corner colour. The second is a "four corner picker", where you will supply the colours for all four corners and can use the picker to pick a colour somewhere between the provided colours. The four corner picker can be useful for more restricted palettes where the player should only pick between shades of a particular colour, such as shades of brown for a skin colour.

Two files are provided: color_picker.rpy and color_picker_examples.rpy. The first file has the essential code which is needed to make the colour picker work (namely, a CDD, two shaders, and a couple functions), and the second file has three example screens and a label to demonstrate various use cases for the colour picker.

Instructions

Download color_picker.zip and unzip it. Place the two provided rpy files in your project's game/ folder. To immediately test the tool, jump to the test label how_to_use_color_picker e.g.

label start:
    jump how_to_use_color_picker

You can remove color_picker_examples.rpy once you're done learning from the examples, or adjust the code to suit your own project needs.

Compatibility

This tool has been tested for compatibility with Ren'Py 7.5-7.6 and 8.0-8.2. It uses shaders and matrixcolor, so it requires at least a version of Ren'Py which has gl2 enabled, but has not been tested for earlier versions.

Terms of Use

You may:

• Use this code during development of any kind of project, commercial or noncommercial.
• Modify and edit the code to suit your needs

You may not:

• Resell all or part of the code as-is or sell it with modifications
• Release any projects created using this code without providing attribution

Attribution must be credited as Feniks, with a link either to the page with this code or to https://feniksdev.com

Final Notes

This color picker is used in my Image Tint Tool, part of my Image Tools for Ren'Py series. You will need both the color picker files from here and the Image Tint Tool files from the listing below for the tint tool to work!

Follow me on itch.io to be informed of future releases! You may also consider looking at my other Ren'Py tools, which I've added to a collection here: https://itch.io/c/3491447/my-renpy-tools. I also release tutorials on my website, https://feniksdev.com