D2D1_GRADIENT_MESH_PATCH structure (d2d1_3.h)

Represents a tensor patch with 16 control points, 4 corner colors, and boundary flags. An ID2D1GradientMesh is made up of 1 or more gradient mesh patches. Use the GradientMeshPatch function or the GradientMeshPatchFromCoonsPatch function to create one.

Syntax

typedef struct D2D1_GRADIENT_MESH_PATCH {
  D2D1_POINT_2F        point00;
  D2D1_POINT_2F        point01;
  D2D1_POINT_2F        point02;
  D2D1_POINT_2F        point03;
  D2D1_POINT_2F        point10;
  D2D1_POINT_2F        point11;
  D2D1_POINT_2F        point12;
  D2D1_POINT_2F        point13;
  D2D1_POINT_2F        point20;
  D2D1_POINT_2F        point21;
  D2D1_POINT_2F        point22;
  D2D1_POINT_2F        point23;
  D2D1_POINT_2F        point30;
  D2D1_POINT_2F        point31;
  D2D1_POINT_2F        point32;
  D2D1_POINT_2F        point33;
  D2D1_COLOR_F         color00;
  D2D1_COLOR_F         color03;
  D2D1_COLOR_F         color30;
  D2D1_COLOR_F         color33;
  D2D1_PATCH_EDGE_MODE topEdgeMode;
  D2D1_PATCH_EDGE_MODE leftEdgeMode;
  D2D1_PATCH_EDGE_MODE bottomEdgeMode;
  D2D1_PATCH_EDGE_MODE rightEdgeMode;
} D2D1_GRADIENT_MESH_PATCH;

Members

point00

The coordinate-space location of the control point in column 0 and row 0 of the tensor grid.

point01

The coordinate-space location of the control point in column 0 and row 1 of the tensor grid.

point02

The coordinate-space location of the control point in column 0 and row 2 of the tensor grid.

point03

The coordinate-space location of the control point in column 0 and row 3 of the tensor grid.

point10

The coordinate-space location of the control point in column 1 and row 0 of the tensor grid.

point11

The coordinate-space location of the control point in column 1 and row 1 of the tensor grid.

point12

The coordinate-space location of the control point in column 1 and row 2 of the tensor grid.

point13

The coordinate-space location of the control point in column 1 and row 3 of the tensor grid.

point20

The coordinate-space location of the control point in column 2 and row 0 of the tensor grid.

point21

The coordinate-space location of the control point in column 2 and row 1 of the tensor grid.

point22

The coordinate-space location of the control point in column 2 and row 2 of the tensor grid.

point23

The coordinate-space location of the control point in column 2 and row 3 of the tensor grid.

point30

The coordinate-space location of the control point in column 3 and row 0 of the tensor grid.

point31

The coordinate-space location of the control point in column 3 and row 1 of the tensor grid.

point32

The coordinate-space location of the control point in column 3 and row 2 of the tensor grid.

point33

The coordinate-space location of the control point in column 3 and row 3 of the tensor grid.

color00

The color associated with the control point in column 0 and row 0 of the tensor grid.

color03

The color associated with the control point in column 0 and row 3 of the tensor grid.

color30

The color associated with the control point in column 3 and row 0 of the tensor grid.

color33

The color associated with the control point in column 3 and row 3 of the tensor grid.

topEdgeMode

Specifies how to render the top edge of the mesh.

leftEdgeMode

Specifies how to render the left edge of the mesh.

bottomEdgeMode

Specifies how to render the bottom edge of the mesh.

rightEdgeMode

Specifies how to render the right edge of the mesh.

Remarks

The following image shows the numbering of control points on a tensor grid.

Number of control points on a tensor grid

Requirements

Requirement Value
Minimum supported client Windows 10 [desktop apps | UWP apps]
Minimum supported server Windows Server 2016 [desktop apps | UWP apps]
Header d2d1_3.h