《OpenCL編程指南》之 與Direct3D互操做

時間  2019-12-14
標籤 OpenCL編程指南 direct3d direct 简体版
原文   原文鏈接

    介紹OpenCL與D3D 10之間的互操做。微信

1.初始化OpenCL上下文實現Direct3D互操做

    OpenCL共享由pragma cl_khr_d3d10_sharing啓用：併發

    #pragma OPENCL EXTENSION cl_khr_d3d10_sharing: enableide

    啓用D3D共享時，不少OpenCL函數會有所擴展，將接受一些處理D3D10共享的參數類型和值。函數

    能夠用D3D互操做屬性來建立OpenCL上下文：佈局

    ·CL_CONTEXT_D3D10_DEVICE_KHR   在clCreateContext和clCreateContextFromtype的屬性參數中做爲一個屬性名。動畫

    函數能夠查詢D3D互操做特定的對象參數：網站

    ·CL_CONTEXT_D3D10_PREFER_SHARED_RESOURCES_KHR  做爲clGetContextInfo的param_name參數值。ui

    ·CL_MEM_D3D10_RESOURCE_KHR 做爲clGetMemObjectInfo的param_name參數值。spa

    ·CL_IMAGE_D3D10_SUBRESOURCE_KHR 做爲clGetImageInfo的param_name參數值。.net

    ·CL_COMMAND_ACQUIRE_D3D10_OBJECTS_KHR 和 CL_COMMAND_RELEASE_D3D10_OBJECTS_KHR 當param_name爲CL_ENCENT_COMMAND_TYPE時，在clGetEventInfo的參數param_value中返回。

    OpenCL D3D10互操做函數在頭文件cl_d3d10.h中。D3D10的Khronos擴展能夠從Khronos網站獲得。對於某些發佈版本，可能須要下載這個擴展。

    初始化OpenCL的過程與日常基本相同，只有幾點細小差異。首先平臺能夠使用clGetPlatformIDs函數列出。因爲咱們在搜索一個支持D3D共享的平臺，要在各個平臺上使用clGetPlatformInfo()調用來查詢它支持的擴展。若是擴展串中包含cl_khr_d3d10_sharing，說明能夠選用這個平臺來實現D3D共享。

    給定一個支持D3D共享的cl_platform_id,能夠在這個平臺上使用clGetDeviceIDsFromD3D10KHR()查詢相應的OpenCL設備ID：

cl_int clGetDeviceIDsFromD3D10KHR(
    cl_platform_id             platform,
    cl_d3d10_device_source_khr d3d_device_source,
    void *                     d3d_object,
    cl_d3d10_device_set_khr    d3d_device_set,
    cl_uint                    num_entries,
    cl_device_id *             devices,
    cl_uint *                  num_devices)

例如：

errNum = clGetDeviceIDsFromD3D10KHR(
    platformIds[index_platform],
    CL_D3D10_DEVICE_KHR,
    g_pD3DDevice,
    CL_PREFERRED_DEVICES_FOR_D3D10_KHR,
    1,
    &cdDevice,
    &num_devices);

if (errNum == CL_INVALID_PLATFORM) {
    printf("Invalid Platform: Specified platform is not valid\n");
} else if( errNum == CL_INVALID_VALUE) {
    printf("Invalid Value: d3d_device_source, d3d_device_set is not valid or num_entries = 0 and devices != NULL or num_devices == devices == NULL\n");
} else if( errNum == CL_DEVICE_NOT_FOUND) {
    printf("No OpenCL devices corresponding to the d3d_object were found\n");
}

代碼爲選擇的OpenCL平臺（platformIds[index_platform]）獲取一個OpenCL設備ID（cdDevice）。常量CL_D3D10_DEVICE_KHR指示發送的D3D10對象（g_pD3DDevice）是一個D3D10設備，經過CL_PREFERRED_DEVICES_FOR_D3D10_KHR來選擇該平臺的指望設備。這會返回與平臺和D3D10設備關聯的指望OpenCL設備。

    這個函數返回的設備ID能夠用來建立一個支持D3D共享的上下文。建立OpenCL上下文時，clCreateContext*()調用中的cl_context_properties域應當包括要共享的D3D10設備的指針。例如：

