Better Dynamic Colors for Ren'Py

Update

This tool is being retired in favour of Better Colorize for Ren'Py, which provides all the same functionality plus additional recolouring flexibility:

This tool will remain available for those who want it, but support will be directed towards Better Colorize for Ren'Py. Thank you to all who downloaded and gave feedback for this tool so I could improve upon it for Better Colorize for Ren'Py!

Overview

Whether you're providing colour options for a character creator, UI elements, or otherwise, sometimes you may want to give players a greater range of colours to use along a spectrum. In particular, providing a slider for skin tones can be difficult to achieve without getting a bunch of muddier middle tones.

This code allows you to provide an arbitrary number of colour codes which will be smoothly interpolated between when dragging a slider so you can better customize all the in-between tones.

Description

This code provides two main features: 

First, there is a special DynamicDisplayable function which will take a variable which ranges from 0-100, an image, and 1-2 lists of colour codes which will be used to recolour the image. This is best used for character creators, especially skin tone sliders, to provide greater control over the available options. You can also use it to provide a whole spectrum of options for completely free recolouring.

Second, there is a special shader which takes up to 8 colour codes and will return a gradient smoothly interpolating between all provided colours. This can be used in combination with the colour codes provided to the DynamicDisplayable to create a bar image which can be used for things like a skin tone slider.

Instructions

Download multi_color_slider.zip and unzip it. Place the provided rpy file (multi_color_slider.rpy) into your project's game/ folder, and the provided images hand_bw.png and hand_heart.png into your images folder . To see an example screen, make a button to go to it, for example on the main menu:

textbutton _("Recolor") action ShowMenu("recolor_example") 

You will see provided hand images with two sliders, one horizontal and one vertical. If you do not need the example code, you may delete the images and everything after the EXAMPLES header in the rpy file.

Compatibility

This system has been tested for compatibility with Ren'Py 7.5-7.6 and 8.0-8.1. It is expected to be compatible with earlier versions so long as they include gl2 (So, 7.4+). Leave a message in the stickied thread if you run into any bugs.

Terms of Use

You may:

• Use this code in commercial and noncommercial projects.
• Modify and edit this code to suit your needs

You may not:

• Resell all or part of this code as-is or sell it with modifications

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

Credits

Hand illustration adapted from Edurs34 from Pixabay (included in zip)

Pixel dressup assets from Welcome_to_heaven (not included in zip).

Final Notes

If you're making a character creator, you may also be interested in my In-Depth Pronouns code, found below:

And if you want even more colour freedom, consider my color picker as well:

Follow me to be informed of future tools! I also release tutorials on my website, https://feniksdev.com I'm in the process of posting a series of tutorials dedicated to screen language! I post general updates from my profile when I release a tutorial unrelated to my tools.