IDirect3DDevice9：：SetFVF 方法 (d3d9.h)

設定目前的頂點數據流宣告。

語法

HRESULT SetFVF(
  [in] DWORD FVF
);

參數

[in] FVF

類型： DWORD

包含固定函式頂點類型的 DWORD。 如需詳細資訊，請參閱 D3DFVF。

傳回值

類型： HRESULT

如果方法成功，傳回值會D3D_OK。 如果方法失敗，則傳回值可以是：D3DERR_INVALIDCALL。

備註

以下是初始化和使用頂點所需的步驟，這些頂點具有位置、擴散和反射色彩，以及紋理座標：

1. 定義自訂頂點類型和 FVF 程式代碼。

   
   struct LVertex
   {
       FLOAT    x, y, z;
       D3DCOLOR specular, diffuse;
       FLOAT    tu, tv;
   };
       
   const DWORD VertexFVF = (D3DFVF_XYZ | D3DFVF_DIFFUSE |
                            D3DFVF_SPECULAR | D3DFVF_TEX1 );
   
   

2. 使用 IDirect3DDevice9：：CreateVertexBuffer 建立具有足夠空間四個頂點的頂點緩衝區。

   
   g_d3dDevice->CreateVertexBuffer( 4*sizeof(LVertex),  
       D3DUSAGE_WRITEONLY, VertexFVF, D3DPOOL_DEFAULT, &pBigSquareVB, NULL );
   
   

3. 設定每個頂點的值。

   
   LVertex * v;
   pBigSquareVB->Lock( 0, 0, (BYTE**)&v, 0 );
       
   v[0].x  = 0.0f;  v[0].y  = 10.0;  v[0].z  = 10.0f;
   v[0].diffuse  = 0xffff0000;
   v[0].specular = 0xff00ff00;
   v[0].tu = 0.0f;  v[0].tv = 0.0f;
       
   v[1].x  = 0.0f;  v[1].y  = 0.0f;  v[1].z  = 10.0f;
   v[1].diffuse  = 0xff00ff00;
   v[1].specular = 0xff00ffff;
   v[1].tu = 0.0f;  v[1].tv = 0.0f;
       
   v[2].x  = 10.0f; v[2].y  = 10.0f; v[2].z  = 10.0f;
   v[2].diffuse  = 0xffff00ff;
   v[2].specular = 0xff000000;
   v[2].tu = 0.0f;  v[2].tv = 0.0f;
       
   v[3].x  = 0.0f; v[3].y  = 10.0f;  v[3].z = 10.0f;
   v[3].diffuse  = 0xffffff00;
   v[3].specular = 0xffff0000;
   v[3].tu = 0.0f; v[3].tv = 0.0f;
       
   pBigSquareVB->Unlock();
   
   

4. 頂點緩衝區已初始化，並已準備好轉譯。 下列程式代碼範例示範如何使用舊版 FVF 繪製方形。

   
   g_d3dDevice->SetFVF(VertexFVF);
   g_d3dDevice->SetStreamSource(0, pBigSquareVB, 0, sizeof(LVertex));
   g_d3dDevice->DrawPrimitive(D3DPT_TRIANGLESTRIP, 0 ,2);
   
   

以下是初始化和使用具有位置、一般和紋理座標頂點所需的步驟：

1. 定義自訂頂點類型和 FVF 程式代碼。

   
   struct Vertex
   {
       FLOAT x, y, z;
       FLOAT nx, ny, nz;
       FLOAT tu, tv;
   };
       
   const DWORD VertexFVF = ( D3DFVF_XYZ | D3DFVF_NORMAL | D3DFVF_TEX1 );
   
   

2. 使用 IDirect3DDevice9：：CreateVertexBuffer 建立具有足夠空間的頂點緩衝區， (類似上述範例) 。
3. 設定每個頂點的值。

   
   Vertex * v;
   pBigSquareVB->Lock(0, 0, (BYTE**)&v, 0);
       
   v[0].x  = 0.0f;  v[0].y  = 10.0;  v[0].z  = 10.0f;
   v[0].nx = 0.0f;  v[0].ny = 1.0f;  v[0].nz = 0.0f;
   v[0].tu = 0.0f;  v[0].tv = 0.0f;
   
   v[1].x  = 0.0f;  v[1].y  = 0.0f;  v[1].z  = 10.0f;
   v[1].nx = 0.0f;  v[1].ny = 1.0f;  v[1].nz = 0.0f;
   v[1].tu = 0.0f;  v[1].tv = 0.0f;
       
   v[2].x  = 10.0f; v[2].y  = 10.0f; v[2].z  = 10.0f;
   v[2].nx = 0.0f;  v[2].ny = 1.0f;  v[2].nz = 0.0f;
   v[2].tu = 0.0f;  v[2].tv = 0.0f;
       
   v[3].x  = 0.0f; v[3].y  = 10.0f;  v[3].z = 10.0f;
   v[3].nx = 0.0f; v[3].ny = 1.0f;   v[3].nz = 0.0f;
   v[3].tu = 0.0f; v[3].tv = 0.0f;
       
   pBigSquareVB->Unlock();
   
   

4. 繪製物件 (類似上述範例) 。

規格需求

需求	值
目標平台	Windows
標頭	d3d9.h (包含 D3D9.h)
程式庫	D3D9.lib

另請參閱

IDirect3DDevice9

IDirect3DDevice9：：GetFVF