cl_context_properties contextProperties[] =
{
    CL_CONTEXT_D3D10_DEVICE_KHR, 
    (cl_context_properties)g_pD3DDevice,
    CL_CONTEXT_PLATFORM,
    (cl_context_properties)platformIds[index_platform],
    0
};


context = clCreateContextFromType( contextProperties, CL_DEVICE_TYPE_GPU, NULL, NULL, &errNum ) ;

這個示例代碼中，會從D3D10CreateDeviceAndSwapChain()調用返回D3D10設備g_pD3DDevice的指針。

2.從D3D緩衝區和紋理建立OpenCL內存對象

    能夠使用clCreateFromD3D10*KHR() OpenCL函數由現有的D3D緩衝區對象和紋理建立OpenCL緩衝區和圖像對象。

    能夠使用clCreateFromD3D10BufferKHR()由現有的D3D緩衝區建立OpenCL內存對象：

cl_mem clCreateFromD3D10BufferKHR(
    cl_context     context,
    cl_mem_flags   flags,
    ID3D10Buffer * resource,
    cl_int *       errcode_ret)

    所返回的OpenCL緩衝區對象的大小與resource的大小相同。這個調用將使resource上的內部Direct3D引用計數增1.所返回OpenCL內存對象上的OpenCL引用計數減至0時，resource上的內部Direct3D引用計數會減1.

    緩衝區與紋理均可以與OpenCL共享。

     在D3D10中，紋理能夠以下建立：

// 2D texture
D3D10_TEXTURE2D_DESC desc;
ZeroMemory( &desc, sizeof(D3D10_TEXTURE2D_DESC) );
desc.Width = g_WindowWidth;
desc.Height = g_WindowHeight;
desc.MipLevels = 1;
desc.ArraySize = 1;
desc.Format = DXGI_FORMAT_R8G8B8A8_UNORM;
desc.SampleDesc.Count = 1;
desc.Usage = D3D10_USAGE_DEFAULT;
desc.BindFlags = D3D10_BIND_SHADER_RESOURCE;
if (FAILED(g_pD3DDevice->CreateTexture2D( &desc, NULL, &g_pTexture2D)))
    return E_FAIL;

這個共享的紋理格式爲DXGI_FORMAT_R8G8B8A8_UNORM。而後能夠使用

cl_mem clCreateFromD3D10Texture2DKHR(
    cl_context        context,
    cl_mem_flags      flags,
    ID3D10Texture2D * resource,
    UINT              subresource,
    cl_int *          errcode_ret)

建立一個OpenCL圖像對象。所返回的OpenCL圖像對象的寬度、高度和深度由resource得子資源subresource的寬度、高度、深度決定。所返回的OpenCL圖像對象的通道類型和次序由resource的格式肯定。

    這個調用將使resource上的內部Direct3D引用計數增1.所返回的OpenCL內存對象上的OpenCL引用計數減至0時，resource上的內部Direct3D引用計數減1.

    相似有3D的，

cl_mem clCreateFromD3D10Texture3DKHR(
    cl_context        context,
    cl_mem_flags      flags,
    ID3D10Texture3D * resource,
    UINT              subresource,
    cl_int *          errcode_ret)

 

微信圖片_20170606080720

微信圖片_20170606080731

3.OpenCL中獲取和釋放Direct3D對象

        在opencl中處理以前必須先獲取direct3d對象，在由direct3d使用以前必須先釋放direct3d對象。

cl_int clEnqueueAcquireD3D10ObjectsKHR(
    cl_command_queue command_queue,
    cl_uint          num_objects,
    const cl_mem *   mem_objects,
    cl_uint          num_events_in_wait_list,
    const cl_event * event_wait_list,
    cl_event *       event)

這會得到由D3D10資源建立的的OpenCL內存對象。

cl_int clEnqueueAcquireD3D10ObjectsKHR(
    cl_command_queue command_queue,
    cl_uint          num_objects,
    const cl_mem *   mem_objects,
    cl_uint          num_events_in_wait_list,
    const cl_event * event_wait_list,
    cl_event *       event)

