立體紋理

立體紋理（volume texture）是一組應用到二維圖元（如一個三角形或一條直線）的三維紋理元素的集合，可以使用立體紋理實現一些特殊效果，如迷霧、爆炸等。當對一個圖元使用立體紋理時，它的每個頂點都需要一組三元紋理坐標。當繪制該圖元時，它中間的每個像素都將用立體紋理中的一些紋理元素的顏色值進行填充，這與二維紋理映射的情況相似。

立體紋理以薄片為單元組織起來，可以把它想象成將（寬 x 高）的二維表面轉換成（寬 x 高 x 深）的三維立體，每個薄片是單獨的一行，立體紋理可以有一系列級別，每一級都較上一級縮小一倍，如下圖所示：

要創建立體紋理，首先必須檢查顯卡是否支持立體紋理：

// check whether device support volume texture
if((pCaps->TextureCaps & D3DPTEXTURECAPS_VOLUMEMAP) == 0)
	return false;

接著，我們需要在靈活頂點格式中指定每個頂點都需要三個紋理坐標，如下所示：

struct sCustomVertex
{
	float x, y, z;
	float u, v, w;
};

#define D3DFVF_CUSTOM_VERTEX	(D3DFVF_XYZ | D3DFVF_TEX1 | D3DFVF_TEXCOORDSIZE3(0))

D3DFVF_TEXCOORDSIZEN

Constructs bit patterns that are used to identify texture coordinate formats within a FVF description. The results of these macros can be combined within a FVF description by using the OR operator.

#define D3DFVF_TEXCOORDSIZEN(CoordIndex) 
#define D3DFVF_TEXCOORDSIZE1(CoordIndex) (D3DFVF_TEXTUREFORMAT1 << (CoordIndex*2 + 16)) 
#define D3DFVF_TEXCOORDSIZE2(CoordIndex) (D3DFVF_TEXTUREFORMAT2) 
#define D3DFVF_TEXCOORDSIZE3(CoordIndex) (D3DFVF_TEXTUREFORMAT3 << (CoordIndex*2 + 16)) 
#define D3DFVF_TEXCOORDSIZE4(CoordIndex) (D3DFVF_TEXTUREFORMAT4 << (CoordIndex*2 + 16))

Parameters

CoordIndex

Value that identifies the texture coordinate set at which the texture coordinate size (1-, 2-, 3-, or 4Dimensional) applies.

Remarks

The D3DFVF_TEXCOORDSIZEN macros use the following constants.

#define D3DFVF_TEXTUREFORMAT1 3 // one floating point value
#define D3DFVF_TEXTUREFORMAT2 0 // two floating point values
#define D3DFVF_TEXTUREFORMAT3 1 // three floating point values
#define D3DFVF_TEXTUREFORMAT4 2 // four floating point values

The following FVF description identifies a vertex format that has a position; a normal; diffuse and specular colors; and two sets of texture coordinates. The first set of texture coordinates includes a single element, and the second set includes two elements:

DWORD dwFVF = D3DFVF_XYZ | D3DFVF_NORMAL | D3DFVF_DIFFUSE |
              D3DFVF_SPECULAR | D3DFVF_TEX2 |
              D3DFVF_TEXCOORDSIZE1(0) |  // Uses 1D texture coordinates for texture coordinate set 1 (index 0).
              D3DFVF_TEXCOORDSIZE2(1);   // And 2D texture coordinates for texture coordinate set 2 (index 1).

接著，為每個頂點指定數據，創建頂點緩沖區并填充它：

// create vertex buffer and fill data

sCustomVertex vertices[] = 	
{
    { -3.0f, -3.0f,  0.0f, 0.0f, 1.0f, 0.0f},
    { -3.0f,  3.0f,  0.0f, 0.0f, 0.0f, 0.0f},
    {  3.0f, -3.0f,  0.0f, 1.0f, 1.0f, 0.0f},
    {  3.0f,  3.0f,  0.0f, 1.0f, 0.0f, 0.0f}
};

pd3dDevice->CreateVertexBuffer(sizeof(vertices), 0, D3DFVF_CUSTOM_VERTEX, D3DPOOL_MANAGED, &g_vertex_buffer, NULL);

void* ptr;
g_vertex_buffer->Lock(0, sizeof(vertices), (void**)&ptr, 0);
memcpy(ptr, vertices, sizeof(vertices));
g_vertex_buffer->Unlock();

