Método ID2D1DeviceContext::CreateGradientStopCollection (d2d1_1.h)

Cria uma coleção de stop de gradiente, permitindo que o gradiente contenha canais de cores com valores fora de [0,1] e também habilitando a renderização para um destino de renderização de alta cor com interpolação no espaço sRGB.

Sintaxe

HRESULT CreateGradientStopCollection(
        const D2D1_GRADIENT_STOP      *straightAlphaGradientStops,
        UINT32                        straightAlphaGradientStopsCount,
        D2D1_COLOR_SPACE              preInterpolationSpace,
        D2D1_COLOR_SPACE              postInterpolationSpace,
        D2D1_BUFFER_PRECISION         bufferPrecision,
        D2D1_EXTEND_MODE              extendMode,
        D2D1_COLOR_INTERPOLATION_MODE colorInterpolationMode,
  [out] ID2D1GradientStopCollection1  **gradientStopCollection1
);

Parâmetros

straightAlphaGradientStops

Tipo: const D2D1_GRADIENT_STOP*

Uma matriz de valores de cor e deslocamentos.

straightAlphaGradientStopsCount

Tipo: UINT

O número de elementos na matriz gradientStops .

preInterpolationSpace

Tipo: D2D1_COLOR_SPACE

Especifica o espaço de cor de entrada e o espaço no qual a interpolação de cor ocorre.

postInterpolationSpace

Tipo: D2D1_COLOR_SPACE

O espaço de cor em que as cores serão convertidas após a interpolação ocorrer.

bufferPrecision

Tipo: D2D1_BUFFER_PRECISION

A precisão da textura usada para conter valores interpolados.

extendMode

Tipo: D2D1_EXTEND_MODE

Define como as cores fora do intervalo definido pela coleção stop são determinadas.

colorInterpolationMode

Tipo: D2D1_COLOR_INTERPOLATION_MODE

Define como as cores são interpoladas. D2D1_COLOR_INTERPOLATION_MODE_PREMULTIPLIED é o padrão, consulte Comentários para obter mais informações.

[out] gradientStopCollection1

Tipo: ID2D1GradientStopCollection1**

A nova coleção de stop de gradiente.

Retornar valor

Tipo: HRESULT

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Comentários

Esse método interpola linearmente entre as paradas de cor. Uma conversão de espaço de cor opcional é aplicada após a interpolação. Se e como essa conversão gama é aplicada é determinada pela interpolação pré e pós-interpolação. Esse método falhará se o contexto do dispositivo não der suporte à precisão de buffer solicitada.

Para obter o resultado desejado, você precisa garantir que as entradas sejam especificadas no espaço de cores correto.

Você sempre deve especificar cores em alfa reto, independentemente do modo de interpolação ser pré-multiplicado ou reto. O modo de interpolação afeta apenas os valores interpolados. Da mesma forma, as paradas retornadas por ID2D1GradientStopCollection::GetGradientStops sempre terão alfa reto.

Se você especificar D2D1_COLOR_INTERPOLATION_MODE_PREMULTIPLIED, todas as paradas serão pré-multiplicadas antes da interpolação e, em seguida, não pré-multiplicadas antes da conversão de cor.

Começando com Windows 8, o comportamento de interpolação desse método foi alterado.

A tabela aqui mostra o comportamento no Windows 7 e anteriores.

A tabela aqui mostra o comportamento em Windows 8 e posteriores.

Requisitos

Confira também

D2D1_BUFFER_PRECISION

D2D1_EXTEND_MODE

D2D1_GAMMA_CONVERSION

D2D1_GRADIENT_STOP

ID2D1DeviceContext

ID2D1GradientStopCollection1

ID2D1RenderTarget::CreateGradientStopCollection