這會得到由Direct3D 10資源建立OpenCL內存對象。clEnqueueAcquireD3D10ObjectsKHR()提供了同步保證，在調用clEnqueueAcquireD3D10ObjectsKHR()以前作出的全部D3D 10調用都必須先徹底執行，以後event才能報告完成，command_queue中的全部後續OpenCL工做才能開始執行。

       釋放函數爲：

cl_int clEnqueueReleaseD3D10ObjectsKHR(
    cl_command_queue command_queue,
    cl_uint          num_objects,
    const cl_mem *   mem_objects,
    cl_uint          num_events_in_wait_list,
    const cl_event * event_wait_list,
    cl_event *       event)

這會得到由Direct3D 10資源建立OpenCL內存對象。clEnqueueReleaseD3D10ObjectsKHR()提供了同步保證，在調用clEnqueueReleaseD3D10ObjectsKHR()以後作出的全部D3D 10調用不會當即開始執行，直到event_wait_list中全部事件都已經完成，並且提交到command_queue中的全部工做都已經完成執行以後這些D3D 10調用纔會開始。

    另外，與D3D10不一樣，OpenGL獲取函數不會提供同步保證。另外，獲取和釋放紋理時，最高效的作法是同時獲取和釋放全部共享的紋理和資源。另外，最好在切換回D3D處理以前處理完全部opencl內核。採用這種方式，獲取和釋放調用能夠用來構成opencl和D3D處理的邊界。

4.OpenCL中處理D3D紋理

      opencl修改紋理內容：

cl_int computeTexture()
{
    cl_int errNum;

    static cl_int seq =0;
    seq = (seq+1)%(g_WindowWidth*2);

    errNum = clSetKernelArg(tex_kernel, 0, sizeof(cl_mem), &g_clTexture2D);
    errNum = clSetKernelArg(tex_kernel, 1, sizeof(cl_int), &g_WindowWidth);
    errNum = clSetKernelArg(tex_kernel, 2, sizeof(cl_int), &g_WindowHeight);
    errNum = clSetKernelArg(tex_kernel, 3, sizeof(cl_int), &seq);
    
    size_t tex_globalWorkSize[2] = { g_WindowWidth, g_WindowHeight };
    size_t tex_localWorkSize[2] = { 32, 4 } ;

    errNum = clEnqueueAcquireD3D10ObjectsKHR(commandQueue, 1, &g_clTexture2D, 0, NULL, NULL );

    errNum = clEnqueueNDRangeKernel(commandQueue, tex_kernel, 2, NULL,
                                    tex_globalWorkSize, tex_localWorkSize,
                                    0, NULL, NULL);
    if (errNum != CL_SUCCESS)
    {
        std::cerr << "Error queuing kernel for execution." << std::endl;
    }
    errNum = clEnqueueReleaseD3D10ObjectsKHR(commandQueue, 1, &g_clTexture2D, 0, NULL, NULL );
    clFinish(commandQueue);
    return 0;
}

用opencl內核計算生成一個D3D紋理對象的內容：

__kernel void xyz_init_texture_kernel(__write_only image2d_t im, int w, int h, int seq )
{
    int2 coord = { get_global_id(0), get_global_id(1) };
    float4 color =  { 
                      (float)coord.x/(float)w,
                      (float)coord.y/(float)h,
                      (float)abs(seq-w)/(float)w,
                      1.0f};
    write_imagef( im, coord, color );
}

這個紋理使用write_imagef()函數寫至內核。這裏seq是一個序列號變量，在宿主機上每一幀會循環遞增，併發送至內核。在內核中，seq變量用於生成紋理顏色值。seq遞增時，顏色會改變來實現紋理動畫。

        另外，代碼中使用了一種渲染技術g_pTechnique。這是一個基本處理管線，會用到一個簡單的頂點着色器，將頂點和紋理座標傳遞到一個像素着色器：

//
// Vertex Shader
//
PS_INPUT VS( VS_INPUT input )
{
    PS_INPUT output = (PS_INPUT)0;
    output.Pos = input.Pos;
    output.Tex = input.Tex;
        
    return output;
}

