高级着色语言HLSL入门（3）

新建网页 1

SetMatrixTranspose—Used to set a transposed 4 × 4 matrix. Sample call:

D3DXMATRIX M(…);

D3DXMatrixTranspose(&M, &M);

ConstTable->SetMatrixTranspose(Device, handle, &M);

Sets a transposed matrix.

HRESULT SetMatrixTranspose(  LPDIRECT3DDEVICE9 pDevice,  D3DXHANDLE hConstant,  CONST D3DXMATRIX* pMatrix);

Parameters

pDevice: [in] Pointer to an IDirect3DDevice9 interface, representing the device associated with the constant table.
hConstant: [in] Unique identifier to the matrix of constants.
pMatrix: [in] Pointer to a transposed matrix.

Return Values

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

SetMatrixTransposeArray—Used to set an array of 4 × 4 transposed matrices. Sample call:

D3DXMATRIX M[4];

// ...Initialize matrices and transpose them.

ConstTable->SetMatrixTransposeArray(Device, handle, M, 4);

Sets an array of transposed matrices.

HRESULT SetMatrixTransposeArray(  LPDIRECT3DDEVICE9 pDevice,  D3DXHANDLE hConstant, 
 CONST D3DXMATRIX* pMatrix,  UINT Count);

Parameters

pDevice: [in] Pointer to an IDirect3DDevice9 interface, representing the device associated with the constant table.
hConstant: [in] Unique identifier to the array of matrix constants.
pMatrix: [in] Array of transposed matrices.
Count: [in] Number of matrices in the array.

Return Values

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

SetMatrixTransposePointerArray—Used to set an array of pointers to 4 × 4 transposed matrices. Sample call:

D3DXMATRIX* M[4];

// ...Allocate,initialize matrix pointers and transpose them.

ConstTable->SetMatrixTransposePointerArray(Device, handle, M, 4);

Sets an array of pointers to transposed matrices.

HRESULT SetMatrixTransposePointerArray(  LPDIRECT3DDEVICE9 pDevice,  D3DXHANDLE hConstant,  
CONST D3DXMATRIX** ppMatrix,  UINT Count);

Parameters

pDevice: [in] Pointer to an IDirect3DDevice9 interface, representing the device associated with the constant table.
hConstant: [in] Unique identifier to the array of matrix constants.
ppMatrix: [in] Array of pointers to transposed matrices.
Count: [in] Number of matrices in the array.

Return Values

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

Remarks

A transposed matrix contains column-major data; that is, each vector is contained in a column.

SetVector—Used to set a variable of type D3DXVECTOR4. Sample call:

D3DXVECTOR4 v(1.0f, 2.0f, 3.0f, 4.0f);

ConstTable->SetVector(Device, handle, &v);

Sets a 4D vector.

HRESULT SetVector(  LPDIRECT3DDEVICE9 pDevice,  D3DXHANDLE hConstant,  CONST D3DXVECTOR4* pVector);

Parameters

pDevice: [in] Pointer to an IDirect3DDevice9 interface, representing the device associated with the constant table.
hConstant: [in] Unique identifier to the vector constant.
pVector: [in] Pointer to a 4D vector.

Return Values

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

SetVectorArray—Used to set a variable that is a vector array. Sample call:

D3DXVECTOR4 v[3];

// ...Initialize vectors

ConstTable->SetVectorArray(Device, handle, v, 3);

Sets an array of 4D vectors.

HRESULT SetVectorArray(  LPDIRECT3DDEVICE9 pDevice,  D3DXHANDLE hConstant,  
CONST D3DXVECTOR4* pVector,  UINT Count);

Parameters

pDevice: [in] Pointer to an IDirect3DDevice9 interface, representing the device associated with the constant table.
hConstant: [in] Unique identifier to the array of vector constants.
pVector: [in] Array of 4D vectors.
Count: [in] Number of vectors in the array.

Return Values

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

SetValue—Used to set an arbitrarily sized type, such as a structure. In the sample call, we use SetValue to set a D3DXMATRIX:

D3DXMATRIX M(…);

