ID2D1RenderTarget::CreateRadialGradientBrush(constD2D1_RADIAL_GRADIENT_BRUSH_PROPERTIES*,constD2D1_BRUSH_PROPERTIES*,ID2D1GradientStopCollection*,ID2D1RadialGradientBrush**) method (d2d1.h)

Creates an ID2D1RadialGradientBrush object that can be used to paint areas with a radial gradient.

Syntax

HRESULT CreateRadialGradientBrush(
  const D2D1_RADIAL_GRADIENT_BRUSH_PROPERTIES *radialGradientBrushProperties,
  const D2D1_BRUSH_PROPERTIES                 *brushProperties,
  ID2D1GradientStopCollection                 *gradientStopCollection,
  ID2D1RadialGradientBrush                    **radialGradientBrush
);

Parameters

radialGradientBrushProperties

Type: const D2D1_RADIAL_GRADIENT_BRUSH_PROPERTIES*

The center, gradient origin offset, and x-radius and y-radius of the brush's gradient.

brushProperties

Type: [in] const D2D1_BRUSH_PROPERTIES*

The transform and base opacity of the new brush.

gradientStopCollection

Type: [in] ID2D1GradientStopCollection*

A collection of D2D1_GRADIENT_STOP structures that describe the colors in the brush's gradient and their locations along the gradient.

radialGradientBrush

Type: [out] ID2D1RadialGradientBrush**

When this method returns, contains a pointer to a pointer to the new brush. This parameter is passed uninitialized.

Return value

Type: HRESULT

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

Requirements

Requirement Value
Target Platform Windows
Header d2d1.h
Library D2d1.lib
DLL D2d1.dll

See also

Brushes Overview

How to Create a Radial Gradient Brush

ID2D1RenderTarget