Funzione CreateHalftonePalette (wingdi.h)

La funzione CreateHalftonePalette crea una tavolozza a metàtone per il contesto di dispositivo (DC) specificato.

Syntax

HPALETTE CreateHalftonePalette(
  [in] HDC hdc
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per una tavolozza a metàtone logica.

Se la funzione ha esito negativo, il valore restituito è zero.

Remarks

Un'applicazione deve creare una tavolozza halftone quando la modalità di estensione di un contesto di dispositivo è impostata su HALFTONE. La tavolozza a metàtone logica restituita da CreateHalftonePalette deve quindi essere selezionata e realizzata nel contesto del dispositivo prima che venga chiamata la funzione StretchBlt o StretchDIBits .

La tavolozza halftone contiene i 20 colori di sistema statici più un set di colori indipendente dal dispositivo (un cubo di colori RGB 6x6x6 e altre sfumature di grigio) scelto per approssimare un'ampia gamma di colori quando un'immagine viene dithered. Le voci di colore esatte sono un dettaglio di implementazione e non sono necessariamente identiche tra dispositivi o versioni Windows. Le applicazioni non devono dipendere da valori di tavolozza specifici o da un particolare algoritmo dithering. Per esaminare le voci in fase di esecuzione, chiamare GetPaletteEntries sul quadratino di tavolozza restituito.

Quando la tavolozza non è più necessaria, chiamare la funzione DeleteObject per eliminarla.

Requisiti

Vedere anche

Funzioni colore

Panoramica dei colori

DeleteObject

GetPaletteEntries

RealizePalette

SelectPalette

SetStretchBltMode

StretchBlt

StretchDIBits