可通過IDirect3DDevice9::CreateVolumeTexture()來創建立體紋理，該函數聲明如下:

Creates a volume texture resource.

HRESULT CreateVolumeTexture(
  UINT Width,
  UINT Height,
  UINT Depth,
  UINT Levels,
  DWORD Usage,
  D3DFORMAT Format,
  D3DPOOL Pool,
  IDirect3DVolumeTexture9** ppVolumeTexture,
  HANDLE* pSharedHandle
);

Parameters

Width

[in] Width of the top-level of the volume texture, in pixels. This value must be a power of two if the D3DPTEXTURECAPS_VOLUMEMAP_POW2 member of D3DCAPS9 is set. The pixel dimensions of subsequent levels will be the truncated value of half of the previous level's pixel dimension (independently). Each dimension clamps at a size of 1 pixel. Thus, if the division by two results in 0 (zero), 1 will be taken instead. The maximum dimension that a driver supports (for width, height, and depth) can be found in MaxVolumeExtent in D3DCAPS9.

Height

[in] Height of the top-level of the volume texture, in pixels. This value must be a power of two if the D3DPTEXTURECAPS_VOLUMEMAP_POW2 member of D3DCAPS9 is set. The pixel dimensions of subsequent levels will be the truncated value of half of the previous level's pixel dimension (independently). Each dimension clamps at a size of 1 pixel. Thus, if the division by 2 results in 0 (zero), 1 will be taken instead. The maximum dimension that a driver supports (for width, height, and depth) can be found in MaxVolumeExtent in D3DCAPS9.

Depth

[in] Depth of the top-level of the volume texture, in pixels. This value must be a power of two if the D3DPTEXTURECAPS_VOLUMEMAP_POW2 member of D3DCAPS9 is set. The pixel dimensions of subsequent levels will be the truncated value of half of the previous level's pixel dimension (independently). Each dimension clamps at a size of 1 pixel. Thus, if the division by 2 results in 0 (zero), 1 will be taken instead. The maximum dimension that a driver supports (for width, height, and depth) can be found in MaxVolumeExtent in D3DCAPS9.

Levels

[in] Number of levels in the texture. If this is zero, Direct3D will generate all texture sublevels down to 1x1 pixels for hardware that supports mipmapped volume textures. Call IDirect3DBaseTexture9::GetLevelCount to see the number of levels generated.

Usage

[in] Usage can be 0, which indicates no usage value. If usage is desired, use D3DUSAGE_DYNAMIC or D3DUSAGE_SOFTWAREPROCESSING. For more information, see D3DUSAGE.

Format

[in] Member of the D3DFORMAT enumerated type, describing the format of all levels in the volume texture.

Pool

[in] Member of the D3DPOOL enumerated type, describing the memory class into which the volume texture should be placed.

ppVolumeTexture

[out, retval] Address of a pointer to an IDirect3DVolumeTexture9 interface, representing the created volume texture resource.

pSharedHandle

[in] Reserved. Set this parameter to NULL.

Return Values

If the method succeeds, the return value is D3D_OK. If the method fails, the return value can be one of the following: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

示例代碼如下:

HRESULT hr;
UINT width = 16, height = 16, depth = 16;

V_RETURN(device->CreateVolumeTexture(width, height, depth, 1, 0, D3DFMT_A8R8G8B8, D3DPOOL_MANAGED,
&g_volume_texture, NULL));

接著調用IDirect3DVolumeTexture9::LockBox()來鎖定立體紋理頂點緩沖區，該函數的聲明如下：

Locks a box on a volume texture resource.

HRESULT LockBox(
  UINT Level,
  D3DLOCKED_BOX * pLockedVolume,
  CONST D3DBOX * pBox,
  DWORD Flags
);

Parameters

Level

[in] Specifies the level of the volume texture resource to lock.

pLockedVolume

[out] Pointer to a D3DLOCKED_BOX structure, describing the locked region.

pBox

[in] Pointer to the volume to lock. This parameter is specified by a pointer to a D3DBOX structure. Specifying NULL for this parameter locks the entire volume level.

Flags

[in] Combination of zero or more locking flags that describe the type of lock to perform. For this method, the valid flags are:

• D3DLOCK_DISCARD
• D3DLOCK_NO_DIRTY_UPDATE
• D3DLOCK_NOSYSLOCK
• D3DLOCK_READONLY

