obs-filters: Add white balance to color filter

[mar10iana]

Description

We added three white balance sliders to the color correction filter, as shown on the screenshots below:

The following changes have been made to the code:

• Added new settings for red, green, and blue white balance adjustments.
• Updated the color_correction_filter_data structure to include white balance variables.
• Modified the create functions to initialize the white balance values.
• Implemented white balance matrix computation in the update functions.
• Integrated the white balance matrix into the final matrix used for color correction.
• Updated the properties functions to add sliders for white balance adjustments.
• Set default values for the new white balance settings.

Motivation and Context

Currently, OBS offers a variety of color correction filters, but lacks a dedicated white balance feature, which is essential for many users. This feature aims to address this problem by introducing three white balance sliders (red, green and blue) that adjust the color temperature.

Ideas website link: https://ideas.obsproject.com/posts/2582/white-balance

How Has This Been Tested?

We tested our feature in a macOS environment.
To test this feature you should go to the color correction filter and check the newly added sliders. If you change the value of the slider, the colours of your source will be updated.

Types of changes

• New feature (non-breaking change which adds functionality)

Checklist:

• My code has been run through clang-format.
• I have read the contributing document.
• My code is not on the master branch.
• The code has been tested.
• All commit messages are properly formatted and commits squashed where appropriate.
• I have included updates to all appropriate documentation.

[WizardCM]

Is it common for white balance to be split into three separate sliders? Keeping in mind OBS is used by a variety of users, some with very intricate knowledge of video/colour and others who just want to make it look good with as little configuration as possible.

[RytoEX]

Do not use merge commits to catch up on branch/repo history. Use git rebase.

[mar10iana]

Is it common for white balance to be split into three separate sliders? Keeping in mind OBS is used by a variety of users, some with very intricate knowledge of video/colour and others who just want to make it look good with as little configuration as possible.

This method offers the highest level of control, allowing precise fine-tuning of color balance across the spectrum. It's ideal for professional users who need to correct complex color casts or achieve specific color grading effects.
For regular users, like myself, despite not being the simplest option, I still find this method pretty straightforward to use.
But ultimately it is up to you guys! We can change it if needed :)

[Warchamp7]

I'm wondering if this makes sense as part of the color correction filter or if it should be a separate filter of it's own.

[mar10iana]

I'm wondering if this makes sense as part of the color correction filter or if it should be a separate filter of it's own.

White balance is usually under the color correction tab on photo and video editing programs such as Adobe Photoshop, After Effects, and others. Our decision was based on this and the fact that changing the white balance is color correcting the image.

[Fenrirthviti]

Just putting my vote that I agree on the above. I've actually several times added an OBS color correction filter mistakenly thinking it had white balance in the past, heh. I think it's a common enough paradigm that users would expect to find it there.

[Warchamp7]

Gonna stick to my original feedback here. I think it is fine to keep the 3 channels for the options but I think this should be moved into a new separate White Balance Filter option instead of crowding the Color Correction one even further.

This will also allow better control for whether to white balance before or after a Color Correction filter, for example.

[Warchamp7]

Create a separate White Balance filter for this functionality instead

[mar10iana]

Create a separate White Balance filter for this functionality instead

I will do it this weekend, thank you.

[mar10iana]

I will create a new branch and a new pull request

[mar10iana]

Create a separate White Balance filter for this functionality instead

Sorry for making another PR instead of updating the last one, but this way was just easier for me.
#11850