详细程序注解学OpenCL一 环境配置和入门程序

本专栏是通过注解程序的方法学习OpenCL，我觉得一个一个地去抠原理也不是办法，干脆直接学习程序，然后把相关原理都直接注解到程序语句当中。

原创地址：http://blog.csdn.net/kenden23/article/details/14101657

一开始要配置好环境，我的是nvidia，所以就按照我的电脑举例，AMD应该也差不多。

1. 首先要到nvidia网站下载适合你显卡的最新驱动，安装好

2. 还是在nvidia网站下载好CUDA开发包，安装好

3. 如果默认安装路径的话，路径应该是在：C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v5.0

4. 打开这个目录会发现里面有include和lib文件夹，这就是我们需要配置在visual studio中的文件

5. 打开visual studio（版本基本都无关系，我用的是vs2012），新建一个win32空项目。按下alt+F7打开项目属性，也可以点击项目文件右键，选择属性。

6. 在属性页里面找到“C/C++”的“常规”项，点击，右边有“附加包含目录”，然后编辑，添加目录：C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v5.0\include

7.在属性页里面找到“连接器”，点击其“常规”项，右边有“附加库目录”，然后也是编辑，添加目录：C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v5.0\lib\Win32，如果是64位系统可以是：C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v5.0\lib\x64。

8. 在属性页里找到“常规”项， 右边“附加依赖项”，编辑，添加lib文件：OpenCL.lib

9. 然后就可以新建源文件，在源文件里面添加相关的OpenCl程序，就可以调试OpenCL程序了。

下面就可以开始学习程序了。

下面是个入门程序，已经注释好了，注释包括了基本原理的解析，可以通过直接阅读和调试程序学习OpenCL了。

本程序是读取电脑中的支持OpenCL的硬件nvidia和intel和AMD等信息，然后显示在屏幕上。

[cpp] view plaincopyprint?