For a description of the flags, see D3DLOCK.

Return Values

If the method succeeds, the return value is D3D_OK. If the method fails, the return value can be D3DERR_INVALIDCALL.

Remarks

For performance reasons, dirty regions are only recorded for level zero of a texture. Dirty regions are automatically recorded when IDirect3DVolumeTexture9::LockBox is called without D3DLOCK_NO_DIRTY_UPDATE or D3DLOCK_READONLY. For more information, see IDirect3DDevice9::UpdateTexture.

D3DLOCKED_BOX

Describes a locked box (volume).

typedef struct D3DLOCKED_BOX {
    int RowPitch;
    int SlicePitch;
    void * pBits;
} D3DLOCKED_BOX, *LPD3DLOCKED_BOX;

Members

RowPitch

Byte offset from the left edge of one row to the left edge of the next row.

SlicePitch

Byte offset from the top-left of one slice to the top-left of the next deepest slice.

pBits

Pointer to the beginning of the volume box. If a D3DBOX was provided to the LockBox call, pBits will be appropriately offset from the start of the volume.

Remarks

Volumes can be visualized as being organized into slices of width x height 2D surfaces stacked up to make a width x height x depth volume. For more information, see Volume Texture Resources (Direct3D 9).

D3DBOX

Defines a volume.

typedef struct D3DBOX {
    UINT Left;
    UINT Top;
    UINT Right;
    UINT Bottom;
    UINT Front;
    UINT Back;
} D3DBOX, *LPD3DBOX;

Members

Left

Position of the left side of the box on the x-axis.

Top

Position of the top of the box on the y-axis.

Right

Position of the right side of the box on the x-axis.

Bottom

Position of the bottom of the box on the y-axis.

Front

Position of the front of the box on the z-axis.

Back

Position of the back of the box on the z-axis.

Remarks

D3DBOX includes the left, top, and front edges; however, the right, bottom, and back edges are not included. For example, a box that is 100 units wide and begins at 0 (thus, including the points up to and including 99) would be expressed with a value of 0 for the Left member and a value of 100 for the Right member. Note that a value of 99 is not used for the Right member.

The restrictions on side ordering observed for D3DBOX are left to right, top to bottom, and front to back.

示例代碼如下:

D3DLOCKED_BOX locked_box;
g_volume_texture->LockBox(0, &locked_box, NULL, 0);

for(UINT w = 0; w < depth; w++)
{
	BYTE* slice_start = (BYTE*) locked_box.pBits;

	for(UINT v = 0; v < height; v++)
	{
		for(UINT u = 0; u < width; u++)
		{
			// create texel color and fill it

			float du = (u - 7.5f) / 7.5f;
			float dv = (v - 7.5f) / 7.5f;
			float dw = (w - 7.5f) / 7.5f;
			float scale = sqrt(du * du + dv * dv + dw * dw);

			if(scale > 1.0f)
				scale = 0.0f;
			else
				scale = 1.0f - scale;

			DWORD r = (DWORD)((w << 4) * scale);
			DWORD g = (DWORD)((v << 4) * scale);
			DWORD b = (DWORD)((u << 4) * scale);

			((DWORD*) locked_box.pBits)[u] = 0xFF000000 + (r << 16) + (g << 8) + b;
		}

		locked_box.pBits = (BYTE*) locked_box.pBits + locked_box.RowPitch;
	}

	locked_box.pBits = slice_start + locked_box.SlicePitch;
}

g_volume_texture->UnlockBox(0);

還必須對立體紋理緩沖區進行解鎖，這需要調用IDirect3DVolumeTexture9::UnlockBox()，代碼如上所示，該函數聲明如下：

Unlocks a box on a volume texture resource.

HRESULT UnlockBox(
  UINT Level
);

Parameters

Level

[in] Specifies the level of the volume texture resource to unlock.

Return Values

If the method succeeds, the return value is D3D_OK. If the method fails, the return value can be D3DERR_INVALIDCALL.

為了生成立體紋理，還必須改變紋理的w坐標：

//--------------------------------------------------------------------------------------
// Handle updates to the scene
//--------------------------------------------------------------------------------------
void CALLBACK OnFrameMove( IDirect3DDevice9* pd3dDevice, double fTime, float fElapsedTime, void* pUserContext )
{
	// change w coordinate of volume texture
	

	float angle = (float) fTime / 2.0f;

	sCustomVertex* ptr;
	g_vertex_buffer->Lock(0, 0, (void**)&ptr, 0);

	for(int i = 0; i < 4; i++)
		ptr[i].w = sin(angle) * sin(angle);

	g_vertex_buffer->Unlock();
}

