Purpose: Scales the image data between selectable black and white points. This tool has three modes:
A configuration file parameter (tool.blackwhitepoint.auto) is available to make this tool do an automatic adjustment when you add it. The algorithm is based on walking each end of the histogram until a value greater than or equal to a set percentage of the largest "tone bucket", default is 5% (0.05). The separate black and white thresholds are configurable, if you find one or both to consistently clip out data you want to retain. You can also simply just slide the sliders to where you want after auto does it's thing. Note that "auto" is not the saved parameter, rather the result parameters are in the command line applied to the saved image
The ReCalculate checkbox enables automatic re-calculation of the auto-calculated black and white points whenever the tool is re-processed. This is useful if upstream tools are added or modified. Note that, if you've set the points manually, checking this box will do away with those settings replace them with auto-calculated settings.
Black/White Point is applied to all three channels by default, but can be applied to a single channel using the drop-down selector.
The left-hand graphic is the tool parameters pane. The right-hand graphic illustrates the equivalent operation applied by a curve.
![]() | ![]() |
Properties: See tool.blackwhitepoint.* in Configuration Properties