BitBlt 和 StretchBlt 使用举例

当使用BitBlt和StretchBlt函数时，你需要指定源设备上下文（通常是一个包含位图的内存设备上下文）和目标设备上下文（例如，屏幕的设备上下文）。以下是这两个函数的使用举例：

一、`使用BitBlt`

BitBlt（位块传输）是Windows GDI（图形设备接口）中的一个函数，用于在设备上下文（通常是一个窗口或位图）之间复制像素数据。BitBlt函数非常强大，因为它允许你指定源和目标矩形区域，以及一个可选的光栅操作（ROP）代码，该代码定义了如何组合源和目标像素。

函数原型通常如下（具体取决于你使用的编程语言和Windows API的版本）：

BOOL BitBlt(HDC     hdcDest, // 目标设备上下文句柄int     nXDest,  // 目标矩形左上角的x坐标int     nYDest,  // 目标矩形左上角的y坐标int     nWidth,  // 矩形区域的宽度int     nHeight, // 矩形区域的高度HDC     hdcSource, // 源设备上下文句柄int     nXSrc,   // 源矩形左上角的x坐标int     nYSrc,   // 源矩形左上角的y坐标DWORD   rop       // 光栅操作码
);

hdcDest：目标设备上下文句柄，通常是一个窗口或位图的设备上下文。
nXDest 和 nYDest：目标矩形左上角的坐标。
nWidth 和 nHeight：要复制的矩形区域的尺寸。
hdcSource：源设备上下文句柄，通常包含要复制的像素数据。
nXSrc 和 nYSrc：源矩形左上角的坐标，指定从源设备上下文中复制的起始位置。
rop：光栅操作码，定义了如何组合源和目标像素。常见的ROP包括SRCCOPY（仅复制源），SRCPAINT（将源与目标组合，保留目标中的背景），等等。你可以使用逻辑运算（如AND、OR、XOR等）来定义自定义的ROP。

下面是一个简单的例子，说明如何使用BitBlt函数将一个位图绘制到窗口的客户区：

// 假设hdc是窗口的客户区设备上下文句柄
// hBitmap是包含要绘制的位图的句柄HDC hdcMem = CreateCompatibleDC(hdc); // 创建一个与hdc兼容的内存设备上下文
HBITMAP hOldBitmap = (HBITMAP)SelectObject(hdcMem, hBitmap); // 选择位图到内存设备上下文// 假设我们想要在位图的整个区域上绘制，并且绘制到窗口的左上角（0, 0）
BitBlt(hdc, 0, 0, bitmapWidth, bitmapHeight, hdcMem, 0, 0, SRCCOPY);// 恢复内存设备上下文中的原始位图
SelectObject(hdcMem, hOldBitmap);
DeleteDC(hdcMem); // 删除内存设备上下文

在这个例子中，我们首先创建了一个与窗口设备上下文兼容的内存设备上下文，并将位图选择到该内存设备上下文中。然后，我们使用BitBlt函数将位图从内存设备上下文复制到窗口的设备上下文中。最后，我们恢复内存设备上下文中的原始位图，并删除内存设备上下文。

总之，BitBlt函数用于从一个设备上下文复制位图到另一个设备上下文。它不会改变位图的大小。

#include <windows.h>// 假设你已经有一个HBITMAP hBitmap和一个HDC hdcMem，其中hdcMem已经选中了hBitmap
// 并且你也已经有了一个HDC hdcScreen，它是屏幕的设备上下文// 源矩形（在hdcMem中）和目标点（在hdcScreen中）
RECT srcRect = { 0, 0, 100, 100 }; // 假设位图大小是100x100
POINT dstPoint = { 100, 100 }; // 在屏幕上的目标位置// 使用BitBlt将位图从hdcMem复制到hdcScreen的指定位置
BitBlt(hdcScreen, dstPoint.x, dstPoint.y, srcRect.right - srcRect.left, srcRect.bottom - srcRect.top, hdcMem, srcRect.left, srcRect.top, SRCCOPY);// ... 清理资源 ...

二、`使用StretchBlt`

StretchBlt是Windows API中的一个函数，用于在设备上下文之间进行位图的拉伸、复制和变换操作。以下是关于StretchBlt函数的详细解释：

函数原型

BOOL StretchBlt(HDC hdcDest,          // 目标设备上下文句柄int nXOriginDest,     // 目标矩形左上角的X坐标int nYOriginDest,     // 目标矩形左上角的Y坐标int nWidthDest,       // 目标矩形的宽度int nHeightDest,      // 目标矩形的高度HDC hdcSrc,           // 源设备上下文句柄int nXOriginSrc,      // 源矩形左上角的X坐标int nYOriginSrc,      // 源矩形左上角的Y坐标int nWidthSrc,        // 源矩形的宽度int nHeightSrc,       // 源矩形的高度DWORD dwRop            // 光栅操作码
);

参数解释