1. #include <stdio.h>  
2. #include <stdlib.h>  
3. #include <string.h>  
4. #include <iostream>  
5.   
6. #ifdef MAC  
7. #include <OpenCL/cl.h>  
8. #else  
9. #include <CL/cl.h>  
10. #endif  
11.   
12. int main() {  
13.   
14.     /* Host data structures */  
15.     cl_platform_id *platforms;  
16.     //每一个cl_platform_id 结构表示一个在主机上的OpenCL执行平台，就是指电脑中支持OpenCL的硬件，如nvidia显卡，intel CPU和显卡，AMD显卡和CPU等  
17.     cl_uint num_platforms;  
18.     cl_int i, err, platform_index = -1;  
19.   
20.     /* Extension data */  
21.     char* ext_data;                           
22.     size_t ext_size;     
23.     const char icd_ext[] = "cl_khr_icd";  
24.   
25.     //要使platform工作，需要两个步骤。1 需要为cl_platform_id结构分配内存空间。2 需要调用clGetPlatformIDs初始化这些数据结构。一般还需要步骤0：询问主机上有多少platforms  
26.   
27.     /* Find number of platforms */  
28.     //返回值如果为-1就说明调用函数失败，如果为0标明成功  
29.     //第二个参数为NULL代表要咨询主机上有多少个platform，并使用num_platforms取得实际flatform数量。  
30.     //第一个参数为1，代表我们需要取最多1个platform。可以改为任意大如：INT_MAX整数最大值。但是据说0，否则会报错，实际测试好像不会报错。下面是步骤0：询问主机有多少platforms  
31.     err = clGetPlatformIDs(5, NULL, &num_platforms);          
32.     if(err < 0) {          
33.         perror("Couldn't find any platforms.");           
34.         exit(1);                              
35.     }                                     
36.   
37.     printf("I have platforms: %d\n", num_platforms); //本人计算机上显示为2，有intel和nvidia两个平台  
38.   
39.     /* Access all installed platforms */  
40.     //步骤1 创建cl_platform_id，并分配空间  
41.     platforms = (cl_platform_id*)                     
42.         malloc(sizeof(cl_platform_id) * num_platforms);   
43.     //步骤2 第二个参数用指针platforms存储platform  
44.     clGetPlatformIDs(num_platforms, platforms, NULL);         
45.   
46.     /* Find extensions of all platforms */  
47.     //获取额外的平台信息。上面已经取得了平台id了，那么就可以进一步获取更加详细的信息了。  
48.     //一个for循环获取所有的主机上的platforms信息  
49.     for(i=0; i<num_platforms; i++)   
50.     {  
51.         /* Find size of extension data */  
52.         //也是和前面一样，先设置第三和第四个参数为0和NULL，然后就可以用第五个参数ext_size获取额外信息的长度了。  
53.         err = clGetPlatformInfo(platforms[i],             
54.             CL_PLATFORM_EXTENSIONS, 0, NULL, &ext_size);      
55.         if(err < 0)   
56.         {  
57.             perror("Couldn't read extension data.");              
58.             exit(1);  
59.         }     
60.   
61.         printf("The size of extension data is: %d\n", ext_size);//我的计算机显示224.  
62.   
63.         /* Access extension data */    
64.         //这里的ext_data相当于一个缓存，存储相关信息。  
65.         ext_data = (char*)malloc(ext_size);   
66.         //这个函数就是获取相关信息的函数，第二个参数指明了需要什么样的信息，如这里的CL_PLATFORM_EXTENSIONS表示是opencl支持的扩展功能信息。我计算机输出一大串，机器比较新（专门为了学图形学而购置的电脑），支持的东西比较多。  
67.         clGetPlatformInfo(platforms[i], CL_PLATFORM_EXTENSIONS,       
68.             ext_size, ext_data, NULL);                
69.         printf("Platform %d supports extensions: %s\n", i, ext_data);  
70.   
71.         //这里是输出生产商的名字，比如我显卡信息是：NVIDIA CUDA  
72.         char *name = (char*)malloc(ext_size);  
73.         clGetPlatformInfo(platforms[i], CL_PLATFORM_NAME,     
74.             ext_size, name, NULL);                
75.         printf("Platform %d name: %s\n", i, name);  
76.   
77.         //这里是供应商信息，我显卡信息：NVIDIA Corporation  
78.         char *vendor = (char*)malloc(ext_size);  
79.         clGetPlatformInfo(platforms[i], CL_PLATFORM_VENDOR,       
80.             ext_size, vendor, NULL);                  
81.         printf("Platform %d vendor: %s\n", i, vendor);  
82.   
83.         //最高支持的OpenCL版本，本机显示：OpenCL1.1 CUDA 4.2.1  
84.         char *version = (char*)malloc(ext_size);  
85.         clGetPlatformInfo(platforms[i], CL_PLATFORM_VERSION,      
86.             ext_size, version, NULL);                 
87.         printf("Platform %d version: %s\n", i, version);  
88.   
89.         //这个只有两个值：full profile 和 embeded profile  
90.         char *profile = (char*)malloc(ext_size);  
91.         clGetPlatformInfo(platforms[i], CL_PLATFORM_PROFILE,      
92.             ext_size, profile, NULL);                 
93.         printf("Platform %d full profile or embeded profile?: %s\n", i, profile);  
94.   
95.         /* Look for ICD extension */     
96.         //如果支持ICD这一扩展功能的platform，输出显示，本机的Intel和Nvidia都支持这一扩展功能  
97.         if(strstr(ext_data, icd_ext) != NULL)   
98.             platform_index = i;  
99.         std::cout<<"Platform_index = "<<platform_index<<std::endl;  
100.         /* Display whether ICD extension is supported */  
101.         if(platform_index > -1)  
102.             printf("Platform %d supports the %s extension.\n",   
103.             platform_index, icd_ext);  
104.   
105.         std::cout<<std::endl;  
106.   
107.         //释放空间  
108.         free(ext_data);  
109.         free(name);  
110.         free(vendor);  
111.         free(version);  
112.         free(profile);  
113.     }  
114.           
115.     if(platform_index <= -1)  
116.         printf("No platforms support the %s extension.\n", icd_ext);  
117.   
118.     /* Deallocate resources */  
119.     free(platforms);  
120.     return 0;  
121. }   

每个电脑的输出结果不一样的，我电脑的输出结果是：