D3DXFillTexture-Funktion

Verwendet eine vom Benutzer bereitgestellte Funktion, um jedes Texel jeder Mip-Ebene einer bestimmten Textur zu füllen.

Syntax

HRESULT D3DXFillTexture(
  _Out_ LPDIRECT3DTEXTURE9 pTexture,
  _In_  LPD3DXFILL2D       pFunction,
  _In_  LPVOID             pData
);

Parameter

pTexture [out]

Typ: LPDIRECT3DTEXTURE9

Zeiger auf eine IDirect3DTexture9-Schnittstelle , die die gefüllte Textur darstellt.

pFunction [in]

Typ: LPD3DXFILL2D

Zeiger auf eine vom Benutzer bereitgestellte Auswertungsfunktion, die verwendet wird, um den Wert jedes Texels zu berechnen. Die Funktion folgt dem Prototyp von LPD3DXFILL2D.

pData [in]

Typ: LPVOID

Zeiger auf einen beliebigen Block benutzerdefinierter Daten. Dieser Zeiger wird an die in pFunction bereitgestellte Funktion übergeben.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Werte sein: D3DERR_INVALIDCALL.

Bemerkungen

Hier ist ein Beispiel, das eine Funktion namens ColorFill erstellt, die auf D3DXFillTexture basiert.

// Define a function that matches the prototype of LPD3DXFILL3D
VOID WINAPI ColorFill (D3DXVECTOR4* pOut, const D3DXVECTOR2* pTexCoord, 
const D3DXVECTOR2* pTexelSize, LPVOID pData)
{
    *pOut = D3DXVECTOR4(pTexCoord->x, pTexCoord->y, 0.0f, 0.0f);
}
    
    
// Fill the texture using D3DXFillTexture
if (FAILED (hr = D3DXFillTexture (m_pTexture, ColorFill, NULL)))
{
    return hr;
}

Anforderungen

Anforderung	Wert
Header	D3dx9tex.h
Bibliothek	D3dx9.lib

Siehe auch

Texturfunktionen in D3DX 9