Metodo ID2D1DeviceContext::CreateGradientStopCollection (d2d1_1.h)

Crea una raccolta di stop sfumatura, consentendo al gradiente di contenere i canali di colore con valori esterni a [0,1] e abilitando anche il rendering in una destinazione di rendering ad alto colore con interpolazione nello spazio sRGB.

Sintassi

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
);

Parametri

straightAlphaGradientStops

Tipo: const D2D1_GRADIENT_STOP*

Matrice di valori di colore e offset.

straightAlphaGradientStopsCount

Tipo: UINT

Numero di elementi nella matrice gradientStops .

preInterpolationSpace

Tipo: D2D1_COLOR_SPACE

Specifica sia lo spazio dei colori di input che lo spazio in cui si verifica l'interpolazione dei colori.

postInterpolationSpace

Tipo: D2D1_COLOR_SPACE

Lo spazio dei colori che i colori verranno convertiti in dopo che si verifica l'interpolazione.

bufferPrecision

Tipo: D2D1_BUFFER_PRECISION

Precisione della trama usata per contenere valori interpolati.

extendMode

Tipo: D2D1_EXTEND_MODE

Definisce il modo in cui vengono determinati i colori all'esterno dell'intervallo definito dall'insieme stop.

colorInterpolationMode

Tipo: D2D1_COLOR_INTERPOLATION_MODE

Definisce la modalità di interpolazione dei colori. D2D1_COLOR_INTERPOLATION_MODE_PREMULTIPLIED è l'impostazione predefinita, vedere Osservazioni per altre informazioni.

[out] gradientStopCollection1

Tipo: ID2D1GradientStopCollection1**

Nuova raccolta di interruzioni sfumature.

Valore restituito

Tipo: HRESULT

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Commenti

Questo metodo interpola in modo lineare tra le interruzioni del colore. Viene applicata una conversione facoltativa dello spazio dei colori dopo l'interpolazione. Se e come viene applicata questa conversione gamma viene determinata dalla pre-interpolazione e post-interpolazione. Questo metodo avrà esito negativo se il contesto del dispositivo non supporta la precisione del buffer richiesta.

Per ottenere il risultato desiderato, è necessario assicurarsi che gli input siano specificati nello spazio dei colori corretto.

È sempre necessario specificare i colori in alfa dritto, indipendentemente dalla modalità interpolazione premultiplied o dritta. La modalità di interpolazione influisce solo sui valori interpolati. Analogamente, le interruzioni restituite da ID2D1GradientStopCollection::GetGradientStops avranno sempre alfa dritto.

Se si specifica D2D1_COLOR_INTERPOLATION_MODE_PREMULTIPLIED, tutti gli arresti vengono premultiplied prima dell'interpolazione e quindi non premultiplied prima della conversione del colore.

A partire da Windows 8, il comportamento di interpolazione di questo metodo è cambiato.

La tabella seguente mostra il comportamento in Windows 7 e versioni precedenti.

La tabella seguente mostra il comportamento in Windows 8 e versioni successive.

Requisiti

Vedi anche

D2D1_BUFFER_PRECISION

D2D1_EXTEND_MODE

D2D1_GAMMA_CONVERSION

D2D1_GRADIENT_STOP

ID2D1DeviceContext

ID2D1GradientStopCollection1

ID2D1RenderTarget::CreateGradientStopCollection