ID2D1Geometry::CompareWithGeometry(ID2D1Geometry*,constD2D1_MATRIX_3X2_F*,D2D1_GEOMETRY_RELATION*) method (d2d1.h)

Describes the intersection between this geometry and the specified geometry. The comparison is performed using the default flattening tolerance.

Syntax

HRESULT CompareWithGeometry(
  ID2D1Geometry           *inputGeometry,
  const D2D1_MATRIX_3X2_F *inputGeometryTransform,
  D2D1_GEOMETRY_RELATION  *relation
);

Parameters

inputGeometry

Type: [in] ID2D1Geometry*

The geometry to test.

inputGeometryTransform

Type: [in, optional] const D2D1_MATRIX_3X2_F*

The transform to apply to inputGeometry, or NULL.

relation

Type: [out] D2D1_GEOMETRY_RELATION*

When this method returns, contains a pointer to a value that describes how this geometry is related to inputGeometry. You must allocate storage for this parameter.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

When interpreting the returned relation value, it is important to remember that the member D2D1_GEOMETRY_RELATION_IS_CONTAINED of the D2D1_GEOMETRY_RELATION enumeration type means that this geometry is contained inside inputGeometry, not that this geometry contains inputGeometry.

For more information about how to interpret other possible return values, see D2D1_GEOMETRY_RELATION.

Requirements

See also

ID2D1Geometry