ZEngine 开发文档

easycker
2010-11-11 17:27:48

[i=s] 本帖最后由 easycker 于 2010-11-11 18:07 编辑 [/i]

[size=2]ZImage

加载图片
bool Load(const char *filename, bool bSetColorKey = false,int colorkey = MAKE_RGBA_8888(255,255,255,255),int displaymode = DISPLAY_PIXEL_FORMAT_8888,int swizzle = 1);
参数:
Filename 被加载文件名,如“image/demo.jpg”
bSetColorKey 是否使用关键色，将关键色设为透明
colorkey 被设为透明色的关键色，如ZImage::RGBA(255,255,255,255)白色;
displaymode 显示模式，无需更改
swizzle 无需更改
返回值:
是否加载成功

复制图像
void Copy(ZImage *zImage);
参数: zImage 被复制的ZImage的对象指针
返回值:

水平翻转
void FlipH();
参数:
返回值:

垂直翻转
void FlipV();
参数:
返回值:

显示图片1
void Show(float dx = 0.0, float dy = 0.0);
参数: dx dy 图片的左上角开始显示在屏幕 dx,dy横纵坐标
返回值:

显示图片2
void Show(float dx,float dy,int mask);
参数:
dx dy 图片的左上角开始显示在屏幕 dx,dy横纵坐标
mask 颜色遮罩,如半透明效果ZImage::RGBA(255,255,255,128);
返回值:

显示图片3
void Show(
float sx, float sy, float sw, float sh,
float dx, float dy, float dw, float dh
);
参数:
sx, sy, sw, sh 从源图像截取的大小sx/sy从哪里截取,sw/wh截取宽高
dx, dy, dw, dh 显示到屏幕dx/dy处，显示的伸缩宽高dw/dh
返回值:

显示图片4
void Show(
float sx, float sy, float sw, float sh,
float dx, float dy, float dw, float dh,
int mask
);
参数:
sx, sy, sw, sh 从源图像截取的大小sx/sy从哪里截取,sw/wh截取宽高
dx, dy, dw, dh 显示到屏幕dx/dy处，显示的伸缩宽高dw/dh
mask 颜色遮罩,如半透明效果ZImage::RGBA(255,255,255,128);
返回值:

显示图片5
void Show(
float sx, float sy, float sw, float sh, float dx,
float dy, float xscale, float yscale, float angle,
int mask
);
参数:
sx, sy, sw, sh 从源图像截取的大小sx/sy从哪里截取,sw/wh截取宽高
dx, dy, 显示到屏幕dx/dy处
xscale,yscale 显示到屏幕后x宽y高的放大倍数1为原始大小，2为原始大小*2
mask 颜色遮罩,如半透明效果ZImage::RGBA(255,255,255,128);
返回值:

创建一个空白图像
void Create(int w = 480, int h = 272, bool bUseColor = false,
int color = RGBA(255,255,255,255),
int displaymode = DISPLAY_PIXEL_FORMAT_8888); //
参数:
w,h 被创建空白图像的宽高
bUseColor 是否使用颜色
color 空白图像的颜色,如ZImage::RGBA(255,0,0,0)
displaymode 显示模式，无需更改
返回值:

销毁当前对象
void Destory();
参数:该函数不常用,通常写于析构函数
返回值:

是否显示图片
void IfShow(bool bShow);
参数: bShow 是否显示,true为显示,false为隐藏
返回值:

显示使用用户自定义的数据变化的图片
void mShow();
参数: 不推荐使用
返回值:

获取这个图像的image_p结构
image_p GetImageP();
参数:
返回值:得到存储图像信息的结构体指针image_p

设置屏幕的颜色
static void SetScreenColors(uint8 r, uint8 g, uint8 b, uint8 a);
参数: r,g,b,a 红色通道，绿色通道，蓝色通道，透明通道。范围0~255
返回值: 可直接调用不用建立对象 Zimage::SetScreenColors(…);

屏幕截图
static void PrintScreen(const char *filename);
参数: filename 文件输出的文件名，可加路径
返回值: 可直接调用不用建立对象 Zimage::PrintScreen(…);

获取颜色
static int RGBA(int r,int g,int b,int a);
参数: r,g,b,a 红色通道，绿色通道，蓝色通道，透明通道。范围0~255
返回值: 可直接调用不用建立对象 Zimage::RGBA(…);[/size]

ZEngine 开发文档 - 01 ZImage