Compartir a través de

Crear un búfer de vértices (Direct3D 9)

  • Artículo

Para crear un objeto de búfer de vértices, llame al método IDirect3DDevice9::CreateVertexBuffer , que acepta cinco parámetros. El primer parámetro especifica la longitud del búfer de vértices, en bytes. Use el operador sizeof para determinar el tamaño de un formato de vértice, en bytes. Tenga en cuenta el siguiente formato de vértice personalizado.

struct CUSTOMVERTEX {
        FLOAT x, y, z;
        FLOAT rhw;
        DWORD color;
        FLOAT tu, tv;   // Texture coordinates
};

// Custom flexible vertex format (FVF) describing the custom vertex structure
#define D3DFVF_CUSTOMVERTEX (D3DFVF_XYZRHW | D3DFVF_DIFFUSE | D3DFVF_TEX1)

Para crear un búfer de vértices que contenga cuatro estructuras CUSTOMVERTEX, especifique [4*sizeof(CUSTOMVERTEX)] para el parámetro Length .

El segundo parámetro es un conjunto de controles de uso. Entre otras cosas, su valor determina si el búfer de vértices es capaz de contener información de recorte (en forma de marcas de recorte) para vértices que existen fuera del área de visualización. Para crear un búfer de vértices que no pueda contener marcas de recorte, incluya la marca D3DUSAGE_DONOTCLIP para el parámetro Usage . La marca D3DUSAGE_DONOTCLIP solo se aplica si también indica que el búfer de vértices contendrá vértices transformados: la marca D3DFVF_XYZRHW se incluye en el parámetro FVF . El método IDirect3DDevice9::CreateVertexBuffer omite la marca D3DUSAGE_DONOTCLIP si indica que el búfer contendrá vértices no transformados (la marca D3DFVF_XYZ). Las marcas de recorte ocupan memoria adicional, lo que hace que un búfer de vértices compatible con recortes sea ligeramente mayor que un búfer de vértices incapaz de contener marcas de recorte. Dado que estos recursos se asignan cuando se crea el búfer de vértices, debe solicitar un búfer de vértices compatible con recortes con antelación.

El tercer parámetro, FVF, es una combinación de D3DFVF que describe el formato de vértice del búfer de vértices. Si especifica 0 para este parámetro, el búfer de vértices es un búfer de vértices que no es FVF. Para obtener más información, consulta Búferes de vértices de FVF (Direct3D 9). El cuarto parámetro describe la clase de memoria en la que se va a colocar el búfer de vértices.

El parámetro final que acepta IDirect3DDevice9::CreateVertexBuffer es la dirección de una variable que se rellenará con un puntero a la nueva interfaz IDirect3DVertexBuffer9 del objeto de búfer de vértices, si la llamada se realiza correctamente.

No se pueden generar marcas de clip para un búfer de vértices creado sin compatibilidad con ellos.

En el siguiente ejemplo de código de C++ se muestra el aspecto que podría tener la creación de un búfer de vértices en el código.

   
// d3dDevice contains the address of an IDirect3DDevice9 interface
// g_pVB is a variable of type LPDIRECT3DVERTEXBUFFER9 

// The custom vertex type
struct CUSTOMVERTEX {
    FLOAT x, y, z;
    FLOAT rhw;
    DWORD color;
    FLOAT tu, tv;   // The texture coordinates
};

#define D3DFVF_CUSTOMVERTEX (D3DFVF_XYZRHW | D3DFVF_DIFFUSE | D3DFVF_TEX1)

// Create a clipping-capable vertex buffer. Allocate enough memory 
// in the default memory pool to hold three CUSTOMVERTEX 
// structures

    if( FAILED( d3dDevice->CreateVertexBuffer( 3*sizeof(CUSTOMVERTEX),
            0 /*Usage*/, D3DFVF_CUSTOMVERTEX, D3DPOOL_DEFAULT, &g_pVB, NULL ) ) )
        return E_FAIL;

Búferes de vértices