HRESULT CreateIndexBuffer( UINT Length , DWORD Usage, D3DFORMAT Format , D3DPOOL Pool, IDirect3DIndexBuffer8** ppIndexBuffer );Length には、インデックスバッファのサイズをバイト単位で指定します
定数 | 解説 |
---|---|
D3DERR_INVALIDCALL | メソッドの呼び出しが無効である |
D3DERR_OUTOFVIDEOMEMORY | 十分なディスプレイメモリが存在しない |
D3DXERR_INVALIDDATA | データが無効である |
E_OUTOFMEMORY | 十分なメモリを割り当てることができない |
HRESULT Lock( UINT OffsetToLock , UINT SizeToLock , BYTE** ppbData , DWORD Flags );OffsetToLock はロックするインデックスデータのオフセットを
HRESULT SetIndices( IDirect3DIndexBuffer8* pIndexData , UINT BaseVertexIndex );pIndexData には、インデックスバッファを指定します
HRESULT DrawIndexedPrimitive( D3DPRIMITIVETYPE Type , UINT MinIndex , UINT NumVertices , UINT StartIndex , UINT PrimitiveCount );Type には、描画するプリミティブを指定します
#include <windows.h> #include <d3d8.h> #include <d3dx8.h> #define TITLE TEXT("Kitty on your lap") #define D3DFVF D3DFVF_XYZRHW | D3DFVF_DIFFUSE IDirect3D8 * pDirect3D; IDirect3DDevice8 * pD3Device; D3DPRESENT_PARAMETERS d3dpp; typedef struct { float x , y , z , w; DWORD color; } D3DVERTEX; LRESULT CALLBACK WndProc(HWND hWnd , UINT msg , WPARAM wp , LPARAM lp) { static D3DVERTEX pt[] = { {10 , 10 , 0 , 1 , 0xFFFF0000} , {200 , 10 , 0 , 1 , 0xFFFF00FF} , {10 , 200 , 0 , 1 , 0xFFFF00FF} , {200 , 200 , 0 , 1 , 0xFF0000FF} }; static WORD index[] = { 0 , 1 , 2 , 3 , 2 , 1}; BYTE *bBuf; static IDirect3DVertexBuffer8 *d3dvb; static IDirect3DIndexBuffer8 *d3dib; switch(msg){ case WM_DESTROY: PostQuitMessage(0); break; case WM_CREATE: pDirect3D->CreateDevice( D3DADAPTER_DEFAULT , D3DDEVTYPE_HAL , hWnd , D3DCREATE_SOFTWARE_VERTEXPROCESSING , &d3dpp , &pD3Device ); pD3Device->CreateVertexBuffer( sizeof (D3DVERTEX) * 4 , 0 , D3DFVF , D3DPOOL_MANAGED , &d3dvb); d3dvb->Lock(0 , 0 , &bBuf , 0); memcpy(bBuf , pt , sizeof (D3DVERTEX) * 4); d3dvb->Unlock(); pD3Device->CreateIndexBuffer(sizeof (WORD) * 6 , D3DUSAGE_WRITEONLY , D3DFMT_INDEX16 , D3DPOOL_MANAGED , &d3dib); d3dib->Lock(0 , 0 , &bBuf , 0); memcpy(bBuf , index , sizeof (WORD) * 6); d3dib->Unlock(); return 0; case WM_PAINT: pD3Device->Clear(0 , NULL , D3DCLEAR_TARGET , D3DCOLOR_XRGB(0xFF , 0xFF , 0xFF) , 1.0 , 0); pD3Device->BeginScene(); pD3Device->SetVertexShader(D3DFVF); pD3Device->SetStreamSource(0 , d3dvb , sizeof (D3DVERTEX)); pD3Device->SetIndices(d3dib , 0); pD3Device->DrawIndexedPrimitive(D3DPT_TRIANGLELIST , 0 , 4 , 0 , 2); pD3Device->EndScene(); pD3Device->Present(NULL , NULL , NULL , NULL); ValidateRect(hWnd , NULL); break; case WM_SIZE: if(pD3Device && (wp == SIZE_RESTORED || wp == SIZE_MAXIMIZED)) { d3dpp.BackBufferWidth = LOWORD(lp); d3dpp.BackBufferHeight = HIWORD(lp); pD3Device->Reset(&d3dpp); InvalidateRect(hWnd,NULL,TRUE); } return 0; } return DefWindowProc(hWnd , msg , wp , lp); } int WINAPI WinMain(HINSTANCE hInstance , HINSTANCE hPrevInstance , LPSTR lpCmdLine,int nCmdShow) { MSG msg; HWND hWnd; WNDCLASS winc; D3DDISPLAYMODE dmode; pDirect3D = Direct3DCreate8(D3D_SDK_VERSION); pDirect3D->GetAdapterDisplayMode(D3DADAPTER_DEFAULT , &dmode); ZeroMemory(&d3dpp , sizeof (d3dpp)); d3dpp.Windowed = TRUE; d3dpp.SwapEffect = D3DSWAPEFFECT_DISCARD; d3dpp.BackBufferFormat = dmode.Format; d3dpp.BackBufferCount = 1; winc.style = CS_CLASSDC; winc.lpfnWndProc = WndProc; winc.cbClsExtra = winc.cbWndExtra = 0; winc.hInstance = hInstance; winc.hIcon = LoadIcon(NULL , IDI_APPLICATION); winc.hCursor = LoadCursor(NULL,IDC_ARROW); winc.hbrBackground = (HBRUSH)GetStockObject(WHITE_BRUSH); winc.lpszMenuName = NULL; winc.lpszClassName = TEXT("KITTY"); if(!RegisterClass(&winc)) return 0; hWnd = CreateWindow(TEXT("KITTY") , TITLE , WS_OVERLAPPEDWINDOW | WS_VISIBLE , CW_USEDEFAULT , CW_USEDEFAULT , CW_USEDEFAULT , CW_USEDEFAULT , (HWND)NULL,(HMENU)NULL , hInstance , (LPSTR)NULL); while (GetMessage(&msg , NULL , 0 , 0 )) { TranslateMessage(&msg); DispatchMessage(&msg); } pDirect3D->Release(); pD3Device->Release(); return msg.wParam; }
HRESULT DrawIndexedPrimitiveUP( D3DPRIMITIVETYPE PrimitiveType , UINT MinIndex , UINT NumVertices , UINT PrimitiveCount , CONST void* pIndexData , D3DFORMAT IndexDataFormat , CONST void* pVertexStreamZeroData , UINT VertexStreamZeroStride );PrimitiveType にはプリミティブを指定します
#include <windows.h> #include <d3d8.h> #include <d3dx8.h> #define TITLE TEXT("Kitty on your lap") #define D3DFVF D3DFVF_XYZRHW | D3DFVF_DIFFUSE IDirect3D8 * pDirect3D; IDirect3DDevice8 * pD3Device; D3DPRESENT_PARAMETERS d3dpp; typedef struct { float x , y , z , w; DWORD color; } D3DVERTEX; LRESULT CALLBACK WndProc(HWND hWnd , UINT msg , WPARAM wp , LPARAM lp) { static D3DVERTEX pt[] = { {10 , 10 , 0 , 1 , 0xFFFF0000} , {200 , 10 , 0 , 1 , 0xFFFF00FF} , {10 , 200 , 0 , 1 , 0xFFFF00FF} , {200 , 200 , 0 , 1 , 0xFF0000FF} }; static WORD index[] = { 0 , 1 , 2 , 3 , 2 , 1}; switch(msg){ case WM_DESTROY: PostQuitMessage(0); break; case WM_CREATE: pDirect3D->CreateDevice( D3DADAPTER_DEFAULT , D3DDEVTYPE_HAL , hWnd , D3DCREATE_SOFTWARE_VERTEXPROCESSING , &d3dpp , &pD3Device ); return 0; case WM_PAINT: pD3Device->Clear(0 , NULL , D3DCLEAR_TARGET , D3DCOLOR_XRGB(0xFF , 0xFF , 0xFF) , 1.0 , 0); pD3Device->BeginScene(); pD3Device->SetVertexShader(D3DFVF); pD3Device->DrawIndexedPrimitiveUP( D3DPT_TRIANGLELIST , 0 , 4 , 2 , index , D3DFMT_INDEX16 , pt , sizeof (D3DVERTEX)); pD3Device->EndScene(); pD3Device->Present(NULL , NULL , NULL , NULL); ValidateRect(hWnd , NULL); break; case WM_SIZE: if(pD3Device && (wp == SIZE_RESTORED || wp == SIZE_MAXIMIZED)) { d3dpp.BackBufferWidth = LOWORD(lp); d3dpp.BackBufferHeight = HIWORD(lp); pD3Device->Reset(&d3dpp); InvalidateRect(hWnd,NULL,TRUE); } return 0; } return DefWindowProc(hWnd , msg , wp , lp); } int WINAPI WinMain(HINSTANCE hInstance , HINSTANCE hPrevInstance , LPSTR lpCmdLine,int nCmdShow) { MSG msg; HWND hWnd; WNDCLASS winc; D3DDISPLAYMODE dmode; pDirect3D = Direct3DCreate8(D3D_SDK_VERSION); pDirect3D->GetAdapterDisplayMode(D3DADAPTER_DEFAULT , &dmode); ZeroMemory(&d3dpp , sizeof (d3dpp)); d3dpp.Windowed = TRUE; d3dpp.SwapEffect = D3DSWAPEFFECT_DISCARD; d3dpp.BackBufferFormat = dmode.Format; d3dpp.BackBufferCount = 1; winc.style = CS_CLASSDC; winc.lpfnWndProc = WndProc; winc.cbClsExtra = winc.cbWndExtra = 0; winc.hInstance = hInstance; winc.hIcon = LoadIcon(NULL , IDI_APPLICATION); winc.hCursor = LoadCursor(NULL,IDC_ARROW); winc.hbrBackground = (HBRUSH)GetStockObject(WHITE_BRUSH); winc.lpszMenuName = NULL; winc.lpszClassName = TEXT("KITTY"); if(!RegisterClass(&winc)) return 0; hWnd = CreateWindow(TEXT("KITTY") , TITLE , WS_OVERLAPPEDWINDOW | WS_VISIBLE , CW_USEDEFAULT , CW_USEDEFAULT , CW_USEDEFAULT , CW_USEDEFAULT , (HWND)NULL,(HMENU)NULL , hInstance , (LPSTR)NULL); while (GetMessage(&msg , NULL , 0 , 0 )) { TranslateMessage(&msg); DispatchMessage(&msg); } pDirect3D->Release(); pD3Device->Release(); return msg.wParam; }このプログラムの結果は、先ほどのものとまったく同じものですが
HRESULT CreateIndexBuffer( UINT Length , DWORD Usage, D3DFORMAT Format , D3DPOOL Pool, IDirect3DIndexBuffer8** ppIndexBuffer );インデックスバッファを作成します
定数 | 解説 |
---|---|
D3DUSAGE_DONOTCLIP |
頂点バッファの内容が決してクリッピングを要求しないことを示す このフラグが設定されたバッファを使ってレンダリングする場合は D3DRS_CLIPPING レンダリング ステートが FALSE に設定されていなければならない |
D3DUSAGE_DYNAMIC | 頂点またはインデックス バッファが動的なメモリの使用を必要とすることを示す これを使用すると、ドライバが配置場所を決定できるので、ドライバにとって有効である 一般的に、静的な頂点バッファはビデオ メモリに配置され 動的な頂点バッファは AGP メモリに配置される 静的な使用方法だけを分離できないことに注意すること D3DUSAGE_DYNAMIC を指定しないと、頂点バッファは静的に作成される D3DUSAGE_DYNAMIC は、D3DLOCK_DISCARD および D3DLOCK_NOOVERWRITE ロッキング フラグによって厳密に強制される この結果、D3DLOCK_DISCARD および D3DLOCK_NOOVERWRITE は D3DUSAGE_DYNAMIC を指定して作成された頂点 およびインデックス バッファでのみ有効である これらは、静的な頂点バッファでは有効なフラグではない D3DUSAGE_DYNAMIC は、管理下の頂点 およびインデックス バッファでは指定できないことに注意すること |
D3DUSAGE_RTPATCHES | 高次プリミティブの描画に頂点バッファを使用するとき設定する |
D3DUSAGE_NPATCHES | N パッチの描画に頂点バッファを使用するとき設定する |
D3DUSAGE_POINTS | ポイント スプライトまたはインデックス付きポイント リストの描画に 頂点バッファを使用するとき設定する |
D3DUSAGE_SOFTWAREPROCESSING | ソフトウェア頂点処理で使用する頂点バッファであることを示す |
D3DUSAGE_WRITEONLY | 頂点バッファへの書き込み操作しか実行しないことをシステムに知らせる このフラグを使用することにより、ドライバは最適なメモリ領域を選択して 効率的に書き込み操作やレンダリングを実行する この能力を使用して作成された頂点バッファからの読み出しは失敗する |
定数 | 解説 |
---|---|
D3DERR_INVALIDCALL | メソッドの呼び出しが無効である |
D3DERR_OUTOFVIDEOMEMORY | 十分なディスプレイメモリが存在しない |
D3DXERR_INVALIDDATA | データが無効である |
E_OUTOFMEMORY | 十分なメモリを割り当てることができない |
HRESULT Lock( UINT OffsetToLock , UINT SizeToLock , BYTE** ppbData , DWORD Flags );指定したデータ範囲をロックして、バッファへのポインタを取得します
定数 | 解説 |
---|---|
D3DLOCK_DISCARD | アプリケーションは、書き込み専用処理でインデックス バッファ全体を上書きする これにより、Direct3D は新しいメモリ領域へのポインタを返すことができるので ダイナミック メモリ アクセス (DMA) と 古い領域からのレンダリングが機能停止することはない |
D3DLOCK_NOOVERWRITE | フレームの開始以降、またはこのフラグが指定されていない最後のロック以降に 描画処理の呼び出しの中で参照された頂点は、ロック中に変更されないことを示す 頂点バッファにのみデータを追加する場合は、このフラグにより処理を最適化できる |
D3DLOCK_NOSYSLOCK | ビデオ メモリ ロックのデフォルトの動作は システムのクリティカル セクションを確保することで ロック中にディスプレイ モードの変更が行われないことを保証する このフラグは、システムワイドなクリティカル セクションがロックの間保持されないようにする ロック処理は若干負荷が高くなるが、マウス カーソルの移動など システムでほかの処理を実行することが可能になる このフラグは、ソフトウェア レンダリングのバックバッファのロックのように ロックが長時間に及び、システムの応答性に 悪影響を与えてしまうようなロックに対して有効である |
D3DLOCK_READONLY | アプリケーションはバッファに書き込みを行わない これにより、いくらかの最適化が実現する D3DLOCK_READONLY は D3DLOCK_DISCARD と共に指定することはできない また、D3DUSAGE_WRITEONLY で作成された頂点バッファに指定することもできない |
HRESULT SetIndices( IDirect3DIndexBuffer8* pIndexData , UINT BaseVertexIndex );デバイスにインデックスデータを設定します
HRESULT DrawIndexedPrimitive( D3DPRIMITIVETYPE Type , UINT MinIndex , UINT NumVertices , UINT StartIndex , UINT PrimitiveCount );インデックスに基いてレンタリングを行います
HRESULT DrawIndexedPrimitiveUP( D3DPRIMITIVETYPE PrimitiveType , UINT MinIndex , UINT NumVertices , UINT PrimitiveCount , CONST void* pIndexData , D3DFORMAT IndexDataFormat , CONST void* pVertexStreamZeroData , UINT VertexStreamZeroStride );ユーザメモリポインタから、指定されているプリミティブをレンタリングします