CD2DGeometry Class

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at CD2DGeometry Class.

A wrapper for ID2D1Geometry.

Syntax

class CD2DGeometry : public CD2DResource;  

Members

Public Constructors

Name Description
CD2DGeometry::CD2DGeometry Constructs a CD2DGeometry object.
CD2DGeometry::~CD2DGeometry The destructor. Called when a D2D geometry object is being destroyed.

Public Methods

Name Description
CD2DGeometry::Attach Attaches existing resource interface to the object
CD2DGeometry::CombineWithGeometry Combines this geometry with the specified geometry and stores the result in an ID2D1SimplifiedGeometrySink.
CD2DGeometry::CompareWithGeometry Describes the intersection between this geometry and the specified geometry. The comparison is performed using the specified flattening tolerance.
CD2DGeometry::ComputeArea Computes the area of the geometry after it has been transformed by the specified matrix and flattened using the specified tolerance.
CD2DGeometry::ComputeLength Calculates the length of the geometry as though each segment were unrolled into a line.
CD2DGeometry::ComputePointAtLength Calculates the point and tangent vector at the specified distance along the geometry after it has been transformed by the specified matrix and flattened using the specified tolerance.
CD2DGeometry::Destroy Destroys a CD2DGeometry object. (Overrides CD2DResource::Destroy.)
CD2DGeometry::Detach Detaches resource interface from the object
CD2DGeometry::FillContainsPoint Indicates whether the area filled by the geometry would contain the specified point given the specified flattening tolerance.
CD2DGeometry::Get Returns ID2D1Geometry interface
CD2DGeometry::GetBounds
CD2DGeometry::GetWidenedBounds Gets the bounds of the geometry after it has been widened by the specified stroke width and style and transformed by the specified matrix.
CD2DGeometry::IsValid Checks resource validity (Overrides CD2DResource::IsValid.)
CD2DGeometry::Outline Computes the outline of the geometry and writes the result to an ID2D1SimplifiedGeometrySink.
CD2DGeometry::Simplify Creates a simplified version of the geometry that contains only lines and (optionally) cubic Bezier curves and writes the result to an ID2D1SimplifiedGeometrySink.
CD2DGeometry::StrokeContainsPoint Determines whether the geometry's stroke contains the specified point given the specified stroke thickness, style, and transform.
CD2DGeometry::Tessellate Creates a set of clockwise-wound triangles that cover the geometry after it has been transformed using the specified matrix and flattened using the specified tolerance.
CD2DGeometry::Widen Widens the geometry by the specified stroke and writes the result to an ID2D1SimplifiedGeometrySink after it has been transformed by the specified matrix and flattened using the specified tolerance.

Public Operators

Name Description
CD2DGeometry::operator ID2D1Geometry* Returns ID2D1Geometry interface

Protected Data Members

Name Description
CD2DGeometry::m_pGeometry A pointer to an ID2D1Geometry.

Inheritance Hierarchy

CObject

CD2DResource

CD2DGeometry

Requirements

Header: afxrendertarget.h

CD2DGeometry::~CD2DGeometry

The destructor. Called when a D2D geometry object is being destroyed.

virtual ~CD2DGeometry();

CD2DGeometry::Attach

Attaches existing resource interface to the object

void Attach(ID2D1Geometry* pResource);

Parameters

pResource
Existing resource interface. Cannot be NULL

CD2DGeometry::CD2DGeometry

Constructs a CD2DGeometry object.

CD2DGeometry(
    CRenderTarget* pParentTarget,  
    BOOL bAutoDestroy = TRUE);

Parameters

pParentTarget
A pointer to the render target.

bAutoDestroy
Indicates that the object will be destroyed by owner (pParentTarget).

CD2DGeometry::CombineWithGeometry

Combines this geometry with the specified geometry and stores the result in an ID2D1SimplifiedGeometrySink.

BOOL CombineWithGeometry(
    CD2DGeometry& inputGeometry,  
    D2D1_COMBINE_MODE combineMode,  
    const D2D1_MATRIX_3X2_F& inputGeometryTransform,  
    ID2D1SimplifiedGeometrySink* geometrySink,  
    FLOAT flatteningTolerance = D2D1_DEFAULT_FLATTENING_TOLERANCE) const;  

Parameters

inputGeometry
The geometry to combine with this instance.

combineMode
The type of combine operation to perform.

inputGeometryTransform
The transform to apply to inputGeometry before combining.

geometrySink
The result of the combine operation.

flatteningTolerance
The maximum bounds on the distance between points in the polygonal approximation of the geometries. Smaller values produce more accurate results but cause slower execution.

Return Value

If the method succeeds, it returns TRUE. Otherwise, it returns FALSE.

CD2DGeometry::CompareWithGeometry

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

D2D1_GEOMETRY_RELATION CompareWithGeometry(
    CD2DGeometry& inputGeometry,  
    const D2D1_MATRIX_3X2_F& inputGeometryTransform,  
    FLOAT flatteningTolerance = D2D1_DEFAULT_FLATTENING_TOLERANCE) const;  

Parameters

inputGeometry
The geometry to test.

inputGeometryTransform
The transform to apply to inputGeometry.

flatteningTolerance
The maximum bounds on the distance between points in the polygonal approximation of the geometries. Smaller values produce more accurate results but cause slower execution.

Return Value

If the method succeeds, it returns TRUE. Otherwise, it returns FALSE.

CD2DGeometry::ComputeArea

Computes the area of the geometry after it has been transformed by the specified matrix and flattened using the specified tolerance.

BOOL ComputeArea(
    const D2D1_MATRIX_3X2_F& worldTransform,  
    FLOAT& area,  
    FLOAT flatteningTolerance = D2D1_DEFAULT_FLATTENING_TOLERANCE) const;  

Parameters

worldTransform
The transform to apply to this geometry before computing its area.

area
When this method returns, contains a pointer to the area of the transformed, flattened version of this geometry. You must allocate storage for this parameter.

flatteningTolerance
The maximum bounds on the distance between points in the polygonal approximation of the geometry. Smaller values produce more accurate results but cause slower execution.

Return Value

If the method succeeds, it returns TRUE. Otherwise, it returns FALSE.

CD2DGeometry::ComputeLength

Calculates the length of the geometry as though each segment were unrolled into a line.

BOOL ComputeLength(
    const D2D1_MATRIX_3X2_F& worldTransform,  
    FLOAT& length,  
    FLOAT flatteningTolerance = D2D1_DEFAULT_FLATTENING_TOLERANCE) const;  

Parameters

worldTransform
The transform to apply to the geometry before calculating its length.

length
When this method returns, contains a pointer to the length of the geometry. For closed geometries, the length includes an implicit closing segment. You must allocate storage for this parameter.

flatteningTolerance
The maximum bounds on the distance between points in the polygonal approximation of the geometry. Smaller values produce more accurate results but cause slower execution.

Return Value

If the method succeeds, it returns TRUE. Otherwise, it returns FALSE.

CD2DGeometry::ComputePointAtLength

Calculates the point and tangent vector at the specified distance along the geometry after it has been transformed by the specified matrix and flattened using the specified tolerance.

BOOL ComputePointAtLength(
    FLOAT length,  
    const D2D1_MATRIX_3X2_F& worldTransform,  
    CD2DPointF& point,  
    CD2DPointF& unitTangentVector,  
    FLOAT flatteningTolerance = D2D1_DEFAULT_FLATTENING_TOLERANCE) const;  

Parameters

length
The distance along the geometry of the point and tangent to find. If this distance is less then 0, this method calculates the first point in the geometry. If this distance is greater than the length of the geometry, this method calculates the last point in the geometry.

worldTransform
The transform to apply to the geometry before calculating the specified point and tangent.

point
The location at the specified distance along the geometry. If the geometry is empty, this point contains NaN as its x and y values.

unitTangentVector
When this method returns, contains a pointer to the tangent vector at the specified distance along the geometry. If the geometry is empty, this vector contains NaN as its x and y values. You must allocate storage for this parameter.

flatteningTolerance
The maximum bounds on the distance between points in the polygonal approximation of the geometry. Smaller values produce more accurate results but cause slower execution.

