SDL2函数简单介绍07

1.const char* SDL_GetPixelFormatName(Uint32 format)
功能：获取像素格式的可读名称
参数：format：要查询的像素格式
返回值：成功返回指定像素格式的刻度名字，不能识别返回SDL_PIXELFORMAT_UNKNOWN
2.void SDL_GetRGB(Uint32 pixel, const SDL_PixelFormat* format, Uint8* r, Uint8* g, Uint8* b)
功能：从一个指定格式的像素获取RGB值
参数：
pixel:像素值
format:一个SDL_PixelFormat结构体描述的像素格式
r:用红色成分填充的指针
g:用绿色成分填充的指针
b:用蓝色成分填充的指针
返回值：无
3.void SDL_GetRGBA(Uint32 pixel, const SDL_PixelFormat* format, Uint8* r, Uint8* g, Uint8* b, Uint8* a)
功能：从一个指定格式的像素获取RGB值
参数：
a:用alpha成分填充的指针
返回值：无
4.Uint32 SDL_MapRGB(const SDL_PixelFormat* format, Uint8 r, Uint8 g, Uint8 b)
功能：将RGB三元组映射到给定像素格式的不透明像素值
参数：
format:SDL_PixelFormat描述的像素格式
r:像素的红色分量，范围为0-255
g:像素的绿色分量，范围为0-255
b:像素的蓝色分量，范围为0-255
返回值：返回像素值
5.Uint32 SDL_MapRGBA(const SDL_PixelFormat* format,Uint8 r, Uint8 g, Uint8 b, Uint8a)
功能：将RGBA四元组映射到给定像素格式的像素值
参数：
a:像素的alpha分量，范围为0-255
返回值：返回像素值
6.Uint32 SDL_MasksToPixelFormatEnum(int bpp,Uint32 Rmask, Uint32 Gmask, Uint32 Bmask,Uint32 Amask)
功能：将bpp值和RGBA掩码转换为枚举的像素格式。
参数：
bpp:每个像素位值；通常是15、16或32
Rmask:格式的红色掩码
Gmask:格式的绿色掩码
Bmask:格式的蓝色掩码
Amask:格式的alpha掩码
返回值：返回一个SDL_PixelFormatEnum枚举值
7.SDL_bool SDL_PixelFormatEnumToMasks(Uint32 format,int* bpp, Uint32* Rmask,Uint32* Gmask, Uint32* Bmask, Uint32* Amask)
功能：将枚举的像素格式转换为bpp值和RGBA掩码
参数：
format：SDL_PixelFormatEnum
返回值：成功返回SDL_TRUE,失败返回SDL_FALSE
8.int SDL_SetPaletteColors(SDL_Palette* palette, const SDL_Color* colors, int firstcolor,int ncolors)
功能：设置调色板中的颜色范围
参数：
palette:要修改的 SDL_Palette结构体
colors:用来拷贝到调色板的SDL_Color数组
firstcolor:要修改的第一个调色板项的索引
ncolors:要修改的总数目
返回值：成功0，失败负数
9.SDL_Surface* SDL_CreateRGBSurface(Uint32 flags,int width, int height, int depth, Uint32 Rmask,Uint32 Gmask, Uint32 Bmask,Uint32 Amask)
功能：分配一个新的RGB纹理
参数：
flags:置0（未使用）
width:纹理的宽度
height:纹理的高度
depth:纹理的深度以位为单位
Rmask:像素的红色掩码
Gmask:像素的绿色掩码
Bmask:像素的蓝色掩码
Amask:像素的alpha掩码
返回值：成功返回新创建的SDL_Surface结构体，失败NULL
10.SDL_Surface* SDL_CreateRGBSurfaceFrom(void* pixels, int width, int height, int depth,int pitch,Uint32 Rmask, Uint32 Gmask,Uint32 Bmask, Uint32 Amask)
功能：为一个已存在的像素数据分配一个新的RGB纹理
参数：
pixels：已存在的像素数据指针
width：纹理的宽度
height：纹理的高度
depth：纹理的深度以位为单位
pitch：以字节为单位的一个原始像素长度
返回值：成功返回新创建的纹理结构体，失败NULL