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 |
|---|---|
|
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. |
|
Elimina i pixel. Questa modalità elimina tutte le righe di pixel eliminate senza tentare di conservare le informazioni. |
|
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. |
|
Uguale a BLACKONWHITE. |
|
Uguale a COLORONCOLOR. |
|
Uguale a HALFTONE. |
|
Uguale a 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 |
|---|---|
|
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 |