include/wincodec.idl

   1 /*
   2  * Copyright 2009 Vincent Povirk for CodeWeavers
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2.1 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  17  */
  18
  19 import "wtypes.idl";
  20 import "propidl.idl";
  21 import "objidl.idl";
  22 import "ocidl.idl";
  23
  24 cpp_quote("#define WINCODEC_SDK_VERSION 0x0236")
  25
  26 #define CODEC_FORCE_DWORD 0x7fffffff
  27
  28 typedef enum WICDecodeOptions {
  29     WICDecodeMetadataCacheOnDemand = 0x00000000,
  30     WICDecodeMetadataCacheOnLoad = 0x00000001,
  31     WICMETADATACACHEOPTION_FORCE_DWORD = CODEC_FORCE_DWORD
  32 } WICDecodeOptions;
  33
  34 typedef enum WICBitmapCreateCacheOption {
  35     WICBitmapNoCache = 0x00000000,
  36     WICBitmapCacheOnDemand = 0x00000001,
  37     WICBitmapCacheOnLoad = 0x00000002,
  38     WICBITMAPCREATECACHEOPTION_FORCE_DWORD = CODEC_FORCE_DWORD
  39 } WICBitmapCreateCacheOption;
  40
  41 typedef enum WICBitmapAlphaChannelOption {
  42     WICBitmapUseAlpha = 0x00000000,
  43     WICBitmapUsePremultipliedAlpha = 0x00000001,
  44     WICBitmapIgnoreAlpha = 0x00000002,
  45     WICBITMAPALPHACHANNELOPTIONS_FORCE_DWORD = CODEC_FORCE_DWORD
  46 } WICBitmapAlphaChannelOption;
  47
  48 typedef enum WICBitmapDecoderCapabilities {
  49     WICBitmapDecoderCapabilitySameEncoder = 0x00000001,
  50     WICBitmapDecoderCapabilityCanDecodeAllImages = 0x00000002,
  51     WICBitmapDecoderCapabilityCanDecodeSomeImages = 0x00000004,
  52     WICBitmapDecoderCapabilityCanEnumerateMetadata = 0x00000008,
  53     WICBitmapDecoderCapabilityCanDecodeThumbnail = 0x00000010,
  54 } WICBitmapDecoderCapabilities;
  55
  56 typedef enum WICBitmapDitherType {
  57     WICBitmapDitherTypeNone = 0x00000000,
  58     WICBitmapDitherTypeSolid = 0x00000000,
  59     WICBitmapDitherTypeOrdered4x4 = 0x00000001,
  60     WICBitmapDitherTypeOrdered8x8 = 0x00000002,
  61     WICBitmapDitherTypeOrdered16x16 = 0x00000003,
  62     WICBitmapDitherTypeSpiral4x4 = 0x00000004,
  63     WICBitmapDitherTypeSpiral8x8 = 0x00000005,
  64     WICBitmapDitherTypeDualSpiral4x4 = 0x00000006,
  65     WICBitmapDitherTypeDualSpiral8x8 = 0x00000007,
  66     WICBitmapDitherTypeErrorDiffusion = 0x00000008,
  67     WICBITMAPDITHERTYPE_FORCE_DWORD = CODEC_FORCE_DWORD
  68 } WICBitmapDitherType;
  69
  70 typedef enum WICBitmapEncoderCacheOption {
  71     WICBitmapEncoderCacheInMemory = 0x00000000,
  72     WICBitmapEncoderCacheTempFile = 0x00000001,
  73     WICBitmapEncoderNoCache = 0x00000002,
  74     WICBITMAPENCODERCACHEOPTION_FORCE_DWORD = CODEC_FORCE_DWORD
  75 } WICBitmapEncoderCacheOption;
  76
  77 typedef enum WICBitmapInterpolationMode {
  78     WICBitmapInterpolationModeNearestNeighbor = 0x00000000,
  79     WICBitmapInterpolationModeLinear = 0x00000001,
  80     WICBitmapInterpolationModeCubic = 0x00000002,
  81     WICBitmapInterpolationModeFant = 0x00000003,
  82     WICBITMAPINTERPOLATIONMODE_FORCE_DWORD = CODEC_FORCE_DWORD
  83 } WICBitmapInterpolationMode;
  84
  85 typedef enum WICBitmapPaletteType {
  86     WICBitmapPaletteTypeCustom = 0x00000000,
  87     WICBitmapPaletteTypeMedianCut = 0x00000001,
  88     WICBitmapPaletteTypeFixedBW = 0x00000002,
  89     WICBitmapPaletteTypeFixedHalftone8 = 0x00000003,
  90     WICBitmapPaletteTypeFixedHalftone27 = 0x00000004,
  91     WICBitmapPaletteTypeFixedHalftone64 = 0x00000005,
  92     WICBitmapPaletteTypeFixedHalftone125 = 0x00000006,
  93     WICBitmapPaletteTypeFixedHalftone216 = 0x00000007,
  94     WICBitmapPaletteTypeFixedWebPalette = WICBitmapPaletteTypeFixedHalftone216,
  95     WICBitmapPaletteTypeFixedHalftone252 = 0x00000008,
  96     WICBitmapPaletteTypeFixedHalftone256 = 0x00000009,
  97     WICBitmapPaletteTypeFixedGray4 = 0x0000000A,
  98     WICBitmapPaletteTypeFixedGray16 = 0x0000000B,
  99     WICBitmapPaletteTypeFixedGray256 = 0x0000000C,
 100     WICBITMAPPALETTETYPE_FORCE_DWORD = CODEC_FORCE_DWORD
 101 } WICBitmapPaletteType;
 102
 103 typedef enum WICBitmapTransformOptions {
 104     WICBitmapTransformRotate0 = 0x00000000,
 105     WICBitmapTransformRotate90 = 0x00000001,
 106     WICBitmapTransformRotate180 = 0x00000002,
 107     WICBitmapTransformRotate270 = 0x00000003,
 108     WICBitmapTransformFlipHorizontal = 0x00000008,
 109     WICBitmapTransformFlipVertical = 0x00000010,
 110     WICBITMAPTRANSFORMOPTIONS_FORCE_DWORD = CODEC_FORCE_DWORD
 111 } WICBitmapTransformOptions;
 112
 113 typedef enum WICColorContextType {
 114     WICColorContextUninitialized = 0x00000000,
 115     WICColorContextProfile = 0x00000001,
 116     WICColorContextExifColorSpace = 0x00000002
 117 } WICColorContextType;
 118
 119 typedef enum WICComponentType {
 120     WICDecoder = 0x00000001,
 121     WICEncoder = 0x00000002,
 122     WICPixelFormatConverter = 0x00000004,
 123     WICMetadataReader = 0x00000008,
 124     WICMetadataWriter = 0x00000010,
 125     WICPixelFormat = 0x00000020,
 126     WICCOMPONENTTYPE_FORCE_DWORD = CODEC_FORCE_DWORD
 127 } WICComponentType;
 128
 129 typedef enum WICComponentSigning {
 130     WICComponentSigned = 0x00000001,
 131     WICComponentUnsigned = 0x00000002,
 132     WICComponentSafe = 0x00000004,
 133     WICComponentDisabled = 0x80000000
 134 } WICComponentSigning;
 135
 136 typedef enum WICComponentEnumerateOptions {
 137     WICComponentEnumerateDefault = 0x00000000,
 138     WICComponentEnumerateRefresh = 0x00000001,
 139     WICComponentEnumerateBuiltInOnly = 0x20000000,
 140     WICComponentEnumerateUnsigned = 0x40000000,
 141     WICComponentEnumerateDisabled = 0x80000000
 142 } WICComponentEnumerateOptions;
 143
 144 typedef GUID WICPixelFormatGUID;
 145 typedef REFGUID REFWICPixelFormatGUID;
 146
 147 cpp_quote("DEFINE_GUID(GUID_WICPixelFormatDontCare, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x00);")
 148 cpp_quote("#define GUID_WICPixelFormatUndefined GUID_WICPixelFormatDontCare")
 149
 150 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat1bppIndexed, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x01);")
 151 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat2bppIndexed, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x02);")
 152 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat4bppIndexed, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x03);")
 153 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat8bppIndexed, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x04);")
 154
 155 cpp_quote("DEFINE_GUID(GUID_WICPixelFormatBlackWhite, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x05);")
 156 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat2bppGray, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x06);")
 157 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat4bppGray, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x07);")
 158 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat8bppGray, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x08);")
 159 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat16bppGray, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x0b);")
 160
 161 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat16bppBGR555, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x09);")
 162 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat16bppBGR565, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x0a);")
 163 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat16bppBGRA5551, 0x05ec7c2b,0xf1e6,0x4961,0xad,0x46,0xe1,0xcc,0x81,0x0a,0x87,0xd2);")
 164 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat24bppBGR, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x0c);")
 165 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat32bppBGR, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x0e);")
 166 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat32bppBGRA, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x0f);")
 167 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat32bppPBGRA, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x10);")
 168
 169 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat48bppRGB, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x15);")
 170 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat64bppRGBA, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x16);")
 171 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat64bppPRGBA, 0x6fddc324,0x4e03,0x4bfe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x17);")
 172
 173 cpp_quote("DEFINE_GUID(GUID_WICPixelFormat32bppCMYK, 0x6fddc324,0x4e03,0x4fbe,0xb1,0x85,0x3d,0x77,0x76,0x8d,0xc9,0x1c);")
 174
 175 typedef struct WICRect {
 176     INT X;
 177     INT Y;
 178     INT Width;
 179     INT Height;
 180 } WICRect;
 181
 182 typedef struct WICBitmapPattern {
 183     ULARGE_INTEGER Position;
 184     ULONG Length;
 185     BYTE *Pattern;
 186     BYTE *Mask;
 187     BOOL EndOfStream;
 188 } WICBitmapPattern;
 189
 190 typedef UINT32 WICColor;
 191
 192 cpp_quote("#define WINCODEC_ERR_WRONGSTATE 0x88982f04")
 193 cpp_quote("#define WINCODEC_ERR_VALUEOUTOFRANGE 0x88982f05")
 194 cpp_quote("#define WINCODEC_ERR_NOTINITIALIZED 0x88982f0c")
 195 cpp_quote("#define WINCODEC_ERR_PROPERTYNOTFOUND 0x88982f40")
 196 cpp_quote("#define WINCODEC_ERR_CODECNOTHUMBNAIL 0x88982f44")
 197 cpp_quote("#define WINCODEC_ERR_PALETTEUNAVAILABLE 0x88982f45")
 198 cpp_quote("#define WINCODEC_ERR_COMPONENTNOTFOUND 0x88982f50")
 199 cpp_quote("#define WINCODEC_ERR_FRAMEMISSING 0x88982f62")
 200 cpp_quote("#define WINCODEC_ERR_UNSUPPORTEDPIXELFORMAT 0x88982f80")
 201 cpp_quote("#define WINCODEC_ERR_UNSUPPORTEDOPERATION 0x88982f81")
 202 cpp_quote("#define WINCODEC_ERR_INSUFFICIENTBUFFER 0x88982f8c")
 203
 204 interface IWICPalette;
 205
 206 [
 207     object,
 208     uuid(3c613a02-34b2-44ea-9a7c-45aea9c6fd6d)
 209 ]
 210 interface IWICColorContext : IUnknown
 211 {
 212     HRESULT InitializeFromFilename(
 213         [in] LPCWSTR wzFilename);
 214
 215     HRESULT InitializeFromMemory(
 216         [in, size_is(cbBufferSize)] const BYTE *pbBuffer,
 217         [in] UINT cbBufferSize);
 218
 219     HRESULT InitializeFromExifColorSpace(
 220         [in] UINT value);
 221
 222     HRESULT GetType(
 223         [out] WICColorContextType *pType);
 224
 225     HRESULT GetProfileBytes(
 226         [in] UINT cbBuffer,
 227         [in, out, unique, size_is(cbBuffer)] BYTE *pbBuffer,
 228         [out] UINT *pcbActual);
 229
 230     HRESULT GetExifColorSpace(
 231         [out] UINT *pValue);
 232 }
 233
 234 [
 235     object,
 236     uuid(00000120-a8f2-4877-ba0a-fd2b6645fb94)
 237 ]
 238 interface IWICBitmapSource : IUnknown
 239 {
 240     HRESULT GetSize(
 241         [out] UINT *puiWidth,
 242         [out] UINT *puiHeight);
 243
 244     HRESULT GetPixelFormat(
 245         [out] WICPixelFormatGUID *pPixelFormat);
 246
 247     HRESULT GetResolution(
 248         [out] double *pDpiX,
 249         [out] double *pDpiY);
 250
 251     HRESULT CopyPalette(
 252         [in] IWICPalette *pIPalette);
 253
 254     HRESULT CopyPixels(
 255         [in] const WICRect *prc,
 256         [in] UINT cbStride,
 257         [in] UINT cbBufferSize,
 258         [out, size_is(cbBufferSize)] BYTE *pbBuffer);
 259 }
 260
 261 [
 262     object,
 263     uuid(00000123-a8f2-4877-ba0a-fd2b6645fb94)
 264 ]
 265 interface IWICBitmapLock : IUnknown
 266 {
 267     HRESULT GetSize(
 268         [out] UINT *pWidth,
 269         [out] UINT *pHeight);
 270
 271     HRESULT GetStride(
 272         [out] UINT *pcbStride);
 273
 274     HRESULT GetDataPointer(
 275         [out] UINT *pcbBufferSize,
 276         [out, size_is(,*pcbBufferSize)] BYTE **ppbData);
 277
 278     HRESULT GetPixelFormat(
 279         [out] WICPixelFormatGUID *pPixelFormat);
 280 }
 281
 282 [
 283     object,
 284     uuid(5009834f-2d6a-41ce-9e1b-17c5aff7a782)
 285 ]
 286 interface IWICBitmapFlipRotator : IWICBitmapSource
 287 {
 288     HRESULT Initialize(
 289         [in] IWICBitmapSource *pISource,
 290         [in] WICBitmapTransformOptions options);
 291 }
 292
 293 [
 294     object,
 295     uuid(00000121-a8f2-4877-ba0a-fd2b6645fb94)
 296 ]
 297 interface IWICBitmap : IWICBitmapSource
 298 {
 299     HRESULT Lock(
 300         [in] const WICRect *prcLock,
 301         [in] DWORD flags,
 302         [out] IWICBitmapLock **ppILock);
 303
 304     HRESULT SetPalette(
 305         [in] IWICPalette *pIPalette);
 306
 307     HRESULT SetResolution(
 308         [in] double dpiX,
 309         [in] double dpiY);
 310 }
 311
 312 [
 313     object,
 314     uuid(00000040-a8f2-4877-ba0a-fd2b6645fb94)
 315 ]
 316 interface IWICPalette : IUnknown
 317 {
 318     HRESULT InitializePredefined(
 319         [in] WICBitmapPaletteType ePaletteType,
 320         [in] BOOL fAddTransparentColor);
 321
 322     HRESULT InitializeCustom(
 323         [in, size_is(colorCount)] WICColor *pColors,
 324         [in] UINT colorCount);
 325
 326     HRESULT InitializeFromBitmap(
 327         [in] IWICBitmapSource *pISurface,
 328         [in] UINT colorCount,
 329         [in] BOOL fAddTransparentColor);
 330
 331     HRESULT InitializeFromPalette(
 332         [in] IWICPalette *pIPalette);
 333
 334     HRESULT GetType(
 335         [out] WICBitmapPaletteType *pePaletteType);
 336
 337     HRESULT GetColorCount(
 338         [out] UINT *pcCount);
 339
 340     HRESULT GetColors(
 341         [in] UINT colorCount,
 342         [out, size_is(colorCount)] WICColor *pColors,
 343         [out] UINT *pcActualColors);
 344
 345     HRESULT IsBlackWhite(
 346         [out] BOOL *pfIsBlackWhite);
 347
 348     HRESULT IsGrayscale(
 349         [out] BOOL *pfIsGrayscale);
 350
 351     HRESULT HasAlpha(
 352         [out] BOOL *pfHasAlpha);
 353 }
 354
 355 [
 356     object,
 357     uuid(23bc3f0a-698b-4357-886b-f24d50671334)
 358 ]
 359 interface IWICComponentInfo : IUnknown
 360 {
 361     HRESULT GetComponentType(
 362         [out] WICComponentType *pType);
 363
 364     HRESULT GetCLSID(
 365         [out] CLSID *pclsid);
 366
 367     HRESULT GetSigningStatus(
 368         [out] DWORD *pStatus);
 369
 370     HRESULT GetAuthor(
 371         [in] UINT cchAuthor,
 372         [in, out, unique, size_is(cchAuthor)] WCHAR *wzAuthor,
 373         [out] UINT *pcchActual);
 374
 375     HRESULT GetVendorGUID(
 376         [out] GUID *pguidVendor);
 377
 378     HRESULT GetVersion(
 379         [in] UINT cchVersion,
 380         [in, out, unique, size_is(cchVersion)] WCHAR *wzVersion,
 381         [out] UINT *pcchActual);
 382
 383     HRESULT GetSpecVersion(
 384         [in] UINT cchSpecVersion,
 385         [in, out, unique, size_is(cchSpecVersion)] WCHAR *wzSpecVersion,
 386         [out] UINT *pcchActual);
 387
 388     HRESULT GetFriendlyName(
 389         [in] UINT cchFriendlyName,
 390         [in, out, unique, size_is(cchFriendlyName)] WCHAR *wzFriendlyName,
 391         [out] UINT *pcchActual);
 392 }
 393
 394 [
 395     object,
 396     uuid(30989668-e1c9-4597-b395-458eedb808df)
 397 ]
 398 interface IWICMetadataQueryReader : IUnknown
 399 {
 400     HRESULT GetContainerFormat(
 401         [out] GUID *pguidContainerFormat);
 402
 403     HRESULT GetLocation(
 404         [in] UINT cchMaxLength,
 405         [in, out, unique, size_is(cchMaxLength)] WCHAR *wzNamespace,
 406         [out] UINT *pcchActualLength);
 407
 408     HRESULT GetMetadataByName(
 409         [in] LPCWSTR wzName,
 410         [in, out, unique] PROPVARIANT *pvarValue);
 411
 412     HRESULT GetEnumerator(
 413         [out] IEnumString **ppIEnumString);
 414 }
 415
 416 [
 417     object,
 418     uuid(a721791a-0def-4d06-bd91-2118bf1db10b)
 419 ]
 420 interface IWICMetadataQueryWriter : IWICMetadataQueryReader
 421 {
 422     HRESULT SetMetadataByName(
 423         [in] LPCWSTR wzName,
 424         [in] const PROPVARIANT *pvarValue);
 425
 426     HRESULT RemoveMetadataByName(
 427         [in] LPCWSTR wzName);
 428 }
 429
 430 [
 431     object,
 432     uuid(3b16811b-6a43-4ec9-a813-3d930c13b940)
 433 ]
 434 interface IWICBitmapFrameDecode : IWICBitmapSource
 435 {
 436     HRESULT GetMetadataQueryReader(
 437         [out] IWICMetadataQueryReader **ppIMetadataQueryReader);
 438
 439     HRESULT GetColorContexts(
 440         [in] UINT cCount,
 441         [in, out, unique, size_is(cCount)] IWICColorContext **ppIColorContexts,
 442         [out] UINT *pcActualCount);
 443
 444     HRESULT GetThumbnail(
 445         [out] IWICBitmapSource **ppIThumbnail);
 446 }
 447
 448 [
 449     object,
 450     uuid(e87a44c4-b76e-4c47-8b09-298eb12a2714)
 451 ]
 452 interface IWICBitmapCodecInfo : IWICComponentInfo
 453 {
 454     HRESULT GetContainerFormat(
 455         [out] GUID *pguidContainerFormat);
 456
 457     HRESULT GetPixelFormats(
 458         [in] UINT cFormats,
 459         [in, out, unique, size_is(cFormats)] GUID *pguidPixelFormats,
 460         [out] UINT *pcActual);
 461
 462     HRESULT GetColorManagementVersion(
 463         [in] UINT cchColorManagementVersion,
 464         [in, out, unique, size_is(cchColorManagementVersion)] WCHAR *wzColorManagementVersion,
 465         [out] UINT *pcchActual);
 466
 467     HRESULT GetDeviceManufacturer(
 468         [in] UINT cchDeviceManufacturer,
 469         [in, out, unique, size_is(cchDeviceManufacturer)] WCHAR *wzDeviceManufacturer,
 470         [out] UINT *pcchActual);
 471
 472     HRESULT GetDeviceModels(
 473         [in] UINT cchDeviceModels,
 474         [in, out, unique, size_is(cchDeviceModels)] WCHAR *wzDeviceModels,
 475         [out] UINT *pcchActual);
 476
 477     HRESULT GetMimeTypes(
 478         [in] UINT cchMimeTypes,
 479         [in, out, unique, size_is(cchMimeTypes)] WCHAR *wzMimeTypes,
 480         [out] UINT *pcchActual);
 481
 482     HRESULT GetFileExtensions(
 483         [in] UINT cchFileExtensions,
 484         [in, out, unique, size_is(cchFileExtensions)] WCHAR *wzFileExtensions,
 485         [out] UINT *pcchActual);
 486
 487     HRESULT DoesSupportAnimation(
 488         [out] BOOL *pfSupportAnimation);
 489
 490     HRESULT DoesSupportChromaKey(
 491         [out] BOOL *pfSupportChromaKey);
 492
 493     HRESULT DoesSupportLossless(
 494         [out] BOOL *pfSupportLossless);
 495
 496     HRESULT DoesSupportMultiframe(
 497         [out] BOOL *pfSupportMultiframe);
 498
 499     HRESULT MatchesMimeType(
 500         [in] LPCWSTR wzMimeType,
 501         [out] BOOL *pfMatches);
 502 }
 503
 504 interface IWICBitmapDecoder;
 505
 506 [
 507     object,
 508     uuid(d8cd007f-d08f-4191-9bfc-236ea7f0e4b5)
 509 ]
 510 interface IWICBitmapDecoderInfo : IWICBitmapCodecInfo
 511 {
 512     [local]
 513     HRESULT GetPatterns(
 514         [in] UINT cbSizePatterns,
 515         [in, out, unique] WICBitmapPattern *pPatterns,
 516         [in, out, unique] UINT *pcPatterns,
 517         [in, out, unique] UINT *pcbPatternsActual);
 518
 519     HRESULT MatchesPattern(
 520         [in] IStream *pIStream,
 521         [out] BOOL *pfMatches);
 522
 523     HRESULT CreateInstance(
 524         [out] IWICBitmapDecoder **ppIBitmapDecoder);
 525 }
 526
 527 [
 528     object,
 529     uuid(9edde9e7-8dee-47ea-99df-e6faf2ed44bf)
 530 ]
 531 interface IWICBitmapDecoder : IUnknown
 532 {
 533     HRESULT QueryCapability(
 534         [in] IStream *pIStream,
 535         [out] DWORD *pdwCapability);
 536
 537     HRESULT Initialize(
 538         [in] IStream *pIStream,
 539         [in] WICDecodeOptions cacheOptions);
 540
 541     HRESULT GetContainerFormat(
 542         [out] GUID *pguidContainerFormat);
 543
 544     HRESULT GetDecoderInfo(
 545         [out] IWICBitmapDecoderInfo **ppIDecoderInfo);
 546
 547     HRESULT CopyPalette(
 548         [in] IWICPalette *pIPalette);
 549
 550     HRESULT GetMetadataQueryReader(
 551         [out] IWICMetadataQueryReader **ppIMetadataQueryReader);
 552
 553     HRESULT GetPreview(
 554         [out] IWICBitmapSource **ppIBitmapSource);
 555
 556     HRESULT GetColorContexts(
 557         [in] UINT cCount,
 558         [in, out, unique, size_is(cCount)] IWICColorContext **ppIColorContexts,
 559         [out] UINT *pcActualCount);
 560
 561     HRESULT GetThumbnail(
 562         [out] IWICBitmapSource **ppIThumbnail);
 563
 564     HRESULT GetFrameCount(
 565         [out] UINT *pCount);
 566
 567     HRESULT GetFrame(
 568         [in] UINT index,
 569         [out] IWICBitmapFrameDecode **ppIBitmapFrame);
 570 }
 571
 572 [
 573     object,
 574     uuid(00000105-a8f2-4877-ba0a-fd2b6645fb94)
 575 ]
 576 interface IWICBitmapFrameEncode : IUnknown
 577 {
 578     HRESULT Initialize(
 579         [in, unique] IPropertyBag2 *pIEncoderOptions);
 580
 581     HRESULT SetSize(
 582         [in] UINT uiWidth,
 583         [in] UINT uiHeight);
 584
 585     HRESULT SetResolution(
 586         [in] double dpiX,
 587         [in] double dpiY);
 588
 589     HRESULT SetPixelFormat(
 590         [in, out] WICPixelFormatGUID *pPixelFormat);
 591
 592     HRESULT SetColorContexts(
 593         [in] UINT cCount,
 594         [in, size_is(cCount)] IWICColorContext **ppIColorContext);
 595
 596     HRESULT SetPalette(
 597         [in] IWICPalette *pIPalette);
 598
 599     HRESULT SetThumbnail(
 600         [in] IWICBitmapSource *pIThumbnail);
 601
 602     HRESULT WritePixels(
 603         [in] UINT lineCount,
 604         [in] UINT cbStride,
 605         [in] UINT cbBufferSize,
 606         [in, size_is(cbBufferSize)] BYTE *pbPixels);
 607
 608     HRESULT WriteSource(
 609         [in] IWICBitmapSource *pIBitmapSource,
 610         [in, unique] WICRect *prc);
 611
 612     HRESULT Commit();
 613
 614     HRESULT GetMetadataQueryWriter(
 615         IWICMetadataQueryWriter **ppIMetadataQueryWriter);
 616 }
 617
 618 interface IWICBitmapEncoder;
 619
 620 [
 621     object,
 622     uuid(94c9b4ee-a09f-4f92-8a1e-4a9bce7e76fb)
 623 ]
 624 interface IWICBitmapEncoderInfo : IWICBitmapCodecInfo
 625 {
 626     HRESULT CreateInstance(
 627         [out] IWICBitmapEncoder **ppIBitmapEncoder);
 628 }
 629
 630 [
 631     object,
 632     uuid(00000103-a8f2-4877-ba0a-fd2b6645fb94)
 633 ]
 634 interface IWICBitmapEncoder : IUnknown
 635 {
 636     HRESULT Initialize(
 637         [in] IStream *pIStream,
 638         [in] WICBitmapEncoderCacheOption cacheOption);
 639
 640     HRESULT GetContainerFormat(
 641         [out] GUID *pguidContainerFormat);
 642
 643     HRESULT GetEncoderInfo(
 644         [out] IWICBitmapEncoderInfo **ppIEncoderInfo);
 645
 646     HRESULT SetColorContexts(
 647         [in] UINT cCount,
 648         [in, size_is(cCount)] IWICColorContext **ppIColorContext);
 649
 650     HRESULT SetPalette(
 651         [in] IWICPalette *pIPalette);
 652
 653     HRESULT SetThumbnail(
 654         [in] IWICBitmapSource *pIThumbnail);
 655
 656     HRESULT SetPreview(
 657         [in] IWICBitmapSource *pIPreview);
 658
 659     HRESULT CreateNewFrame(
 660         [out] IWICBitmapFrameEncode **ppIFrameEncode,
 661         [in, out, unique] IPropertyBag2 **ppIEncoderOptions);
 662
 663     HRESULT Commit();
 664
 665     HRESULT GetMetadataQueryWriter(
 666         [out] IWICMetadataQueryWriter **ppIMetadataQueryWriter);
 667 }
 668
 669 [
 670     object,
 671     uuid(00000301-a8f2-4877-ba0a-fd2b6645fb94)
 672 ]
 673 interface IWICFormatConverter : IWICBitmapSource
 674 {
 675     HRESULT Initialize(
 676         [in] IWICBitmapSource *pISource,
 677         [in] REFWICPixelFormatGUID dstFormat,
 678         [in] WICBitmapDitherType dither,
 679         [in] IWICPalette *pIPalette,
 680         [in] double alphaThresholdPercent,
 681         [in] WICBitmapPaletteType paletteTranslate);
 682
 683     HRESULT CanConvert(
 684         [in] REFWICPixelFormatGUID srcPixelFormat,
 685         [in] REFWICPixelFormatGUID dstPixelFormat,
 686         [out] BOOL *pfCanConvert);
 687 }
 688
 689 [
 690     object,
 691     uuid(9f34fb65-13f4-4f15-bc57-3726b5e53d9f)
 692 ]
 693 interface IWICFormatConverterInfo : IWICComponentInfo
 694 {
 695     HRESULT GetPixelFormats(
 696         [in] UINT cFormats,
 697         [in, out, size_is(cFormats)] WICPixelFormatGUID *pPixelFormatGUIDs,
 698         [out] UINT *pcActual);
 699
 700     HRESULT CreateInstance(
 701         [out] IWICFormatConverter **ppIConverter);
 702 }
 703
 704 [
 705     object,
 706     uuid(135ff860-22b7-4ddf-b0f6-218f4f299a43)
 707 ]
 708 interface IWICStream : IStream
 709 {
 710     HRESULT InitializeFromIStream(
 711         [in] IStream *pIStream);
 712
 713     HRESULT InitializeFromFilename(
 714         [in] LPCWSTR wzFileName,
 715         [in] DWORD dwAccessMode);
 716
 717     HRESULT InitializeFromMemory(
 718         [in, size_is(cbBufferSize)] BYTE *pbBuffer,
 719         [in] DWORD cbBufferSize);
 720
 721     HRESULT InitializeFromIStreamRegion(
 722         [in] IStream *pIStream,
 723         [in] ULARGE_INTEGER ulOffset,
 724         [in] ULARGE_INTEGER ulMaxSize);
 725 }
 726
 727 [
 728     object,
 729     uuid(00000302-a8f2-4877-ba0a-fd2b6645fb94)
 730 ]
 731 interface IWICBitmapScaler : IWICBitmapSource
 732 {
 733     HRESULT Initialize(
 734         [in] IWICBitmapSource *pISource,
 735         [in] UINT uiWidth,
 736         [in] UINT uiHeight,
 737         [in] WICBitmapInterpolationMode mode);
 738 }
 739
 740 [
 741     object,
 742     uuid(e4fbcf03-223d-4e81-9333-d635556dd1b5)
 743 ]
 744 interface IWICBitmapClipper : IWICBitmapSource
 745 {
 746     HRESULT Initialize(
 747         [in] IWICBitmapSource *pISource,
 748         [in] const WICRect *prc);
 749 }
 750
 751 [
 752     object,
 753     uuid(b66f034f-d0e2-40ab-b436-6de39e321a94)
 754 ]
 755 interface IWICColorTransform : IWICBitmapSource
 756 {
 757     HRESULT Initialize(
 758         [in] IWICBitmapSource *pIBitmapSource,
 759         [in] IWICColorContext *pIContextSource,
 760         [in] IWICColorContext *pIContextDest,
 761         [in] REFWICPixelFormatGUID pixelFmtDest);
 762 }
 763
 764 [
 765     object,
 766     uuid(b84e2c09-78c9-4ac4-8bd3-524ae1663a2f)
 767 ]
 768 interface IWICFastMetadataEncoder : IUnknown
 769 {
 770     HRESULT Commit();
 771
 772     HRESULT GetMetadataQueryWriter(
 773         [out] IWICMetadataQueryWriter **ppIMetadataQueryWriter);
 774 }
 775
 776 cpp_quote("DEFINE_GUID(CLSID_WICImagingFactory, 0xcacaf262,0x9370,0x4615,0xa1,0x3b,0x9f,0x55,0x39,0xda,0x4c,0x0a);")
 777
 778 [
 779     object,
 780     uuid(ec5ec8a9-c395-4314-9c77-54d7a935ff70)
 781 ]
 782 interface IWICImagingFactory : IUnknown
 783 {
 784     HRESULT CreateDecoderFromFilename(
 785         [in] LPCWSTR wzFilename,
 786         [in, unique] const GUID *pguidVendor,
 787         [in] DWORD dwDesiredAccess,
 788         [in] WICDecodeOptions metadataOptions,
 789         [out, retval] IWICBitmapDecoder **ppIDecoder);
 790
 791     HRESULT CreateDecoderFromStream(
 792         [in] IStream *pIStream,
 793         [in, unique] const GUID *pguidVendor,
 794         [in] WICDecodeOptions metadataOptions,
 795         [out, retval] IWICBitmapDecoder **ppIDecoder);
 796
 797     HRESULT CreateDecoderFromFileHandle(
 798         [in] ULONG_PTR hFile,
 799         [in, unique] const GUID *pguidVendor,
 800         [in] WICDecodeOptions metadataOptions,
 801         [out, retval] IWICBitmapDecoder **ppIDecoder);
 802
 803     HRESULT CreateComponentInfo(
 804         [in] REFCLSID clsidComponent,
 805         [out] IWICComponentInfo **ppIInfo);
 806
 807     HRESULT CreateDecoder(
 808         [in] REFGUID guidContainerFormat,
 809         [in, unique] const GUID *pguidVendor,
 810         [out, retval] IWICBitmapDecoder **ppIDecoder);
 811
 812     HRESULT CreateEncoder(
 813         [in] REFGUID guidContainerFormat,
 814         [in, unique] const GUID *pguidVendor,
 815         [out, retval] IWICBitmapEncoder **ppIEncoder);
 816
 817     HRESULT CreatePalette(
 818         [out] IWICPalette **ppIPalette);
 819
 820     HRESULT CreateFormatConverter(
 821         [out] IWICFormatConverter **ppIFormatConverter);
 822
 823     HRESULT CreateBitmapScaler(
 824         [out] IWICBitmapScaler **ppIBitmapScaler);
 825
 826     HRESULT CreateBitmapClipper(
 827         [out] IWICBitmapClipper **ppIBitmapClipper);
 828
 829     HRESULT CreateBitmapFlipRotator(
 830         [out] IWICBitmapFlipRotator **ppIBitmapFlipRotator);
 831
 832     HRESULT CreateStream(
 833         [out] IWICStream **ppIWICStream);
 834
 835     HRESULT CreateColorContext(
 836         [out] IWICColorContext **ppIWICColorContext);
 837
 838     HRESULT CreateColorTransformer(
 839         [out] IWICColorTransform **ppIWICColorTransform);
 840
 841     HRESULT CreateBitmap(
 842         [in] UINT uiWidth,
 843         [in] UINT uiHeight,
 844         [in] REFWICPixelFormatGUID pixelFormat,
 845         [in] WICBitmapCreateCacheOption option,
 846         [out] IWICBitmap **ppIBitmap);
 847
 848     HRESULT CreateBitmapFromSource(
 849         [in] IWICBitmapSource *piBitmapSource,
 850         [in] WICBitmapCreateCacheOption option,
 851         [out] IWICBitmap **ppIBitmap);
 852
 853     HRESULT CreateBitmapFromSourceRect(
 854         [in] IWICBitmapSource *piBitmapSource,
 855         [in] UINT x,
 856         [in] UINT y,
 857         [in] UINT width,
 858         [in] UINT height,
 859         [out] IWICBitmap **ppIBitmap);
 860
 861     HRESULT CreateBitmapFromMemory(
 862         [in] UINT uiWidth,
 863         [in] UINT uiHeight,
 864         [in] REFWICPixelFormatGUID pixelFormat,
 865         [in] UINT cbStride,
 866         [in] UINT cbBufferSize,
 867         [in, size_is(cbBufferSize)] BYTE *pbBuffer,
 868         [out] IWICBitmap **ppIBitmap);
 869
 870     HRESULT CreateBitmapFromHBITMAP(
 871         [in] HBITMAP hBitmap,
 872         [in, unique] HPALETTE hPalette,
 873         [in] WICBitmapAlphaChannelOption options,
 874         [out] IWICBitmap **ppIBitmap);
 875
 876     HRESULT CreateBitmapFromHICON(
 877         [in] HICON hIcon,
 878         [out] IWICBitmap **ppIBitmap);
 879
 880     HRESULT CreateComponentEnumerator(
 881         [in] DWORD componentTypes,
 882         [in] DWORD options,
 883         [out] IEnumUnknown **ppIEnumUnknown);
 884
 885     HRESULT CreateFastMetadataEncoderFromDecoder(
 886         [in] IWICBitmapDecoder *pIDecoder,
 887         [out] IWICFastMetadataEncoder **ppIFastEncoder);
 888
 889     HRESULT CreateFastMetadataEncoderFromFrameDecode(
 890         [in] IWICBitmapFrameDecode *pIFrameDecoder,
 891         [out] IWICFastMetadataEncoder **ppIFastEncoder);
 892
 893     HRESULT CreateQueryWriter(
 894         [in] REFGUID guidMetadataFormat,
 895         [in, unique] const GUID *pguidVendor,
 896         [out] IWICMetadataQueryWriter **ppIQueryWriter);
 897
 898     HRESULT CreateQueryWriterFromReader(
 899         [in] IWICMetadataQueryReader *pIQueryReader,
 900         [in, unique] const GUID *pguidVendor,
 901         [out] IWICMetadataQueryWriter **ppIQueryWriter);
 902 }
 903
 904 [
 905     local,
 906     object,
 907     uuid(dc2bb46d-3f07-481e-8625-220c4aedbb33)
 908 ]
 909 interface IWICEnumMetadataItem : IUnknown
 910 {
 911     HRESULT Next(
 912         [in] ULONG celt,
 913         [in, out, unique, size_is(celt)] PROPVARIANT *rgeltSchema,
 914         [in, out, size_is(celt)] PROPVARIANT *rgeltId,
 915         [in, out, optional, size_is(celt)] PROPVARIANT *rgeltValue,
 916         [out, optional] ULONG *pceltFetched);
 917
 918     HRESULT Skip(
 919         [in] ULONG celt);
 920
 921     HRESULT Reset();
 922
 923     HRESULT Clone(
 924         [out] IWICEnumMetadataItem **ppIEnumMetadataItem);
 925 }
 926
 927 cpp_quote("HRESULT WINAPI WICConvertBitmapSource(REFWICPixelFormatGUID dstFormat, IWICBitmapSource *pISrc, IWICBitmapSource **ppIDst);")
 928
 929 cpp_quote("DEFINE_GUID(CLSID_WICBmpDecoder, 0x6b462062,0x7cbf,0x400d,0x9f,0xdb,0x81,0x3d,0xd1,0x0f,0x27,0x78);")
 930 cpp_quote("DEFINE_GUID(CLSID_WICPngDecoder, 0x389ea17b,0x5078,0x4cde,0xb6,0xef,0x25,0xc1,0x51,0x75,0xc7,0x51);")
 931 cpp_quote("DEFINE_GUID(CLSID_WICIcoDecoder, 0xc61bfcdf,0x2e0f,0x4aad,0xa8,0xd7,0xe0,0x6b,0xaf,0xeb,0xcd,0xfe);")
 932 cpp_quote("DEFINE_GUID(CLSID_WICJpegDecoder, 0x9456a480,0xe88b,0x43ea,0x9e,0x73,0x0b,0x2d,0x9b,0x71,0xb1,0xca);")
 933 cpp_quote("DEFINE_GUID(CLSID_WICGifDecoder, 0x381dda3c,0x9ce9,0x4834,0xa2,0x3e,0x1f,0x98,0xf8,0xfc,0x52,0xbe);")
 934 cpp_quote("DEFINE_GUID(CLSID_WICTiffDecoder, 0xb54e85d9,0xfe23,0x499f,0x8b,0x88,0x6a,0xce,0xa7,0x13,0x75,0x2b);")
 935 cpp_quote("DEFINE_GUID(CLSID_WICWmpDecoder, 0xa26cec36,0x234c,0x4950,0xae,0x16,0xe3,0x4a,0xac,0xe7,0x1d,0x0d);")
 936
 937 cpp_quote("DEFINE_GUID(CLSID_WICBmpEncoder, 0x69be8bb4,0xd66d,0x47c8,0x86,0x5a,0xed,0x15,0x89,0x43,0x37,0x82);")
 938 cpp_quote("DEFINE_GUID(CLSID_WICPngEncoder, 0x27949969,0x876a,0x41d7,0x94,0x47,0x56,0x8f,0x6a,0x35,0xa4,0xdc);")
 939 cpp_quote("DEFINE_GUID(CLSID_WICJpegEncoder, 0x1a34f5c1,0x4a5a,0x46dc,0xb6,0x44,0x1f,0x45,0x67,0xe7,0xa6,0x76);")
 940 cpp_quote("DEFINE_GUID(CLSID_WICGifEncoder, 0x114f5598,0x0b22,0x40a0,0x86,0xa1,0xc8,0x3e,0xa4,0x95,0xad,0xbd);")
 941 cpp_quote("DEFINE_GUID(CLSID_WICTiffEncoder, 0x0131be10,0x2001,0x4c5f,0xa9,0xb0,0xcc,0x88,0xfa,0xb6,0x4c,0xe8);")
 942 cpp_quote("DEFINE_GUID(CLSID_WICWmpEncoder, 0xac4ce3cb,0xe1c1,0x44cd,0x82,0x15,0x5a,0x16,0x65,0x50,0x9e,0xc2);")
 943
 944 cpp_quote("DEFINE_GUID(CLSID_WICDefaultFormatConverter, 0x1a3f11dc,0xb514,0x4b17,0x8c,0x5f,0x21,0x54,0x51,0x38,0x52,0xf1);")
 945
 946 cpp_quote("DEFINE_GUID(GUID_ContainerFormatBmp, 0x0af1d87e,0xfcfe,0x4188,0xbd,0xeb,0xa7,0x90,0x64,0x71,0xcb,0xe3);")
 947 cpp_quote("DEFINE_GUID(GUID_ContainerFormatPng, 0x1b7cfaf4,0x713f,0x473c,0xbb,0xcd,0x61,0x37,0x42,0x5f,0xae,0xaf);")
 948 cpp_quote("DEFINE_GUID(GUID_ContainerFormatIco, 0xa3a860c4,0x338f,0x4c17,0x91,0x9a,0xfb,0xa4,0xb5,0x62,0x8f,0x21);")
 949 cpp_quote("DEFINE_GUID(GUID_ContainerFormatJpeg, 0x19e4a5aa,0x5662,0x4fc5,0xa0,0xc0,0x17,0x58,0x02,0x8e,0x10,0x57);")
 950 cpp_quote("DEFINE_GUID(GUID_ContainerFormatTiff, 0x163bcc30,0xe2e9,0x4f0b,0x96,0x1d,0xa3,0xe9,0xfd,0xb7,0x88,0xa3);")
 951 cpp_quote("DEFINE_GUID(GUID_ContainerFormatGif, 0x1f8a5601,0x7d4d,0x4cbd,0x9c,0x82,0x1b,0xc8,0xd4,0xee,0xb9,0xa5);")
 952 cpp_quote("DEFINE_GUID(GUID_ContainerFormatWmp, 0x57a37caa,0x367a,0x4540,0x91,0x6b,0xf1,0x83,0xc5,0x09,0x3a,0x4b);")
 953
 954 cpp_quote("DEFINE_GUID(GUID_VendorMicrosoft, 0xf0e749ca,0xedef,0x4589,0xa7,0x3a,0xee,0x0e,0x62,0x6a,0x2a,0x2b);")
 955
 956 cpp_quote("DEFINE_GUID(CATID_WICBitmapDecoders, 0x7ed96837,0x96f0,0x4812,0xb2,0x11,0xf1,0x3c,0x24,0x11,0x7e,0xd3);")
 957 cpp_quote("DEFINE_GUID(CATID_WICBitmapEncoders, 0xac757296,0x3522,0x4e11,0x98,0x62,0xc1,0x7b,0xe5,0xa1,0x76,0x7e);")
 958 cpp_quote("DEFINE_GUID(CATID_WICFormatConverters, 0x7835eae8,0xbf14,0x49d1,0x93,0xce,0x53,0x3a,0x40,0x7b,0x22,0x48);")