Interfaccia ID2D1RadialGradientBrush (d2d1.h)
Disegna un'area con una sfumatura radiale.
Ereditarietà
L'interfaccia ID2D1RadialGradientBrush eredita da ID2D1Brush. ID2D1RadialGradientBrush include anche questi tipi di membri:
Metodi
L'interfaccia ID2D1RadialGradientBrush include questi metodi.
| ID2D1RadialGradientBrush::GetCenter Recupera il centro dei puntini di sospensione sfumatura. |
| ID2D1RadialGradientBrush::GetGradientOriginOffset Recupera l'offset dell'origine sfumatura rispetto al centro dell'ellisse sfumatura. |
| ID2D1RadialGradientBrush::GetGradientStopCollection Recupera l'ID2D1GradientStopCollection associato a questo oggetto pennello a sfumatura radiale. |
| ID2D1RadialGradientBrush::GetRadiusX Recupera il raggio x dell'ellisse sfumatura. |
| ID2D1RadialGradientBrush::GetRadiusY Recupera il raggio y dell'ellisse sfumatura. |
| ID2D1RadialGradientBrush::SetCenter Specifica il centro dei puntini di sospensione sfumatura nello spazio delle coordinate del pennello. |
| ID2D1RadialGradientBrush::SetGradientOriginOffset Specifica l'offset dell'origine sfumatura rispetto al centro dell'ellisse sfumatura. |
| ID2D1RadialGradientBrush::SetRadiusX Specifica il raggio x dell'ellisse sfumatura nello spazio delle coordinate del pennello. |
| ID2D1RadialGradientBrush::SetRadiusY Specifica il raggio y dell'ellisse sfumatura nello spazio delle coordinate del pennello. |
Commenti
L'ID2D1RadialGradientBrush è simile all'ID2D1LinearGradientBrush in cui entrambi mappano una raccolta di interruzioni sfumature a una sfumatura. Tuttavia, la sfumatura lineare ha un punto iniziale e un punto finale per definire il vettore sfumatura sfumatura, mentre la sfumatura radiale usa un punto di sospensione e un'origine sfumatura per definire il relativo comportamento sfumatura. Per definire la posizione e le dimensioni dei puntini di sospensione, usare i metodi SetCenter, SetRadiusX e SetRadiusY per specificare il centro, il raggio x e il raggio y dell'ellisse. L'origine sfumatura è il centro dell'ellisse, a meno che non venga specificato un offset sfumatura usando il metodo SetGradientOriginOffset .
Il pennello esegue il mapping della posizione di arresto sfumatura 0,0f dell'origine sfumatura e la posizione 1.0f viene mappata al limite dell'ellisse. Quando l'origine sfumatura si trova all'interno dell'ellisse, il contenuto dell'ellisse racchiude l'intero intervallo [0, 1] della sfumatura del pennello si arresta. Se l'origine sfumatura è esterna ai limiti dell'ellisse, il pennello funziona ancora, ma la sfumatura non è ben definita.
Il punto iniziale e il punto finale sono descritti nello spazio pennello e vengono mappati alla destinazione di rendering quando viene usato il pennello. Si noti che le coordinate iniziali e finali sono assolute, non relative alle dimensioni della destinazione di rendering. Un valore di (0, 0) esegue il mapping all'angolo superiore sinistro della destinazione di rendering, mentre un valore di (1, 1) esegue il mapping di un solo pixel in diagonale da (0, 0). Se è presente una trasformazione del pennello di non rientro o la trasformazione di destinazione di rendering, vengono trasformati anche i puntini di sospensione del pennello e l'origine sfumatura.
È possibile specificare un'ellisse che non riempie completamente l'area dipinta. Quando si verifica questo problema, l'D2D1_EXTEND_MODE e l'impostazione (specificata dal pennello ID2D1GradientStopCollection) determina il modo in cui viene dipinta l'area rimanente.
Creazione di oggetti ID2D1RadialGradientBrush
Per creare un pennello sfumatura radiale, usare il metodo ID2D1RenderTarget::CreateRadialGradientBrush della destinazione di rendering in cui verrà usato il pennello. Il pennello può essere usato solo con la destinazione di rendering che l'ha creata o con le destinazioni compatibili per tale destinazione di rendering.Un pennello sfumatura radiale è una risorsa dipendente dal dispositivo: l'applicazione deve creare pennelli sfumature radiali dopo aver inizializzato la destinazione di rendering con cui verranno usati i pennelli e ricreare i pennelli ogni volta che la destinazione di rendering deve essere ricreata. Per altre informazioni sulle risorse, vedere Panoramica delle risorse.
Esempio
Per un esempio su come creare un pennello sfumatura radiale, vedere l'argomento How to Create a Radial Gradient Brush (Come creare un pennello sfumatura radiale).
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | d2d1.h |