主页 / 库函数目录 / 图像处理 / getimage

功能:

这个函数的四个重载分别用于从窗口 / 文件 / 资源 / IMAGE 对象中获取图像

说明:

如果目标对象包含多帧图像,那么仅获取第一帧图像。

声明:
// 从窗口获取图像
int getimage(
    PIMAGE imgDest,       // 保存图像的 IMAGE 对象指针
    int xSrc,             // 要获取图像的区域左上角 x 坐标
    int ySrc,             // 要获取图像的区域左上角 y 坐标
    int widthSrc,         // 要获取图像的区域宽度
    int heightSrc         // 要获取图像的区域高度
);

// 从另一个 IMAGE 对象中获取图像
int getimage(
    PIMAGE imgDest,       // 保存图像的 IMAGE 对象指针
    PCIMAGE imgSrc,       // 源图像 IMAGE 对象
    int xSrc,             // 要获取图像的区域左上角 x 坐标
    int ySrc,             // 要获取图像的区域左上角 y 坐标
    int widthSrc,         // 要获取图像的区域宽度
    int heightSrc         // 要获取图像的区域高度
);

// 从图片文件获取图像(png/bmp/jpg/gif/emf/wmf/ico)
int getimage(
    PIMAGE imgDest,       // 保存图像的 IMAGE 对象指针
    LPCTSTR pImgFile,     // 图片文件名
    int zoomWidth = 0,    // 设定图像缩放至的宽度(0 表示默认宽度,不缩放)
    int zoomHeight = 0    // 设定图像缩放至的高度(0 表示默认高度,不缩放)
);

// 从资源文件获取图像(png/bmp/jpg/gif/emf/wmf/ico)
int getimage(
    PIMAGE imgDest,       // 保存图像的 IMAGE 对象指针
    LPCTSTR pResType,     // 资源类型
    LPCTSTR pResName,     // 资源名称
    int zoomWidth = 0,    // 设定图像缩放至的宽度(0 表示默认宽度,不缩放)
    int zoomHeight = 0    // 设定图像缩放至的高度(0 表示默认高度,不缩放)
);
参数: pimg (详见各重载函数原型内的注释) 返回值:
返回值含义
grOk (值为 0) 读取成功
grAllocError 读取时内存分配失败
grFileNotFound 文件不存在
grNullPointer 指针转换失败
grIOerror 读取失败
示例: 请参考 putimage 函数示例。