
-evaluate Add 10 adds ten channel quantum units, not ten percent brightness. ImageMagick defines QuantumRange as installation-dependent and documents a percent suffix for values expressed as a fraction of that range. A script moved between Q8 and Q16 builds can therefore change its relative effect without changing the written number.
State the intended unit
Decide whether the requirement is an absolute code-value adjustment in a known representation or a fraction of the available channel range. These are different contracts.
For a conventional Q8 range of 255, ten units are about 3.92% of the range. For Q16's 65535, ten units are about 0.0153%. These are illustrative ratios, not measured image changes or perceptual brightness predictions.
Express a range-relative value explicitly
A proposed POSIX-shell example is:
magick input.png -evaluate Add '10%' adjusted.png
The quoted percent value requests ten percent of QuantumRange. It does not mean a ten-percent increase relative to each pixel's previous value. Multiply is a different arithmetic operation.
This example has not been executed. Confirm the installed ImageMagick 7 build and actual shell. When translating the command to a Windows batch file, account for that shell's handling of percent signs instead of copying POSIX quoting blindly.
Hold the other arithmetic conditions fixed
Compare the same input, colorspace and channel selection. Numeric addition in one colorspace is not necessarily equivalent to addition in another. If only a chosen channel should change, state that channel scope explicitly rather than treating a build-depth comparison as a global appearance test.
The coordinate-unit guide illustrates a separate absolute-versus-relative decision. Here the denominator is channel QuantumRange, not canvas width or height.
Inspect the result near the range limits
An addition can push high values beyond the intended range. The evaluate documentation describes clipping where necessary; a visually flat highlight is not evidence that the percentage calculation failed. Verify behavior for the actual build and chosen output representation rather than claiming HDRI and integer pipelines are interchangeable.
Record the operation and units with the output. The luma-statistics guide shows why a measurement still needs interpretation. This task establishes portable arithmetic intent; it does not promise equal perceived brightness, recover clipped detail or report a performed conversion.
Related tasks
- How to Keep a ComfyUI Conditioning Area in the Same Relative Place After Resizing
- How to Compare FFmpeg signalstats Luma Readings Without Treating Them as a Quality Score
Sources and scope
- ImageMagick 7 option reference: evaluate: Bare Add operates in channel quantum units; percent values scale to installation-dependent QuantumRange.
Documentation-based ImageMagick 7 guidance checked against official pages captured October 23, 2026. Examples and inspections are proposed, not performed. Confirm the installed build, coder support and actual shell before use.
Prepared by Imagild Editorial, the company editorial team responsible for these guides. AI assisted research and drafting. This is documentation-based guidance with proposed examples, not a claim of hands-on testing or an independent product review. Report a correction.
Cover: Pignatta / Pixabay, Pixabay Content License. This is an illustrative source photograph, not an application screenshot or a generated test result.