ConstTable->SetValue(Device, handle, (void*)&M, sizeof(M));

Sets the contents of the buffer to the constant table.

HRESULT SetValue(  LPDIRECT3DDEVICE9 pDevice,  D3DXHANDLE hConstant,  LPCVOID pData,  UINT Bytes);

Parameters

pDevice: [in] Pointer to an IDirect3DDevice9 interface, representing the device associated with the constant table.
hConstant: [in] Unique identifier to a constant.
pData: [in] Buffer containing data.
Bytes: [in] Size of the buffer, in bytes.

Return Values

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

16.2.1.3 设置常量默认值

下一个方法就是设置常量的默认值，这些默认值在声明时初始化。这个方法应该在应用程序建立（setup）期间被调用一次（called once）。

HRESULT ID3DXConstantTable::SetDefaults(

LPDIRECT3DDEVICE9 pDevice

);

pDevice——关联到常量表的设备的指针。

Sets the constants to their default values. The default values are declared in the variable declarations in the shader.

HRESULT SetDefaults(  LPDIRECT3DDEVICE9 pDevice);

Parameters

pDevice: [in] Pointer to an IDirect3DDevice9 interface, representing the device associated with the constant table.

Return Values

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

16.2.2 编译HLSL着色器

我们可以编译一个着色器——用我们已保存的着色器的文本文件——使用下列函数：

HRESULT D3DXCompileShaderFromFile(

LPCSTR pSrcFile,

CONST D3DXMACRO* pDefines,

LPD3DXINCLUDE pInclude,

LPCSTR pFunctionName,

LPCSTR pTarget,

DWORD Flags,

LPD3DXBUFFER* ppShader,

LPD3DXBUFFER* ppErrorMsgs,

LPD3DXCONSTANTTABLE* ppConstantTable

);

pSrcFile——要编译的包含着色器源代码的文本文件的文件名

pDefines——参数可选，这里指定为空。

pInclude——ID3DXInclude接口指针。这个接口被设计成由应用程序实现，所以我们可以重载默认include的行为。通常默认行为就可以了，而且我们可以通过将其指定为空忽略此参数。

pFunctionName——指定入口点函数名的字符串。例如，如果着色器的入口点函数叫做Main，我们可以给此参数传递“Main”。

pTarget——指定要编译成的HLSL着色器源文件的版本的字符串。有效的顶点着色器版本是：vs_1_1, vs_2_0, vs_2_sw。有效的像素着色器版本是2.0，我们可以给此参数传递vs_2_0。

备注：有编译不同版本着色器的能力，是HLSL与汇编语言比的主要优势。用HLSL我们只需为需要的目标简单的重新编译，便可快速移植着色器到不同的版本。使用汇编，我们可能需要手动移植代码。

Flags——可选的编译标记，指定为0标识没有标记。有效的选项是：

D3DXSHADER_DEBUG——通知编译器写入调试信息

D3DXSHADER_SKIPVALIDATION——通知编译器不要做任何代码检查。此项仅用于你已知着色器能够工作时。

D3DXSHADER_SKIPOPTIMIZATION——通知编译器不要执行任何代码优化。实践中，这个选项应该仅用于调试，因为这种情况下你不希望编译器以任何方式修改代码。

ppShader——返回已编译的着色器代码的ID3DXBuffer指针。这个已编译过的着色器代码将作为另一个实际创建顶点/像素着色器函数的参数。

ppErrorMsgs——返回包含错误码和错误消息字符串的ID3DXBuffer指针

ppConstantTable——返回包含此着色器常量表数据的ID3DXConstantTable指针

Compile a shader file.

HRESULT D3DXCompileShaderFromFile(  LPCSTR pSrcFile,  CONST D3DXMACRO* pDefines,  LPD3DXINCLUDE pInclude,  
LPCSTR pFunctionName,  LPCSTR pProfile,  DWORD Flags,  LPD3DXBUFFER* ppShader,  
LPD3DXBUFFER * ppErrorMsgs,  LPD3DXCONSTANTTABLE * ppConstantTable);

