Funzione SetStretchBltMode (wingdi.h)

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

Vedi anche

Funzioni bitmap

Panoramica delle bitmap

GetStretchBltMode

SetBrushOrgEx

StretchBlt