CD2DBrush 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 CD2DBrush Class.

A wrapper for ID2D1Brush.

class CD2DBrush : public CD2DResource;  

Protected Constructors

NameDescription
CD2DBrush::CD2DBrushConstructs a CD2DBrush object.
CD2DBrush::~CD2DBrushThe destructor. Called when a D2D brush object is being destroyed.

Public Methods

NameDescription
CD2DBrush::AttachAttaches existing resource interface to the object
CD2DBrush::DestroyDestroys a CD2DBrush object. (Overrides CD2DResource::Destroy.)
CD2DBrush::DetachDetaches resource interface from the object
CD2DBrush::GetReturns ID2D1Brush interface
CD2DBrush::GetOpacityGets the degree of opacity of this brush
CD2DBrush::GetTransformGets the current transform of the render target
CD2DBrush::IsValidChecks resource validity (Overrides CD2DResource::IsValid.)
CD2DBrush::SetOpacitySets the degree of opacity of this brush
CD2DBrush::SetTransformApplies the specified transform to the render target, replacing the existing transformation. All subsequent drawing operations occur in the transformed space

Public Operators

NameDescription
CD2DBrush::operator ID2D1Brush*Returns ID2D1Brush interface

Protected Data Members

NameDescription
CD2DBrush::m_pBrushStores a pointer to an ID2D1Brush object.
CD2DBrush::m_pBrushPropertiesBrush properties.

CObject

CD2DResource

CD2DBrush

Header: afxrendertarget.h

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

virtual ~CD2DBrush();

Attaches existing resource interface to the object

void Attach(ID2D1Brush* pResource);

Parameters

pResource
Existing resource interface. Cannot be NULL

Constructs a CD2DBrush object.

CD2DBrush(
    CRenderTarget* pParentTarget,  
    CD2DBrushProperties* pBrushProperties = NULL,  
    BOOL bAutoDestroy = TRUE);

Parameters

pParentTarget
A pointer to the render target.

pBrushProperties
A pointer to the opacity and transformation of a brush.

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

Destroys a CD2DBrush object.

virtual void Destroy();

Detaches resource interface from the object

ID2D1Brush* Detach();

Return Value

Pointer to detached resource interface.

Returns ID2D1Brush interface

ID2D1Brush* Get();

Return Value

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

Gets the degree of opacity of this brush

FLOAT GetOpacity() const;  

Return Value

A value between zero and 1 that indicates the opacity of the brush. This value is a constant multiplier that linearly scales the alpha value of all pixels filled by the brush. The opacity values are clamped in the range 0 to 1 before they are multiplied together

Gets the current transform of the render target

void GetTransform(D2D1_MATRIX_3X2_F* transform) const;  

Parameters

transform
When this returns, contains the current transform of the render target. This parameter is passed uninitialized

Checks resource validity

virtual BOOL IsValid() const;  

Return Value

TRUE if resource is valid; otherwise FALSE.

Stores a pointer to an ID2D1Brush object.

ID2D1Brush* m_pBrush;  

Brush properties.

CD2DBrushProperties* m_pBrushProperties;  

Returns ID2D1Brush interface

operator ID2D1Brush*();

Return Value

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

Sets the degree of opacity of this brush

void SetOpacity(FLOAT opacity);

Parameters

opacity
A value between zero and 1 that indicates the opacity of the brush. This value is a constant multiplier that linearly scales the alpha value of all pixels filled by the brush. The opacity values are clamped in the range 0 to 1 before they are multiplied together

Applies the specified transform to the render target, replacing the existing transformation. All subsequent drawing operations occur in the transformed space

void SetTransform(const D2D1_MATRIX_3X2_F* transform);

Parameters

transform
The transform to apply to the render target

Classes

Show: