D3DXFillCubeTexture-Funktion

Artikel
06/13/2023

Verwendet eine vom Benutzer bereitgestellte Funktion, um jedes Texel jeder Mip-Ebene einer bestimmten Würfeltextur aufzufüllen.

Syntax

HRESULT D3DXFillCubeTexture(
  _Out_ LPDIRECT3DCUBETEXTURE9 pTexture,
  _In_  LPD3DXFILL3D           pFunction,
  _In_  LPVOID                 pData
);

Parameter

pTexture [out]

Typ: LPDIRECT3DCUBETEXTURE9

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

pFunction [in]

Typ: LPD3DXFILL3D

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

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

Im folgenden Beispiel wird eine Funktion namens ColorCubeFill erstellt, die auf D3DXFillCubeTexture basiert.

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

Anforderungen

Anforderung	Wert
Header	D3dx9tex.h
Bibliothek	D3dx9.lib

Siehe auch

Texturfunktionen in D3DX 9

Freigeben über