用二级域名做的网站算新站吗,免费动漫软件app下载大全,中国互联网协会招聘,秦皇岛网站排名公司1.SDL简介
SDL#xff08;Simple DirectMedia Layer#xff09;#xff0c;是一个跨平台的C语言多媒体开发库。 支持Windows、Mac OS X、Linux、iOS、Android 提供对音频、键盘、鼠标、游戏操纵杆、图形硬件的底层访问 很多的视频播放软件、模拟器、受欢迎的游戏都在使用…1.SDL简介
SDLSimple DirectMedia Layer是一个跨平台的C语言多媒体开发库。 支持Windows、Mac OS X、Linux、iOS、Android 提供对音频、键盘、鼠标、游戏操纵杆、图形硬件的底层访问 很多的视频播放软件、模拟器、受欢迎的游戏都在使用它 目前最新的稳定版是2.0.14 API文档wiki SDL2/FrontPage - SDL Wiki 2.SDL下载
SDL官网下载地址download-sdl2。 Windows 下载 由于我们使用的是MinGW编译器所以选择下载SDL2-devel-2.0.14-mingw.tar.gz。
解压后的目录结构如下图所示跟FFmpeg的目录结构类似因此就不再赘述每个文件夹的作用。 3. 在代码中配置SDL 1.使用QT 来个简单的SDL HelloWorld吧打印一下SDL的版本号。 2. 我们要将 SDL 文件夹下的 64位的include 和lib 放在 qt 的workspace 目录下 当前我们新建的QT目录为 D:\AllInformation\qtworkspacenew 我们将sdl中的64位的bin 和include 都拷贝 到 sdl 文件夹下 配置.pro 文件 TEMPLATE app
CONFIG console
CONFIG - app_bundle
CONFIG - qtSOURCES \main.cwin32{SDL_HOME ../sdl
}
#INCLUDEPATH 的意思是再原先的INCLUDEPATH的基础上再添加等号后面的值 $${SDL_HOME}的意思是从 SDL_HOME中取出值也就是 ../sdl,
#连起来看这句话的意思是给原先的 INCLUDEPATH 再加上 当前.pro文件的上一级目录下的/sdl/include
#INCLUDEPATH 的意思是添加 .h文件
INCLUDEPATH $${SDL_HOME}/include#LIBS 的意思是添加静态库和动态库的访问路径
LIBS -L $${SDL_HOME}/lib \-lsdl2 #include stdio.h
#include SDL2/SDL.h#undef main
int main()
{printf(Hello World!\n);SDL_version v;SDL_VERSION(v);// 2 0 14printf(v.major %d , v.minor %d, v.patch %d \n,v.major,v.minor,v.patch);printf(v.major %u , v.minor %u, v.patch %u \n,v.major,v.minor,v.patch);return 0;
}测试中发现
如果我们只是重命名 静态库 libSDL2.a 改成了libSDL2yyy.a,这个没有影响 但是如果我们只是重命名 libSDL2.dll.a 改成了libSDL2yyy.dll.a,则会有build error 这说明我们在.pro 中 加的这段话是先找 libSDL2.dll.a这个的因此使用的还是动态库不是静态库。
LIBS -L $${SDL_HOME}/lib \ -lsdl2 3 注意的点实际上刚开的代码是不能运行的原因是main有冲突需要在main.cpp中添加#undef main #undef main
int main(int argc, char *argv[])
{QApplication a(argc, argv);MainWindow w;w.show();return a.exec();
}官方文档是这么说的
I think you want
#define SDL_MAIN_HANDLEDin your main file, BEFORE the line
#include SDL2/SDL.h 4.主要流程 以及关键API的使用线程使用show YUV, 播放PCM ◼ SDL_Init ()初始化SDL系统 ◼ SDL_CreateWindow()创建窗口SDL_Window ◼ SDL_CreateRenderer()创建渲染器SDL_Renderer ◼ SDL_CreateTexture()创建纹理SDL_Texture ◼ SDL_CreateTextureFromSurfaceSDL_Renderer * renderer, SDL_Surface * surface通过指定的surface创建纹理SDL_Texture。 ◼ SDL_UpdateTexture()设置纹理的数据 ◼ SDL_RenderCopy()将纹理的数据拷贝给渲染器 ◼ SDL_RenderPresent()显示 ◼ SDL_Delay()工具函数用于延时 ◼ SDL_Quit ()退出SDL系统 核心理解这块的内容 ◼ SDL_Window 代表了一个“窗口” ◼ SDL_Renderer 代表了一个“渲染上下文”作用是将SDL_Texture 显示到window上去就需要用这个。 ◼ SDL_Texture 代表了一个“纹理”理解为可以直接被 驱动 显示的图片 ◼ SDL_Surface 代表真正要显示的图片的内容。但是没有办法被 驱动 直接显示 大致流程如下 要显示图片将图片转换成 SDL_Surface 再将 SDL_Surface 转换成 SDL_Texture 通过 SDL_Renderer 将 SDL_Texture 显示到window上。 涉及到的函数如下 1.SDL_CreateWindow 创建windows 2.SDL_CreateRenderer 创建 渲染器上下文 3.SDL_CreateTexture 创建纹理数据 (纹理数据可以直接被 显卡驱动 显示) 3.SDL_Surface* surface SDL_LoadBMP(a.bmp); 将具体的bmp图片变成surface 3.SDL_CreateTextureFromSurface 通过surface创建纹理数据() 4.将纹理Texture拷贝到CPU
SDL_RenderCopy5.真正显示
SDL_RenderPresent //4 拷贝纹理到渲染目标,第三个参数表示将texture整个都画上去SDL_RenderCopy(renderer, texture, NULL, dstRect1);SDL_RenderCopy(renderer, texture, NULL, dstRect2);SDL_RenderCopy(renderer, texture, NULL, dstRect3);//5 更新所有的渲染操作到屏幕上SDL_RenderPresent(renderer); 6.改动render的target如果为NULL则代表renderer的target指向create renderer时的window,例如下下面的写法。
SDL_SetRenderTarget(renderer,newtexture);
SDL_SetRenderTarget(renderer,NULL);
作用SDL_SetRenderTarget方法的真正含义是将给那个texture上画如果是NULL则表示给create renderer的window上画。常用的用法有两种6.1 用于手动的画一些图形假设我们在window要有很多个邮件标志这个邮件标志实际上就是一个正方形斜角线组成的。而且这个邮件标志在window上显示了很多个。那么合理的方法是先创建这个 邮件 当做一个texture用的时候直接用就OK 。 一般会写成一个方法因为要将画笔从最开始的window转到新建的这个newteture //创建信封图片
SDL_Texture * MyCreateTexture(SDL_Renderer * renderer){// renderer the rendering context// format one of the enumerated values in SDL_PixelFormatEnum// access one of the enumerated values in SDL_TextureAccess// w the width of the texture in pixels// h the height of the texture in pixelsSDL_Texture * recttexture SDL_CreateTexture(renderer,SDL_PIXELFORMAT_RGB888,SDL_TEXTUREACCESS_TARGET,50,50);//注意的是传递进来的renderer是在main 函数中创建的该renderer默认的target是window可以通过SDL_GetRenderTarget函数获得。SDL_Texture * renderertexture SDL_GetRenderTarget(renderer);printf(renderertexture %p\n,renderertexture);//得到的是NULL表示使用的默认的window//我们现在要给 recttexture 上画因此要将renderer 的target转到 recttextureSDL_SetRenderTarget(renderer,recttexture);//设置画笔颜色 为黄色SDL_SetRenderDrawColor(renderer,255, 255, 0,SDL_ALPHA_OPAQUE);// 画图形SDL_Rect rect {0, 0, 50, 50};SDL_RenderDrawRect(renderer, rect);SDL_RenderDrawLine(renderer, 0, 0, 50, 50);SDL_RenderDrawLine(renderer, 50, 0, 0, 50);return recttexture;
} 6.2 当画完 这个新的texture之后要重新把画的指向 指回 window一般用法是用于清屏步骤如下先将target 设置为NULL设置为NULL就表示指向 创建renderer时绑定的window ;然后设置画笔的颜色;最后用画笔的颜色将window填满。//将renderer 的 target变成windowSDL_SetRenderTarget(renderer, NULL);SDL_SetRenderDrawColor(renderer, 255, 255, 255, 255); //设置画笔颜色SDL_RenderClear(renderer); //清屏用画笔颜色涂满 SDL_SetRenderTarget方法的第二个参数//下来的代码一般是 显示下一张图片后面的代码只是演示和这一小块的 setRendererTarget知识点无关//5.1 拷贝纹理到渲染目标,第三个参数表示将texture整个都画上去SDL_RenderCopy(renderer, texture, NULL, dstRect1);SDL_RenderCopy(renderer, texture, NULL, dstRect2);SDL_RenderCopy(renderer, texture, NULL, dstRect3);//5.2 更新所有的渲染操作到屏幕上SDL_RenderPresent(renderer); 显示图片的相关代码 #include stdio.h
#include SDL2/SDL.h#define WINDOWWIDTH 600
#define WINDOWHEIGHT 480//目标为将一张bmp的图片显示出来#undef main
int main()
{printf(Hello World! sdl show bmp\n);int ret 0;// 0.初始化子系统SDL_Init(SDL_INIT_VIDEO);//1.创建window 窗口const char * windowtitle 002sdlshowbmp;SDL_Window * window NULL;//2.创建renderer 渲染器上下文SDL_Renderer * renderer NULL;//3.加载bmp file 真正要显示的图片数据SDL_Surface * surface NULL;//4.创建Texture 创建纹理纹理也是数据且是能被 驱动 识别的数据这个texture的目的就是将 surface 转变的为可以被 驱动显示的 texture数据SDL_Texture * texture NULL;//5.测试代码将window的宽和高设置为surface的宽和高再从window中拿出来看是否设置成功int testWidth 0;int testHight 0;//1.创建windowwindow SDL_CreateWindow(windowtitle,10,10,WINDOWWIDTH,WINDOWHEIGHT,SDL_WINDOW_SHOWN);if(window NULL){ret -1;printf(SDL_CreateWindow error because window null ret %d\n, ret);return ret;}//2.创建rendererrenderer SDL_CreateRenderer(window,-1,SDL_RENDERER_ACCELERATED|SDL_RENDERER_PRESENTVSYNC);if(renderer NULL){ret -2;printf(SDL_CreateRenderer error because renderer null ret %d\n, ret);goto end;}//3.加载bmp filesurface SDL_LoadBMP(D:/AllInformation/qtworkspacenew/002-sdl-showbmp/2.bmp);if(surface NULL){ret -3;printf(SDL_LoadBMP error because surface null ret %d\n, ret);goto end;}//4.创建Texturetexture SDL_CreateTextureFromSurface(renderer,surface);if(texture NULL){ret -4;printf(SDL_CreateTextureFromSurface error because texture null ret %d\n, ret);goto end;}//5.根据surface的大小重新设置window的大小,这样的目的是让window的大小和图片的大小一样大printf(surface-w %d,surface-h %d \n,surface-w,surface-h);SDL_SetWindowSize(window,surface-w,surface-h);SDL_GetWindowSize(window,testWidth,testHight);printf(测试发现确实window的宽和高改动成功了。testWidth %d,testHight %d \n,testWidth,testHight);//6.到这里为止所有的数据都已经准备好了我们需要将texture数据显示到window上分为两步//6.1 将纹理数据texture 复制到window上这个工作需要经过 渲染上下文(renderer)完成由于创建renderer的时候就是通过当前的window创建的//因此第一个参数就是这个renderer绑定的是当前要显示的window//第二个参数就是要将哪个 texture 显示到window上//第三个参数const SDL_Rect * srcrect意思是你要将 texture的哪些部分拿出来显示传递NULL表示整个texture//第四个参数const SDL_Rect * dstrect意思是要显示的数据应该放置在window的什么位置ret SDL_RenderCopy(renderer,texture,NULL,NULL);if(ret -1){printf(SDL_RenderCopy error because ret %d\n, ret);goto end;}//6.2 将渲染器上下文 连接起来的 texture和window的数据显示到屏幕上SDL_RenderPresent(renderer);//6.3 思考为什么显示要分为两步呢这是因为有可能纹理数据 比较复杂可能要分为好几块显示在window上不同的位置因此将所有的数据赋值到window上 和 全部显示分开是比较合理的//7 因为显示会一闪而过因此在这里调用SDL_Delay只是让多显示一会SDL_Delay(8000);end:SDL_DestroyTexture(texture);SDL_FreeSurface(surface);SDL_DestroyRenderer(renderer);SDL_DestroyWindow(window);SDL_Quit();return ret;
}显示自己画图的代码 #include stdio.h
#include SDL2/SDL.h#define WINDOWWIDTH 800
#define WINDOWHEIGHT 800//我们是有这样一种情况就是在一个window上 有多个同样的自己画出的图片注意是自己画的我们假设是一个简单的信封 一个正方形 两个对角线
//那么合理的做法是画出来这个 “正方形 两个对角线” 然后使用的时候只要copy这个整体的图片就OK了//创建信封图片
SDL_Texture * MyCreateTexture(SDL_Renderer * renderer){// renderer the rendering context// format one of the enumerated values in SDL_PixelFormatEnum// access one of the enumerated values in SDL_TextureAccess// w the width of the texture in pixels// h the height of the texture in pixelsSDL_Texture * recttexture SDL_CreateTexture(renderer,SDL_PIXELFORMAT_RGB888,SDL_TEXTUREACCESS_TARGET,50,50);//注意的是传递进来的renderer是在main 函数中创建的该renderer默认的target是window可以通过SDL_GetRenderTarget函数获得。SDL_Texture * renderertexture SDL_GetRenderTarget(renderer);printf(renderertexture %p\n,renderertexture);//得到的是NULL表示使用的默认的window//我们现在要给 recttexture 上画因此要将renderer 的target转到 recttextureSDL_SetRenderTarget(renderer,recttexture);//设置画笔颜色 为黄色SDL_SetRenderDrawColor(renderer,255, 255, 0,SDL_ALPHA_OPAQUE);// 画图形SDL_Rect rect {0, 0, 50, 50};SDL_RenderDrawRect(renderer, rect);SDL_RenderDrawLine(renderer, 0, 0, 50, 50);SDL_RenderDrawLine(renderer, 50, 0, 0, 50);return recttexture;
}#undef main
int main()
{printf(Hello World! sdl show bmp\n);int ret 0;// 0.初始化子系统SDL_Init(SDL_INIT_VIDEO);//1.创建window 窗口const char * windowtitle 003sdlshowrect;SDL_Window * window NULL;//2.创建renderer 渲染器上下文SDL_Renderer * renderer NULL;//3.创建Texture 创建纹理纹理也是数据且是能被 驱动 识别的数据这个texture的目的就是将 surface 转变的为可以被 驱动显示的 texture数据SDL_Texture * texture NULL;SDL_Rect dstRect1 {0,0,50,50};const SDL_Rect dstRect2 {100,100,50,50};const SDL_Rect dstRect3 {200,200,50,50};int run 10;//1.创建windowwindow SDL_CreateWindow(windowtitle,10,10,WINDOWWIDTH,WINDOWHEIGHT,SDL_WINDOW_SHOWN);if(window NULL){ret -1;printf(SDL_CreateWindow error because window null ret %d\n, ret);return ret;}//2.创建rendererrenderer SDL_CreateRenderer(window,-1,SDL_RENDERER_ACCELERATED|SDL_RENDERER_PRESENTVSYNC);if(renderer NULL){ret -2;printf(SDL_CreateRenderer error because renderer null ret %d\n, ret);goto end;}//3.创建Texture,MyCreateTexture();texture MyCreateTexture(renderer);if(texture NULL){ret -4;printf(MyCreateTexture error because texture null ret %d\n, ret);goto end;}//4.在将renderer的target设置为默认的window参数传递NULL就是改动成windowSDL_SetRenderTarget(renderer,NULL);//5.1 拷贝纹理到渲染目标,第三个参数表示将texture整个都画上去SDL_RenderCopy(renderer, texture, NULL, dstRect1);SDL_RenderCopy(renderer, texture, NULL, dstRect2);SDL_RenderCopy(renderer, texture, NULL, dstRect3);//5.2 更新所有的渲染操作到屏幕上SDL_RenderPresent(renderer);SDL_Delay(500);//6.弄个循环跑10次观察效果while(run){dstRect1.x rand() % 600;dstRect1.y rand() % 400;//清屏这是常用清屏方式。将target变成window这时候本来就是window这样做只是为了好理解。然后将window的颜色变成默认的颜色我们这里将其变成黑色SDL_SetRenderTarget(renderer, NULL);SDL_SetRenderDrawColor(renderer, 0, 0, 0, 255); //设置window背景为黑色这时候由于之前画笔被设置为 黄色SDL_RenderClear(renderer); //清屏SDL_RenderCopy(renderer, texture, NULL, dstRect1);SDL_RenderPresent(renderer);SDL_Delay(300);run--;}end:SDL_DestroyTexture(texture);SDL_DestroyRenderer(renderer);SDL_DestroyWindow(window);SDL_Quit();return ret;
}SDL_EVENT事件代码 • SDL_WaitEvent() 等待一个事件 • SDL_PushEvent() 发送一个事件 #include stdio.h
#include SDL2/SDL.h#define WINDOWWIDTH 800
#define WINDOWHEIGHT 800//我们是有这样一种情况就是在一个window上 有多个同样的自己画出的图片注意是自己画的我们假设是一个简单的信封 一个正方形 两个对角线
//那么合理的做法是画出来这个 “正方形 两个对角线” 然后使用的时候只要copy这个整体的图片就OK了//创建信封图片
SDL_Texture * MyCreateTexture(SDL_Renderer * renderer){// renderer the rendering context// format one of the enumerated values in SDL_PixelFormatEnum// access one of the enumerated values in SDL_TextureAccess// w the width of the texture in pixels// h the height of the texture in pixelsSDL_Texture * recttexture SDL_CreateTexture(renderer,SDL_PIXELFORMAT_RGB888,SDL_TEXTUREACCESS_TARGET,50,50);//注意的是传递进来的renderer是在main 函数中创建的该renderer默认的target是window可以通过SDL_GetRenderTarget函数获得。SDL_Texture * renderertexture SDL_GetRenderTarget(renderer);printf(renderertexture %p\n,renderertexture);//得到的是NULL表示使用的默认的window//我们现在要给 recttexture 上画因此要将renderer 的target转到 recttextureSDL_SetRenderTarget(renderer,recttexture);//设置画笔颜色 为黄色SDL_SetRenderDrawColor(renderer,255, 255, 0,SDL_ALPHA_OPAQUE);// 画图形SDL_Rect rect {0, 0, 50, 50};SDL_RenderDrawRect(renderer, rect);SDL_RenderDrawLine(renderer, 0, 0, 50, 50);SDL_RenderDrawLine(renderer, 50, 0, 0, 50);return recttexture;
}void showClick(SDL_Event event,SDL_Renderer *renderer,SDL_Texture *texture) {//清屏将target变成window这时候本来就是window这样做只是为了好理解SDL_SetRenderTarget(renderer, NULL);SDL_SetRenderDrawColor(renderer, 0, 0, 0, 255); //window背景为黑色这时候由于之前画笔被设置为 黄色SDL_RenderClear(renderer); //清屏SDL_MouseButtonEvent btn event.button;int w 0;int h 0;if (SDL_QueryTexture(texture, NULL, NULL, w, h)) return;int x btn.x - (w 1);int y btn.y - (h 1);SDL_Rect dstRect {x, y, w, h};// 复制纹理到渲染目标if (SDL_RenderCopy(renderer, texture, NULL, dstRect)) return;// 更新渲染操作到屏幕上SDL_RenderPresent(renderer);
}#undef main
int main()
{printf(Hello World! sdl show bmp\n);int ret 0;// 0.初始化子系统SDL_Init(SDL_INIT_VIDEO);//1.创建window 窗口const char * windowtitle 003sdlshowrect;SDL_Window * window NULL;//2.创建renderer 渲染器上下文SDL_Renderer * renderer NULL;//3.创建Texture 创建纹理纹理也是数据且是能被 驱动 识别的数据这个texture的目的就是将 surface 转变的为可以被 驱动显示的 texture数据SDL_Texture * texture NULL;SDL_Rect dstRect1 {0,0,50,50};const SDL_Rect dstRect2 {100,100,50,50};const SDL_Rect dstRect3 {200,200,50,50};int run 10;//1.创建windowwindow SDL_CreateWindow(windowtitle,10,10,WINDOWWIDTH,WINDOWHEIGHT,SDL_WINDOW_SHOWN);if(window NULL){ret -1;printf(SDL_CreateWindow error because window null ret %d\n, ret);return ret;}//2.创建rendererrenderer SDL_CreateRenderer(window,-1,SDL_RENDERER_ACCELERATED|SDL_RENDERER_PRESENTVSYNC);if(renderer NULL){ret -2;printf(SDL_CreateRenderer error because renderer null ret %d\n, ret);goto end;}//3.创建Texture,MyCreateTexture();texture MyCreateTexture(renderer);if(texture NULL){ret -4;printf(MyCreateTexture error because texture null ret %d\n, ret);goto end;}//4.在将renderer的target设置为默认的window参数传递NULL就是改动成windowSDL_SetRenderTarget(renderer,NULL);//5.1 拷贝纹理到渲染目标,第三个参数表示将texture整个都画上去SDL_RenderCopy(renderer, texture, NULL, dstRect1);SDL_RenderCopy(renderer, texture, NULL, dstRect2);SDL_RenderCopy(renderer, texture, NULL, dstRect3);//5.2 更新所有的渲染操作到屏幕上SDL_RenderPresent(renderer);SDL_Delay(500);// 等待退出事件while (run) {SDL_Event event;SDL_WaitEvent(event);switch (event.type) {case SDL_QUIT:goto end;case SDL_MOUSEBUTTONUP:showClick(event, renderer, texture);break;}}end:SDL_DestroyTexture(texture);SDL_DestroyRenderer(renderer);SDL_DestroyWindow(window);SDL_Quit();return ret;
}#include SDL2/SDL.h
#include stdio.h
#define FF_QUIT_EVENT (SDL_USEREVENT 2) // 用户自定义事件
#undef main
int main(int argc, char* argv[])
{SDL_Window *window NULL; // Declare a pointerSDL_Renderer *renderer NULL;SDL_Init(SDL_INIT_VIDEO); // Initialize SDL2// Create an application window with the following settings:window SDL_CreateWindow(An SDL2 window, // window titleSDL_WINDOWPOS_UNDEFINED, // initial x positionSDL_WINDOWPOS_UNDEFINED, // initial y position640, // width, in pixels480, // height, in pixelsSDL_WINDOW_SHOWN | SDL_WINDOW_BORDERLESS// flags - see below);// Check that the window was successfully createdif (window NULL){// In the case that the window could not be made...printf(Could not create window: %s\n, SDL_GetError());return 1;}/* We must call SDL_CreateRenderer in order for draw calls to affect this window. */renderer SDL_CreateRenderer(window, -1, 0);/* Select the color for drawing. It is set to red here. */SDL_SetRenderDrawColor(renderer, 255, 0, 0, 255);/* Clear the entire screen to our selected color. */SDL_RenderClear(renderer);/* Up until now everything was drawn behind the scenes.This will show the new, red contents of the window. */SDL_RenderPresent(renderer);SDL_Event event;int b_exit 0;for (;;){SDL_WaitEvent(event);switch (event.type){case SDL_KEYDOWN: /* 键盘事件 */switch (event.key.keysym.sym){case SDLK_a:printf(key down a\n);break;case SDLK_s:printf(key down s\n);break;case SDLK_d:printf(key down d\n);break;case SDLK_q:printf(key down q and push quit event\n);SDL_Event event_q;event_q.type FF_QUIT_EVENT;SDL_PushEvent(event_q);break;default:printf(key down 0x%x\n, event.key.keysym.sym);break;}break;case SDL_MOUSEBUTTONDOWN: /* 鼠标按下事件 */if (event.button.button SDL_BUTTON_LEFT){printf(mouse down left\n);}else if(event.button.button SDL_BUTTON_RIGHT){printf(mouse down right\n);}else{printf(mouse down %d\n, event.button.button);}break;case SDL_MOUSEMOTION: /* 鼠标移动事件 */printf(mouse movie (%d,%d)\n, event.button.x, event.button.y);break;case FF_QUIT_EVENT:printf(receive quit event\n);b_exit 1;break;}if(b_exit)break;}//destory rendererif (renderer)SDL_DestroyRenderer(renderer);// Close and destroy the windowif (window)SDL_DestroyWindow(window);// Clean upSDL_Quit();return 0;
} SDL 的线程事件 ◼ SDL线程创建SDL_CreateThread SDL_Thread * t SDL_CreateThread(thread_work,thread_work,NULL);创建一个新的sdl子线程第一个参数该子线程调用的方法名字为thread_work;第二个参数为线程的名字第三个参数为要给线程传递的数据成功时返回指向新线程对象的不透明指针如果无法创建新线程则返回 NULL调用SDL_GetError ()获取更多信息。主线程一般需要调用 SDL_WaitThread(t, NULL);等待子线程结束进而回收子线程的资源。也可以调用void SDL_DetachThread(SDL_Thread * thread);方法不回收。让子线程结束后交给系统让系统回收从之前C自己的thread的经验来看这个detach 可能有问题如果子线程用到的资源是主线程的但是主线程这时候结束了因为不使用SDL_WaitThread那么主线程结束就结束了不会等待子线程那么有可能出现不可预知的问题因此按照Cthread的经验除非必要SDL_DetachThread方法还是慎用。◼ SDL线程等待SDL_WaitThead 一般用于主线程等待子线程结束 extern DECLSPEC void SDLCALL SDL_WaitThread(SDL_Thread * thread, int *status); SDL_Thread * thread所等待的线程 int *status返回的线程状态 ◼ SDL互斥锁SDL_CreateMutex/SDL_DestroyMutex /** * Create a mutex, initialized unlocked. */ extern DECLSPEC SDL_mutex *SDLCALL SDL_CreateMutex(void); /** * Destroy a mutex. */ extern DECLSPEC void SDLCALL SDL_DestroyMutex(SDL_mutex * mutex); 有了子线程后就存在子线程和主线程抢占资源的问题如果这个资源是共享的就有可能发生问题。因此我们要 使用 互斥量 将访问共享资源的部分 lock起来那么首先就要有这个 互斥量也就是SDL_mutex ◼ SDL锁定互斥SDL_LockMutex/SDL_UnlockMutex 加互斥锁有两种 SDL_LockMutex和SDL_TryLockMutex SDL_LockMutex仅返回0和-1,SDL_TryLockMutex还会返回SDL_TIMEDOUT /*** Lock the mutex.** \return 0, or -1 on error.*/
#define SDL_mutexP(m) SDL_LockMutex(m)
extern DECLSPEC int SDLCALL SDL_LockMutex(SDL_mutex * mutex);/*** Try to lock the mutex** \return 0, SDL_MUTEX_TIMEDOUT, or -1 on error*/
extern DECLSPEC int SDLCALL SDL_TryLockMutex(SDL_mutex * mutex);解互斥锁函数 /*** Unlock the mutex.** \return 0, or -1 on error.** \warning It is an error to unlock a mutex that has not been locked by* the current thread, and doing so results in undefined behavior.*/
#define SDL_mutexV(m) SDL_UnlockMutex(m)
extern DECLSPEC int SDLCALL SDL_UnlockMutex(SDL_mutex * mutex);◼ SDL条件变量(信号量)SDL_CreateCond/SDL_DestoryCond 理论上使用mutex后就已经能完成 对于共享数据的保护了但是还 有一个问题参考54 C 多线程 条件变量 condition_variable,wait(),notify_one()-CSDN博客 这个问题是当一个写线程一个读线程共同的读取共享数据的时候如果共享数据这时候已经读取完成了那么理论上要等待 写线程 写入数据才可以读取到真正的数据。但是当SDL_UnlockMutex后实际上不管是读线程还是写线程都有可能再次拿到线程的如果是读线程拿到了就会白白的浪费一次。因此有必要 创建和使用 SDL_cond。 extern DECLSPEC SDL_cond *SDLCALL SDL_CreateCond(void);extern DECLSPEC void SDLCALL SDL_DestroyCond(SDL_cond * cond);◼ SDL条件变量(信号量)等待/通知SDL_CondWait/SDL_CondSingal SDL_cond的使用通常要和SDL_LockMutex一起使用。 步骤一般是这样的 1. SDL_LockMutex 2. SDL_CondWait 的线程 ------ 等待 有 SDL_CondSingal方法 的线程通知并且含有SDL_CondSingal 方法线程 unlockMutex之后才会真正的调用 含有 SDL_CondWait 的线程 /*** Wait on the condition variable, unlocking the provided mutex.** \warning The mutex must be locked before entering this function!** The mutex is re-locked once the condition variable is signaled.** \return 0 when it is signaled, or -1 on error.*/
extern DECLSPEC int SDLCALL SDL_CondWait(SDL_cond * cond, SDL_mutex * mutex);A线程 A线程在执行SDL_CondSignal之前是要 SDL_LockMutex的 B线程 B现成在执行SDL_CondWait 之前是一定要SDL_LockMutex的 当走到 SDL_CondWait 的时候如果这时候B线程已经拿到了锁子但是还没有等到A线程的SDL_CondSignal通知就会做两件事情1释放已经拿到的锁子2在当前行等待A线程调用SDL_CondSignal并且等待A 线程释放锁子SDL_UnlockMutex #include SDL2/SDL.h
#include stdio.hSDL_mutex *s_lock NULL;
SDL_cond *s_cond NULL;int thread_work(void *arg)
{SDL_LockMutex(s_lock);printf( thread_work sleep\n);sleep(10); // 用来测试获取锁printf( thread_work wait\n);// 释放s_lock资源并等待signal。之所以释放s_lock是让别的线程能够获取到s_lockSDL_CondWait(s_cond, s_lock); //另一个线程(1)发送signal和(2)释放lock后这个函数退出printf( thread_work receive signal, continue to do ~_~!!!\n);printf( thread_work end\n);SDL_UnlockMutex(s_lock);return 0;
}#undef main
int main()
{s_lock SDL_CreateMutex();s_cond SDL_CreateCond();SDL_Thread * t SDL_CreateThread(thread_work,thread_work,NULL);if(!t){printf( %s,SDL_GetError);return -1;}for(int i 0;i 2;i){sleep(2);printf(main execute \n);}printf(main SDL_LockMutex(s_lock) before \n);SDL_LockMutex(s_lock); // 获取锁但是子线程还拿着锁printf(main ready send signal\n);printf(main SDL_CondSignal(s_cond) before \n);SDL_CondSignal(s_cond); // 发送信号唤醒等待的线程printf(main SDL_CondSignal(s_cond) after \n);sleep(10);SDL_UnlockMutex(s_lock);// 释放锁让其他线程可以拿到锁printf(main SDL_UnlockMutex(s_lock) after \n);SDL_WaitThread(t, NULL);SDL_DestroyMutex(s_lock);SDL_DestroyCond(s_cond);return 0;
}注意的问题这个是以前没有理解透彻的点之前的理解是只要lock mutex后就会锁住直到该线程执行完毕执行 unlock mutex后其他线程才有可能拿到CPU实际不是的。 如果A线程和B线程都要访问共享数据那么当 A SDL_LockMutex后B实际上还是能拿到CPU的例如当A中sleep的时候会很大概率让出CPU那么这时候B是很有可能拿到CPU执行自己的代码的直到B中的也使用 SDL_LockMutex发现该mutex在A中已经被lock就会等着拿锁子B中的代码就会等待很大概率让出CPU。 SDL 显示YUV数据SDL视频显示的流程 SDL 播放PCM数据SDL播放PCM流程 打开音频设备 int SDLCALL SDL_OpenAudio( SDL_AudioSpec * desired, SDL_AudioSpec * obtained); // desired期望的参数。 // obtained实际音频设备的参数一般情况下设置为NULL即可。 第一个参数是user设置的但是参数要设置的对
第二个参数是当前硬件的参数一般传递为NULL失败则返回-1int SDL_OpenAudio(SDL_AudioSpec *desired, SDL_AudioSpec *obtained); SDL_AudioSpec typedef struct SDL_AudioSpec { int freq ; // 音频采样率常用的有48000,44100等。 SDL_AudioFormat format ; // 音频数据格式音频数据的格式。举例几种格式 AUDIO_U16SYSUnsigned 16-bit samplesAUDIO_S16SYSSigned 16-bit samplesAUDIO_S32SYS32-bit integer samplesAUDIO_F32SYS32-bit floating point samples Uint8 channels ; // 声道数: 1 单声道, 2 立体声 Uint8 silence ; // 设置静音的值 因为声音采样是有符号的所以0当然就是这个值 Uint16 samples ; // 音频缓冲区中的采样个数要求必须是2的n次 Uint16 padding ; // 考虑到兼容性的一个参数 Uint32 size ; // 音频缓冲区的大小以字节为单位 SDL_AudioCallback callback ; // 填充音频缓冲区的回调函数 void * userdata ; // 用户自定义的数据 } SDL_AudioSpec ; 在这里说明一下填充音频缓冲区的回调函数的作用。当音频设备需要更多数据的时候会调用该回调函数。 SDL_AudioCallback // userdataSDL_AudioSpec结构中的用户自定义数据一般情况下可以不用。 // stream该指针指向需要填充的音频缓冲区。 // len音频缓冲区的大小以字节为单位1024*2*2。 void ( SDLCALL * SDL_AudioCallback ) ( void *userdata, Uint8 *stream, int len); 播放音频数据 // 当 pause_on 设置为 0 的时候即可开始播放音频数据。设置为 1 的时候将会 播放静音的值。 void SDLCALL SDL_PauseAudio( int pause_on) 核心API
初始化SDL系统 和 退出SDL系统
int SDL_Init(Uint32 flags)
int SDL_InitSubSystem(Uint32 flags)
void SDL_Quit(void)
void SDL_QuitSubSystem(Uint32 flags)
功能:初始化SDL
参数:
flags 系统名称取值如下
SDL_INIT_TIMER定时器子系统SDL_INIT_AUDIO音频子系统SDL_INIT_VIDEO视频子系统SDL_INIT_JOYSTICK操纵杆子系统SDL_INIT_HAPTIC触屏反馈子系统SDL_INIT_GAMECONTROLLER控制器子系统SDL_INIT_EVENTS事件子系统SDL_INIT_EVERYTHING上述所有子系统SDL_INIT_NOPARACHUTE不致命的信号
返回值:
成功返回0
失败返回 -1
原型:
int SDL_Init(Uint32 flags)功能:初始化SDL子系统
参数:
flags 系统名称
同SDL_Init()
返回值:
成功返回0
失败返回 -1
原型:
int SDL_InitSubSystem(Uint32 flags)功能:退出SDL
参数 : 无
返回值 : 无
原型:
void SDL_Quit(void)功能:退出系统
参数:
flags 系统名称
同SDL_Init()
返回值: 无
原型:
void SDL_QuitSubSystem(Uint32 flags) 创建窗口SDL_Window 和 销毁 SDL_DestroyWindow(window);
SDL_CreateWindow(const char *title, int x, int y, int w, int h, Uint32 flags)
函数功能创建一个window函数参数title 的意思是 这个windows上左上角 显示的文字
x 表示该window左上角的坐标x
y 表示该window左上角的坐标y
w 表示该window的宽度
h 表示该window的高度
flags 表示该window的属性有以下值 SDL_WINDOW_FULLSCREEN, SDL_WINDOW_OPENGL,SDL_WINDOW_HIDDEN, SDL_WINDOW_BORDERLESS,SDL_WINDOW_RESIZABLE, SDL_WINDOW_MAXIMIZED,SDL_WINDOW_MINIMIZED, SDL_WINDOW_INPUT_GRABBED,SDL_WINDOW_ALLOW_HIGHDPI, SDL_WINDOW_VULKANSDL_WINDOW_METAL返回值return The created window, or NULL if window creation failed.extern DECLSPEC SDL_Window * SDLCALL SDL_CreateWindow(const char *title,int x, int y, int w,int h, Uint32 flags); SDL_DestroyWindow(window); 创建渲染器SDL_Renderer 和 销毁 SDL_DestroyRenderer(renderer);
SDL_CreateRenderer() 函数功能
Create a 2D rendering context for a window.--为窗口创建2D渲染器函数参数
window你要给那个window上创建2D渲染器
index指定要使用的渲染器索引通常传入-1表示使用第一个支持的渲染器。
flag用于设置渲染器的标志例如SDL_RENDERER_ACCELERATED、SDL_RENDERER_PRESENTVSYNC等。参考源码中的说明请使用 enum SDL_RendererFlags 中的值 extern DECLSPEC SDL_Renderer * SDLCALL SDL_CreateRenderer(SDL_Window * window,int index, Uint32 flags); 创建纹理 SDL_CreateTexture 和销毁纹理 SDL_DestroyTexture extern DECLSPEC SDL_Texture * SDLCALL SDL_CreateTexture(SDL_Renderer * renderer,Uint32 format,int access, int w,int h); // 基于渲染器创建纹理创建纹理的第二个参数应该是YUV420的格式那么在sdl中YUV420格式是什么呢//这个在SDL_CreateTexture的源码中是看不到的在sdl 的官网上查找 SDL_CreateTexture 方法的使用 https://wiki.libsdl.org/wiki/search//可以看到 第二个参数的说明为 one of the enumerated values in SDL_PixelFormatEnum那我们就search SDL_PixelFormatEnum看在这个enum中YUV420是什么// 可以得到 SDL_PIXELFORMAT_IYUV planar mode: Y U V (3 planes)// 第三个参数我们要显示的YUV的数据因此要用 SDL_TEXTUREACCESS_STREAMING, /** Changes frequently, lockable */
typedef enum
{SDL_TEXTUREACCESS_STATIC, /** Changes rarely, not lockable */SDL_TEXTUREACCESS_STREAMING, /** Changes frequently, lockable */ 使用流形式因此如果显示的图片或者视频都要用这个SDL_TEXTUREACCESS_TARGET /** Texture can be used as a render target */ 这个是如果将texture做为 渲染目标的时候用这个这个意味着如果我们要自己画一张图用这个
} SDL_TextureAccess;函数功能
用于创建一个二维图形纹理纹理可以用于在渲染器上绘制图像。纹理是对图像数据的抽象通过纹理可以方便地进行图像渲染。函数参数
renderer: 纹理将与之关联的渲染器。
format: 纹理的像素格式例如 SDL_PIXELFORMAT_RGBA8888。参考SDL_pixels.h中的SDL_PixelFormatEnum这里怎么知道format有哪些参数呢方法是在整个sdl2的include文件夹中查找SDL_PIXELFORMAT_RGBA8888就能找到这个 枚举类型了
access: 纹理的访问权限例如 SDL_TEXTUREACCESS_STATIC 表示静态纹理。。参考enum SDL_TextureAccesstypedef enum
{SDL_TEXTUREACCESS_STATIC, /** Changes rarely, not lockable */SDL_TEXTUREACCESS_STREAMING, /** Changes frequently, lockable */SDL_TEXTUREACCESS_TARGET /** Texture can be used as a render target */
} SDL_TextureAccess;w, h: 纹理的宽度和高度。* \param renderer The renderer.* \param format The format of the texture.* \param access One of the enumerated values in ::SDL_TextureAccess.* \param w The width of the texture in pixels.* \param h The height of the texture in pixels.返回值* \return The created texture is returned, or NULL if no rendering context was* active, the format was unsupported, or the width or height were out* of range.extern DECLSPEC SDL_Texture * SDLCALL SDL_CreateTexture(SDL_Renderer * renderer,Uint32 format,int access, int w,int h); SDL_UpdateTexture函数的用途与用法
SDL_UpdateTexture 用于更新纹理的像素数据。通常在创建纹理后我们可能需要更新它以显示新的图像、视频帧或其他图形数据。这个函数提供了一种有效的方式来更新纹理的内容。 extern DECLSPEC int SDLCALL SDL_UpdateTexture(SDL_Texture * texture, const SDL_Rect * rect, const void *pixels, int pitch);
texture: 要更新的目标纹理。rect: 指定要更新的纹理矩形区域如果为NULL则更新整个纹理。pixels: 包含像素数据的指针。pitch: 像素数据的行字节数。这个参数有点不好理解将原文贴一下 The number of bytes in a row of pixel data, including padding between lines.这个是啥意思呢这里需要解释一下pitch的计算方式以一帧尺寸为960x540格式为SDL_PIXELFORMAT_IYUV为例计算
pitch
SDL_PIXELFORMAT_IYUV也就是IYUV类型也称为YUV420p、I420它在内存中的存储格式为三平面存储。
即第一个平面960个字节的位置存Y分量第二个平面480个字节存U分量第三个平面480个字节存V分量。
而这个函数中的pitch所说的一行数像素数据中的字节数其实指的是第一个平面的长度字节为单位也就是960字节
虽然和宽度在数学上相等但它们所表达的意思是不一样的
另外这是一个相当慢的函数旨在用于不经常更改的静态纹理。
原文链接https://blog.csdn.net/qq_25333681/article/details/90083753
SDL_RenderCopy ,将纹理数据texture 复制到window上
将纹理数据texture 复制到window上这个工作需要经过 渲染上下文(renderer)完成由于创建renderer的时候就是通过当前的window创建的 //因此第一个参数就是这个renderer绑定的是当前要显示的window //第二个参数就是要将哪个 texture 显示到window上 //第三个参数const SDL_Rect * srcrect意思是你要将 texture的哪些部分拿出来显示传递NULL表示整个texture //第四个参数const SDL_Rect * dstrect意思是要显示的数据应该放置在window的什么位置 ret SDL_RenderCopy(renderer,texture,NULL,NULL); SDL_RenderPresent(renderer)将渲染器上下文 连接起来的 texture和window的数据显示到屏幕上
SDL_RenderPresent(renderer); 代码演示 #include stdio.h
#include string.h#include SDL2/SDL.h//自定义消息类型
#define REFRESH_EVENT (SDL_USEREVENT 1) // 请求画面刷新事件
#define QUIT_EVENT (SDL_USEREVENT 2) // 退出事件//定义分辨率
// YUV像素分辨率
#define YUV_WIDTH 320
#define YUV_HEIGHT 240
//定义YUV格式
#define YUV_FORMAT SDL_PIXELFORMAT_IYUVint s_thread_exit 0; // 退出标志 1则退出int refresh_video_timer(void *data)
{while (!s_thread_exit){SDL_Event event;event.type REFRESH_EVENT;SDL_PushEvent(event);SDL_Delay(40);}s_thread_exit 0;//push quit eventSDL_Event event;event.type QUIT_EVENT;SDL_PushEvent(event);return 0;
}
#undef main
int main(int argc, char* argv[])
{//初始化 SDLif(SDL_Init(SDL_INIT_VIDEO)){fprintf( stderr, Could not initialize SDL - %s\n, SDL_GetError());return -1;}// SDLSDL_Event event; // 事件SDL_Rect rect; // 矩形SDL_Window *window NULL; // 窗口SDL_Renderer *renderer NULL; // 渲染SDL_Texture *texture NULL; // 纹理SDL_Thread *timer_thread NULL; // 请求刷新线程uint32_t pixformat YUV_FORMAT; // YUV420P即是SDL_PIXELFORMAT_IYUV// 分辨率// 1. YUV的分辨率int video_width YUV_WIDTH;int video_height YUV_HEIGHT;// 2.显示窗口的分辨率int win_width YUV_WIDTH;int win_height YUV_WIDTH;// YUV文件句柄FILE *video_fd NULL;const char *yuv_path D:/AllInformation/qtworkspacenew/05-sdl-yuv/yuv420p_320x240.yuv;size_t video_buff_len 0;uint8_t *video_buf NULL; //读取数据后先把放到buffer里面// 我们测试的文件是YUV420P格式,需要计算计算出来一张图片的大小是多大。 实际上就是 video_width * video_height * 1.5又由于YUV 都是占用的1个字节uint32_t y_frame_len video_width * video_height; // Y frame层占用的空间uint32_t u_frame_len video_width * video_height / 4; // U frame层占用的空间uint32_t v_frame_len video_width * video_height / 4; // V farme层占用的空间uint32_t yuv_frame_len y_frame_len u_frame_len v_frame_len; //YUV 一张图片占用的大小这里用的名字 yuv_frame_len不是很合理len看起来是长度但是实际上这里算的是空间虽然一个Y,U,V都是1个字节因此len 和 占用空间是1:1的也就是值是一样的但是这样用容易引起误会//创建窗口我们在创建窗口的时候让窗口的width 和heigth和视频的宽和高一样其实这个值是可以不和视频的宽高一致的我们看一些主流的播放器都是去记录上次user对于这个窗口的大小的。window SDL_CreateWindow(Simplest YUV Player,SDL_WINDOWPOS_UNDEFINED,SDL_WINDOWPOS_UNDEFINED,win_width, win_height,SDL_WINDOW_OPENGL|SDL_WINDOW_RESIZABLE);if(!window){fprintf(stderr, SDL: could not create window, err:%s\n,SDL_GetError());goto _FAIL;}// 基于窗口创建渲染器renderer SDL_CreateRenderer(window, -1, 0);// 基于渲染器创建纹理创建纹理的第二个参数应该是YUV420的格式那么在sdl中YUV420格式是什么呢//这个在SDL_CreateTexture的源码中是看不到的在sdl 的官网上查找 SDL_CreateTexture 方法的使用 https://wiki.libsdl.org/wiki/search//可以看到 第二个参数的说明为 one of the enumerated values in SDL_PixelFormatEnum那我们就search SDL_PixelFormatEnum看在这个enum中YUV420是什么// 可以得到 SDL_PIXELFORMAT_IYUV planar mode: Y U V (3 planes)// 第三个参数我们要显示的YUV的数据因此要用 SDL_TEXTUREACCESS_STREAMING, /** Changes frequently, lockable */texture SDL_CreateTexture(renderer,pixformat,SDL_TEXTUREACCESS_STREAMING,video_width,video_height);// 分配空间每一张图片占用的大小video_buf (uint8_t*)malloc(yuv_frame_len);if(!video_buf){fprintf(stderr, Failed to alloce yuv frame space!\n);goto _FAIL;}// 打开YUV文件video_fd fopen(yuv_path, rb);if( !video_fd ){fprintf(stderr, Failed to open yuv file\n);goto _FAIL;}// 创建子线程该线程做了两件事1.发送刷新线程的REFRESH_EVENT2.//然后再主线程 有一个一直循环的代码监听子线程发送的这两个事件用于刷新window画面或者关闭跳出循环timer_thread SDL_CreateThread(refresh_video_timer,NULL,NULL);while (1){// 收取SDL系统里面的事件SDL_WaitEvent(event);if(event.type REFRESH_EVENT) // 画面刷新事件{//1.从 video_fd中读取数据 到 video_bufvideo_buff_len fread(video_buf, 1, yuv_frame_len, video_fd);if(video_buff_len 0){fprintf(stderr, Failed to read data from yuv file!\n);goto _FAIL;}// 2.设置纹理的数据 video_width 320 plane//第一个参数是 要更新那个textureSDL_UpdateTexture(texture, NULL, video_buf, video_width);// 可以通过 指定 rect指定显示区域可以通过修改w和h进行缩放
// rect.x 0;
// rect.y 0;
// float w_ratio win_width * 1.0 /video_width;
// float h_ratio win_height * 1.0 /video_height;
// // 320x240 怎么保持原视频的宽高比例
// rect.w video_width * w_ratio;
// rect.h video_height * h_ratio;
// rect.w video_width * 0.5;
// rect.h video_height * 0.5;// 清除当前显示SDL_RenderClear(renderer);// 将纹理的数据拷贝给渲染器
// SDL_RenderCopy(renderer, texture, NULL, rect);SDL_RenderCopy(renderer, texture, NULL, NULL);// 显示SDL_RenderPresent(renderer);}else if(event.type SDL_WINDOWEVENT){//If ResizeSDL_GetWindowSize(window, win_width, win_height);printf(SDL_WINDOWEVENT win_width:%d, win_height:%d\n,win_width,win_height );}else if(event.type SDL_QUIT) //退出事件{s_thread_exit 1;}else if(event.type QUIT_EVENT){break;}}_FAIL:s_thread_exit 1; // 保证线程能够退出// 释放资源if(timer_thread)SDL_WaitThread(timer_thread, NULL); // 等待线程退出if(video_buf)free(video_buf);if(video_fd)fclose(video_fd);if(texture)SDL_DestroyTexture(texture);if(renderer)SDL_DestroyRenderer(renderer);if(window)SDL_DestroyWindow(window);SDL_Quit();return 0;}全部API包括核心api
相关文件 SDL2/SDL.h 功能:初始化SDL
参数:
flags 系统名称取值如下
SDL_INIT_TIMER定时器子系统SDL_INIT_AUDIO音频子系统SDL_INIT_VIDEO视频子系统SDL_INIT_JOYSTICK操纵杆子系统SDL_INIT_HAPTIC触屏反馈子系统SDL_INIT_GAMECONTROLLER控制器子系统SDL_INIT_EVENTS事件子系统SDL_INIT_EVERYTHING上述所有子系统SDL_INIT_NOPARACHUTE不致命的信号
返回值:
成功返回0
失败返回 -1
原型:
int SDL_Init(Uint32 flags)功能:初始化SDL子系统
参数:
flags 系统名称
同SDL_Init()
返回值:
成功返回0
失败返回 -1
原型:
int SDL_InitSubSystem(Uint32 flags)功能:退出SDL
参数 : 无
返回值 : 无
原型:
void SDL_Quit(void)功能:退出系统
参数:
flags 系统名称
同SDL_Init()
返回值: 无
原型:
void SDL_QuitSubSystem(Uint32 flags)功能:检测系统是否启动
参数:
flags同SDL_Init()
返回值:
成功返回0
失败返回 SDL_INIT_NOPARACHUTE.
原型:
Uint32 SDL_WasInit(Uint32 flags)相关文件 SDL2/SDL_hints.h
函数名:SDL_ClearHints
功能:清空所有提示
参数:无
返回值:无
备注:
原型:void SDL_ClearHints(void)函数名: SDL_GetHint
功能:获取一个提示
参数:
name 提示名称
返回值: 提示名称所代表的内容
备注:
原型:
const char* SDL_GetHint(const char* name)函数名:SDL_SetHint
功能:设置提示
参数:
name 提示名称
value 提示内容
返回值:
成功返回SDL_TRUE
失败返回 SDL_FALSE
备注:
原型:
SDL_bool SDL_SetHint(const char* name, const char* value)函数名:SDL_SetHintWithPriority
功能:设置提示优先级
参数:
name 提示名称
value 提示内容
priority 优先级
SDL_HINT_DEFAULT低优先级,使用默认值SDL_HINT_NORMAL中优先级SDL_HINT_OVERRIDE高优先级
返回值:
成功返回SDL_TRUE
失败返回 SDL_FALSE
备注:
原型:
SDL_bool SDL_SetHintWithPriority(const char* name, const char* value, SDL_HintPriority priority)相关文件 SDL2/SDL_error.h
函数名: SDL_ClearError
功能:清空所有错误提示
参数:无
返回值:无
备注:
原型:
void SDL_ClearError(void)函数名: SDL_GetError
功能:获取一个错误提示
参数:无
返回值:提示内容
备注:
原型:
const char* SDL_GetError(void)函数名:SDL_SetError
功能:设置错误提示
参数:
fmt printf()风格消息格式字符串
返回值:-1
备注:
原型:
int SDL_SetError(const char* fmt, ...)函数名:
SDL_CreateWindowAndRenderer
功能:给窗口配置渲染器
参数:
width 窗口宽
height 窗口高
window 窗口指针
renderer 渲染器指针
返回值:
备注:
原型:
int SDL_CreateWindowAndRenderer(int width,
int height,
Uint32 window_flags,
SDL_Window** window,
SDL_Renderer** renderer)函数名:SDL_CreateWindowFrom
功能:从现有的窗口创建sdl窗口
参数:data 窗口指针
返回值:sdl窗口指针
备注:
原型:
SDL_Window* SDL_CreateWindowFrom(const void* data)
例子:
//用mfc窗口句柄创建一个sdl window
SDL_Window * pWindow
SDL_CreateWindowFrom( (void *)(
GetDlgItem(IDC_STATIC1)-gt;GetSafeHwnd() ) );函数名:SDL_DestroyWindow
功能:销毁一个窗口
参数:
window 窗口指针
返回值:无
备注:
原型:
void SDL_DestroyWindow(SDL_Window* window)函数名:SDL_DisableScreenSaver
功能:禁止屏幕储存
参数:
返回值:
备注:
原型:
void SDL_DisableScreenSaver(void)函数名:SDL_EnableScreenSaver
功能:允许屏幕储存
参数:
返回值:
备注:
原型:
void SDL_EnableScreenSaver(void)函数名:SDL_GetClosestDisplayMode
功能:获得最接近的匹配请求的显示模式。
参数:
displayIndex索引
mode 显示模式
closest 最接近的匹配可用的显示模式
返回值:
备注:
原型:
SDL_DisplayMode* SDL_GetClosestDisplayMode(int displayIndex,
const SDL_DisplayMode* mode,
SDL_DisplayMode* closest)函数名:SDL_GetCurrentDisplayMode
功能:获得当前的显示模式的信息
参数:
displayIndex索引
mode 显示模式
返回值:
成功返回0失败返回-1
备注:
原型:
int SDL_GetCurrentDisplayMode(int displayIndex,SDL_DisplayMode* mode)函数名:SDL_GetCurrentVideoDriver
功能:获取当前视频驱动
参数:
返回值:视频驱动名称
备注:
原型:
const char* SDL_GetCurrentVideoDriver(void)函数名:SDL_GetDesktopDisplayMode
功能:获取关于桌面显示模式的信息
参数:
返回值:
成功返回0
失败返回 -1
备注:
原型:
int SDL_GetDesktopDisplayMode(int displayIndex,
SDL_DisplayMode* mode)函数名:SDL_GetDisplayBounds
功能:获取桌面区域显示
参数:
返回值:成功 0 失败 -1
备注:
原型:
int SDL_GetDisplayBounds(int displayIndex,
SDL_Rect* rect)函数名: SDL_GetDisplayMode
功能:获取特定信息显示模式
参数:
displayIndex显示查询的索引
modeIndex查询的索引显示模式
mode 显示模式
返回值:
成功返回0
失败返回 -1
备注:
原型:
int SDL_GetDisplayMode(int
displayIndex,
int modeIndex,
SDL_DisplayMode* mode)函数名:SDL_GetNumVideoDisplays
功能:返回可用的视频显示器的数量。
参数:
返回值:
显示器数量
备注:
原型:
int SDL_GetNumVideoDisplays(void)函数名: SDL_GetNumVideoDrivers
功能:返回可用的视频驱动的数量
参数:
返回值:
驱动数量
备注:
原型:
int SDL_GetNumVideoDrivers(void)函数名:SDL_GetVideoDriver
功能:获取指定索引视频驱动名称
参数:
返回值:
成功返回 名称
失败返回 空字符串
备注:
原型:
const char* SDL_GetVideoDriver(int index)函数名:SDL_GetWindowBrightness
功能:获取窗口亮度
参数:
返回值:
0.0 完全黑暗
1.0正常亮度
备注:
原型:
float SDL_GetWindowBrightness(SDL_Window* window)函数名:SDL_GetWindowData
功能:获取窗口数据
参数:
window 窗口指针
name 名称
返回值:
成功返回 窗口数据指针
失败 NULL
备注:
原型:
void* SDL_GetWindowData(SDL_Window* window,
const char* name)函数名:SDL_GetWindowDisplayIndex
功能:获取窗口显示索引
参数:window 窗口指针
返回值:显示索引
备注:
原型:
int SDL_GetWindowDisplayIndex(SDL_Window* window)函数名:SDL_GetWindowDisplayMode
功能:获取窗口显示模式
参数:
window 窗口指针
mode 显示模式
返回值:0 -1
备注:
原型:
int SDL_GetWindowDisplayMode(SDL_Window* window,
SDL_DisplayMode* mode)函数名:SDL_GetWindowFlags
功能:获取窗口旗帜
参数:
window 窗口指针
返回值:
SDL_WINDOW_FULLSCREEN全屏窗口SDL_WINDOW_FULLSCREEN_DESKTOP全屏窗口在当前桌面分辨率SDL_WINDOW_OPENGL与OpenGL窗口可用的上下文SDL_WINDOW_SHOWN窗口是可见的SDL_WINDOW_HIDDEN窗口不可见SDL_WINDOW_BORDERLESS没有窗口装饰SDL_WINDOW_RESIZABLE窗口可以调整大小SDL_WINDOW_MINIMIZED窗口最小化SDL_WINDOW_MAXIMIZED窗口最大化SDL_WINDOW_INPUT_GRABBED窗口有输入焦点SDL_WINDOW_INPUT_FOCUS窗口有输入焦点SDL_WINDOW_MOUSE_FOCUS窗口有鼠标焦点SDL_WINDOW_FOREIGN不是由SDL的窗口
备注:
原型:
Uint32 SDL_GetWindowFlags(SDL_Window* window)函数名称:SDL_GetWindowFromID
功能:获取指定id窗口
参数:窗口id
返回值:
成功 窗口指针
失败 NULL
原型:
SDL_Window* SDL_GetWindowFromID(Uint32 id)函数名称:
SDL_GetWindowGammaRamp
功能:获取窗口的颜色
参数:
返回值:
成功返回0
失败返回 -1
原型:
int SDL_GetWindowGammaRamp(SDL_Window* window,
Uint16* red,
Uint16* green,
Uint16* blue)函数名称:SDL_GetWindowGrab
功能:得到一个窗口的输入模式
参数:window 窗口指针
返回值:
成功返回SDL_TRUE
失败返回 SDL_FALSE
原型:
SDL_bool SDL_GetWindowGrab(SDL_Window* window)函数名称:SDL_GetWindowID
功能:获取窗口id
参数:window 窗口指针
返回值:窗口id
原型:
Uint32 SDL_GetWindowID(SDL_Window* window)函数名称:
SDL_GetWindowMinimumSize
功能:获取窗口最小值
参数:
window 窗口指针
w,h 窗口宽高
返回值:
原型:
void SDL_GetWindowMinimumSize(SDL_Window* window,
int* w,
int* h)函数名称:
SDL_GetWindowMaximumSize
功能:获取窗口最大值
参数:
window 窗口指针
w,h 宽高
返回值:
原型:
void SDL_GetWindowMaximumSize(SDL_Window* window,
int* w,
int* h)函数名称:SDL_GetWindowPixelFormat
功能:获取窗口像素格式
参数:
返回值:
成功返回 像素格式
失败返回SDL_PIXELFORMAT_UNKNOWN
原型:
Uint32 SDL_GetWindowPixelFormat(SDL_Window* window)函数名称:SDL_GetWindowPosition
功能:获取窗口坐标
参数:
window 窗口指针
x,y 坐标
返回值:
原型:
void SDL_GetWindowPosition(SDL_Window* window,
int* x,
int* y)函数名称:SDL_GetWindowSize
功能:获取窗口大小
参数:
window 窗口指针
w,h 窗口宽高
返回值:
原型:
void SDL_GetWindowSize(SDL_Window* window,
int* w,
int* h)函数名称:SDL_GetWindowSurface
功能:获取窗口贴图
参数:
window 窗口指针
返回值:
成功返回 窗口贴图
失败返回 NULL
原型:
SDL_Surface* SDL_GetWindowSurface(SDL_Window* window)函数名称:SDL_GetWindowTitle
功能:获取窗口标题
参数:
window 窗口指针
返回值:
成功返回 窗口标题
失败返回 空字符串
原型:
const char* SDL_GetWindowTitle(SDL_Window* window)函数名称:SDL_HideWindow
功能:隐藏窗口
参数:
window 窗口指针
返回值:
原型:
void SDL_HideWindow(SDL_Window* window)函数名称:SDL_IsScreenSaverEnabled
功能:检测屏幕储存是否启用
参数:
返回值:
成功返回 SDL_TRUE
失败返回 SDL_FALSE
原型:
SDL_bool SDL_IsScreenSaverEnabled(void)函数名称:SDL_MaximizeWindow
功能:窗口最大化
参数:
window 窗口指针
返回值:
原型:
void SDL_MaximizeWindow(SDL_Window* window)函数名称:SDL_MinimizeWindow
功能:窗口最小化
参数:
window 窗口指针
返回值:
原型:
void SDL_MinimizeWindow(SDL_Window* window)函数名称: SDL_RaiseWindow
功能:提高上方的窗口,设置输入焦点
参数:
window 窗口指针
返回值:
原型:
void SDL_RaiseWindow(SDL_Window* window)函数名称:SDL_RestoreWindow
功能:恢复被最大化或最小化的窗口
参数:
window 窗口指针
返回值:
原型:
void SDL_RestoreWindow(SDL_Window* window)函数名称:SDL_SetWindowBrightness
功能:设置窗口亮度
参数:
window 窗口指针
brightness 亮度值(参考 0.0为黑暗1.0为光亮)
返回值:
成功返回 0
失败返回 -1
原型:
int SDL_SetWindowBrightness(SDL_Window* window,
float brightness)函数名称:SDL_SetWindowDisplayMode
功能:设置窗口显示模式
参数:
window 窗口指针
mode 显示模式
返回值:
成功返回 0
失败返回 -1
原型:
int SDL_SetWindowDisplayMode(SDL_Window* window,
const SDL_DisplayMode* mode)函数名称:SDL_SetWindowFullscreen
功能:设置窗口全屏状态
参数:
window 窗口指针
flags 旗帜
SDL_WINDOW_FULLSCREEN, 真全屏SDL_WINDOW_FULLSCREEN_DESKTOP 假全屏(以桌面大小)
返回值:
成功返回 0
失败返回 -1
原型:
int SDL_SetWindowFullscreen(SDL_Window* window,
Uint32 flags)函数名称:
SDL_SetWindowGammaRamp
功能:设置窗口的伽马坡道
参数:
window 窗口指针
red,green,blue 红绿蓝
返回值:
成功返回 0
失败返回 -1
原型:
int SDL_SetWindowGammaRamp(SDL_Window* window,
const Uint16* red,
const Uint16* green,
const Uint16* blue)函数名称:SDL_SetWindowGrab
功能:设置窗口的输入
参数:
window 窗口指针
grabbed 是否开启
返回值:
原型:
void SDL_SetWindowGrab(SDL_Window* window,
SDL_bool grabbed)函数名称:SDL_SetWindowIcon
功能:设置窗口小图标
参数:
window 窗口指针
icon 图标贴图
返回值:
原型:
void SDL_SetWindowIcon(SDL_Window* window,
SDL_Surface* icon)函数名称:
SDL_SetWindowMaximumSize
功能:设置窗口最大大小
参数:
window 窗口指针
max_w,max_h 最大宽和最大高
返回值:
原型:
void SDL_SetWindowMaximumSize(SDL_Window* window,
int max_w,
int max_h)函数名称:
SDL_SetWindowMinimumSize
功能:设置窗口最小大小
参数:
window 窗口指针
min_w,min_h 最小宽和最小高
返回值:
原型:
void SDL_SetWindowMinimumSize(SDL_Window* window,
int min_w,
int min_h)函数名称:SDL_SetWindowPosition
功能:设置窗口位置坐标
参数:
window 窗口指针
x,y 坐标
返回值:
原型:
void SDL_SetWindowPosition(SDL_Window* window,
int x,
int y)函数名称:SDL_SetWindowSize
功能:设置窗口大小
参数:
window 窗口指针
w,h 宽高
返回值:
原型:
void SDL_SetWindowSize(SDL_Window* window,
int w,
int h)函数名称:SDL_SetWindowTitle
功能:设置窗口标题
参数:
window 窗口指针
title 标题
返回值:
原型:
void SDL_SetWindowTitle(SDL_Window* window,
const char* title)函数名称:SDL_ShowWindow
功能:显示窗口
参数:
window 窗口指针
返回值:
原型:
void SDL_ShowWindow(SDL_Window* window)函数名称:
SDL_UpdateWindowSurfaceRects
功能:更新窗口指定区域
参数:
window 窗口指针
rects 矩形局域
numrects 矩形数量
返回值:
成功返回 0
失败返回 -1
原型:
int SDL_UpdateWindowSurfaceRects(SDL_Window* window,const SDL_Rect*
rects,int numrects)函数名称:SDL_UpdateWindowSurface
功能:更新窗口
参数:
window 窗口指针
返回值:
成功返回 0
失败返回 -1
原型:
int SDL_UpdateWindowSurface(SDL_Window* window)函数名称:SDL_VideoInit
功能:初始化视频子系统,可以选择指定的视频驱动程序
参数:
driver_name 驱动名称
返回值:
成功返回 0
失败返回 -1
原型:
int SDL_VideoInit(const char*
driver_name)函数名称:SDL_VideoQuit
功能:结束视频子系统
参数:
返回值:
原型:
void SDL_VideoQuit(void)函数名称:SDL_GetWindowWMInfo
功能:获取驱动程序特定的信息
参数:
window 窗口指针
info 信息
返回值:
成功返回 SDL_TRUE
失败返回 SDL_FALSE
原型:
SDL_bool SDL_GetWindowWMInfo(SDL_Window* window,
SDL_SysWMinfo* info)发几个结构体
SDL_DisplayMode结构 显示模式
Uint32 format SDL_PixelFormatEnum值之一
int w 宽
int h 高
int refresh_rate 刷新率SDL_WindowEvent结构 窗口事件
Uint32 type 类型
Uint32 timestamp 时间戳
Uint32 windowID 窗口ID
Uint8 event 事件
Uint8 padding1 填充1
Uint8 padding2 填充2
Uint8 padding3 填充3
Sint32 data1 事件相关数据1
Sint32 data2 事件相关数据2SDL_RendererInfo结构 渲染器信息
const char* name 渲染器名称
Uint32 flags 支持渲染器的旗帜
Uint32 num_texture_formats 纹理格式的数量
Uint32[16] texture_formats 纹理格式
int max_texture_width 纹理最大宽
int max_texture_height 纹理最大高
SDL_PixelFormat结构 像素格式
Uint32 format依据它解析出的uint32_t类型32位值
SDL_Palette* palette调色板数据
Uint8 BitsPerPixel每像素位数。
Uint8 BytesPerPixel每像素字节数。
Uint8 padding[2]对结构对齐而使用的填充字节
Uint32 Rmask32位值R分量掩码。
Uint32 Gmask32位值G分量掩码。
Uint32 Bmask32位值B分量掩码。
Uint32 Amask32位值A分量掩码。
Uint8 Rloss8减去R分量占用位数。
Uint8 Gloss8减去G分量占用位数。
Uint8 Bloss8减去B分量占用位数。
Uint8 Aloss8减去A分量占用位数。
Uint8 RshiftRmask的第一非0位位置。
Uint8 GshiftGmask的第一非0位位置。
Uint8 BshiftBmask的第一非0位位置。
Uint8 AshiftAmask的第一非0位位置。
int refcount引用计数。分配和释放时使用。
struct SDL_PixelFormat* next下一个像素格式结构块。关联文件 SDL2/SDL_assert.h 每个SDL_ASSERT_LEVEL设置和相应的影响三个SDL_assert功能:
三个SDL_assert函数:
SDL_assertSDL_assert_releaseSDL_assert_paranoid
SDL_ASSERT_LEVEL值 描述
0 禁用 ,禁用禁用
1 禁用启用禁用
2 启用启用禁用
3 启用启用启用SDL_assert_data结构体 断点数据
int always_ignore 1或0 是否同意用该断点
unsigned int trigger_count 多少次触发断点
const char* condition 断点检查条件
const char* filename 包含该断点的文件名
int linenum 断点在文件中的位置
const char* function 包含断点的函数名
const struct SDL_assert_data* next 下一个断点函数名称:SDL_SetAssertionHandler
功能:设置断点处理
参数:
返回值:
备注:
这个函数允许应用程序来显示自己的断点或强迫响应断点失败。
处理程序的函数原型:SDL_assert_state YourAssertionHandler(const SDL_assert_data *datavoid *userdata)
data 一个指针SDL_assert_data结构对应于当前的断点
userdata 作为用户数据传递给SDL_SetAssertionHandler原型:
void SDL_SetAssertionHandler(SDL_AssertionHandler handler,
void* userdata)函数名称:SDL_TriggerBreakpoint
功能:触发断点调试
参数:
返回值:
原型:void SDL_TriggerBreakpoint(void)函数名称:SDL_assert
功能:设置调试断点
参数:
返回值:
原型:
void SDL_assert(condition)函数名称:
SDL_assert_paranoid
功能:设置调试paranoid断点
参数:
返回值:
原型:
void SDL_assert_paranoid(condition)函数名称:SDL_assert_release
功能:设置调试release断点
参数:
返回值:
原型:
void SDL_assert_release(condition)关联文件 SDL2/SDL_render.h
函数名称:
功能:创建渲染器
参数:
返回值:
原型:
SDL_Renderer* SDL_CreateRenderer(SDL_Window* window,
int index,
Uint32 flags)函数名称:
功能:创建一个2 d软件渲染表面。
参数:
surface 表面指针
返回值:
成功 渲染器指针
失败 NULL
原型:
SDL_Renderer* SDL_CreateSoftwareRenderer(SDL_Surface* surface)access
SDL_TEXTUREACCESS_STATIC变化很少,而不是可锁定的
SDL_TEXTUREACCESS_STREAMING经常变化,可锁定的
w,h 宽高
返回值:
成功 纹理指针
失败 请用SDL_GetError() 获取错误信息
原型:
SDL_Texture* SDL_CreateTexture(SDL_Renderer* renderer,
Uint32 format,
int access,
int w,
int h)函数名称:
功能:创建一个从现有的表面纹理
参数:
renderer 渲染器指针
surface 表面指针
返回值:
成功 纹理指针
失败 请用SDL_GetError() 获取错误信息
原型:
SDL_Texture* SDL_CreateTextureFromSurface(SDL_Renderer* renderer,
SDL_Surface* surface)函数名称:
功能:创建一个窗口并配置渲染器
参数:
width 窗口宽
height 窗口高
window_flags 参见
SDL_CreateWindow()
window 创建的窗口指针
renderer 渲染器指针
返回值:
成功 0
失败 -1
原型:
int SDL_CreateWindowAndRenderer(int width,
int height,
Uint32 window_flags,
SDL_Window** window,
SDL_Renderer** renderer)函数名称:
功能:销毁一个渲染器
参数:renderer 渲染器指针
返回值:
原型
void SDL_DestroyRenderer(SDL_Renderer* renderer)函数名称:
功能:销毁一个纹理
参数: texture 纹理指针
返回值:
原型:
void SDL_DestroyTexture(SDL_Texture* texture)函数名称:
功能:获取渲染器驱动数量
参数:
返回值:
成功 gt;1
原型:
int SDL_GetNumRenderDrivers(void)函数名称:
功能:获取渲染器绘图混合模式
参数:
renderer 渲染器指针
blendMode
SDL_BLENDMODE_NONE
没有混合
dstRGBA srcRGBA
SDL_BLENDMODE_BLEND
灰度混合
dstRGB (srcRGB * srcA)(dstRGB *(1-srcA))
dstA srcA (dstA *(1-srcA))
SDL_BLENDMODE_ADD
添加混合
dstRGB (srcRGB * srcA) dstRGB
dstA dstA
SDL_BLENDMODE_MOD
颜色调整
dstRGB srcRGB * dstRGB
dstA dstA
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_GetRenderDrawBlendMode(SDL_Renderer* renderer,
SDL_BlendMode* blendMode)函数名称:
功能:获取渲染器绘图颜色
参数:
renderer 渲染器指针
r,g,b,a 红绿蓝灰度(透明度)
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_GetRenderDrawColor(SDL_Renderer* renderer,
Uint8* r,
Uint8* g,
Uint8* b,
Uint8* a)函数名称:
功能:获取渲染器驱动信息
参数:
index 驱动序列
info 信息详细参见
SDL_RendererInfo结构体
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_GetRenderDriverInfo(int index,
SDL_RendererInfo* info)函数名称:
功能:获取指定窗口的渲染器
参数:
window 窗口指针
返回值:
成功 渲染器指针
失败 NULL
原型
SDL_Renderer* SDL_GetRenderer(SDL_Window* window)函数名称:
功能:获取纹理灰度(透明度)
参数:
texture 纹理指针
alpha 灰度(透明度)
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_GetTextureAlphaMod(SDL_Texture* texture,
Uint8* alpha)函数名称:
功能:获取纹理混合模式
参数:
texture 纹理指针
blendMode 混合模式
SDL_BLENDMODE_NONE
没有混合
dstRGBA srcRGBA
SDL_BLENDMODE_BLEND
灰度混合
dstRGB (srcRGB * srcA)(dstRGB *(1-srcA))
dstA srcA (dstA *(1-srcA))
SDL_BLENDMODE_ADD
添加混合
dstRGB (srcRGB * srcA) dstRGB
dstA dstA
SDL_BLENDMODE_MOD
颜色调整
dstRGB srcRGB * dstRGB
dstA dstA
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_GetTextureBlendMode(SDL_Texture* texture,
SDL_BlendMode* blendMode)函数名称:
功能:获取纹理颜色模式
参数:
texture 纹理指针
r,g,b 颜色
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_GetTextureColorMod(SDL_Texture* texture,
Uint8* r,
Uint8* g,
Uint8* b)函数名称:
功能:锁定纹理
参数:
texture 纹理指针
rect 锁定区域NULL 为整个纹理
pixels 像素
pitch 暂时理解为程度
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_LockTexture(SDL_Texture* texture,
const SDL_Rect* rect,
void** pixels,
int* pitch)函数名称:
功能:查询纹理
参数:
texture 纹理指针
format,access,w,h 参见
SDL_CreateTexture
返回值:
原型:
int SDL_QueryTexture(SDL_Texture* texture,
Uint32* format,
int* access,
int* w,
int* h)函数名称:
功能:清空渲染器
参数:
renderer 渲染器指针
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型
int SDL_RenderClear(SDL_Renderer* renderer)函数名称:
功能:复制纹理到渲染器
参数:
renderer 渲染器指针
texture 纹理指针
srcrect 源区域NULL为整个纹理
dstrect 目标区域NULL为整个渲染目标
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_RenderCopy(SDL_Renderer* renderer,
SDL_Texture* texture,
const SDL_Rect* srcrect,
const SDL_Rect* dstrect)函数名称:
功能:复制纹理到指定区域2
参数:
renderer 渲染器指针
texture 纹理指针
srcrect 源区域NULL为整个纹理
dstrect 目标区域NULL为整个渲染目标
angle 旋度
center 中心
flip 翻转
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_RenderCopyEx(SDL_Renderer* renderer,
SDL_Texture* texture,
const SDL_Rect* srcrect,
const SDL_Rect* dstrect,
const double angle,
const SDL_Point *center,
const SDL_RendererFlip flip);函数名称:
功能:向渲染器绘制一个线段
参数:
renderer 渲染器指针
x1,y1 第一个端点的坐标
x2,y2 第二个端点的坐标
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_RenderDrawLine(SDL_Renderer* renderer,
int x1,
int y1,
int x2,
int y2)函数名称:
功能:绘制多个线段
参数:
renderer 渲染器指针
points SDL_Point 数组 点坐标
count 数组长度
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_RenderDrawLines(SDL_Renderer* renderer,
const SDL_Point* points,
int count)函数名称:
功能:绘制一个点
参数:
renderer 渲染器指针
x,y 点坐标
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_RenderDrawPoint(SDL_Renderer* renderer,
int x,
int y)函数名称:
功能:绘制多个点
参数:
renderer 渲染器指针
points SDL_Point 数组 点坐标
count 数组长度
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型
int SDL_RenderDrawPoints(SDL_Renderer* renderer,
const SDL_Point* points,
int count)函数名称:
功能:绘制一个矩形
参数:
renderer 渲染器指针
rect 矩形详细参见SDL_Rect结构
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_RenderDrawRect(SDL_Renderer*
renderer,
const SDL_Rect* rect)函数名称:
功能:绘制多个矩形
参数:
renderer 渲染器指针
rects SDL_Rect数组
count 数组长度
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_RenderDrawRects(SDL_Renderer* renderer,
const SDL_Rect* rects,
int count)函数名称:
功能:绘制一个填充矩形
参数:
renderer 渲染器指针
rect 矩形
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_RenderFillRect(SDL_Renderer* renderer,
const SDL_Rect* rect)函数名称:
功能:绘制多个填充矩形
参数:
renderer 渲染器指针
rects SDL_Rect数组
count 数组长度
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_RenderFillRects(SDL_Renderer* renderer,
const SDL_Rect* rects,
int count)函数名称:
功能:获取渲染器剪切区域
参数:
renderer 渲染器指针
rect 矩形区域
返回值:
原型:
void SDL_RenderGetClipRect(SDL_Renderer* renderer,
SDL_Rect* rect);函数名称:
功能:获取绘图区域绘制当前目标
参数:
renderer 渲染器指针
rect 矩形区域
返回值:
原型
void SDL_RenderGetViewport(SDL_Renderer* renderer,
SDL_Rect* rect)函数名称:
功能:更新屏幕
参数:
返回值:
原型:
void SDL_RenderPresent(SDL_Renderer* renderer)函数名称:
功能:读取渲染器区域像素
参数:
renderer 渲染器指针
rect 读取区域
format 格式
pixels 像素
pitch 像素间距
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_RenderReadPixels(SDL_Renderer* renderer,
const SDL_Rect* rect,
Uint32 format,
void* pixels,
int pitch)函数名称:
功能:设置渲染器剪切区域
参数:
renderer 渲染器指针
rect 剪切区域
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_RenderSetClipRect(SDL_Renderer* renderer,
const SDL_Rect* rect);函数名称:
功能:设置绘图区域绘制当前目标
参数:
renderer 渲染器指针
rect 绘图区域
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_RenderSetViewport(SDL_Renderer* renderer,
const SDL_Rect* rect)函数名称:
功能:设置渲染器绘制混合模式
参数:
renderer 渲染器指针
blendMode 混合模式
SDL_BLENDMODE_NONE
没有混合
dstRGBA srcRGBA
SDL_BLENDMODE_BLEND
透明混合
dstRGB (srcRGB * srcA)(dstRGB *(1-srcA))
dstA srcA (dstA *(1-srcA))
SDL_BLENDMODE_ADD
添加混合
dstRGB (srcRGB * srcA) dstRGB
dstA dstA
SDL_BLENDMODE_MOD
颜色调整
dstRGB srcRGB * dstRGB
dstA dstA
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_SetRenderDrawBlendMode(SDL_Renderer* renderer,
SDL_BlendMode blendMode)函数名称:
功能:设置绘制颜色
参数:
renderer 渲染器指针
r,g,b,a 红绿蓝透明度
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型
int SDL_SetRenderDrawColor(SDL_Renderer* renderer,
Uint8 r,
Uint8 g,
Uint8 b,
Uint8 a)函数名称:
功能:设置一个纹理作为当前渲染目标
参数:
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_SetRenderTarget(SDL_Renderer *renderer,
SDL_Texture *texture)函数名称:
功能:设置纹理透明度
参数:
texture 纹理指针
alpha 透明度
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_SetTextureAlphaMod(SDL_Texture* texture,
Uint8 alpha)函数名称:
功能:设置纹理混合模式
参数:
texture 纹理指针
blendMode 混合模式SDL_BLENDMODE_NONE
没有混合
dstRGBA srcRGBA
SDL_BLENDMODE_BLEND
透明混合
dstRGB (srcRGB * srcA)(dstRGB *(1-srcA))
dstA srcA (dstA *(1-srcA))
SDL_BLENDMODE_ADD
添加混合
dstRGB (srcRGB * srcA) dstRGB
dstA dstA
SDL_BLENDMODE_MOD
颜色调整
dstRGB srcRGB * dstRGB
dstA dstA
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_SetTextureBlendMode(SDL_Texture* texture,
SDL_BlendMode blendMode)函数名称:
功能:设置纹理颜色模式
参数:
texture 纹理指针
r,g,b 颜色
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型:
int SDL_SetTextureColorMod(SDL_Texture* texture,
Uint8 r,
Uint8 g,
Uint8 b)函数名称:
功能:解锁纹理
参数:texture 纹理指针
返回值:
原型:
void SDL_UnlockTexture(SDL_Texture* texture)函数名称:
功能:更新纹理
参数:
texture 纹理指针
rect 区域
pixels 像素
pitch 像素间距
返回值:
成功返回 0
失败 用 SDL_GetError() 获取
原型
int SDL_UpdateTexture(SDL_Texture* texture,
const SDL_Rect* rect,
const void* pixels,
int pitch)宏
像素格式宏
SDL_PIXELTYPE(format)
像素的类型格式
SDL_PIXELORDER(format)位像素格式
SDL_PIXELLAYOUT(format)通道像素格式的位模式
SDL_BITSPERPIXEL(format)像素颜色信息
SDL_BYTESPERPIXEL(format)一个像素的字节数
SDL_ISPIXELFORMAT_INDEXED(format)适用于像素格式的调色板
SDL_ISPIXELFORMAT_ALPHA(format)alpha通道的像素格式
SDL_ISPIXELFORMAT_FOURCC(format)适用于像素格式代表独特的格式,例如YUV格式常量
像素格式的值
SDL_PIXELFORMAT_UNKNOWN
SDL_PIXELFORMAT_INDEX1LSB
SDL_PIXELFORMAT_INDEX1MSB
SDL_PIXELFORMAT_INDEX4LSB
SDL_PIXELFORMAT_INDEX4MSB
SDL_PIXELFORMAT_INDEX8
SDL_PIXELFORMAT_RGB332
SDL_PIXELFORMAT_RGB444
SDL_PIXELFORMAT_RGB555
SDL_PIXELFORMAT_BGR555
SDL_PIXELFORMAT_ARGB4444
SDL_PIXELFORMAT_RGBA4444
SDL_PIXELFORMAT_ABGR4444
SDL_PIXELFORMAT_BGRA4444
SDL_PIXELFORMAT_ARGB1555
SDL_PIXELFORMAT_RGBA5551
SDL_PIXELFORMAT_ABGR1555
SDL_PIXELFORMAT_BGRA5551
SDL_PIXELFORMAT_RGB565
SDL_PIXELFORMAT_BGR565
SDL_PIXELFORMAT_RGB24
SDL_PIXELFORMAT_BGR24
SDL_PIXELFORMAT_RGB888
SDL_PIXELFORMAT_RGBX8888
SDL_PIXELFORMAT_BGR888
SDL_PIXELFORMAT_BGRX8888
SDL_PIXELFORMAT_ARGB8888
SDL_PIXELFORMAT_RGBA8888
SDL_PIXELFORMAT_ABGR8888
SDL_PIXELFORMAT_BGRA8888
SDL_PIXELFORMAT_ARGB2101010
SDL_PIXELFORMAT_YV12
SDL_PIXELFORMAT_IYUV
SDL_PIXELFORMAT_YUY2
SDL_PIXELFORMAT_UYVY
SDL_PIXELFORMAT_YVYU结构体
SDL_Color
Uint8 r 红色 取值范围0-255
Uint8 g绿色 取值范围 0-255
Uint8 b蓝色 取值范围0-255
Uint8 a透明度 取值范围 0-255SDL_Palette
int ncolors 调色板颜色数量数组长度
SDL_Color* colors 颜色数组
Uint32 version 内部使用不翻译
int refcount 内部使用不翻译功能:创建一个SDL_Palette 结构对应调色板
参数:ncolors 颜色数量
返回值:
成功 参见SDL_Palette结构
失败 NULL
备注:调色板初始化为白色的
原型:
SDL_Palette* SDL_AllocPalette(int ncolors)功能:计算256伽马值
参数:
gamma 伽马值 0.0~1.0
ramp 一个数组存放的是需要正的梯度 长度256
返回值:
原型:
void SDL_CalculateGammaRamp(float gamma,
Uint16* ramp)功能:释放一个由SDL_AllocFormat创建的像素格式
参数:format 像素格式指针
返回值:
原型:
void SDL_FreeFormat(SDL_PixelFormat* format)功能:释放一个调色板
参数:palette 调色板指针
返回值:
原型:
void SDL_FreePalette(SDL_Palette* palette)功能:获取像素格式对应名称
参数:
format参见常量 像素格式的值
返回值:
成功 名称字符串
失败 SDL_PIXELFORMAT_UNKNOWN
原型:
const char* SDL_GetPixelFormatName(Uint32 format)功能:获取一个像素的RGB值
参数:
pixel 像素值
format 格式
r,g,b 颜色
返回值:
原型:
void SDL_GetRGB(Uint32 pixel,
const SDL_PixelFormat* format,
Uint8* r,
Uint8* g,
Uint8* b)功能:获取一个像素的RGB值
参数:
部分同上
a 透明度
返回值:
原型:
void SDL_GetRGBA(Uint32 pixel,
const SDL_PixelFormat* format,
Uint8* r,
Uint8* g,
Uint8* b,
Uint8* a)功能:将RGB值映射到一个像素格式
参数:
format 像素格式 详细参见SDL_PixelFormat结构体
r,g,b 颜色
返回值:
如果这个像素格式有一个8位索引则返回匹配的调色板
如果这个像素格式有灰度将返回1
如果这个像素格式bpp(颜色深度)小于32-bpp,将忽略返回值
原型:
Uint32 SDL_MapRGB(const SDL_PixelFormat* format,
Uint8 r,
Uint8 g,
Uint8 b)功能:获取一个像素的RGBA值
参数:
部分同上函数
a 灰度(透明度)
返回值:
返回的像素值最接近给定的RGBA颜色值的格式
如果指定的像素格式没有灰度值返回将被忽略
如果这个像素格式有一个8位索引则返回匹配的调色板
如果这个像素格式bpp(颜色深度)小于32-bpp,将忽略返回值
原型:
Uint32 SDL_MapRGBA(const SDL_PixelFormat* format,
Uint8 r,
Uint8 g,
Uint8 b,
Uint8 a)功能:用bpp值和RGBA值来获得像素格式
参数:
bpp 颜色深度
Rmask R分量掩码
Gmask G分量掩码
Bmask B分量掩码
Amask A分量掩码
返回值:
参见上面的 像素格式的值
原型:
Uint32 SDL_MasksToPixelFormatEnum(int bpp,
Uint32 Rmask,
Uint32 Gmask,
Uint32 Bmask,
Uint32 Amask)功能:获取像素格式的值的颜色深度和RGBA值
参数:
format 参见上面的 像素格式的值 常量
bpp颜色深度
Rmask Gmask Bmask Amask 颜色分量掩码
返回值:
成功 SDL_TURE
失败 SDL_FALSE
原型:
SDL_bool SDL_PixelFormatEnumToMasks(Uint32 format,
int* bpp,
Uint32* Rmask,
Uint32* Gmask,
Uint32* Bmask,
Uint32* Amask)功能:设置调色板的颜色
参数:
palette 调色板
colors 颜色数组
firstcolor 第一个颜色
ncolors 颜色数组长度
返回值:
成功 0
失败 用SDL_GetError() 获取错误信息
原型:
int SDL_SetPaletteColors(SDL_Palette* palette,
const SDL_Color* colors,
int firstcolor,
int ncolors)功能 为一个像素格式配置调色板
参数:
format 像素格式
palette 调色板
返回值:
成功 0
失败 用SDL_GetError() 获取错误信息
原型:
int SDL_SetPixelFormatPalette(SDL_PixelFormat* format,
SDL_Palette* palette)关联文件 SDL2/SDL_rect.h 结构体
SDL_Point
int x 横坐标
int y 纵坐标SDL_Rect
int x 横坐标
int y 纵坐标
int w 宽
int h 高功能:检测矩形A与矩形B是否碰撞
参数:
A 矩形A
B 矩形B
返回值:
成功返回 SDL_TRUE
失败返回 SDL_FALSE
原型:
SDL_bool SDL_HasIntersection(const SDL_Rect* A,
const SDL_Rect* B)功能:矩形A矩形B相交区域
A 矩形A
B 矩形B
result 相交区域
返回值:
成功返回 SDL_TRUE
失败返回 SDL_FALSE
原型:
SDL_bool SDL_IntersectRect(const SDL_Rect* A,
const SDL_Rect* B,
SDL_Rect* result)功能:计算最小矩形封闭的点的集合
参数:
points 点集数组
count 数组长度
clip 用于剪切区域内的点,NULL 所有点
result 结果矩形
返回值:
成功返回 SDL_TRUE
失败返回 SDL_FALSE
原型:
SDL_bool SDL_EnclosePoints(const SDL_Point* points,
int count,
const SDL_Rect* clip,
SDL_Rect* result)功能:检测线段与矩形是否碰撞
参数:
rect 矩形
x1,y1,x2,y2 线段坐标
返回值:
成功返回 SDL_TRUE
失败返回 SDL_FALSE
原型:
SDL_bool SDL_IntersectRectAndLine(const SDL_Rect* rect,
int* X1,
int* Y1,
int* X2,
int* Y2)功能:检查矩形是否为空
参数:r 矩形
返回值:
成功返回 SDL_TRUE
失败返回 SDL_FALSE
原型:
SDL_bool SDL_RectEmpty(const SDL_Rect* r)功能:合并两个矩形
参数:
A 矩形A
B 矩形B
result 结果矩形
返回值:
成功返回 SDL_TRUE
失败返回 SDL_FALSE
原型:
void SDL_UnionRect(const SDL_Rect* A,
const SDL_Rect* B,
SDL_Rect* result)功能:检查两个矩形是否相等
参数:
a 矩形a
b 矩形b
返回值:
成功返回 SDL_TRUE
失败返回 SDL_FALSE
原型:
SDL_bool SDL_RectEquals(const SDL_Rect* a,
const SDL_Rect* b)关联文件 SDL2/SDL_surface.h 结构体SDL_Surface
Uint32 flags (内部使用)
SDL_PixelFormat* format 像素格式
详细请看SDL_PixelFormat结构体(只读)
int w, h 宽高 (只读)
int pitch 像素间距(只读)
void* pixels 像素(读写)
void* userdata 用户数据(读写)
int locked 锁定(内部使用)
void* lock_data 锁数据 (内部使用)
SDL_Rect clip_rect剪切区域 (只读)
SDL_!BlitMap* map (内部使用)
int refcount 引用计数函数部分
功能:实现缩放表面复制到目标表面
参数:
src 源表面指针
srcrect 源区域
dst 目标表面
dstrect 目标区域
返回值:
成功 0
失败 请用SDL_GetError() 获取错误信息
原型:
int BlitScaled(SDL_Surface* src,
const SDL_Rect* srcrect,
SDL_Surface* dst,
SDL_Rect* dstrect)功能:可进行快速表面复制到目标表面
参数:
src 源表面指针
srcrect 源区域
dst 目标表面
dstrect 目标区域
返回值:
成功 0
失败 请用SDL_GetError() 获取错误信息
原型:
int SDL_BlitSurface(SDL_Surface* src,
const SDL_Rect* srcrect,
SDL_Surface* dst,
SDL_Rect* dstrect)功能:以一种格式的像素块复制到另一种格式
参数:
width 以像素为单位的块的宽度
height 以像素为单位的块的高度
src_format 源像素的格式
src 一个指向源像素的指针
src_pitch 复制该块的间距
dst_format 目标像素的格式
dst 填充了新的象素数据的指针
dst_pitch 目标块的间距
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
原型:
int SDL_ConvertPixels(int width,
int height,
Uint32 src_format,
const void* src,
int src_pitch,
Uint32 dst_format,
void* dst,
int dst_pitch)功能:将表面传送到指定的像素格式的表面进行优化
参数:
src 源表面
fmt 像素格式
flags 未被使用应置为0
返回值:
成功 优化后的表面指针
失败 NULL
原型:
SDL_Surface* SDL_ConvertSurface(SDL_Surface* src,
const SDL_PixelFormat* fmt,
Uint32 flags)功能:将现有的表面复制到指定格式的新的表面
参数:
src 源表面指针
pixel_format 像素格式取值参考 像素格式的值 常量
flags 设置为0既可
返回值:
原型:
SDL_Surface* SDL_ConvertSurfaceFormat(SDL_Surface* src,
Uint32 pixel_format,
Uint32 flags)功能:创建一个RGB表面
参数:
flags 设置为0既可
width,height 宽高
depth 颜色深度
Rmask Gmask Bmask Amask 颜色掩码
返回值:
成功 表面指针
失败 NULL
原型:
SDL_Surface* SDL_CreateRGBSurface(Uint32 flags,
int width,
int height,
int depth,
Uint32 Rmask,
Uint32 Gmask,
Uint32 Bmask,
Uint32 Amask)功能:绘制多个填充矩形
参数:
dst 绘制表面
rects 矩形数组参见SDL_Rect结构体
count 数组长度
color 颜色可以通过SDL_MapRGB或SDL_MapRGBA被生成。
返回值:
原型:
int SDL_FillRects(SDL_Surface* dst,
const SDL_Rect* rects,
int count,
Uint32 color)功能:释放一个表面
参数:
surface 表面指针
返回值:
原型:
void SDL_FreeSurface(SDL_Surface* surface)功能:获得的裁剪的矩形表面
参数:
surface 表面指针
rect 裁剪矩形
返回值:
原型:
void SDL_GetClipRect(SDL_Surface* surface,
SDL_Rect* rect)功能:获取表面的颜色键(透明度)
参数:
surface 表面指针
key 颜色键指针
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
备注:颜色键是用表面上的格式的一个象素由SDL_MapRGB作为生成的。
原型:
int SDL_GetColorKey(SDL_Surface* surface,
Uint32* key)功能:获取表面透明度
参数:
surface 表面指针
alpha 透明度指针
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
备注:
原型:
int SDL_GetSurfaceAlphaMod(SDL_Surface* surface,
Uint8* alpha)功能:获得用于位块传输操作的混合模式
参数:
surface 表面指针
blendMode 混合模式
SDL_BLENDMODE_NONE 无混合
dstRGBA srcRGBA
SDL_BLENDMODE_BLEND 透明混合
dstRGB (srcRGB * srcA) (dstRGB * (1-srcA))
dstA srcA (dstA * (1-srcA))
SDL_BLENDMODE_ADD 添加混合
dstRGB (srcRGB * srcA) dstRGB
dstA dstA
SDL_BLENDMODE_MOD 颜色混合
dstRGB srcRGB * dstRGB
dstA dstA
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
备注:
原型:
int SDL_GetSurfaceBlendMode(SDL_Surface* surface,
SDL_BlendMode* blendMode)功能:获得表面的颜色值
参数:
surface 表面指针
r,g,b 颜色指针
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
备注:
原型:
int SDL_GetSurfaceColorMod(SDL_Surface* surface,
Uint8* r,
Uint8* g,
Uint8* b)功能:加载一张bmp图片
参数:
file 文件
返回值:
成功 表面指针
失败 NULL
备注:
原型:
SDL_Surface* SDL_LoadBMP(const char* file)功能:从一个SDL提供的数据流加载bmp格式图片
参数:
src 数据流指针
freedst 不为0获取后关闭数据流为0则相反
返回值:
成功 表面指针
失败 NULL
备注:
原型:
SDL_Surface* SDL_LoadBMP_RW(SDL_RWops* src,
int freesrc)功能:锁定表面
参数:
surface 被锁定表面指针
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
备注:
原型:
int SDL_LockSurface(SDL_Surface* surface)功能:进行低层次的位块传输
参数:
src 源表面
srcrect 源矩形
dst 目标表面
dstrect 目标矩形
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
备注:
原型:
int SDL_LowerBlit(SDL_Surface* src,
SDL_Rect* srcrect,
SDL_Surface* dst,
SDL_Rect* dstrect)功能:进行低层次的表面缩放位块传输
参数:
src 源表面
srcrect 源矩形
dst 目标表面
dstrect 目标矩形
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
备注:
原型:
int SDL_LowerBlitScaled(SDL_Surface* src,
SDL_Rect* srcrect,
SDL_Surface* dst,
SDL_Rect* dstrect)功能:确定一个表面是否必须锁定访问。
参数:surface 表面指针
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
备注:
原型:
int SDL_MUSTLOCK(SDL_Surface* surface)功能:保存一个表面为bmp图片
参数:
surface 表面指针
file 保存文件
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
备注:
原型:
int SDL_SaveBMP(SDL_Surface* surface,
const char* file)功能:保存表面到一个SDL数据流
参数:
surface 表面指针
dst 数据流指针
freedst 不为0保存后关闭数据流为0则相反
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
备注:
原型:
int SDL_SaveBMP_RW(SDL_Surface* surface,
SDL_RWops* dst,
int freedst)功能:设置裁剪矩形表面
参数:
surface 表面指针
rect 剪裁矩形
返回值:
成功SDL_TRUE
失败 SDL_FALSE
备注:
原型:
SDL_bool SDL_SetClipRect(SDL_Surface* surface,
const SDL_Rect* rect)功能:设置表面透明度
参数:
surface 表面指针
alpha 透明度
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
备注:
原型:
int SDL_SetSurfaceAlphaMod(SDL_Surface* surface,
Uint8 alpha)功能:设置表面混合模式
参数:
surface 表面指针
blendMode 混合模式
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
备注:
原型:
int SDL_SetSurfaceBlendMode(SDL_Surface* surface,
SDL_BlendMode blendMode)功能:设置表面颜色模式
参数:
surface 表面指针
r,g,b 颜色
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
备注:
原型:
int SDL_SetSurfaceColorMod(SDL_Surface* surface,
Uint8 r,
Uint8 g,
Uint8 b)功能:设置表面调色板
参数:
surface 表面指针
palette 调色板指针
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
备注:
原型:
int SDL_SetSurfacePalette(SDL_Surface* surface,
SDL_Palette* palette)功能:设置RLE加速表面
参数:
surface 表面指针
flag 为0关闭加速非0开启
返回值:
返回0表示成功
失败则返回一个负的错误代码请使用SDL_GetError获取更多信息。
备注:
原型:
int SDL_SetSurfaceRLE(SDL_Surface* surface,
int flag)功能:解锁表面
参数:
surface 表面指针
返回值:
备注:
原型:
void SDL_UnlockSurface(SDL_Surface* surface)功能:设置表面的颜色键透明像素
参数:
surface 表面指针
flag
SDL_TRUE启用SDL_FALSE禁用
key 颜色键透明象素
返回值:
备注:
原型:
int SDL_SetColorKey(SDL_Surface* surface,
int flag,
Uint32 key)头文件 SDL_syswm.h 枚举
枚举名:SDL_SYSWM_TYPE
简介:支持窗口化子系统的枚举
值:
SDL_SYSWM_UNKNOWN 未知系统
SDL_SYSWM_WINDOWS
微软的Windows
SDL_SYSWM_X11
X Window系统
SDL_SYSWM_DIRECTFB
DirectFB
SDL_SYSWM_COCOA
苹果Mac OS X
SDL_SYSWM_UIKIT
苹果iOS结构名:SDL_SysWMmsg
简介 包含系统相关的窗口管理器消息的结构。
成员:
SDL_version version
包含当前SDL版的SDL_version结构
SDL_SYSWM_TYPE subsystem
窗口系统类型,详细参见SDL_SYSWM_TYPE枚举
int dummy
未使用没有特定的系统可用帮助编译器
HWND win.hwnd 该消息的窗口
UINT win.msg 该消息的类型
WPARAM win.wParam
WORD消息参数
LPARAM win.lParam
长消息的参数
XEvent x11.event
X11事件结构
DFBEvent dfb.event
DirectFB的事件函数功能:获得有关的窗口的具体信息
参数:
window 其信息被请求的窗口
info 一个SDL_SysWMinfo结构,保存窗口信息
返回值:
成功 SDL_TRUE
失败 SDL_FALSE
原型:
SDL_bool SDL_GetWindowWMInfo(SDL_Window* window,
SDL_SysWMinfo* info)示例:
#include SDL.h
#include SDL_syswm.hint main(int argc, char *argv[]) {
SDL_Init(0);
SDL_Window* window SDL_CreateWindow(,0,0,0,0,SDL_WINDOW_HIDDEN);SDL_SysWMinfo info;SDL_VERSION(amp;info.version); // initialize info structure with SDL version infoif(SDL_GetWindowWMInfo(window,amp;info)) { // the call returns true on success
// success
const char *subsystem an unknown system!;
switch(info.subsystem) {
case SDL_SYSWM_UNKNOWN: break;
case SDL_SYSWM_WINDOWS: subsystem Microsoft Windows(TM); break;
case SDL_SYSWM_X11: subsystem X Window System; break;
case SDL_SYSWM_DIRECTFB: subsystem DirectFB; break;
case SDL_SYSWM_COCOA: subsystem Apple OS X; break;
case SDL_SYSWM_UIKIT: subsystem UIKit; break;
}
SDL_Log(This program is running SDL version %d.%d.%d on %s,
(int)info.version.major,
(int)info.version.minor,
(int)info.version.patch,
subsystem);} else {
// call failed
SDL_LogError(SDL_LOG_CATEGORY_ERROR, Couldnt get window information: %s, SDL_GetError());
}SDL_DestroyWindow(window);
SDL_Quit();}头文件 SDL_clipboard.h 功能:从剪切板中获取一条utf-8字符串
参数:
返回值:
成功 字符串指针
失败 NULL
原型:
char* SDL_GetClipboardText(void)功能:检查剪贴板中是否有字符串
参数:
返回值:
有 SDL_TRUE
没有 SDL_FALSE
原型:
SDL_bool SDL_HasClipboardText(void)功能:设置一条字符串到剪贴板
参数:
text 字符串指针
返回值:
成功返回 0
失败 请用SDL_GetError()获取错误信息
原型:
int SDL_SetClipboardText(const char* text)头文件 SDL_events.h 枚举
枚举名:SDL_EventType
值:
SDL_FIRSTEVENT
删除未使用应用程序事件
SDL_QUIT
用户请求的事件
Android和iOS的事件
SDL_APP_TERMINATING
操作系统终止应用
SDL_APP_LOWMEMORY
操作系统是内存不足;释放一些
SDL_APP_WILLENTERBACKGROUND
应用程序进入后台
SDL_APP_DIDENTERBACKGROUND
进入应用背面
SDL_APP_WILLENTERFOREGROUND
应用正进入前面
SDL_APP_DIDENTERFOREGROUND
进入应用前面窗口事件
SDL_WINDOWEVENT
窗口状态变化
SDL_SYSWMEVENT
特定的系统事件键盘事件
SDL_KEYDOWN
键按下
SDL_KEYUP
按键松开SDL_TEXTEDITING
键盘文字编辑组成
SDL_TEXTINPUT
键盘文字输入鼠标事件
SDL_MOUSEMOTION
鼠标移动
SDL_MOUSEBUTTONDOWN
按下鼠标按钮
SDL_MOUSEBUTTONUP
释放鼠标按钮
SDL_MOUSEWHEEL
鼠标滚轮运动操纵杆事件
SDL_JOYAXISMOTION
摇杆轴运动
SDL_JOYBALLMOTION
操纵杆轨迹球运动
SDL_JOYHATMOTION
摇杆帽位置变化
SDL_JOYBUTTONDOWN
操纵杆按钮按下
SDL_JOYBUTTONUP
摇杆键发布
SDL_JOYDEVICEADDED
摇杆连接
SDL_JOYDEVICEREMOVED
断开操纵杆控制器事件
SDL_CONTROLLERAXISMOTION
控制轴运动
SDL_CONTROLLERBUTTONDOWN
控制按钮被按下
SDL_CONTROLLERBUTTONUP
控制按钮发布
SDL_CONTROLLERDEVICEADDED
控制器相连
SDL_CONTROLLERDEVICEREMOVED
控制器断开连接
SDL_CONTROLLERDEVICEREMAPPED
控制器映射更新触摸事件
SDL_FINGERDOWN
用户触摸输入装置
SDL_FINGERUP
用户停止触摸输入设备
SDL_FINGERMOTION
用户拖动手指输入设备手势事件
SDL_DOLLARGESTURE
SDL_DOLLARRECORD
SDL_MULTIGESTURE剪贴板事件
SDL_CLIPBOARDUPDATE
改变剪贴板拖放事件
SDL_DROPFILE这些是供您使用并应分配SDL_RegisterEvents
SDL_USEREVENT
一个用户指定的事件
SDL_LASTEVENT
仅适用于边界内部数组例子:
SDL_Event e;
while (SDL_PollEvent(amp;e) {
if (e.type SDL_KEYDOWN) {
printf(User just pressed down a key!);
}
}结构名:SDL_DollarGestureEvent
简介 包含复杂的手势事件信息的结构
成员:
Uint32 type 类型
Uint32 timestamp 事件的时间戳
SDL_TouchID touchId 触摸设备序列
SDL_GestureID gestureId 描述
Uint32 numFingers 描述
float error 错误描述
float x
//0 ~1。切换到屏幕COORDS
float y 描述结构名: SDL_DropEvent
简介:
包含用于请求一个文件系统打开一个文件的结构
成员:
Uint32 type 事件类型
Uint32 timestamp 事件的时间戳
char* file 文件名它应该用SDL_free释放结构名:SDL_Event
简介 包含不同事件类型的结构
成员:
Uint32 type 事件类型所有事件都可用
SDL_CommonEvent common 常见的事件数据
SDL_WindowEvent window 窗口事件
SDL_KeyboardEvent key 键盘事件SDL_TextEditingEvent edit 文本编辑事件
SDL_TextInputEvent text 文本输入事件
SDL_MouseMotionEvent motion 鼠标移动事件
SDL_MouseButtonEvent button 鼠标按钮事件
SDL_MouseWheelEvent wheel
鼠标滚轮事件
SDL_JoyAxisEvent jaxis
操纵杆轴事件数据
SDL_JoyBallEvent jball
操纵杆球事件数据
SDL_JoyHatEvent jhat
摇杆帽事件数据
SDL_JoyButtonEvent jbutton
操纵杆按钮事件数据
SDL_JoyDeviceEvent jdevice
操纵杆设备事件数据
SDL_ControllerAxisEvent caxis
游戏手柄轴事件数据
SDL_ControllerButtonEvent cbutton
游戏控制器按钮事件数据
SDL_ControllerDeviceEvent cdevice
游戏控制器设备的事件数据
SDL_QuitEvent quit
退出请求事件数据
SDL_UserEvent user
自定义事件数据
SDL_SysWMEvent syswm
系统相关的窗口事件数据
SDL_TouchFingerEvent tfinger
手指触碰事件数据
SDL_MultiGestureEvent mgesture
多手指手势数据
SDL_DollarGestureEvent dgesture
UINT32
类型
事件类型所有活动共享
SDL_CommonEvent
常见
常见的事件数据
SDL_WindowEvent
窗口
窗口事件数据
SDL_KeyboardEvent
关键
键盘事件数据
SDL_TextEditingEvent
编辑
文本编辑事件数据
SDL_TextInputEvent
文本
文本输入事件数据
SDL_MouseMotionEvent
运动
鼠标移动事件数据
SDL_MouseButtonEvent
钮
鼠标按钮的事件数据
SDL_MouseWheelEvent
轮
鼠标滚轮事件数据
SDL_JoyAxisEvent
jaxis
操纵杆轴事件数据
SDL_JoyBallEvent
jball
操纵杆球事件数据
SDL_JoyHatEvent
与jHat
摇杆帽事件数据
SDL_JoyButtonEvent
JButton的
操纵杆按钮事件数据
SDL_JoyDeviceEvent
jdevice
操纵杆设备的事件数据
SDL_ControllerAxisEvent
CAXIS
游戏手柄轴事件数据
SDL_ControllerButtonEvent
CButton的
游戏控制器按钮事件数据
SDL_ControllerDeviceEvent
cdevice
游戏控制器设备的事件数据
SDL_QuitEvent
退出
退出请求事件数据
SDL_USEREVENT
用户
自定义事件数据
SDL_SysWMEvent
syswm
系统相关的窗口事件数据
SDL_TouchFingerEvent
tfinger
手指触碰事件数据
SDL_MultiGestureEvent
mgesture
多手指手势数据
SDL_DollarGestureEvent
dgesture
多手指手势数据
SDL_DropEvent
多手指手势数据
SDL_DropEvent drop
拖放事件数据结构名:SDL_JoyAxisEvent
简介:包含摇杆轴运动事件信息的结构。
成员:
Uint32 type 事件类型
Uint32 timestamp 时间戳
SDL_JoystickID which 摇杆事件索引
Uint8 axis
Uint8 padding1
Uint8 padding2
Uint8 padding3
Sint16 value 轴的当前位置,取值范围: -32768 to 32767
Uint16 padding4结构名 :SDL_JoyBallEvent
简介 包含操纵杆轨迹球移动事件信息的结构
Uint32 type 事件类型
Uint32 timestamp 时间戳
SDL_JoystickID which 事件操纵杆的索引
Uint8 ball 轨迹球
Uint8 padding1
Uint8 padding2
Uint8 padding3
Sint16 xrel 在X方向上的相对运动
Sint16 yrel
在Y方向上的相对运动结构名:SDL_JoyButtonEvent
简介 :包含操纵杆按钮事件信息的结构。
成员:
Uint32 type 事件类型
Uint32 timestamp 时间戳
SDL_JoystickID which 事件操纵杆的索引
Uint8 button 按钮的索引
Uint8 state 按钮的状态
Uint8 padding1
Uint8 padding2结构名:SDL_JoyHatEvent
简介 包含摇杆帽的位置变化事件信息的结构。
成员
Uint32 type 事件类型
Uint32 timestamp 时间戳
SDL_JoystickID which 事件操纵杆的索引
Uint8 hat 摇杆帽的索引
Uint8 value 摇杆帽的新位置
Uint8 padding1
Uint8 padding2SDL_KeyboardEventUint32 type 事件类型
Uint32 timestamp 时间戳
Uint32 windowID 有键盘焦点的窗口
Uint8 state 键的状态
Uint8 repeat 重复非0值
Uint8 padding2
Uint8 padding3
SDL_Keysym keysym 键值SDL_MouseMotionEvent
包含鼠标移动事件信息的结构。
UINT32 type 事件类型
UINT32 timestamp 事件的时间标记
UINT32 WINDOWID
鼠标焦点的窗口
UINT32 which SDL_TOUCH_MOUSEID
UINT32 state 按钮的状态
SINT32 x
X坐标相对于窗口
SINT32 y
Y坐标相对于窗口
SINT32 xrel
在X方向上的相对运动
SINT32 yrel
在Y方向上的相对运动SDL_MouseButtonEvent
包含鼠标按钮事件信息的结构。
UINT32 type 事件类型 SDL_MOUSEBUTTONDOWN或SDL_MOUSEBUTTONUP
UINT32 timestamp
事件的时间标记
UINT32 WINDOWID
鼠标焦点的窗口
UINT32 which
鼠标ID
UINT8 button 按钮
UINT8 state 按钮的状态 SDL_PRESSED或SDL_RELEASED
UINT8 padding1
UINT8 padding2
SINT32 x
X坐标相对于窗口
SINT32 y
Y坐标相对于窗口SDL_MouseWheelEvent
包含鼠标滚轮事件信息的结构。
UINT32 type SDL_MOUSEWHEEL
UINT32 timestamp 事件的时间标记
UINT32 WINDOWID 鼠标焦点的窗口
UINT32 which
鼠标ID SDL_TOUCH_MOUSEID;
SINT32 x 水平滚动
SINT32 y 垂直滚动SDL_MultiGestureEvent
包含多个手指的手势事件信息的结构
UINT32 type SDL_MULTIGESTURE
UINT32 timestamp
事件的时间标记
SDL_TouchID touchId 触摸设备索引
float dTheta 描述
float dDist 描述
float x 描述
float y 描述
UINT16 numFingers 描述
UINT16 paddingSDL_QuitEvent
包含了“退出请求”事件的结构。
Uint32 type 值为SDL_QUIT
Uint32 timestamp 时间戳
SDL_SysWMEvent
它包含一个视频驱动程序相关的系统事件的结构。
UINT32 type SDL_SYSWMEVENT
UINT32 timestamp 事件的时间标记
SDL_SysWMmsg * msg
驱动程序相关的数据SDL_TextEditingEvent
包含键盘的文本编辑事件信息的结构。
Uint32 type 值为SDL_TEXTEDITING
Uint32 timestamp 时间戳
Uint32 windowID
具有键盘焦点的窗口
char text 字符串
Sint32 start 开始位置
Sint32 length 长度SDL_TextInputEvent
包含键盘文本输入事件信息的结构。
Uint32 type SDL_TEXTINPUT
Uint32 timestamp 时间戳
Uint32 windowID
有键盘输入焦点的窗口
char text 输入的字符串utf-8编码SDL_TouchFingerEvent
包含手指触摸事件信息的结构。Uint32 type
SDL_FINGERMOTION, SDL_FINGERDOWN, 或 SDL_FINGERUP
Uint32 timestamp 时间戳
SDL_TouchID 触摸索引
SDL_FingerID 手指索引
float x 触摸事件x轴的坐标
float y 触摸事件y轴的坐标
float dx 移动于x轴的距离
float dy 移动于y轴的距离
float pressure 施加的压力值SDL_USEREVENT
它包含一个应用程序定义的事件类型的结构。
UINT32 type
从SDL_RegisterEvents得到的值
UINT32 timestamp
事件的时间标记
UINT32 WINDOWID
相关的窗口
SINT32 code
用户定义的事件代码
void* data1
用户定义的数据指针1
void* data2
用户定义的数据指针2
代码示例
Uint32 myEventType SDL_RegisterEvents(1);
if (myEventType ! ((Uint32)-1)) {
SDL_Event event;
SDL_zero(event);
event.type myEventType;
event.user.code my_event_code;
event.user.data1 significant_data;
event.user.data2 0;
SDL_PushEvent(amp;event);
}SDL_WindowEvent
UINT32 type
取值SDL_WINDOWEVENT
UINT32 timestamp 事件的时间标记
UINT32 WINDOWID
相关的窗口
UINT8 event
SDL_WindowEventID
UINT8 padding1
UINT8 padding2
UINT8 padding3
SINT32 data1
事件相关的数据
SINT32 data2
事件相关的数据
代码示例
void PrintEvent(const SDL_Event * event)
{
if (event-gt;type SDL_WINDOWEVENT) {
switch (event-gt;window.event) {
case SDL_WINDOWEVENT_SHOWN:
SDL_Log(Window %d shown, event-gt;window.windowID);
break;
case SDL_WINDOWEVENT_HIDDEN:
SDL_Log(Window %d hidden, event-gt;window.windowID);
break;
case SDL_WINDOWEVENT_EXPOSED:
SDL_Log(Window %d exposed, event-gt;window.windowID);
break;
case SDL_WINDOWEVENT_MOVED:
SDL_Log(Window %d moved to %d,%d,
event-gt;window.windowID, event-gt;window.data1,
event-gt;window.data2);
break;
case SDL_WINDOWEVENT_RESIZED:
SDL_Log(Window %d resized to %dx%d,
event-gt;window.windowID, event-gt;window.data1,
event-gt;window.data2);
break;
case SDL_WINDOWEVENT_MINIMIZED:
SDL_Log(Window %d minimized, event-gt;window.windowID);
break;
case SDL_WINDOWEVENT_MAXIMIZED:
SDL_Log(Window %d maximized, event-gt;window.windowID);
break;
case SDL_WINDOWEVENT_RESTORED:
SDL_Log(Window %d restored, event-gt;window.windowID);
break;
case SDL_WINDOWEVENT_ENTER:
SDL_Log(Mouse entered window %d,
event-gt;window.windowID);
break;
case SDL_WINDOWEVENT_LEAVE:
SDL_Log(Mouse left window %d, event-gt;window.windowID);
break;
case SDL_WINDOWEVENT_FOCUS_GAINED:
SDL_Log(Window %d gained keyboard focus,
event-gt;window.windowID);
break;
case SDL_WINDOWEVENT_FOCUS_LOST:
SDL_Log(Window %d lost keyboard focus,
event-gt;window.windowID);
break;
case SDL_WINDOWEVENT_CLOSE:
SDL_Log(Window %d closed, event-gt;window.windowID);
break;
default:
SDL_Log(Window %d got unknown event %d,
event-gt;window.windowID, event-gt;window.event);
break;
}
}
}函数功能:使用此函数来添加一个回调当一个事件被添加到事件队列中被触发
参数:
filter 当一个事件发生时要调用的函数
userdata 用户数据
返回值:
备注:
原型:
void SDL_AddEventWatch(SDL_EventFilter filter,
void* userdata)功能:使用这个函数来删除事件回
参数:
filter 当一个事件发生时要调用的函数
userdata 用户数据
返回值:
备注:
原型:
void SDL_DelEventWatch(SDL_EventFilter filter,
void* userdata)功能:利用此函数的类型来设置处理事件的状态
参数:
type 事件的类型见SDL_EventType
state 如何处理该事件见备注详细信息
返回值:
返回SDL_DISABLE或SDL_ENABLE
备注:
state可以是下列任何一项
-1
SDL_QUERY
返回指定事件的当前处理状态0
SDL_IGNORE又名SDL_DISABLE
该事件将被自动从事件队列丢弃不会被过滤1
SDL_ENABLE
该事件将被正常处理
原型:
Uint8 SDL_EventState(Uint32 type,
int state)功能:
使用此函数可对当前事件队列中运行特定的过滤功能
参数:
filter 当一个事件发生时要调用的函数
userdata 用户数据
返回值:
备注:
原型:
void SDL_FilterEvents(SDL_EventFilter filter, void* userdata)功能:
使用此函数可从事件队列中清除事件
参数:
type 要清除事件的类型见SDL_EventType的详细信息
返回值:
备注:
原型:
void SDL_FlushEvent(Uint32 type)功能:
使用此函数可从事件队列中清除多个事件。
参数:
minType 清除的最小事件类型见SDL_EventType的详细信息
maxType 清除的最大事件类型见SDL_EventType的详细信息
返回值:
备注:
原型:
void SDL_FlushEvents(Uint32 minType,
Uint32 maxType)功能:
使用此函数来查询当前的事件过滤器。
参数:
filter 当前的回调函数将存储在这里
userdata 传递给当前的事件过滤器的指针将被保存在这里
返回值:
成功 SDL_TRUE
失败 SDL_FALSE
备注:
原型:
SDL_bool SDL_GetEventFilter(SDL_EventFilter* filter,
void** userdata)功能:
使用此函数来检查事件队列中的某些事件类型的存在。
参数:
要查询的事件类型
返回值:
成功 SDL_TRUE
失败 SDL_FALSE
备注:
原型:
SDL_bool SDL_HasEvent(Uint32 type)功能:
使用此函数来检查一系列事件队列中的事件类型的存在。
参数:
minType
要查询的最低类型事件;见SDL_EventType的详细信息
maxType
要查询的最高类型事件;见SDL_EventType的详细信息
返回值:
成功 SDL_TRUE
失败 SDL_FALSE
备注:
原型:
SDL_bool SDL_HasEvents(Uint32 minType,
Uint32 maxType)功能:
使用此功能来检查事件队列中的消息并返回它们。
参数:
events 事件
numevents 事件数量
action 要采取的行动见备注
minType 事件类型的最小值
maxType 事件类型的最大值
返回值:
成功返回实际存储的事件数量
失败返回一个为负的错误代码
备注:
action可以是以下任一操作从枚举SDL_eventaction也可以看到
SDL_ADDEVENT
numevents事件将被添加到事件队列的后面
SDL_PEEKEVENT
到在事件队列的前面numevents事件时指定的最小和最大事件类型范围内将被返回不会被从队列中删除
SDL_GETEVENT
到在事件队列的前面numevents事件时指定的最小和最大事件类型范围内将被返回将被从队列中删除如果action是SDL_ADDEVENT最多numevents事件将被添加到事件队列的后面。如果action是SDL_PEEKEVENT最多在事件队列的前面numevents事件时指定的最小和最大事件类型范围内将被返回不会被从队列中删除。如果action是SDL_GETEVENT最多在事件队列的前面numevents事件时指定的最小和最大事件类型范围内将被返回将被从队列中删除
在2.0以下版本中您可能必须在调用此函数之前调用SDL_PumpEvents。否则当你调用SDL_PeepEvents的事件可能还没有准备好进行过滤。
原型:
int SDL_PeepEvents(SDL_Event* events,
int numevents,
SDL_eventaction action,
Uint32 minType,
Uint32 maxType)功能:使用此函数来轮询当前挂起的事件。
参数:
event 事件,SDL_Event结构
返回值:
有一个可用事件返回1
没有则返回 0
备注:
原型:
int SDL_PollEvent(SDL_Event* event)功能:使用此函数可从事件循环收集从输入设备的事件。
参数:
返回值:
备注:
原型:
void SDL_PumpEvents(void)功能:使用此函数可将事件添加到事件队列。
参数:
event 被添加到队列中的事件参见SDL_Event
返回值:
成功则返回0如果返回1的情况下则过滤掉或者在失败时返回一个负的错误代码请SDL_GetError获取更多信息。一个常见的错误原因是事件队列已满。
备注:
原型:
int SDL_PushEvent(SDL_Event* event)功能:查询SDL_Quit是否在队列中
参数:
返回值:
在 SDL_TRUE
不在 SDL_FALSE
备注:
原型:
SDL_bool SDL_QuitRequested(void)功能:
使用此函数来分配一组用户定义的事件
参数:
numevents 要分配的事件数
返回值:
成功 开始事件编号
失败 -1
备注:
原型:
Uint32 SDL_RegisterEvents(int numevents)
例子:
Uint32 myEventType SDL_RegisterEvents(1);
if (myEventType ! ((Uint32)-1)) {
SDL_Event event;
SDL_zero(event);
event.type myEventType;
event.user.code my_event_code;
event.user.data1 significant_data;
event.user.data2 0;
SDL_PushEvent(amp;event);
}功能:使用此函数可设置过滤器来处理所有的事件
参数:
filter 当一个事件发生时要调用的函数
userdata 用户数据传递给该函数的指针
返回值:
备注:
原型:
void SDL_SetEventFilter(SDL_EventFilter filter,
void* userdata)功能:使用此函数无限期地等待下一个可用的事件
参数:
event 事件
返回值:
返回 1 成功
返回 0 失败
备注:
原型:
int SDL_WaitEvent(SDL_Event* event)功能:使用此函数要等到指定的超时以毫秒为单位为下一个可用的事件。
参数:
event 事件
timeout 超时的最大毫秒数以等待下一个可用的事件
返回值:
返回 1 成功
返回 0 失败
备注:
原型:
int SDL_WaitEventTimeout(SDL_Event* event,
int timeout)SDL_Keymod枚举
KMOD_NONE 0无修饰符适用
KMOD_LSHIFT 左Shift键是按下
KMOD_RSHIFT 右Shift键是按下
KMOD_LCTRL 左Ctrl控制键被按下
KMOD_RCTRL
右边的Ctrl控制键被按下
KMOD_LALT 左边的Alt键是向下
KMOD_RALT 右边的Alt键被按下
KMOD_LGUI 左边的图形用户界面键通常是Windows键关闭
KMOD_RGUI
正确的图形用户界面键通常是Windows键关闭
KMOD_NUM Num Lock键可能位于一个扩展键盘上
KMOD_CAPS 大写锁定键被按下
KMOD_MODE AltGr键是按下/*****
KMOD_CTRL
KMOD_LCTRL | KMOD_RCTRL
KMOD_SHIFT
KMOD_LSHIFT | KMOD_RSHIFT
KMOD_ALT
KMOD_LALT | KMOD_RALT
KMOD_GUI
KMOD_LGUI | KMOD_RGUI
KMOD_RESERVED
保留为将来使用*****/SDL_Keysym
包含关键事件的结构。
SDL_Scancode scancode SDL的物理键码
SDL_Keycode sym
SDL的虚拟键码
Uint16 mod 按键模式
Uint32 unused 未使用功能:从一个可读的键名获取其键
参数:
name 可读的键名
返回值:
成功 返回键码
失败 SDLK_UNKNOWN
备注:
原型:
SDL_Keycode SDL_GetKeyFromName(const char* name)功能:从一个物理键码获得其虚拟键码
参数:
scancode 物理键码
返回值:
成功 返回键码
失败 SDLK_UNKNOWN
备注:
原型:
SDL_Keycode SDL_GetKeyFromScancode(SDL_Scancode scancode)功能:获取键名
参数:
key 虚拟键码
返回值:
成功 返回一个包含其键名的字符串
失败 NULL
备注:
原型:
const char* SDL_GetKeyName(SDL_Keycode key)功能:获取键盘当前状态
参数:
numkeys 接收到返回的数组的长度
返回值:
返回一个指针指向一个数组
值1表示被按下0则不是
备注:
原型:
const Uint8* SDL_GetKeyboardState(int* numkeys)
例子
const Uint8 *state SDL_GetKeyboardState(NULL);
if ( state[SDL_SCANCODE_RETURN] ) {
printf(lt;RETURNgt; is pressed.);
}功能:获取当前功能键状态
参数:
返回值:
返回功能键状态
备注:
原型:
SDL_Keymod SDL_GetModState(void)功能:获取其虚拟键码对应的物理键码
参数:
key 虚拟键码
返回值:
物理键码
备注:
原型:
SDL_Scancode SDL_GetScancodeFromKey(SDL_Keycode key)功能:从一个可读的键名获取其物理键码
参数:
name 可读名称字符串
返回值:
物理键码
备注:
原型:
SDL_Scancode SDL_GetScancodeFromName(const char* name)功能:从一个物理键码获取可读的键名
参数:
scancode 物理键码
返回值:
一个可读键名字符串
备注:
原型:
const char* SDL_GetScancodeName(SDL_Scancode scancode)功能:设置当前的功能键状态
参数:modstate 功能键状态参见SDL_Keymod
返回值:
备注:
原型:
void SDL_SetModState(SDL_Keymod modstate)功能:设置文本输入区域
参数:
rect 输入区域
返回值:
备注:
原型:
void SDL_SetTextInputRect(SDL_Rect* rect)功能:开始输入文本
参数:
返回值:
备注:
原型:
void SDL_StartTextInput(void)功能:结束输入文本
参数:
返回值:
备注:
原型:
void SDL_StopTextInput(void)功能:创建一个颜色的光标
参数:
surface 光标图像
hot_x,hot_y 光标热点值
返回值:
成功返回 光标
失败返回 NULL
原型;
SDL_Cursor* SDL_CreateColorCursor(SDL_Surface* surface,
int hot_x,
int hot_y)功能:使用此函数来创建使用指定的位图数据和掩码的光标以MSB格式
参数:
data
对于光标的每个像素的颜色值
mask
对于光标的每个像素的掩码值;
w
光标的宽度
?
光标的高度
hot_x
光标的左上角相对于实际的鼠标位置的X轴位置
hot_y
光标的左上角相对于实际的鼠标位置的Y轴位置
返回值:
成功返回一个新的
光标
失败 NULL
原型;
SDL_Cursor* SDL_CreateCursor(const Uint8* data,
const Uint8* mask,
int w,
int h,
int hot_x,
int hot_y)例子:
/* Stolen from the mailing list */
/* Creates a new mouse cursor from an XPM *//* XPM */
static const char *arrow[] {
/* width height num_colors chars_per_pixel */32 32 3 1,
/* colors */
X c #000000,
. c #ffffff,c None,
/* pixels */
X ,
XX ,
X.X ,
X..X ,
X...X ,
X....X ,
X.....X ,
X......X ,
X.......X ,
X........X ,
X.....XXXXX ,
X..X..X ,
X.X X..X ,
XX X..X ,
X X..X ,X..X ,X..X ,X..X ,XX
,,,,,,,,,,,,,,
0,0
};
static SDL_Cursor *init_system_cursor(const char *image[])
{
int i, row, col;
Uint8 data[4*32];
Uint8 mask[4*32];
int hot_x, hot_y;
i -1;
for ( row0; rowlt;32; row ) {
for ( col0; collt;32; col ) {
if ( col % 8 ) {
data[i] lt;lt; 1;
mask[i] lt;lt; 1;
} else {
i;
data[i] mask[i] 0;
}
switch (image[4row][col]) {
case X:
data[i] | 0x01;
mask[i] | 0x01;
break;
case .:
mask[i] | 0x01;
break;
case :
break;
}
}
}
sscanf(image[4row], %d,%d, amp;hot_x, amp;hot_y);
return SDL_CreateCursor(data, mask, 32, 32, hot_x, hot_y);
}功能:释放一个鼠标指针
参数:
cursor 鼠标指针
返回值:
原型;
void SDL_FreeCursor(SDL_Cursor* cursor)功能:获取当前活动的鼠标指针
参数:
返回值:
成功 鼠标指针
失败 NULL
原型;
SDL_Cursor* SDL_GetCursor(void)功能:获得当前有鼠标焦点的窗口。
参数:
返回值:
成功 窗口指针
失败 NULL
原型;
SDL_Window* SDL_GetMouseFocus(void)功能:获取鼠标状态
参数:
x,y 鼠标坐标指针
返回值:
返回当前按键状态的32位键位掩码
原型;
Uint32 SDL_GetMouseState(int* x,
int* y)
例子:
SDL_PumpEvents();
if(SDL_GetMouseState(NULL, NULL)amp;SDL_BUTTON(1))
printf(Mouse Button 1(left) is pressed.);功能:使用此功能来查询相对鼠标模式是否开启
参数:
返回值:
成功 SDL_TURE
失败 SDL_FALSE
原型;
SDL_bool SDL_GetRelativeMouseMode(void)功能:使用此功能来检索鼠标的相对状态。
参数:x,y 鼠标坐标指针
返回值:
返回当前按键状态的32位键位掩码
原型;
Uint32 SDL_GetRelativeMouseState(int* x,
int* y)功能:设置当前活动的鼠标
参数:cursor 鼠标指针
返回值:
原型;
void SDL_SetCursor(SDL_Cursor* cursor)功能:使用此功能来打开或关闭相对鼠标模式
参数:
enabled
SDL_TURE 开启 SDL_FALSE 关闭
返回值:
成功返回 0
失败返回一个为负的错误代码
原型;
int SDL_SetRelativeMouseMode(SDL_bool enabled)功能:设置光标是否显示
参数:
1显示光标0隐藏它-1查询当前状态
返回值:
1 光标显示
0 光标隐藏
原型;
int SDL_ShowCursor(int toggle)功能:使用此功能可将鼠标移动到窗口内的指定位置
参数:
w 窗口指针
x,y 坐标
返回值:
原型;
void SDL_WarpMouseInWindow(SDL_Window* window,
int x,
int y)