最后設置要渲染的紋理層和立體紋理，紋理階段混合方法，頂點數據，并渲染它：

// set textue and stream source and vertex format
pd3dDevice->SetTexture(0, g_volume_texture);
pd3dDevice->SetStreamSource(0, g_vertex_buffer, 0, sizeof(sCustomVertex));
pd3dDevice->SetFVF(D3DFVF_CUSTOM_VERTEX);

// set texture color blend method
pd3dDevice->SetTextureStageState(0, D3DTSS_COLORARG1,		D3DTA_TEXTURE);	
pd3dDevice->SetTextureStageState(0, D3DTSS_COLOROP,		D3DTOP_SELECTARG1);	
pd3dDevice->SetSamplerState(0,		D3DSAMP_MINFILTER,		D3DTEXF_LINEAR);
pd3dDevice->SetSamplerState(0,		D3DSAMP_MAGFILTER,		D3DTEXF_LINEAR);

 // Clear the render target and the zbuffer 
V( pd3dDevice->Clear(0, NULL, D3DCLEAR_TARGET | D3DCLEAR_ZBUFFER, D3DCOLOR_ARGB(0, 0, 0, 0), 1.0f, 0) );

// Render the scene
if( SUCCEEDED( pd3dDevice->BeginScene() ) )
{
	pd3dDevice->DrawPrimitive(D3DPT_TRIANGLESTRIP, 0, 2);
	RenderText();

	V(g_button_dlg.OnRender(fElapsedTime));
    V( pd3dDevice->EndScene() );
}

運行效果圖：

立體紋理和普通二維紋理的主要區別是：頂點紋理坐標是三維的，紋理對象指針的類型不同，立體紋理的創建也不同，而立體紋理在使用上和普通二維紋理基本相同。

在示例程序中，立體紋理是由程序生成的，比較復雜。Direct3D提供了輔助函數D3DXCreateVolumeTextureFromFile()來從圖片文件中生成立體紋理，該函數的聲明如下：

Creates a volume texture from a file.

HRESULT D3DXCreateVolumeTextureFromFile(
  LPDIRECT3DDEVICE9 pDevice,
  LPCTSTR pSrcFile,
  LPDIRECT3DVOLUMETEXTURE9 * ppVolumeTexture
);

Parameters

pDevice

[in] Pointer to an IDirect3DDevice9 interface, representing the device to be associated with the volume texture.

pSrcFile

[in] Pointer to a string that specifies the file name. If the compiler settings require Unicode, the data type LPCTSTR resolves to LPCWSTR. Otherwise, the string data type resolves to LPCSTR. See Remarks.

ppVolumeTexture

[out] Address of a pointer to an IDirect3DVolumeTexture9 interface representing the created texture object.

Return Values

If the function succeeds, the return value is D3D_OK. If the function fails, the return value can be one of the following:

D3DERR_NOTAVAILABLE
D3DERR_OUTOFVIDEOMEMORY
D3DERR_INVALIDCALL
D3DXERR_INVALIDDATAE_OUTOFMEMORY

Remarks

The compiler setting also determines the function version. If Unicode is defined, the function call resolves to D3DXCreateVolumeTextureFromFileW. Otherwise, the function call resolves to D3DXCreateVolumeTextureFromFileA because ANSI strings are being used.

The function is equivalent to D3DXCreateVolumeTextureFromFileEx(pDevice, pSrcFile, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppVolumeTexture).

This function supports the following file formats: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm, and .tga. See D3DXIMAGE_FILEFORMAT.

Mipmapped textures automatically have each level filled with the loaded texture.

When loading images into mipmapped textures, some devices are unable to go to a 1x1 image and this function will fail. If this happens, then the images need to be loaded manually.

Note that a resource created with this function will be placed in the memory class denoted by D3DPOOL_MANAGED.

Filtering is automatically applied to a texture created using this method. The filtering is equivalent to D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER in D3DX_FILTER.

通過文件創建立體紋理時文件格式必須是立體紋理格式，對于普通格式的圖片文件，可以通過DirectX提供的紋理工具"DirectX Texture Tool"轉換成立體紋理格式的文件。

 

主程序：

 

下載示例工程