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 |