三.图象对象模块

头文件：img.h

库文件：img.lib，img.dll

图象处理模块负责创建RVB支持数字图象对象的创建，销毁和RVB自定义的格式转换等。

3.1常量

名称	说明
RV_CVT_BIN2RGB	二值图转化为 RGB 图像
RV_CVT_BIN2GRAY	二值图转化为灰度图
RV_CVT_RGB2GRAY	RGB 图转化为灰度图
RV_CVT_GRAY2RGB	灰度图转化为 RGB 图
RV_CVT_GRAY2BIN	灰度图转化为二值图
RV_CVT_RGB2BIN	RGB 图转化为二值图

名称	说明
RIT_BIN	二值图象
RIT_GRAY	灰度图象
RIT_RGB	RGB 图象
RIT_RGBA	RGBA 图象

3.2函数

rviClone

声明：RvImage rviClone(const RvImage src, RvImage dest )；

描述：复制图象对象。

参数：1、RvImage src- 源对象

2、RvImage dest – 目标对象

返回：目标图象对象

rviConvert

声明：void rviConvert(RvImage src, int code , RvImage dest )；

描述：将源图象转化为指定格式对象。

参数：1、RvImage src- 源对象

2、int code - 转化方式

3、RvImage dest – 目标对象

返回：目标图象对象

rviCast

声明：BOOL rviCast(RvImage image, RV_IMAGE_TYPE type)；

描述：将源图象转化为指定格式对象。

参数：1、RvImage src- 源对象

2、RV_IMAGE_TYPE type – 目标图象格式

返回：TRUE 或FALSE。表示转换成功或失败。

rviGetRedChannel

声明：RvImage rviGetRedChannel (const RvImage src, RvImage dest )；

描述：获取RGB图象中的RED通道分量。如果输入的目标图象为NULL，则创建一个新的灰度图象。

参数：1、RvImage src- 源对象

2、RvImage dest –目标对象

返回：目标图象。

rviGetGreenChannel

声明：RvImage rviGetGreenChannel(const RvImage src, RvImage dest)；

描述：获取RGB图象中的GREEN通道分量。如果输入的目标图象为NULL，则创建一个新的灰度图象。

参数：1、RvImage src- 源对象

2、RvImage dest –目标对象

返回：目标图象

rviGetBlueChannel

声明：RvImage rviGetBlueChannel(const RvImage src, RvImage dest)；

描述：获取RGB图象中的BLUE通道分量。如果输入的目标图象为NULL，则创建一个新的灰度图象。

参数：1、RvImage src- 源对象

2、RvImage dest –目标对象

返回：目标图象

rviMergeRGB

声明：RvImage rviMergeRGB(const RvImage red, const RvImage green, const RvImage blue, RvImage dest )；

描述：将三个灰度图象作为红，绿，蓝三个通道合并成一个RGB图象。

参数：1、const RvImage red – 红色通道

2、const RvImage green – 绿色通道

3、const RvImage blue – 兰色通道

4、RvImage dest – 目标图象

返回：目标图象

rvCreateImage

声明：RvImage rvCreateImage(RV_IMAGE_TYPE type, int width, int height)；

RvImage rvCreateImageEx(RV_IMAGE_TYPE type, int width, int height, void* pDatsSource, UINT size, int pitch);

描述：创建一个数字图象对象。

参数：1、RV_IMAGE_TYPE type-数字图象类型

2、int width- 宽度

3、int height- 高度

4、void* pDatsSource- 数据源缓冲区

5、UINT size- 数据源头大小

6、int pitch – 对齐后的行字节数

返回：图象对象

rvDestroyImage

声明：void rvDestroyImage(RvImage image)；

描述：销毁数字图象。

参数：RvImage image– 数字图象对象

返回：无

rviFlood

声明：void rviFlood(RvImage image, RvByte level) ；

描述：将某个灰度值填充图象。

参数：1、RvImage image– 数字图象对象

2、RvByte level – 灰度值

返回：无

rviFloodEx

声明：void rviFloodEx(RvImage image, const void* pImageData, UINT size )；

描述：将某个数据区的像素值填充给数字图象。

参数：1、RvImage image- 数字图象

2、const void* pImageData,- 图象数据首地址

3、UINT size – 图象数据大小（字节为单位）

返回：无

rviSetSize

声明：BOOL rviSetSize(RvImage image, int width, int height)；

描述：设置图象大小。（相当重新设置图象大小）

参数：1、RvImage image – 图象对象

2、int width- 宽度

3、int height- 高度

返回：TRUE 或FALSE ，表示成功或失败。

rviClear

声明：void rviClear(RvImage image)；

描述：清除对象数据，将像素值设置为0。

参数：RvImage image – 图象对象。

返回：无

rviGetData

声明：void* rviGetData(RvImage image)；

描述：将三个灰度图象作为红，绿，蓝三个通道合并成一个RGB图象。

参数：RvImage image – 图象对象。

返回：返回数字图象数据内存区首地址。

rviGetWidth

声明：int rviGetWidth(const RvImage image)；

描述：获取数字图象的宽度。

参数：const RvImage image- 图象对象

返回：宽度

rviGetHeight

声明：int rviGetHeight(const RvImage image)；

描述：获取数字图形的高度。

参数：const RvImage image- 图象对象

返回：高度

rviGetSize

声明：UINT rviGetSize(const RvImage image)；

描述：返回图象数据区大小，以字节为单位

参数：const RvImage image- 图象对象

返回：图象数据区大小

rviGetPitch

声明：int rviGetPitch(const RvImage image)；

描述：获取数字图象对齐后的行字节数。

参数：const RvImage image- 图象对象

返回：对齐后的行字节数。

rviGetType

声明：RV_IMAGE_TYPE rviGetType(const RvImage image)；

描述：获取图象对象的类型。

参数：const RvImage image-图象对象

返回：图象类型