Funzione SetStretchBltMode (wingdi.h)

Articolo
03/04/2024

La funzione SetStretchBltMode imposta la modalità di estensione bitmap nel contesto di dispositivo specificato.

Sintassi

int SetStretchBltMode(
  [in] HDC hdc,
  [in] int mode
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] mode

Modalità di estensione. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
BLACKONWHITE	Esegue un'operazione AND booleana utilizzando i valori di colore per i pixel eliminati ed esistenti. Se la bitmap è una bitmap monocromatica, questa modalità mantiene i pixel neri a scapito dei pixel bianchi.
COLORONCOLOR	Elimina i pixel. Questa modalità elimina tutte le righe di pixel eliminate senza tentare di conservare le informazioni.
SEMITONO	Esegue il mapping dei pixel dal rettangolo di origine in blocchi di pixel nel rettangolo di destinazione. Il colore medio del blocco di pixel di destinazione approssima il colore dei pixel di origine. Dopo aver impostato la modalità di estensione HALFTONE, un'applicazione deve chiamare la funzione SetBrushOrgEx per impostare l'origine del pennello. Se non riesce a farlo, si verifica un disallineamento del pennello.
STRETCH_ANDSCANS	Uguale a BLACKONWHITE.
STRETCH_DELETESCANS	Uguale a COLORONCOLOR.
STRETCH_HALFTONE	Uguale a HALFTONE.
STRETCH_ORSCANS	Uguale a WHITEONBLACK.
WHITEONBLACK	Esegue un'operazione OR booleana utilizzando i valori di colore per i pixel eliminati ed esistenti. Se la bitmap è una bitmap monocromatica, questa modalità mantiene i pixel bianchi a scapito dei pixel neri.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è la modalità di estensione precedente.

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

Questa funzione può restituire il valore seguente.

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Uno o più parametri di input non sono validi.

Commenti

La modalità di estensione definisce il modo in cui il sistema combina righe o colonne di una bitmap con pixel esistenti in un dispositivo di visualizzazione quando un'applicazione chiama la funzione StretchBlt .

Le modalità BLACKONWHITE (STRETCH_ANDSCANS) e WHITEONBLACK (STRETCH_ORSCANS) vengono in genere usate per mantenere i pixel di primo piano nelle bitmap monocromatiche. La modalità COLORONCOLOR (STRETCH_DELETESCANS) viene in genere usata per mantenere il colore nelle bitmap a colori.

La modalità HALFTONE è più lenta e richiede più elaborazione dell'immagine di origine rispetto alle altre tre modalità; ma produce immagini di qualità superiore. Si noti anche che SetBrushOrgEx deve essere chiamato dopo aver impostato la modalità HALFTONE per evitare il disallineamento del pennello.

Potrebbero essere disponibili anche altre modalità di estensione a seconda delle funzionalità del driver di dispositivo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll