1
0
mirror of https://github.com/microsoft/DirectXTex synced 2024-11-23 13:00:06 +00:00

Updated WIC I O Functions (markdown)

Chuck Walbourn 2018-12-07 15:50:39 -08:00
parent c1ff6174ac
commit 2b5e31570b

@ -171,7 +171,14 @@ if ( FAILED(hr) )
* ``WIC_FLAGS_ALL_FRAMES`` By default, only the first frame of a multi-frame file is loaded. If this flag is provided, all frames are loaded and resized to match the size of the first image to fit the DirectXTex requirements for a 2D array.
## Color space
* `` WIC_FLAGS_IGNORE_SRGB`` While there is no explicit 'sRGB' pixel format defined for WIC, the load function will check for known metadata tags and may return ``DXGI_FORMAT_*_SRGB`` formats if there are equivalents of the same size and channel configuration available. If this flag is specified, any 'sRGB' metadata is ignored instead.
* `` WIC_FLAGS_IGNORE_SRGB`` While there is no explicit 'sRGB' pixel format defined for WIC, the load function will check for known metadata tags and may return ``DXGI_FORMAT_*_SRGB`` formats if there are equivalents of the same size and
channel configuration available. If this flag is specified, any 'sRGB' metadata is ignored instead.
* ``WIC_FLAGS_FORCE_SRGB`` When writing a file, the ``DXGI_*_SRGB`` formats are used to indicate the need to write with 'sRGB' metadata. If this flag is specified, 'sRGB' metadata is always written even if the input format is not explicitly an ``DXGI_*_SRGB`` format.
* ``WIC_FLAGS_FORCE_LINEAR`` When writing a file, if the type is not a ``DXGI_*_SRGB`` format, then metadata for a gamma of 1.0 is written to indicate the file is in linear color space. If this flag is specified, 1.0 gamma metadata is always written even if the input format is a ``DXGI_*_SRGB`` format.
> Note these flags apply to the JPEG, TIFF, and PNG container file formats.
## Dithering
These flags control the use of dithering for image conversions. It defaults to 'no' dithering.