Image Tint Tool for Ren'Py [Addon]

Overview

If you've got backgrounds taking place during different times of day or in different lighting conditions, you might want to tint your character sprites to blend in better with the background. For example, you can darken the image and add a hint of blue for nighttime, desaturate and tint the image brown for a sepia flashback, or up the contrast and apply a purple overlay for some club lighting. With the Image Tint Tool, you can preview these changes in real-time against the background to ensure your characters look like they belong in any environment.

The files from Image Tools for Ren'Py and Color Picker for Ren'Py are required for this tool to work.

Description

The Image Tint Tool builds off of Image Tools for Ren'Py, with similar features for entering image tags, moving them around, and saving tints to the clipboard. It provides simple sliders and a colour picker to apply various effects to an image, like tinting and adjusting the saturation and contrast.

Features

Free Version

Extra Paid File

Enter an image tag, and use click-and-drag to move the image around the screen and the mousewheel to zoom in and out to position it where needed Enter a separate background tag to display behind the image and compare against Save and load image tags and backgrounds for later. Loading backgrounds will also load any previously set up tints for that tag. A color picker which applies a tint with the selected colour to the image in real-time Two additional sliders to control saturation and contrast levels so you can get that perfect tint UI is can be moved or hidden so you can compare against the background properly Built-in tutorial to walk you through all the features Adaptable UI intended to work with most project sizes and dimensions - just drop into your project and get started

A special dictionary where you can paste in the matrices created by the tool along with a tag name (e.g. sunset = TintMatrix("ffddcc")) This dictionary is then used to automatically generate tinted variants of all the images in your game - configuration options will allow you to specify a smaller subset of images, or only apply tints to layered images. You can then show images with the tint attribute i.e. show eileen sunset The dictionary can also be used with a special apply_matrix transform with the name of the tint i.e. show eileen at apply_matrix("sunset")

Instructions

Included in image_tint_tool.zip is a rpy file, image_tint_tool.rpy, inside a folder, image_tools. Place the image_tools folder with your other script files inside the project's game/ folder. Similarly, the paid file tint_tool_tips.rpy can be placed in the same folder.

This tool requires the files from Image Tools for Ren'Py AND the color picker from Color Picker for Ren'Py. You must include those files in your project as well for this tool to work.

If you haven't already, create a button to access the image tools - I recommend adding a textbutton to the main menu screen with a line like:

textbutton "Image Tools" action ShowMenu("image_tools")

Clicking this button will take you to the tool hub screen, where you can select the Image Tinting Tool. The first time you open this tool, you will be shown the tutorial. You can use the menu button in the top left corner of the tool screen to reread the tutorial at any time.

Compatibility

This tool has been tested for compatibility with Ren'Py 7.5-7.6 and 8.0-8.2. It uses nearrect for dropdowns and thus is not compatible with earlier Ren'Py versions without modification. It has been tested with several project sizes and image declarations for UI adaptability, but as the possible permutations are near-infinite, some edge cases may have been missed - if you have any issues, please make a post in the forums below.

Terms of Use

Both the free version and any paid addons have the same terms of use, with the following exception: the paid tint tool tips file can be included in a built game, provided it is archived. The code to do so is included in the file.

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 this code with your project - it is a development tool, and should not be packaged in a completed game. The code to exclude the tool from a built game is included in the files.
• 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

Credits

• Daaz is from When Stars Collide by Steamberry Studio
• Rice field background art by Mugenjoncel

Final Notes

This is the third and final part of a multi-part release which includes addons to the base Image Tools for Ren'Py tool. Follow me to be informed of new releases!

The next tool is a fully-featured achievement system which both plugs into the Steam backend and also makes it easy to have in-game popups and an achievement gallery. Find it below!

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, http://feniksdev.com