IconConversionMode

Conversion mode for icon images, when an exact match is not available for the requested size and color depth.

Values

NameDescription
Closest

Finds the closest match to the requested size and color depth, and returns the image unaltered. The caller must be capable of using an image that doesn't match what was requested.

Resize

Finds the closest match to the requested size and color depth, and resizes and/or modifies the color depth to match what was requested.

Exact

Returns only an exact match. If an exact match cannot be found, a 404 (Not Found) status code is returned.

SameResolutionLowerColorDepth

Returns any found image with the requested resolution (height and width) as long it is has the same or lower color depth than what was requested. The image color depth is increased to match what was requested. This conversion is guaranteed not to change image fidelity.

If no image can be found with the same resolution, and the same-or-lower color depth, a 404 (Not Found) status code is returned.