Parameters

pSrcFile: [in] Pointer to a string that specifies the filename.
pDefines: [in] An optional NULL terminated array of D3DXMACRO structures. This value may be NULL.
pInclude: [in] Optional interface pointer, ID3DXInclude, to use for handling #include directives. If this value is NULL, #includes will either be honored when compiling from a file or will cause an error when compiled from a resource or memory.
pFunctionName: [in] Pointer to the shader entry point function where execution begins.
pProfile: [in] Pointer to a shader profile which determines the shader instruction set. See D3DXGetVertexShaderProfile or D3DXGetPixelShaderProfile for a list of the profiles available.
Flags: [in] Compile options identified by various flags. The Direct3D 10 HLSL compiler is now the default. See D3DXSHADER Flags for details.
ppShader: [out] Returns a buffer containing the created shader. This buffer contains the compiled shader code, as well as any embedded debug and symbol table information.
ppErrorMsgs: [out] Returns a buffer containing a listing of errors and warnings that were encountered during the compile. These are the same messages the debugger displays when running in debug mode. This value may be NULL.
ppConstantTable: [out] Returns an ID3DXConstantTable interface, which can be used to access shader constants. This value may be NULL.

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_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

这里是一个调用D3DXCompileShaderFromFile的例子：

        // compile shader

        ID3DXBuffer*    shader_buffer;
        ID3DXBuffer*    error_buffer;

        HRESULT hr = D3DXCompileShaderFromFile("VertexShader.cxx", NULL, NULL, "main", "vs_1_1", D3DXSHADER_DEBUG,
                                               &shader_buffer, &error_buffer, &g_constant_table);

        // output any error messages
        if(error_buffer)
        {
            MessageBox(NULL, (char*)error_buffer->GetBufferPointer(), "ERROR", MB_OK);
            safe_release<ID3DXBuffer*>(error_buffer);
        }

        if(FAILED(hr))
        {
            MessageBox(NULL, "D3DXCreateEffectFromFile() - FAILED", "ERROR", MB_OK);
            return false;
        }

示例截图：

