DirectX/Inizializzazione/Device e SwapChain: differenze tra le versioni

== Creare le strutture ==

In quasi tutti i libri e tutorial online troverete una chiamata a questa funzione:

HRESULT WINAPI D3D10CreateDeviceAndSwapChain(IDXGIAdapter *pAdapter, D3D10_DRIVER_TYPE DriverType, HMODULE Software, UINT Flags, UINT SDKVersion, DXGI_SWAP_CHAIN_DESC *pSwapChainDesc, IDXGISwapChain **ppSwapChain, ID3D10Device **ppDevice);

Questa funzione come ricorda il nome crea Device e SwapChain contemporaneamente. Tralasciamo per un secondo l'enorme numero di argomenti. Per quanto possa essere "comodo" creare entrambe le strutture con una sola istruzione, questo porta almeno un aspetto negativo: nella funzione trovate un puntatore a struttura DXGI_SWAP_CHAIN_DEST *''pSwapChainDesc''. Questa struttura, simile a WNDCLASSEX, serve a descrivere le caratteristiche del programma (risoluzione, profondità di colore, frequenza), tra cui l'[[w:Antialiasing|Antialiasing]].

 

== Strutture da conoscere ==

La prima struttura da saper usare è DXGI_MODE_DESC. Questa struttura contiene le informazioni riguardanti una determinata risoluzione video:

struct DXGI_MODE_DESC

{

DXGI_MODE_SCALING Scaling;

};

* Width, Height, sono il numero di pixel orizzontali e verticali che la risoluzione offre (1024x768: Width = 1024, Height = 768).

* RefreshRate è un'altra struttura con due membri: Numerator e Denominator. Questa consente di rappresentare un numero razionale. Il valore di questo campo indica la frequenza di refresh (Refresh Rate). Ne perleremo a breve.

 

Passiamo a DXGI_SAMPLE_DESC:

struct DXGI_SAMPLE_DESC

{

UINT Quality;

};

Questa struttura indica le impostazioni di Antialiasing da applicare. ''Count'' è il livello scelto (1 - disattivato, 2, 4, 8, 16, 32). ''Quality'' è un campo a cui ogni scheda video può dare una propria interpretazione. Nonostante si chiami ''Qualità'', aumentarne il valore non corrisponde sempre ad un miglioramento visivo. Impostarlo a valori errati, può far crashare il programma allo stesso modo in cui crasha, dando a ''Count'' un valore errato o non supportato.

 

Veniamo ora allo DXGI_SWAP_CHAIN_DESC, la struttura che ci farà creare lo SwapChain:

struct DXGI_SWAP_CHAIN_DESC

{

UINT Flags;

};

* BufferDesc: è una struttura di tipo DXGI_MODE_DESC. Indica la modalità video (risoluzione, colore) che vogliamo usare nel caso in cui volessimo lavorare Fullscreen (a schermo intero). Quando lavoriamo in modalità Windowed (disegnamo dentro una finestra delimitata da bordi e barra del titolo), i campi Width e Height vanno impostati alla dimensione della finestra. Indicano insomma i lati del rettangolo da disegno che andremo ad usare.

* SampleDesc: le impostazioni di Antialiasing.

== Creare le strutture con una sola chiamata ==

Nel caso in cui aveste deciso la strada "semplice", senza Antialiasing, e che crea le strutture in una sola volta dovrete usare questa funzione:

HRESULT WINAPI D3D10CreateDeviceAndSwapChain(IDXGIAdapter *pAdapter, D3D10_DRIVER_TYPE DriverType, HMODULE Software, UINT Flags, UINT SDKVersion, DXGI_SWAP_CHAIN_DESC *pSwapChainDesc, IDXGISwapChain **ppSwapChain, ID3D10Device **ppDevice);

Vediamo ora gli argomenti:

*pAdapter: quale scheda video vuoi utilizzare? Impostando a NULL, chiediamo di usare quella predefinita. Vedremo dopo come trovare le schede disponibili.

 

Ecco il codice:

/* Determiniamo quale risoluzione vogliamo utilizzare. Nel prossimo capitolo vedremo. */

/* Supponiamo di voler usare 800x600 */

if (hr != S_OK)

printf("Errore nella creazione del Device o dello SwapChain\n");

 

{{Avanzamento|75%|14 ottobre 2011}}