Compartilhar via


Interface ID2D1RadialGradientBrush (d2d1.h)

Pinta uma área com um gradiente radial.

Herança

A interface ID2D1RadialGradientBrush herda de ID2D1Brush. ID2D1RadialGradientBrush também tem estes tipos de membros:

Métodos

A interface ID2D1RadialGradientBrush tem esses métodos.

 
ID2D1RadialGradientBrush::GetCenter

Recupera o centro da elipse de gradiente.
ID2D1RadialGradientBrush::GetGradientOriginOffset

Recupera o deslocamento da origem do gradiente em relação ao centro da elipse de gradiente.
ID2D1RadialGradientBrush::GetGradientStopCollection

Recupera o ID2D1GradientStopCollection associado a esse objeto de pincel de gradiente radial.
ID2D1RadialGradientBrush::GetRadiusX

Recupera o raio x da elipse de gradiente.
ID2D1RadialGradientBrush::GetRadiusY

Recupera o raio y da elipse de gradiente.
ID2D1RadialGradientBrush::SetCenter

Especifica o centro da elipse de gradiente no espaço de coordenadas do pincel.
ID2D1RadialGradientBrush::SetGradientOriginOffset

Especifica o deslocamento da origem do gradiente em relação ao centro da elipse de gradiente.
ID2D1RadialGradientBrush::SetRadiusX

Especifica o raio x da elipse de gradiente, no espaço de coordenadas do pincel.
ID2D1RadialGradientBrush::SetRadiusY

Especifica o raio y da elipse de gradiente, no espaço de coordenadas do pincel.

Comentários

O ID2D1RadialGradientBrush é semelhante ao ID2D1LinearGradientBrush , pois ambos mapeiam uma coleção de paradas de gradiente para um gradiente. No entanto, o gradiente linear tem um ponto inicial e final para definir o vetor de gradiente, enquanto o gradiente radial usa uma elipse e uma origem de gradiente para definir seu comportamento de gradiente. Para definir a posição e o tamanho da elipse, use os métodos SetCenter, SetRadiusX e SetRadiusY para especificar o raio central, x e y da elipse. A origem do gradiente é o centro da elipse, a menos que um deslocamento de gradiente seja especificado usando o método SetGradientOriginOffset .

O pincel mapeia a posição de parada de gradiente 0,0f da origem do gradiente e a posição 1,0f é mapeada para o limite de elipse. Quando a origem do gradiente está dentro da elipse, o conteúdo da elipse inclui todo o intervalo [0, 1] do gradiente do pincel para. Se a origem do gradiente estiver fora dos limites da elipse, o pincel ainda funcionará, mas seu gradiente não será bem definido.

O ponto inicial e o ponto de extremidade são descritos no espaço de pincel e são mapeados para o destino de renderização quando o pincel é usado. Observe que as coordenadas inicial e final são absolutas, não em relação ao tamanho do destino de renderização. Um valor de (0, 0) é mapeado para o canto superior esquerdo do destino de renderização, enquanto um valor de (1, 1) mapeia apenas um pixel diagonalmente de (0, 0). Se houver uma transformação de pincel de não entidade ou uma transformação de destino de renderização, a elipse de pincel e a origem do gradiente também serão transformadas.

É possível especificar uma elipse que não preenche completamente a área que está sendo pintada. Quando isso ocorre, o D2D1_EXTEND_MODE e a configuração (especificados pelo pincel ID2D1GradientStopCollection) determinam como a área restante é pintada.

Criando objetos ID2D1RadialGradientBrush

Para criar um pincel de gradiente radial, use o método ID2D1RenderTarget::CreateRadialGradientBrush do destino de renderização no qual o pincel será usado. O pincel só pode ser usado com o destino de renderização que o criou ou com os destinos compatíveis para esse destino de renderização.

Um pincel de gradiente radial é um recurso dependente do dispositivo: seu aplicativo deve criar pincéis de gradiente radial depois de inicializar o destino de renderização com o qual os pincéis serão usados e recriar os pincéis sempre que o destino de renderização precisar ser recriado. (Para obter mais informações sobre recursos, consulte Visão geral de recursos.)

Exemplos

Para obter um exemplo de como criar um pincel de gradiente radial, consulte o tópico Como criar um pincel de gradiente radial .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1.h

Confira também

Visão geral de pincéis

Como criar um pincel de gradiente radial

ID2D1Brush