
Choose -sparse-color Voronoi when each pixel should take the color of its nearest supplied control point. That produces solid nearest-point cells rather than a smooth blended gradient. Other sparse-color methods interpolate between points, so matching the point list alone does not establish the intended result.
Decide between regions and interpolation
ImageMagick documents barycentric as a triangle-based color gradient with three points, or a linear gradient with two. The generated gradient can extend beyond that triangle. Its shepards and inverse methods weight colors by distance.
Voronoi instead assigns a solid color according to the nearest point. This makes it useful for a deliberately synthetic region map or color-cell illustration. It does not identify objects, cluster a photograph's existing colors or infer semantic boundaries.
Define the canvas and points together
Write each control point's coordinates and assigned color. Check the image's virtual-canvas offset before deciding where those coordinates lie: the documentation places sparse-color points according to the image's location on that virtual canvas.
Points may lie beyond the raster edge and can use floating-point coordinates. An apparently missing point is therefore not necessarily an invalid input; it may influence the available raster from outside its bounds.
If a preview was scaled, use the source-coordinate mapping guide before recording positions. Copying thumbnail coordinates changes the intended cell boundaries.
Apply the method to a working image
Choose the output dimensions, prepare the point list and apply the documented Voronoi method in the installed ImageMagick 7 build. Use distinct colors while establishing the regions so the boundaries are easy to inspect, then choose the required final palette.
The method changes selected color channels. Alpha is a separate consideration: the manual warns that the default color-channel behavior does not automatically alter transparency. A transparent starting raster can conceal a correctly computed color map unless alpha handling is deliberately resolved.
Inspect boundaries rather than judging photographic similarity
Check which control point owns pixels near a boundary and whether a virtual-canvas offset shifted the expected arrangement. Confirm that the required output contains solid cells, not distance-weighted transitions.
The reference color-matching guide solves a different problem. This guide creates a new point-defined map; it does not match a photograph's appearance. The procedure is based on documentation, with no generated example, benchmark or performed conversion claimed.
Related tasks
- Why Does My Image Edit Land in the Wrong Place When I Copy Preview Coordinates?
- Photoshop Match Color: Use the Reference Layer or the Whole Composite?
Sources and scope
- ImageMagick 7 option reference: sparse-color: Voronoi maps each pixel to its nearest color point; barycentric and inverse-distance methods interpolate, and point positions follow virtual-canvas offsets.
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: Mariya Eskina / Pexels, Pexels License. This is an illustrative source photograph, not an application screenshot or a generated test result.