首页 > 代码库 > 《OpenCL编程指南》之 与Direct3D互操作

《OpenCL编程指南》之 与Direct3D互操作

    介绍OpenCL与D3D 10之间的互操作。

1.初始化OpenCL上下文实现Direct3D互操作

    OpenCL共享由pragma cl_khr_d3d10_sharing启用:

    #pragma OPENCL EXTENSION cl_khr_d3d10_sharing: enable

    启用D3D共享时,很多OpenCL函数会有所扩展,将接受一些处理D3D10共享的参数类型和值。

    可以用D3D互操作属性来创建OpenCL上下文:

    ·CL_CONTEXT_D3D10_DEVICE_KHR   在clCreateContext和clCreateContextFromtype的属性参数中作为一个属性名。

    函数可以查询D3D互操作特定的对象参数:

    ·CL_CONTEXT_D3D10_PREFER_SHARED_RESOURCES_KHR  作为clGetContextInfo的param_name参数值。

    ·CL_MEM_D3D10_RESOURCE_KHR 作为clGetMemObjectInfo的param_name参数值。

    ·CL_IMAGE_D3D10_SUBRESOURCE_KHR 作为clGetImageInfo的param_name参数值。

    ·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 textureD3D10_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)

 

技术分享

技术分享

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 layoutg_pD3DDevice->IASetInputLayout( g_pSineVertexLayout );// Set vertex bufferstride = sizeof( SimpleSineVertex );offset = 0;g_pD3DDevice->IASetVertexBuffers( 0, 1, &g_pSineVertexBuffer, &stride, &offset );// Set primitive topologyg_pD3DDevice->IASetPrimitiveTopology( D3D10_PRIMITIVE_TOPOLOGY_LINESTRIP );computeBuffer();g_pTechnique->GetPassByIndex( 1 )->Apply( 0 );g_pD3DDevice->Draw( 256, 0 );

        运行时,程序会应用这个内核生成纹理内容,然后运行D3D管线对纹理采样,并在屏幕上显示。然后还会绘制顶点缓冲区,在屏幕上得到一个正弦曲线。

技术分享

 

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

《OpenCL编程指南》之 与Direct3D互操作