hdcDest：
- 类型：HDC（设备上下文句柄）
- 描述：指向目标设备环境的句柄，即位图将要被绘制到的设备上下文。
nXOriginDest, nYOriginDest：
- 类型：int
- 描述：目标矩形左上角的X坐标和Y坐标，以逻辑单位表示。
nWidthDest, nHeightDest：
- 类型：int
- 描述：目标矩形的宽度和高度，以逻辑单位表示。
hdcSrc：
- 类型：HDC
- 描述：指向源设备环境的句柄，即位图来源的设备上下文。
nXOriginSrc, nYOriginSrc：
- 类型：int
- 描述：源矩形左上角的X坐标和Y坐标，以逻辑单位表示。
nWidthSrc, nHeightSrc：
- 类型：int
- 描述：源矩形的宽度和高度，以逻辑单位表示。
dwRop：
- 类型：DWORD
- 描述：光栅操作码，定义了系统如何在输出操作中组合颜色。这些操作包括刷子、源位图和目标位图等对象。常见的光栅操作码包括BLACKNESS、DSTINVERT、MERGECOPY、MERGEPAINT等。

返回值

如果函数成功执行，返回非零值。
如果函数失败，返回值为0。

功能描述

StretchBlt函数的主要功能是将一个位图从源矩形区域拉伸或压缩到目标矩形区域。通过指定不同的参数，可以实现不同的位图操作效果，如缩放、旋转（间接实现，通常配合其他图形变换函数）、镜像等。

应用场景

StretchBlt函数在图形处理、界面设计、游戏开发等领域有广泛应用。例如，在前端开发中，可以使用StretchBlt函数将图像按比例缩放以适应不同的屏幕分辨率；在多媒体处理中，可以使用StretchBlt函数对视频图像进行拉伸和变换以实现特殊效果。

注意事项

由于StretchBlt函数涉及到图像变换操作，可能会影响到图像的质量。在需要高精度图像处理时，可能需要考虑其他方法。
在使用StretchBlt函数时，需要确保源设备上下文和目标设备上下文都是有效的，并且源矩形和目标矩形的坐标和尺寸参数是合理的。

示例代码

假设我们有一个位图图像（保存在内存中），并希望将其拉伸到一个窗口的客户区：

初始化：
- 获取窗口的客户区DC（hdcDest）。
- 创建一个兼容的内存DC（hdcSrc），并将位图选入该内存DC。
设置参数：
- 假设窗口客户区的矩形为RECT rect = {0, 0, 640, 480};（宽640，高480）。
- 假设源位图的矩形为RECT rectSrc = {0, 0, 320, 240};（宽320，高240）。
- 选择一个光栅操作码，如SRCCOPY（将源位图直接复制到目标位图）。
调用StretchBlt函数：

