Funzione SetPixelFormat (wingdi.h)

Articolo
08/27/2023

La funzione SetPixelFormat imposta il formato pixel del contesto di dispositivo specificato sul formato specificato dall'indice iPixelFormat .

Sintassi

BOOL SetPixelFormat(
  HDC                         hdc,
  int                         format,
  const PIXELFORMATDESCRIPTOR *ppfd
);

Parametri

hdc

Specifica il contesto del dispositivo il cui formato pixel tenta di impostare la funzione.

format

Indice che identifica il formato pixel da impostare. I vari formati di pixel supportati da un contesto di dispositivo sono identificati da indici basati su un'unica.

ppfd

Puntatore a una struttura PIXELFORMATDESCRIPTOR che contiene la specifica del formato pixel logico. Il componente metafile del sistema usa questa struttura per registrare la specifica del formato pixel logico. La struttura non ha alcun altro effetto sul comportamento della funzione SetPixelFormat .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Se hdc fa riferimento a una finestra, la chiamata alla funzione SetPixelFormat modifica anche il formato pixel della finestra. L'impostazione del formato pixel di una finestra più volte può causare complicazioni significative per Window Manager e per le applicazioni multithread, quindi non è consentito. Un'applicazione può impostare il formato pixel di una finestra una sola volta. Una volta impostato il formato pixel di una finestra, non può essere modificato.

È necessario selezionare un formato pixel nel contesto di dispositivo prima di chiamare la funzione wglCreateContext . La funzione wglCreateContext crea un contesto di rendering per il disegno sul dispositivo nel formato pixel selezionato del contesto di dispositivo.

Una finestra OpenGL ha un proprio formato pixel. Per questo motivo, solo i contesti di dispositivo recuperati per l'area client di una finestra OpenGL possono disegnare nella finestra. Di conseguenza, deve essere creata una finestra OpenGL con gli stili WS_CLIPCHILDREN e WS_CLIPSIBLINGS. Inoltre, l'attributo della classe window non deve includere lo stile CS_PARENTDC.

Esempio

L'esempio di codice seguente mostra l'utilizzo di SetPixelFormat .

PIXELFORMATDESCRIPTOR pfd = { 
    sizeof(PIXELFORMATDESCRIPTOR),   // size of this pfd  
    1,                     // version number  
    PFD_DRAW_TO_WINDOW |   // support window  
    PFD_SUPPORT_OPENGL |   // support OpenGL  
    PFD_DOUBLEBUFFER,      // double buffered  
    PFD_TYPE_RGBA,         // RGBA type  
    24,                    // 24-bit color depth  
    0, 0, 0, 0, 0, 0,      // color bits ignored  
    0,                     // no alpha buffer  
    0,                     // shift bit ignored  
    0,                     // no accumulation buffer  
    0, 0, 0, 0,            // accum bits ignored  
    32,                    // 32-bit z-buffer  
    0,                     // no stencil buffer  
    0,                     // no auxiliary buffer  
    PFD_MAIN_PLANE,        // main layer  
    0,                     // reserved  
    0, 0, 0                // layer masks ignored  
}; 
HDC  hdc; 
int  iPixelFormat; 
 
// get the best available match of pixel format for the device context   
iPixelFormat = ChoosePixelFormat(hdc, &pfd); 
 
// make that the pixel format of the device context  
SetPixelFormat(hdc, iPixelFormat, &pfd);

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
Libreria	Gdi32.lib
DLL	Gdi32.dll