Поделиться через

Метод IDirect3DDevice9::SetFVF (d3d9helper.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. Создайте буфер вершин с достаточным пространством для четырех вершин с помощью IDirect3Device9::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
Header d3d9helper.h (включая D3D9.h)
Библиотека D3D9.lib

См. также раздел

IDirect3DDevice9

IDirect3DDevice9::GetFVF