执行程序：

    /**************************************************************************************************
      Demonstrates transforming an object by the view and projection matrices, and setting
      the vertex color using a vertex shader.

      You will have to switch to the REF device if your hardware does not support shaders.
      Or you can use software vertex processing: D3DCREATE_SOFTWARE_VERTEXPROCESSING.
    **************************************************************************************************/

    #include "d3dUtility.h"

    #pragma warning(disable : 4100)

    const int WIDTH  = 640;
    const int HEIGHT = 480;

    IDirect3DDevice9*        g_device;
    ID3DXMesh*                g_teapot;
    IDirect3DVertexShader9* g_vertex_shader;
    ID3DXConstantTable*        g_constant_table;

    D3DXHANDLE                g_view_proj_handle;
    D3DXMATRIX                g_proj_matrix;

        ////////////////////////////////////////////////////////////////////////////////////////////////////

    bool setup()
    {
        D3DXCreateTeapot(g_device, &g_teapot, NULL);

        // compile shader

        ID3DXBuffer*    shader_buffer;
        ID3DXBuffer*    error_buffer;

        HRESULT hr = D3DXCompileShaderFromFile("VertexShader.cxx", NULL, NULL, "main", "vs_1_1", D3DXSHADER_DEBUG,
                                               &shader_buffer, &error_buffer, &g_constant_table);

        // output any error messages
        if(error_buffer)
        {
            MessageBox(NULL, (char*)error_buffer->GetBufferPointer(), "ERROR", MB_OK);
            safe_release<ID3DXBuffer*>(error_buffer);
        }

        if(FAILED(hr))
        {
            MessageBox(NULL, "D3DXCreateEffectFromFile() - FAILED", "ERROR", MB_OK);
            return false;
        }

        hr = g_device->CreateVertexShader((DWORD*) shader_buffer->GetBufferPointer(), &g_vertex_shader);

        if(FAILED(hr))
        {
            MessageBox(NULL, "CreateVertexShader - FAILED", "ERROR", MB_OK);
            return false;
        }

        safe_release<ID3DXBuffer*>(shader_buffer);

        g_view_proj_handle = g_constant_table->GetConstantByName(NULL, "g_view_proj_matrix");
        g_constant_table->SetDefaults(g_device);

        // set the projection matrix
            D3DXMatrixPerspectiveFovLH(&g_proj_matrix, D3DX_PI/4.0f, (float)WIDTH/HEIGHT, 1.0f, 1000.0f);

        g_device->SetRenderState(D3DRS_FILLMODE, D3DFILL_WIREFRAME);

        return true;
    }

        ///////////////////////////////////////////////////////////////////////////////////////////////////////

    void cleanup()
    {
        safe_release<ID3DXMesh*>(g_teapot);
        safe_release<IDirect3DVertexShader9*>(g_vertex_shader);
        safe_release<ID3DXConstantTable*>(g_constant_table);
    }

        ///////////////////////////////////////////////////////////////////////////////////////////////////////

    bool display(float time_delta)
    {
        static float angle  = (3.0f * D3DX_PI) / 2.0f;
        static float height = 5.0f;

        if(GetAsyncKeyState(VK_LEFT) & 0x8000f)
            angle -= 0.5f * time_delta;

        if(GetAsyncKeyState(VK_RIGHT) & 0x8000f)
            angle += 0.5f * time_delta;

        if(GetAsyncKeyState(VK_UP) & 0x8000f)
            height += 5.0f * time_delta;

        if(GetAsyncKeyState(VK_DOWN) & 0x8000f)
            height -= 5.0f * time_delta;

        D3DXVECTOR3 position(cosf(angle) * 10.0f, height, sinf(angle) * 10.0f);
        D3DXVECTOR3 target(0.0f, 0.0f, 0.0f);
        D3DXVECTOR3 up(0.0f, 1.0f, 0.0f);

        D3DXMATRIX view_matrix;
        D3DXMatrixLookAtLH(&view_matrix, &position, &target, &up);

        D3DXMATRIX view_proj_matrix = view_matrix * g_proj_matrix;
        g_constant_table->SetMatrix(g_device, g_view_proj_handle, &view_proj_matrix);

        // render now

        g_device->Clear(0, NULL, D3DCLEAR_TARGET | D3DCLEAR_ZBUFFER, 0x00000000, 1.0f, 0);

        g_device->BeginScene();

        g_device->SetVertexShader(g_vertex_shader);
        g_teapot->DrawSubset(0);

        g_device->EndScene();

        g_device->Present(NULL, NULL, NULL, NULL);

        return true;
    }

        ///////////////////////////////////////////////////////////////////////////////////////////////////////

    LRESULT CALLBACK wnd_proc(HWND hwnd, UINT msg, WPARAM word_param, LPARAM long_param)
    {
        switch(msg)
        {
        case WM_DESTROY:
            PostQuitMessage(0);
            break;

        case WM_KEYDOWN:
            if(word_param == VK_ESCAPE)
                DestroyWindow(hwnd);

            break;
        }

        return DefWindowProc(hwnd, msg, word_param, long_param);
    }

        ///////////////////////////////////////////////////////////////////////////////////////////////////////

    int WINAPI WinMain(HINSTANCE inst, HINSTANCE, PSTR cmd_line, int cmd_show)
    {
        if(! init_d3d(inst, WIDTH, HEIGHT, true, D3DDEVTYPE_HAL, &g_device))
        {
            MessageBox(NULL, "init_d3d() - failed.", 0, MB_OK);
            return 0;
        }

        if(! setup())
        {
            MessageBox(NULL, "Steup() - failed.", 0, MB_OK);
            return 0;
        }

        enter_msg_loop(display);

        cleanup();
        g_device->Release();

        return 0;
    }

下载源程序

posted on 2008-04-05 16:45 lovedday 阅读(3170) 评论(0) 编辑收藏引用

只有注册用户登录后才能发表评论。




网站导航: 博客园 IT新闻 BlogJava 知识库博问管理

天行健君子当自强而不息