include/d2d1effectauthor.idl

   1 /*
   2  * Copyright 2022 Ziqing Hui 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 "d2d1_1.idl";
  20
  21 typedef enum D2D1_FILTER
  22 {
  23     D2D1_FILTER_MIN_MAG_MIP_POINT               = 0x00,
  24     D2D1_FILTER_MIN_MAG_POINT_MIP_LINEAR        = 0x01,
  25     D2D1_FILTER_MIN_POINT_MAG_LINEAR_MIP_POINT  = 0x04,
  26     D2D1_FILTER_MIN_POINT_MAG_MIP_LINEAR        = 0x05,
  27     D2D1_FILTER_MIN_LINEAR_MAG_MIP_POINT        = 0x10,
  28     D2D1_FILTER_MIN_LINEAR_MAG_POINT_MIP_LINEAR = 0x11,
  29     D2D1_FILTER_MIN_MAG_LINEAR_MIP_POINT        = 0x14,
  30     D2D1_FILTER_MIN_MAG_MIP_LINEAR              = 0x15,
  31     D2D1_FILTER_ANISOTROPIC                     = 0x55,
  32     D2D1_FILTER_FORCE_DWORD = 0xffffffff
  33 } D2D1_FILTER;
  34
  35 typedef enum D2D1_FEATURE
  36 {
  37     D2D1_FEATURE_DOUBLES                  = 0x0,
  38     D2D1_FEATURE_D3D10_X_HARDWARE_OPTIONS = 0x1,
  39     D2D1_FEATURE_FORCE_DWORD = 0xffffffff
  40 } D2D1_FEATURE;
  41
  42 typedef enum D2D1_CHANNEL_DEPTH
  43 {
  44     D2D1_CHANNEL_DEPTH_DEFAULT = 0x0,
  45     D2D1_CHANNEL_DEPTH_1       = 0x1,
  46     D2D1_CHANNEL_DEPTH_4       = 0x4,
  47     D2D1_CHANNEL_DEPTH_FORCE_DWORD = 0xffffffff
  48 } D2D1_CHANNEL_DEPTH;
  49
  50 typedef enum D2D1_CHANGE_TYPE
  51 {
  52     D2D1_CHANGE_TYPE_NONE       = 0x0,
  53     D2D1_CHANGE_TYPE_PROPERTIES = 0x1,
  54     D2D1_CHANGE_TYPE_CONTEXT    = 0x2,
  55     D2D1_CHANGE_TYPE_GRAPH      = 0x3,
  56     D2D1_CHANGE_TYPE_FORCE_DWORD = 0xffffffff
  57 } D2D1_CHANGE_TYPE;
  58
  59 typedef enum D2D1_PIXEL_OPTIONS
  60 {
  61     D2D1_PIXEL_OPTIONS_NONE             = 0x0,
  62     D2D1_PIXEL_OPTIONS_TRIVIAL_SAMPLING = 0x1,
  63     D2D1_PIXEL_OPTIONS_FORCE_DWORD = 0xffffffff
  64 } D2D1_PIXEL_OPTIONS;
  65
  66 typedef enum D2D1_VERTEX_OPTIONS
  67 {
  68     D2D1_VERTEX_OPTIONS_NONE              = 0x0,
  69     D2D1_VERTEX_OPTIONS_DO_NOT_CLEAR      = 0x1,
  70     D2D1_VERTEX_OPTIONS_USE_DEPTH_BUFFER  = 0x2,
  71     D2D1_VERTEX_OPTIONS_ASSUME_NO_OVERLAP = 0x4,
  72     D2D1_VERTEX_OPTIONS_FORCE_DWORD = 0xffffffff
  73 } D2D1_VERTEX_OPTIONS;
  74
  75 typedef enum D2D1_VERTEX_USAGE
  76 {
  77     D2D1_VERTEX_USAGE_STATIC  = 0x0,
  78     D2D1_VERTEX_USAGE_DYNAMIC = 0x1,
  79     D2D1_VERTEX_USAGE_FORCE_DWORD = 0xffffffff
  80 } D2D1_VERTEX_USAGE;
  81
  82 typedef enum D2D1_BLEND_OPERATION
  83 {
  84     D2D1_BLEND_OPERATION_ADD          = 0x1,
  85     D2D1_BLEND_OPERATION_SUBTRACT     = 0x2,
  86     D2D1_BLEND_OPERATION_REV_SUBTRACT = 0x3,
  87     D2D1_BLEND_OPERATION_MIN          = 0x4,
  88     D2D1_BLEND_OPERATION_MAX          = 0x5,
  89     D2D1_BLEND_OPERATION_FORCE_DWORD = 0xffffffff
  90 } D2D1_BLEND_OPERATION;
  91
  92 typedef enum D2D1_BLEND
  93 {
  94     D2D1_BLEND_ZERO             = 1,
  95     D2D1_BLEND_ONE              = 2,
  96     D2D1_BLEND_SRC_COLOR        = 3,
  97     D2D1_BLEND_INV_SRC_COLOR    = 4,
  98     D2D1_BLEND_SRC_ALPHA        = 5,
  99     D2D1_BLEND_INV_SRC_ALPHA    = 6,
 100     D2D1_BLEND_DEST_ALPHA       = 7,
 101     D2D1_BLEND_INV_DEST_ALPHA   = 8,
 102     D2D1_BLEND_DEST_COLOR       = 9,
 103     D2D1_BLEND_INV_DEST_COLOR   = 10,
 104     D2D1_BLEND_SRC_ALPHA_SAT    = 11,
 105     D2D1_BLEND_BLEND_FACTOR     = 14,
 106     D2D1_BLEND_INV_BLEND_FACTOR = 15,
 107     D2D1_BLEND_FORCE_DWORD = 0xffffffff
 108 } D2D1_BLEND;
 109
 110 typedef struct D2D1_INPUT_DESCRIPTION
 111 {
 112     D2D1_FILTER filter;
 113     UINT32 levelOfDetailCount;
 114 } D2D1_INPUT_DESCRIPTION;
 115
 116 typedef struct D2D1_VERTEX_RANGE
 117 {
 118     UINT32 startVertex;
 119     UINT32 vertexCount;
 120 } D2D1_VERTEX_RANGE;
 121
 122 typedef struct D2D1_BLEND_DESCRIPTION
 123 {
 124     D2D1_BLEND sourceBlend;
 125     D2D1_BLEND destinationBlend;
 126     D2D1_BLEND_OPERATION blendOperation;
 127     D2D1_BLEND sourceBlendAlpha;
 128     D2D1_BLEND destinationBlendAlpha;
 129     D2D1_BLEND_OPERATION blendOperationAlpha;
 130     float blendFactor[4];
 131 } D2D1_BLEND_DESCRIPTION;
 132
 133 typedef struct D2D1_RESOURCE_TEXTURE_PROPERTIES
 134 {
 135     const UINT32 *extents;
 136     UINT32 dimensions;
 137     D2D1_BUFFER_PRECISION bufferPrecision;
 138     D2D1_CHANNEL_DEPTH channelDepth;
 139     D2D1_FILTER filter;
 140     const D2D1_EXTEND_MODE *extendModes;
 141 } D2D1_RESOURCE_TEXTURE_PROPERTIES;
 142
 143 typedef struct D2D1_INPUT_ELEMENT_DESC
 144 {
 145     const char *semanticName;
 146     UINT32 semanticIndex;
 147     DXGI_FORMAT format;
 148     UINT32 inputSlot;
 149     UINT32 alignedByteOffset;
 150 } D2D1_INPUT_ELEMENT_DESC;
 151
 152 typedef struct D2D1_VERTEX_BUFFER_PROPERTIES
 153 {
 154     UINT32 inputCount;
 155     D2D1_VERTEX_USAGE usage;
 156     const BYTE *data;
 157     UINT32 byteWidth;
 158 } D2D1_VERTEX_BUFFER_PROPERTIES;
 159
 160 typedef struct D2D1_CUSTOM_VERTEX_BUFFER_PROPERTIES
 161 {
 162     const BYTE *shaderBufferWithInputSignature;
 163     UINT32 shaderBufferSize;
 164     const D2D1_INPUT_ELEMENT_DESC *inputElements;
 165     UINT32 elementCount;
 166     UINT32 stride;
 167 } D2D1_CUSTOM_VERTEX_BUFFER_PROPERTIES;
 168
 169 [
 170     object,
 171     uuid(9b8b1336-00a5-4668-92b7-ced5d8bf9b7b),
 172     local,
 173 ]
 174 interface ID2D1VertexBuffer : IUnknown
 175 {
 176     HRESULT Map(
 177         [out] BYTE **data,
 178         [in] UINT32 size
 179     );
 180     HRESULT Unmap();
 181 }
 182
 183 [
 184     object,
 185     uuid(688d15c3-02b0-438d-b13a-d1b44c32c39a),
 186     local,
 187 ]
 188 interface ID2D1ResourceTexture : IUnknown
 189 {
 190     HRESULT Update(
 191         [in] const UINT32 *min_extents,
 192         [in] const UINT32 *max_extents,
 193         [in] const UINT32 *strides,
 194         [in] UINT32 dimensions,
 195         [in] const BYTE *data,
 196         [in] UINT32 data_size
 197     );
 198 }
 199
 200 [
 201     object,
 202     uuid(519ae1bd-d19a-420d-b849-364f594776b7),
 203     local,
 204 ]
 205 interface ID2D1RenderInfo : IUnknown
 206 {
 207     HRESULT SetInputDescription(
 208         [in] UINT32 index,
 209         [in] D2D1_INPUT_DESCRIPTION description
 210     );
 211     HRESULT SetOutputBuffer(
 212         [in] D2D1_BUFFER_PRECISION precision,
 213         [in] D2D1_CHANNEL_DEPTH depth
 214     );
 215     void SetCached(
 216         [in] BOOL is_cached
 217     );
 218     void SetInstructionCountHint(
 219         [in] UINT32 count
 220     );
 221 }
 222
 223 [
 224     object,
 225     uuid(693ce632-7f2f-45de-93fe-18d88b37aa21),
 226     local,
 227 ]
 228 interface ID2D1DrawInfo : ID2D1RenderInfo
 229 {
 230     HRESULT SetPixelShaderConstantBuffer(
 231         [in] const BYTE *buffer,
 232         [in] UINT32 size
 233     );
 234     HRESULT SetResourceTexture(
 235         [in] UINT32 index,
 236         [in] ID2D1ResourceTexture *texture
 237     );
 238     HRESULT SetVertexShaderConstantBuffer(
 239         [in] const BYTE *buffer,
 240         [in] UINT32 size
 241     );
 242     HRESULT SetPixelShader(
 243         [in] REFGUID id,
 244         [in] D2D1_PIXEL_OPTIONS options
 245     );
 246     HRESULT SetVertexProcessing(
 247         [in, optional] ID2D1VertexBuffer *buffer,
 248         [in] D2D1_VERTEX_OPTIONS options,
 249         [in, optional] const D2D1_BLEND_DESCRIPTION *description,
 250         [in, optional] const D2D1_VERTEX_RANGE *range,
 251         [in, optional] const GUID *shader
 252     );
 253 }
 254
 255 [
 256     object,
 257     uuid(5598b14b-9fd7-48b7-9bdb-8f0964eb38bc),
 258     local,
 259 ]
 260 interface ID2D1ComputeInfo : ID2D1RenderInfo
 261 {
 262     HRESULT SetComputeShaderconstantBuffer(
 263         [in] const BYTE *buffer,
 264         [in] UINT32 size
 265     );
 266     HRESULT SetComputeShader(
 267         [in] REFGUID id
 268     );
 269     HRESULT SetResourceTexture(
 270         [in] UINT32 index,
 271         [in] ID2D1ResourceTexture *texture
 272     );
 273 }
 274
 275 [
 276     object,
 277     uuid(b2efe1e7-729f-4102-949f-505fa21bf666),
 278     local,
 279 ]
 280 interface ID2D1TransformNode : IUnknown
 281 {
 282     UINT32 GetInputCount();
 283 }
 284
 285 [
 286     object,
 287     uuid(13d29038-c3e6-4034-9081-13b53a417992),
 288     local,
 289 ]
 290 interface ID2D1TransformGraph : IUnknown
 291 {
 292     UINT32 GetInputCount();
 293     HRESULT SetSingleTransformNode(
 294         [in] ID2D1TransformNode *node
 295     );
 296     HRESULT AddNode(
 297         [in] ID2D1TransformNode *node
 298     );
 299     HRESULT RemoveNode(
 300         [in] ID2D1TransformNode *node
 301     );
 302     HRESULT SetOutputNode(
 303         [in] ID2D1TransformNode *node
 304     );
 305     HRESULT ConnectNode(
 306         [in] ID2D1TransformNode *from_node,
 307         [in] ID2D1TransformNode *to_node,
 308         [in] UINT32 index
 309     );
 310     HRESULT ConnectToEffectInput(
 311         [in] UINT32 input_index,
 312         [in] ID2D1TransformNode *node,
 313         [in] UINT32 node_index
 314     );
 315     void Clear();
 316     HRESULT SetPassthroughGraph(
 317         [in] UINT32 index
 318     );
 319 }
 320
 321 [
 322     object,
 323     uuid(ef1a287d-342a-4f76-8fdb-da0d6ea9f92b),
 324     local,
 325 ]
 326 interface ID2D1Transform : ID2D1TransformNode
 327 {
 328     HRESULT MapOutputRectToInputRects(
 329         [in] const D2D1_RECT_L *output_rect,
 330         [out] D2D1_RECT_L *input_rects,
 331         [in] UINT32 input_rects_count
 332     );
 333     HRESULT MapInputRectsToOutputRect(
 334         [in] const D2D1_RECT_L *input_rects,
 335         [in] const D2D1_RECT_L *input_opaque_rects,
 336         [in] UINT32 input_rect_count,
 337         [out] D2D1_RECT_L *output_rect,
 338         [out] D2D1_RECT_L *output_opaque_rect
 339     );
 340     HRESULT MapInvalidRect(
 341         [in] UINT32 index,
 342         [in] D2D1_RECT_L input_rect,
 343         [out] D2D1_RECT_L *output_rect
 344     );
 345 }
 346
 347 [
 348     object,
 349     uuid(36bfdcb6-9739-435d-a30d-a653beff6a6f),
 350     local,
 351 ]
 352 interface ID2D1DrawTransform : ID2D1Transform
 353 {
 354     HRESULT SetDrawInfo(
 355         [in] ID2D1DrawInfo *info
 356     );
 357 }
 358
 359 [
 360     object,
 361     uuid(0d85573c-01e3-4f7d-bfd9-0d60608bf3c3),
 362     local,
 363 ]
 364 interface ID2D1ComputeTransform : ID2D1Transform
 365 {
 366     HRESULT SetComputeInfo(
 367         [in] ID2D1ComputeInfo *info
 368     );
 369     HRESULT CalculateThreadgroups(
 370         [in] const D2D1_RECT_L *output_rect,
 371         [out] UINT32 *dimension_x,
 372         [out] UINT32 *dimension_y,
 373         [out] UINT32 *dimension_z
 374     );
 375 }
 376
 377 [
 378     object,
 379     uuid(0359dc30-95e6-4568-9055-27720d130e93),
 380     local,
 381 ]
 382 interface ID2D1AnalysisTransform : IUnknown
 383 {
 384     HRESULT ProcessAnalysisResults(
 385         [in] const BYTE *data,
 386         [in] UINT32 size
 387     );
 388 }
 389
 390 [
 391     object,
 392     uuid(db1800dd-0c34-4cf9-be90-31cc0a5653e1),
 393     local,
 394 ]
 395 interface ID2D1SourceTransform : ID2D1Transform
 396 {
 397     HRESULT SetRenderInfo(
 398         [in] ID2D1RenderInfo *info
 399     );
 400     HRESULT Draw(
 401         [in] ID2D1Bitmap1 *target,
 402         [in] const D2D1_RECT_L *draw_rect,
 403         [in] D2D1_POINT_2U target_origin
 404     );
 405 }
 406
 407 [
 408     object,
 409     uuid(1a799d8a-69f7-4e4c-9fed-437ccc6684cc),
 410     local,
 411 ]
 412 interface ID2D1ConcreteTransform : ID2D1TransformNode
 413 {
 414     HRESULT SetOutputBuffer(
 415         [in] D2D1_BUFFER_PRECISION precision,
 416         [in] D2D1_CHANNEL_DEPTH depth
 417     );
 418     void SetCached(
 419         [in] BOOL is_cached
 420     );
 421 }
 422
 423 [
 424     object,
 425     uuid(63ac0b32-ba44-450f-8806-7f4ca1ff2f1b),
 426     local,
 427 ]
 428 interface ID2D1BlendTransform : ID2D1ConcreteTransform
 429 {
 430     void SetDescription(
 431         [in] const D2D1_BLEND_DESCRIPTION *description
 432     );
 433     void GetDescription(
 434         [out] D2D1_BLEND_DESCRIPTION *description
 435     );
 436 }
 437
 438 [
 439     object,
 440     uuid(4998735c-3a19-473c-9781-656847e3a347),
 441     local,
 442 ]
 443 interface ID2D1BorderTransform : ID2D1ConcreteTransform
 444 {
 445     void SetExtendModeX(
 446         [in] D2D1_EXTEND_MODE mode
 447     );
 448     void SetExtendModeY(
 449         [in] D2D1_EXTEND_MODE mode
 450     );
 451     D2D1_EXTEND_MODE GetExtendModeX();
 452     D2D1_EXTEND_MODE GetExtendModeY();
 453 }
 454
 455 [
 456     object,
 457     uuid(3fe6adea-7643-4f53-bd14-a0ce63f24042),
 458     local,
 459 ]
 460 interface ID2D1OffsetTransform : ID2D1TransformNode
 461 {
 462     void SetOffset(
 463         [in] D2D1_POINT_2L offset
 464     );
 465     D2D1_POINT_2L GetOffset();
 466 }
 467
 468 [
 469     object,
 470     uuid(90f732e2-5092-4606-a819-8651970baccd),
 471     local,
 472 ]
 473 interface ID2D1BoundsAdjustmentTransform : ID2D1TransformNode
 474 {
 475     void SetOutputBounds(
 476         [in] const D2D1_RECT_L *bounds
 477     );
 478     void GetOutputBounds(
 479         [out] D2D1_RECT_L *bounds
 480     );
 481 }
 482
 483 [
 484     object,
 485     uuid(3d9f916b-27dc-4ad7-b4f1-64945340f563),
 486     local,
 487 ]
 488 interface ID2D1EffectContext : IUnknown
 489 {
 490     void GetDpi(
 491         [out] float *dpi_x,
 492         [out] float *dpi_y
 493     );
 494     HRESULT CreateEffect(
 495         [in] REFCLSID clsid,
 496         [out] ID2D1Effect **effect
 497     );
 498     HRESULT GetMaximumSupportedFeatureLevel(
 499         [in] const D3D_FEATURE_LEVEL *levels,
 500         [in] UINT32 level_count,
 501         [out] D3D_FEATURE_LEVEL *max_level
 502     );
 503     HRESULT CreateTransformNodeFromEffect(
 504         [in] ID2D1Effect *effect,
 505         [out] ID2D1TransformNode **node
 506     );
 507     HRESULT CreateBlendTransform(
 508         [in] UINT32 num_inputs,
 509         [in] const D2D1_BLEND_DESCRIPTION *description,
 510         [out] ID2D1BlendTransform **transform
 511     );
 512     HRESULT CreateBorderTransform(
 513         [in] D2D1_EXTEND_MODE mode_x,
 514         [in] D2D1_EXTEND_MODE mode_y,
 515         [out] ID2D1BorderTransform **transform
 516     );
 517     HRESULT CreateOffsetTransform(
 518         [in] D2D1_POINT_2L offset,
 519         [out] ID2D1OffsetTransform **transform
 520     );
 521     HRESULT CreateBoundsAdjustmentTransform(
 522         [in] const D2D1_RECT_L *output_rect,
 523         [out] ID2D1BoundsAdjustmentTransform **transform
 524     );
 525     HRESULT LoadPixelShader(
 526         [in] REFGUID shader_id,
 527         [in] const BYTE *buffer,
 528         [in] UINT32 buffer_size
 529     );
 530     HRESULT LoadVertexShader(
 531         [in] REFGUID shader_id,
 532         [in] const BYTE *buffer,
 533         [in] UINT32 buffer_size
 534     );
 535     HRESULT LoadComputeShader(
 536         [in] REFGUID shader_id,
 537         [in] const BYTE *buffer,
 538         [in] UINT32 buffer_size
 539     );
 540     BOOL IsShaderLoaded(
 541         [in] REFGUID shader_id
 542     );
 543     HRESULT CreateResourceTexture(
 544         [in, optional] const GUID *id,
 545         [in] const D2D1_RESOURCE_TEXTURE_PROPERTIES *texture_properties,
 546         [in] const BYTE *data,
 547         [in] const UINT32 *strides,
 548         [in] UINT32 data_size,
 549         [out] ID2D1ResourceTexture **texture
 550     );
 551     HRESULT FindResourceTexture(
 552         [in] const GUID *id,
 553         [out] ID2D1ResourceTexture **texture
 554     );
 555     HRESULT CreateVertexBuffer(
 556         [in] const D2D1_VERTEX_BUFFER_PROPERTIES *buffer_properties,
 557         [in, optional] const GUID *id,
 558         [in, optional] const D2D1_CUSTOM_VERTEX_BUFFER_PROPERTIES *custom_buffer_properties,
 559         [out] ID2D1VertexBuffer **buffer
 560     );
 561     HRESULT FindVertexBuffer(
 562         [in] const GUID *id,
 563         [out] ID2D1VertexBuffer **buffer
 564     );
 565     HRESULT CreateColorContext(
 566         [in] D2D1_COLOR_SPACE space,
 567         [in] const BYTE *profile,
 568         [in] UINT32 profile_size,
 569         [out] ID2D1ColorContext **color_context
 570     );
 571     HRESULT CreateColorContextFromFilename(
 572         [in] const WCHAR *filename,
 573         [out] ID2D1ColorContext **color_context
 574     );
 575     HRESULT CreateColorContextFromWicColorContext(
 576         [in] IWICColorContext *wic_color_context,
 577         [out] ID2D1ColorContext **color_context
 578     );
 579     HRESULT CheckFeatureSupport(
 580         [in] D2D1_FEATURE feature,
 581         [out] void *data,
 582         [in] UINT32 data_size
 583     );
 584     BOOL IsBufferPrecisionSupported(
 585         [in] D2D1_BUFFER_PRECISION precision
 586     );
 587 }
 588
 589 [
 590     object,
 591     uuid(a248fd3f-3e6c-4e63-9f03-7f68ecc91db9),
 592     local,
 593 ]
 594 interface ID2D1EffectImpl : IUnknown
 595 {
 596     HRESULT Initialize(
 597         [in] ID2D1EffectContext *context,
 598         [in] ID2D1TransformGraph *graph
 599     );
 600     HRESULT PrepareForRender(
 601         [in] D2D1_CHANGE_TYPE type
 602     );
 603     HRESULT SetGraph(
 604         [in] ID2D1TransformGraph *graph
 605     );
 606 }