technique10 Render
{
    pass P0
    {
        SetVertexShader( CompileShader( vs_4_0, VS() ) );
        SetGeometryShader( NULL );
        SetPixelShader( CompileShader( ps_4_0, PS() ) );
    }
}

        這個技術使用常規的D3D10調用加載。像素着色器再對OpenCL內核修改的紋理完成紋理查找，比提供顯示：

SamplerState samLinear
{
    Filter = MIN_MAG_MIP_LINEAR;
    AddressU = Wrap;
    AddressV = Wrap;
};

float4 PS( PS_INPUT input) : SV_Target
{
    return txDiffuse.Sample( samLinear, input.Tex );
}

在像素着色器中，samLinear是輸入紋理的一個線性採樣器。對於渲染循環的每次迭代，OpenCL在computeTexture()中更新紋理內容，有D3D10顯示更新的紋理。

5.OpenCL中處理D3D頂點數據

     現考慮 使用一個包含頂點數據的D3D緩衝區在屏幕上繪製一個正弦曲線。首先爲D3D中的頂點緩衝區定義一個簡單的結構：

struct SimpleSineVertex
{
    D3DXVECTOR4 Pos;
};

能夠爲這個結構建立一個D3D10緩衝區，這裏緩衝區中包含256個元素：

bd.Usage = D3D10_USAGE_DEFAULT;
bd.ByteWidth = sizeof( SimpleSineVertex ) * 256;
bd.BindFlags = D3D10_BIND_VERTEX_BUFFER;
bd.CPUAccessFlags = 0;
bd.MiscFlags = 0;

hr = g_pD3DDevice->CreateBuffer( &bd, NULL, &g_pSineVertexBuffer );

由於要使用OpenCL設置緩衝區中的數據，因此爲第二個參數pInitialData傳入NULL，只分配空間。一旦建立了D3D緩衝區 g_pSineVertexBuffer，能夠使用clCreateFromD3D10BufferKHR()函數從g_pSineVertexBuffer建立一個OpenCL緩衝區：

g_clBuffer = clCreateFromD3D10BufferKHR( context, CL_MEM_READ_WRITE, g_pSineVertexBuffer, &errNum );
if( errNum != CL_SUCCESS)
{

    std::cerr << "Error creating buffer from D3D10" << std::endl;
    return E_FAIL;
}

與前相似，g_clBuffer能夠做爲一個內核參數發送到一個生產數據的OpenCL內核。 在示例代碼中，正弦曲線的頂點位置在內核中生成：

__kernel void init_vbo_kernel(__global float4 *vbo, int w, int h, int seq)
{
    int gid = get_global_id(0);
    float4 linepts;
    float f = 1.0f;
    float a = 0.4f;
    float b = 0.0f;

    linepts.x = gid/(w/2.0f)-1.0f;
    linepts.y = b + a*sin(3.14*2.0*((float)gid/(float)w*f + (float)seq/(float)w));
    linepts.z = 0.5f;
    linepts.w = 0.0f;

    vbo[gid] = linepts;
}

渲染時，設置佈局和緩衝區，並指定一個線條帶。接下來，computeBuffer()調用前面的內核更新緩衝區。激活一個簡單的渲染管線，並繪製256個數據點：

// Set the input layout
g_pD3DDevice->IASetInputLayout( g_pSineVertexLayout );
// Set vertex buffer
stride = sizeof( SimpleSineVertex );
offset = 0;
g_pD3DDevice->IASetVertexBuffers( 0, 1, &g_pSineVertexBuffer, &stride, &offset );

// Set primitive topology
g_pD3DDevice->IASetPrimitiveTopology( D3D10_PRIMITIVE_TOPOLOGY_LINESTRIP );

computeBuffer();
g_pTechnique->GetPassByIndex( 1 )->Apply( 0 );
g_pD3DDevice->Draw( 256, 0 );

        運行時，程序會應用這個內核生成紋理內容，而後運行D3D管線對紋理採樣，並在屏幕上顯示。而後還會繪製頂點緩衝區，在屏幕上獲得一個正弦曲線。

image

 

示例工程源碼：http://download.csdn.net/download/qq_33892166/9867159

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程