Return Value

If the method succeeds, it returns TRUE. Otherwise, it returns FALSE.

CD2DGeometry::Destroy

Destroys a CD2DGeometry object.

virtual void Destroy();

CD2DGeometry::Detach

Detaches resource interface from the object

ID2D1Geometry* Detach();

Return Value

Pointer to detached resource interface.

CD2DGeometry::FillContainsPoint

Indicates whether the area filled by the geometry would contain the specified point given the specified flattening tolerance.

BOOL FillContainsPoint(
    CD2DPointF point,  
    const D2D1_MATRIX_3X2_F& worldTransform,  
    BOOL* contains,  
    FLOAT flatteningTolerance = D2D1_DEFAULT_FLATTENING_TOLERANCE) const;  

Parameters

point
The point to test.

worldTransform
The transform to apply to the geometry prior to testing for containment.

contains
When this method returns, contains a bool value that is TRUE if the area filled by the geometry contains point; otherwise, FALSE. You must allocate storage for this parameter.

flatteningTolerance
The numeric accuracy with which the precise geometric path and path intersection is calculated. Points missing the fill by less than the tolerance are still considered inside. Smaller values produce more accurate results but cause slower execution.

Return Value

If the method succeeds, it returns TRUE. Otherwise, it returns FALSE.

CD2DGeometry::Get

Returns ID2D1Geometry interface

ID2D1Geometry* Get();

Return Value

Pointer to an ID2D1Geometry interface or NULL if object is not initialized yet.

CD2DGeometry::GetBounds

BOOL GetBounds(
const D2D1_MATRIX_3X2_F& worldTransform,  
CD2DRectF& bounds) const; 

Parameters

worldTransform
bounds

Return Value

CD2DGeometry::GetWidenedBounds

Gets the bounds of the geometry after it has been widened by the specified stroke width and style and transformed by the specified matrix.

BOOL GetWidenedBounds(
    FLOAT strokeWidth,  
    ID2D1StrokeStyle* strokeStyle,  
    const D2D1_MATRIX_3X2_F& worldTransform,  
    CD2DRectF& bounds,  
    FLOAT flatteningTolerance = D2D1_DEFAULT_FLATTENING_TOLERANCE) const;  

Parameters

strokeWidth
The amount by which to widen the geometry by stroking its outline.

strokeStyle
The style of the stroke that widens the geometry.

worldTransform
A transform to apply to the geometry after the geometry is transformed and after the geometry has been stroked.

bounds
When this method returns, contains the bounds of the widened geometry. You must allocate storage for this parameter.

flatteningTolerance
The maximum bounds on the distance between points in the polygonal approximation of the geometries. Smaller values produce more accurate results but cause slower execution.

Return Value

If the method succeeds, it returns TRUE. Otherwise, it returns FALSE.

CD2DGeometry::IsValid

Checks resource validity

virtual BOOL IsValid() const;  

Return Value

TRUE if resource is valid; otherwise FALSE.

CD2DGeometry::m_pGeometry

A pointer to an ID2D1Geometry.

ID2D1Geometry* m_pGeometry;  

CD2DGeometry::operator ID2D1Geometry*

Returns ID2D1Geometry interface

operator ID2D1Geometry*();

Return Value

Pointer to an ID2D1Geometry interface or NULL if object is not initialized yet.

CD2DGeometry::Outline

Computes the outline of the geometry and writes the result to an ID2D1SimplifiedGeometrySink.

BOOL Outline(
    const D2D1_MATRIX_3X2_F& worldTransform,  
    ID2D1SimplifiedGeometrySink* geometrySink,  
    FLOAT flatteningTolerance = D2D1_DEFAULT_FLATTENING_TOLERANCE) const;  

Parameters

worldTransform
The transform to apply to the geometry outline.

geometrySink
The ID2D1SimplifiedGeometrySink to which the geometry transformed outline is appended.

flatteningTolerance
The maximum bounds on the distance between points in the polygonal approximation of the geometry. Smaller values produce more accurate results but cause slower execution.

Return Value

If the method succeeds, it returns TRUE. Otherwise, it returns FALSE.

