Skip to content

Add clarification for auto-calculate white channel option #249

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Add clarification for auto-calculate white channel option #249

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/features/cct.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Accurate | This mode subtracts the calculated white value from the RGB channels.
Brighter | This does the exact opposite and not touch the RGB channels at all, just mix in the dedicated white.
None | No auto white calculation is performed. The white channel of colors can be manually set using the `White channel` slider in the user interface, RGB-only effects and most realtime sources will leave the white channel off.
Dual | The `White channel` slider is present in the UI and works the same as in `None` mode, however if the slider value is 0 (far left), the `Brighter` mode is used for auto white calculation. This is the default auto white mode.
Max | Sets white to the value of the brightest RGB channel. This is good for white-only LEDs without any RGB.
Max | Sets white to the value of the brightest RGB channel. This is good for white-only LEDs without any RGB, however note that using any value other than "None" will cause the light to be treated as having RGB channels, so the color picker will show in the web UI.
Copy link
Collaborator

@blazoncek blazoncek Mar 24, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is true for any mode, not just Max. Perhaps move it out of the spreadsheet.

Copy link
Contributor Author

@marcone marcone Mar 24, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is true for any mode, not just Max. Perhaps move it out of the spreadsheet.

I mentioned this here because "Max" is the only option where it specifically says that it is "good for white-only LEDs". Or are you saying that the part about it being good for white-only LEDs should be removed?

Copy link
Collaborator

@blazoncek blazoncek Mar 24, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You seem obsessed with "white only". 😄 Sorry, no offense intended.
Any option is good (or possible) for "white only", depending on what you need or want (or what your external devices expect, yes don't forget that).
I'm saying that choosing anything but "None" will treat your output as RGB and not RGBW or W.

Copy link
Contributor Author

@marcone marcone Mar 24, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You seem obsessed with "white only". 😄 Sorry, no offense intended.

i'm just trying to understand. As a new user, it is confusing to me to see a full RGB color picker when I only have plain white LEDs connected, have set all the outputs to be white, and chosen the white handling option that is documented to be good for white-only LEDs. I can't imagine I'm the only person in the whole world who is confused by this, so I'm trying to figure it out and hopefully update the documentation so it's more clear to other new users.

Copy link
Contributor Author

@marcone marcone Mar 24, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What further adds to the confusion is that if I set the first 3 outputs to "None" and the 4th output to "Max", I don't get the color wheel, but if I set any of the other outputs to "Max" then I do get the color wheel. That seems like an actual bug to me. This is with the build you asked me to try the other day though, so maybe it's related to that. I can try one of the stable builds if you want.

Copy link
Collaborator

@blazoncek blazoncek Mar 24, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The UI adapts to the main segment. Any segment can be main and it is distinguished by a lighter gray in UI. Also affecting UI are selected segments (the ones with checkmark).

Copy link
Contributor Author

@marcone marcone Mar 24, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I only have one segment, which contains all 4 outputs.

Copy link
Collaborator

@blazoncek blazoncek Mar 24, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Then you have your answer. If one of the outputs is RGB (as when Auto white is enabled) UI will respond as segment being RGBW, separate outputs into segments and you'll have control individually.
You can automatically create segments from outputs using selection box in settings.

Please continue discussion either on forum or on Discord.

Copy link
Contributor Author

@marcone marcone Mar 24, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Then you have your answer

No. Perhaps I didn't explain myself well. I have 4 outputs, all in the same segment, all "PWM White". If I set the "Auto-calculate W channel from RGB" option for each of them like so:

0 : None
1 : None
2 : None
3 : Max

then I don't see the color wheel in the color tab, but if I set them e.g. like so:

0 : None
1 : None
2 : Max
3 : None

then I do see the color wheel. Again, all 4 outputs are in the same segment, and I have only one segment.


`Accurate` and `Brighter` methods are applied on a per-pixel basis, so they also work in color palettes and realtime effects!

Expand Down Expand Up @@ -64,4 +64,4 @@ If your hardware uses an IC that controls the color temperature based on one PWM

#### CCT in the JSON API

Please see [here](/interfaces/json-api/#cct-control) for more info on how to handle WLED CCT from integrations.
Please see [here](/interfaces/json-api/#cct-control) for more info on how to handle WLED CCT from integrations.