OutOfRangeSampleHandling Enum

Namespace: Meziantou.Framework.Imaging
Assembly: Meziantou.Framework.Imaging.dll
Package: Meziantou.Framework.Imaging 1.2.11
Available in package assets: net10.0net11.0

Selects what happens to the floating-point samples (RgbaFloat, RgbaHalf) that a narrower pixel format cannot store: the samples outside [0, 1] of an integer format, and the finite samples beyond the range of Half (±65,504).

public enum OutOfRangeSampleHandling

Remarks

Samples that are not numbers are always rejected: no policy gives them a value.

Fields

Name	Value	Description
`Reject`	`0`	The conversion throws an `UnsupportedImageFeatureException` before anything is written. This is the default.
`Clip`	`1`	Each sample is clipped to the range of the destination: [0, 1] for an integer format (infinities included), ±65,504 for `RgbaHalf` (infinities are kept). Clipping a color component changes its hue: tone mapping (`PixelConversionOptions.ToneMapping`) keeps it.