CD2DGeometry::Simplify

Creates a simplified version of the geometry that contains only lines and (optionally) cubic Bezier curves and writes the result to an ID2D1SimplifiedGeometrySink.

BOOL Simplify(
    D2D1_GEOMETRY_SIMPLIFICATION_OPTION simplificationOption,  
    const D2D1_MATRIX_3X2_F& worldTransform,  
    ID2D1SimplifiedGeometrySink* geometrySink,  
    FLOAT flatteningTolerance = D2D1_DEFAULT_FLATTENING_TOLERANCE) const;  

Parameters

simplificationOption
A value that specifies whether the simplified geometry should contain curves.

worldTransform
The transform to apply to the simplified geometry.

geometrySink
The ID2D1SimplifiedGeometrySink to which the simplified geometry is appended.

flatteningTolerance
The maximum bounds on the distance between points in the polygonal approximation of the geometry. Smaller values produce more accurate results but cause slower execution.

Return Value

If the method succeeds, it returns TRUE. Otherwise, it returns FALSE.

CD2DGeometry::StrokeContainsPoint

Determines whether the geometry's stroke contains the specified point given the specified stroke thickness, style, and transform.

BOOL StrokeContainsPoint(
    CD2DPointF point,  
    FLOAT strokeWidth,  
    ID2D1StrokeStyle* strokeStyle,  
    const D2D1_MATRIX_3X2_F& worldTransform,  
    BOOL* contains,  
    FLOAT flatteningTolerance = D2D1_DEFAULT_FLATTENING_TOLERANCE) const;  

Parameters

point
The point to test for containment.

strokeWidth
The thickness of the stroke to apply.

strokeStyle
The style of the stroke to apply.

worldTransform
The transform to apply to the stroked geometry.

contains
When this method returns, contains a boolean value set to TRUE if the geometry's stroke contains the specified point; otherwise, FALSE. You must allocate storage for this parameter.

flatteningTolerance
The numeric accuracy with which the precise geometric path and path intersection is calculated. Points missing the stroke by less than the tolerance are still considered inside. Smaller values produce more accurate results but cause slower execution.

Return Value

If the method succeeds, it returns TRUE. Otherwise, it returns FALSE.

CD2DGeometry::Tessellate

Creates a set of clockwise-wound triangles that cover the geometry after it has been transformed using the specified matrix and flattened using the specified tolerance.

BOOL Tessellate(
    const D2D1_MATRIX_3X2_F& worldTransform,  
    ID2D1TessellationSink* tessellationSink,  
    FLOAT flatteningTolerance = D2D1_DEFAULT_FLATTENING_TOLERANCE) const;  

Parameters

worldTransform
The transform to apply to this geometry, or NULL.

tessellationSink
The ID2D1TessellationSink to which the tessellated is appended.

flatteningTolerance
The maximum bounds on the distance between points in the polygonal approximation of the geometry. Smaller values produce more accurate results but cause slower execution.

Return Value

If the method succeeds, it returns TRUE. Otherwise, it returns FALSE.

CD2DGeometry::Widen

Widens the geometry by the specified stroke and writes the result to an ID2D1SimplifiedGeometrySink after it has been transformed by the specified matrix and flattened using the specified tolerance.

BOOL Widen(
    FLOAT strokeWidth,  
    ID2D1StrokeStyle* strokeStyle,  
    const D2D1_MATRIX_3X2_F& worldTransform,  
    ID2D1SimplifiedGeometrySink* geometrySink,  
    FLOAT flatteningTolerance = D2D1_DEFAULT_FLATTENING_TOLERANCE) const;  

Parameters

strokeWidth
The amount by which to widen the geometry.

strokeStyle
The style of stroke to apply to the geometry, or NULL.

worldTransform
The transform to apply to the geometry after widening it.

geometrySink
The ID2D1SimplifiedGeometrySink to which the widened geometry is appended.

flatteningTolerance
The maximum bounds on the distance between points in the polygonal approximation of the geometry. Smaller values produce more accurate results but cause slower execution.

Return Value

If the method succeeds, it returns TRUE. Otherwise, it returns FALSE.

See Also

Classes