/split-toning

A Blender addon for simulating the Split Toning effect in Adobe Lightroom/Photoshop

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

split-toning

A Blender add-on to provide a compositor node for simulating the Split Toning effect in Adobe Photoshop/Lightroom. It allows you to easily manipulate the colors of shadows and highlights separately.

Example

Original:

Adjusted (1):

Adjusted (2):

Usage

Download the latest zip file of this repository from this link: https://github.com/yuki-koyama/split-toning/archive/master.zip.

Open the User Preference widget, install the add-on by choosing the downloaded zip file (split-toning-master.zip) from Install Add-on from File..., and enable the add-on.

Go to Compositor and open the Add menu; you'll find a Split Toning option.

Once clicking the Split Toning option, a node will be added to the active node tree. The node can be linked to other nodes in a standard way.

Supported Blender Version

Blender 2.83. It is not tested on 2.9x.

Why not using the Color Balance node?

The effect of Split Toning itself is very similar to the Color Balance node in Blender. However, our Split Toning node has several different points:

  • Controllable Highlights-Shadows balance: Split Toning provides a parameter called Balance, which controls how highlights and shadows are split.
  • Fewer parameters: Split Toning has only five parameters and so it is easier to explore possible effects.
  • Brightness preservation: Split Toning only alters the hue and saturation of the image and does not alter the brightness (strictly speaking, the value of HSV). This makes it much easier to control the colorfulness and brightness.
  • Photoshop-users friendliness: Split Toning is very similar to the one in Adobe Photoshop/Lightroom.

License

GPL-3.0

Contributing

Requests, suggestions, issues, and PRs are highly welcomed!

Code Formatting

https://wiki.blender.org/wiki/Style_Guide/Python

Versioning

We follow the PEP440 rules except that we use - (hyphen) instead of . (period). For example, the version 1-2 means its major version is 1 and its minor version is 2. 1-3rc1, 1-4-dev2 are valid version tags.

Why Use Hyphens?

Blender add-ons directories are not allowed to use . (period) in their names.

To install zip files downloaded via GitHub's tagged zip download functionality (e.g., https://github.com/yuki-koyama/split-toning/archive/1-2.zip) directly into Blender as add-ons, we cannot use . (period) in tag names.