HDC hdcDest = GetDC(hwnd); // hwnd是窗口句柄
HDC hdcSrc = CreateCompatibleDC(hdcDest);
HBITMAP hBitmap = LoadBitmap(...); // 假设这里加载了位图到hBitmap
SelectObject(hdcSrc, hBitmap);RECT rect = {0, 0, 640, 480}; // 目标矩形区域
RECT rectSrc = {0, 0, 320, 240}; // 源位图矩形区域// 调用StretchBlt函数进行位图拉伸
StretchBlt(hdcDest, rect.left, rect.top, rect.right - rect.left, rect.bottom - rect.top, // 目标位置和大小hdcSrc, rectSrc.left, rectSrc.top, rectSrc.right - rectSrc.left, rectSrc.bottom - rectSrc.top, // 源位置和大小SRCCOPY); // 光栅操作码// 释放资源
DeleteDC(hdcSrc);
ReleaseDC(hwnd, hdcDest);
DeleteObject(hBitmap);

注意事项

资源管理：在调用完StretchBlt后，记得释放所有创建的资源，如内存DC和位图对象。
错误处理：虽然本示例没有展示，但在实际使用中，应检查StretchBlt的返回值以确保操作成功，并在需要时处理错误。
光栅操作码：根据具体需求选择合适的光栅操作码。SRCCOPY是最简单的选择，它会直接将源位图复制到目标位置。但Windows API提供了许多其他选项，可以实现更复杂的颜色组合效果。
坐标和尺寸：确保源矩形和目标矩形的坐标和尺寸是合理的，并考虑到设备的分辨率和位图的原始尺寸。
性能考虑：StretchBlt函数在处理大图像或频繁调用时可能会影响性能。在需要高性能的场景中，可能需要考虑其他优化方法或技术。

总之，StretchBlt函数与BitBlt类似，但它允许你拉伸或压缩位图以适应目标矩形的大小。

#include <windows.h>// 假设你已经有一个HBITMAP hBitmap和一个HDC hdcMem，其中hdcMem已经选中了hBitmap
// 并且你也已经有了一个HDC hdcScreen，它是屏幕的设备上下文// 源矩形（在hdcMem中）和目标矩形（在hdcScreen中）
RECT srcRect = { 0, 0, 100, 100 }; // 假设位图大小是100x100
RECT dstRect = { 100, 100, 300, 300 }; // 在屏幕上的目标位置，大小为200x200// 使用StretchBlt将位图从hdcMem拉伸到hdcScreen的指定位置
StretchBlt(hdcScreen, dstRect.left, dstRect.top, dstRect.right - dstRect.left, dstRect.bottom - dstRect.top, hdcMem, srcRect.left, srcRect.top, srcRect.right - srcRect.left, srcRect.bottom - srcRect.top, SRCCOPY);// ... 清理资源 ...

在这两个例子中，SRCCOPY是一个光栅操作码（ROP），它表示源矩形应被复制到目标矩形。还有其他ROP可以用来执行更复杂的位图操作，如与、或、异或等。

请注意，这些示例假设你已经正确创建了HBITMAP和HDC，并且已经将位图选入内存设备上下文。此外，你还需要在适当的时候释放这些资源，以避免内存泄漏。在实际应用中，你可能还需要处理错误情况，例如当BitBlt或StretchBlt调用失败时。

三、注意

BitBlt函数不支持图像缩放。BitBlt函数用于将一个图像的大小尺寸原封不动地贴到目标位置上，即在贴图的过程中图像的大小尺寸不会改变。但是，源图像可与目标位图进行指定的光栅操作。

与BitBlt不同，StretchBlt函数支持图像缩放。StretchBlt函数从源矩形中复制一个位图到目标矩形，必要时按目标设备设置的模式进行图像的拉伸或压缩。也即是，StretchBlt可以将内存中的位图拷贝到屏幕上，并且可以根据屏幕画图区的大小来进行伸缩，以适应响应的屏幕（或图像控件）。

在使用StretchBlt对图像进行缩小时，需要特别注意图像失真的问题。为了解决这个问题，可以在对图像进行缩小之前设置一下Mode，例如，使用pDC->SetStretchBltMode(HALFTONE);来减少失真。

另外，推荐在画图前使用 libyuv 缩放，不是使用画图接口来缩放！

综上所述，如果需要实现图像的缩放功能，应该选择使用StretchBlt函数而非BitBlt函数。

四、使用BitBlt或StretchBlt将位图绘制到hdcScreen上

当您使用CreateDIBSection创建了一个与设备无关的位图（DIB）后，您可以使用GDI函数BitBlt或StretchBlt将位图的内容绘制到屏幕或其他设备上下文（如窗口的DC）上。以下是使用BitBlt函数进行绘制的基本步骤：

步骤

创建兼容的设备上下文：首先，您需要一个与屏幕兼容的设备上下文（HDC）。这通常是通过调用GetDC(NULL)或GetDC(hWnd)（其中hWnd是窗口句柄）来获取的。
创建DIBSection：使用CreateDIBSection函数创建一个DIBSection，并加载RGB数据到该DIBSection中。
选择位图到设备上下文：使用SelectObject函数将DIBSection选入到您的内存设备上下文中。
使用BitBlt进行绘制：调用BitBlt函数，将内存设备上下文中的位图绘制到屏幕设备上下文上。
清理资源：释放所有分配的资源，包括位图句柄、内存和设备上下文。

示例代码

以下是一个简化的示例代码，展示了如何使用BitBlt将DIBSection绘制到屏幕上：

#include <windows.h>// 假设您已经加载了RGB数据到rgbData指针中，并且设置了BITMAPINFOHEADER结构bmiHeader// ... 省略了RGB数据加载和BITMAPINFOHEADER设置的代码 ...// 获取屏幕的设备上下文
HDC hdcScreen = GetDC(NULL); // 或者使用特定窗口的句柄，如 GetDC(hWnd)// 创建兼容的内存设备上下文
HDC hdcMem = CreateCompatibleDC(hdcScreen);// 创建DIBSection
HBITMAP hBitmap = CreateDIBSection(hdcMem, &bmi, DIB_RGB_COLORS, (void**)&rgbData, NULL, 0);
if (hBitmap == NULL) {// 处理错误// ...goto Cleanup;
}// 选择位图到内存设备上下文
HBITMAP hOldBitmap = (HBITMAP)SelectObject(hdcMem, hBitmap);// 假设源矩形的位置和大小与位图相同
RECT srcRect = { 0, 0, bmiHeader.biWidth, bmiHeader.biHeight };// 绘制位图到屏幕上的指定位置（例如，(100, 100)）
POINT dstPoint = { 100, 100 };
BitBlt(hdcScreen, dstPoint.x, dstPoint.y, bmiHeader.biWidth, bmiHeader.biHeight, hdcMem, 0, 0, SRCCOPY);// 恢复原始位图到内存设备上下文（如果需要）
SelectObject(hdcMem, hOldBitmap);// 清理资源
DeleteObject(hBitmap); // 释放位图句柄
DeleteDC(hdcMem); // 删除内存设备上下文
ReleaseDC(NULL, hdcScreen); // 释放屏幕设备上下文（如果使用特定窗口，则替换为hWnd）// ... 其他清理代码 ...Cleanup:
// ...
return;