    主页-＞库函数目录-＞图像处理相关函数-＞putimage

    功能：
    这个函数的几个重载用于在屏幕或另一个图像上绘制指定图像。

    声明：
    // 绘制图像到屏幕
    void putimage(
        int dstX,              // 绘制位置的 x 坐标
        int dstY,              // 绘制位置的 y 坐标
        PIMAGE pSrcImg,        // 要绘制的 IMAGE 对象指针
        DWORD dwRop = SRCCOPY  // 三元光栅操作码（详见备注）
    );
    // 绘制图像到屏幕(指定宽高)
    void putimage(
        int dstX,              // 绘制位置的 x 坐标
        int dstY,              // 绘制位置的 y 坐标
        int dstWidth,          // 绘制的宽度
        int dstHeight,         // 绘制的高度
        PIMAGE pSrcImg,        // 要绘制的 IMAGE 对象指针
        int srcX,              // 绘制内容在 IMAGE 对象中的左上角 x 坐标
        int srcY,              // 绘制内容在 IMAGE 对象中的左上角 y 坐标
        DWORD dwRop = SRCCOPY  // 三元光栅操作码（详见备注）
    );
    // 绘制图像到屏幕(拉伸)
    void putimage(
        int dstX,              // 绘制位置的 x 坐标
        int dstY,              // 绘制位置的 y 坐标
        int dstWidth,          // 绘制的宽度
        int dstHeight,         // 绘制的高度
        PIMAGE pSrcImg,        // 要绘制的 IMAGE 对象指针
        int srcX,              // 绘制内容在 IMAGE 对象中的左上角 x 坐标
        int srcY,              // 绘制内容在 IMAGE 对象中的左上角 y 坐标
        int srcWidth,          // 绘制内容在源 IMAGE 对象中的宽度
        int srcHeight,         // 绘制内容在源 IMAGE 对象中的高度
        DWORD dwRop = SRCCOPY  // 三元光栅操作码（详见备注）
    );
    // 绘制图像到另一图像
    void putimage(
        PIMAGE pDstImg,        // 目标 IMAGE 对象指针
        int dstX,              // 绘制位置的 x 坐标
        int dstY,              // 绘制位置的 y 坐标
        PIMAGE pSrcImg,        // 源 IMAGE 对象指针
        DWORD dwRop = SRCCOPY  // 三元光栅操作码（详见备注）
    );
    // 绘制图像到另一图像(指定宽高)
    void putimage(
        PIMAGE pDstImg,        // 目标 IMAGE 对象指针
        int dstX,              // 绘制位置的 x 坐标
        int dstY,              // 绘制位置的 y 坐标
        int dstWidth,          // 绘制的宽度
        int dstHeight,         // 绘制的高度
        PIMAGE pSrcImg,        // 源 IMAGE 对象指针
        int srcX,              // 绘制内容在源 IMAGE 对象中的左上角 x 坐标
        int srcY,              // 绘制内容在源 IMAGE 对象中的左上角 y 坐标
        DWORD dwRop = SRCCOPY  // 三元光栅操作码（详见备注）
    );
    // 绘制图像到另一图像(拉伸)
    void putimage(
        PIMAGE pDstImg,        // 目标 IMAGE 对象指针
        int dstX,              // 绘制位置的 x 坐标
        int dstY,              // 绘制位置的 y 坐标
        int dstWidth,          // 绘制的宽度
        int dstHeight,         // 绘制的高度
        PIMAGE pSrcImg,        // 源 IMAGE 对象指针
        int srcX,              // 绘制内容在源 IMAGE 对象中的左上角 x 坐标
        int srcY,              // 绘制内容在源 IMAGE 对象中的左上角 y 坐标
        int srcWidth,          // 绘制内容在源 IMAGE 对象中的宽度
        int srcHeight,         // 绘制内容在源 IMAGE 对象中的高度
        DWORD dwRop = SRCCOPY  // 三元光栅操作码（详见备注）
    );

    参数：
    （详见各重载函数原型内的注释）
    备注：
    三元光栅操作码（即位操作模式），支持全部的 256 种三元光栅操作码，常用的几种如下：

    值含义
    DSTINVERT绘制出的像素颜色 = NOT 屏幕颜色
    MERGECOPY绘制出的像素颜色 = 图像颜色 AND 当前填充颜色
    MERGEPAINT绘制出的像素颜色 = 屏幕颜色 OR (NOT 图像颜色)
    NOTSRCCOPY绘制出的像素颜色 = NOT 图像颜色
    NOTSRCERASE绘制出的像素颜色 = NOT (屏幕颜色 OR 图像颜色)
    PATCOPY绘制出的像素颜色 = 当前填充颜色
    PATINVERT绘制出的像素颜色 = 屏幕颜色 XOR 当前填充颜色
    PATPAINT绘制出的像素颜色 = 屏幕颜色 OR ((NOT 图像颜色) OR 当前填充颜色)
    SRCAND绘制出的像素颜色 = 屏幕颜色 AND 图像颜色
    SRCCOPY绘制出的像素颜色 = 图像颜色
    SRCERASE绘制出的像素颜色 = (NOT 屏幕颜色) AND 图像颜色
    SRCINVERT绘制出的像素颜色 = 屏幕颜色 XOR 图像颜色
    SRCPAINT绘制出的像素颜色 = 屏幕颜色 OR 图像颜色

    注：1. AND / OR / NOT / XOR 为布尔位运算。2. "屏幕颜色"指绘制所经过的屏幕像素点的颜色。3. "图像颜色"是指通过 IMAGE 对象中的图像的颜色。4. "当前填充颜色"是指通过 setfillstyle 设置的用于当前填充的颜色。5. 查看全部的三元光栅操作码请详见：三元光栅操作码。

    返回值：
    （无）

    示例：
    以下局部代码读取 c:\test.jpg 绘制在屏幕左上角：
    PIMAGE img = newimage();
    getimage(img, "c:\\test.jpg");
    putimage(0, 0, img);
    delimage(img);
    以下局部代码将屏幕 (0,0) 起始的长宽各 100 像素的图像拷贝至 (200,200) 位置：
    PIMAGE img = newimage();
    getimage(img, 0, 0, 100, 100);
    putimage(200, 200, img);
    delimage(img);