?? dibapi.cpp
字號:
// ************************************************************************
// 文件名：dibapi.cpp
//
// 公用 DIB(Independent Bitmap) API函數庫：
//
// PaintDIB() - 繪制DIB對象
// FindDIBBits() - 返回DIB圖像象素起始位置
// DIBWidth() - 返回DIB寬度
// DIBHeight() - 返回DIB高度
// DIBNumColors() - 計算DIB調色板顏色數目
// CopyHandle() - 拷貝內存塊
//
// SaveDIB() - 將DIB保存到指定文件中
// ReadDIBFile() - 重指定文件中讀取DIB對象
// NewDIB() - 根據提供的寬、高、顏色位數來創建一個新的DIB
//
// PaletteSize() - 返回DIB調色板大小
//
// ************************************************************************
#include "stdafx.h"
#include "dibapi.h"
#include <io.h>
#include <errno.h>
#include <math.h>
#include <direct.h>
/*
* Dib文件頭標志（字符串"BM"，寫DIB時用到該常數）
*/
#define DIB_HEADER_MARKER ((WORD) ('M' << 8) | 'B')
/*************************************************************************
*
* 函數名稱：
* PaintDIB()
*
* 參數:
* HDC hDC - 輸出設備DC
* LPRECT lpDCRect - 繪制矩形區域
* HDIB hDIB - 指向DIB對象的指針
* LPRECT lpDIBRect - 要輸出的DIB區域
* CPalette* pPal - 指向DIB對象調色板的指針
*
* 返回值:
* BOOL - 繪制成功返回TRUE，否則返回FALSE。
*
* 說明:
* 該函數主要用來繪制DIB對象。其中調用了StretchDIBits()或者
* SetDIBitsToDevice()來繪制DIB對象。輸出的設備由由參數hDC指
* 定；繪制的矩形區域由參數lpDCRect指定；輸出DIB的區域由參數
* lpDIBRect指定。
*
************************************************************************/
BOOL WINAPI PaintDIB(HDC hDC,
LPRECT lpDCRect,
HDIB hDIB,
LPRECT lpDIBRect,
CPalette* pPal)
{
LPSTR lpDIBHdr; // BITMAPINFOHEADER指針
LPSTR lpDIBBits; // DIB象素指針
BOOL bSuccess=FALSE; // 成功標志
HPALETTE hPal=NULL; // DIB調色板
HPALETTE hOldPal=NULL; // 以前的調色板
// 判斷DIB對象是否為空
if (hDIB == NULL)
{
// 返回
return FALSE;
}
// 鎖定DIB
lpDIBHdr = (LPSTR) ::GlobalLock((HGLOBAL) hDIB);
// 找到DIB圖像象素起始位置
lpDIBBits = ::FindDIBBits(lpDIBHdr);
// 獲取DIB調色板，并選中它
if (pPal != NULL)
{
hPal = (HPALETTE) pPal->m_hObject;
// 選中調色板
hOldPal = ::SelectPalette(hDC, hPal, TRUE);
}
// 設置顯示模式
::SetStretchBltMode(hDC, COLORONCOLOR);
// 判斷是調用StretchDIBits()還是SetDIBitsToDevice()來繪制DIB對象
if ((RECTWIDTH(lpDCRect) == RECTWIDTH(lpDIBRect)) &&
(RECTHEIGHT(lpDCRect) == RECTHEIGHT(lpDIBRect)))
{
// 原始大小，不用拉伸。
bSuccess = ::SetDIBitsToDevice(hDC, // hDC
lpDCRect->left, // DestX
lpDCRect->top, // DestY
RECTWIDTH(lpDCRect), // nDestWidth
RECTHEIGHT(lpDCRect), // nDestHeight
lpDIBRect->left, // SrcX
(int)DIBHeight(lpDIBHdr) -
lpDIBRect->top -
RECTHEIGHT(lpDIBRect), // SrcY
0, // nStartScan
(WORD)DIBHeight(lpDIBHdr), // nNumScans
lpDIBBits, // lpBits
(LPBITMAPINFO)lpDIBHdr, // lpBitsInfo
DIB_RGB_COLORS); // wUsage
}
else
{
// 非原始大小，拉伸。
bSuccess = ::StretchDIBits(hDC, // hDC
lpDCRect->left, // DestX
lpDCRect->top, // DestY
RECTWIDTH(lpDCRect), // nDestWidth
RECTHEIGHT(lpDCRect), // nDestHeight
lpDIBRect->left, // SrcX
lpDIBRect->top, // SrcY
RECTWIDTH(lpDIBRect), // wSrcWidth
RECTHEIGHT(lpDIBRect), // wSrcHeight
lpDIBBits, // lpBits
(LPBITMAPINFO)lpDIBHdr, // lpBitsInfo
DIB_RGB_COLORS, // wUsage
SRCCOPY); // dwROP
}
// 解除鎖定
::GlobalUnlock((HGLOBAL) hDIB);
// 恢復以前的調色板
if (hOldPal != NULL)
{
::SelectPalette(hDC, hOldPal, TRUE);
}
// 返回
return bSuccess;
}
/*************************************************************************
*
* 函數名稱：
* FindDIBBits()
*
* 參數:
* LPSTR lpbi - 指向DIB對象的指針
*
* 返回值:
* LPSTR - 指向DIB圖像象素起始位置
*
* 說明:
* 該函數計算DIB中圖像象素的起始位置，并返回指向它的指針。
*
************************************************************************/
LPSTR WINAPI FindDIBBits(LPSTR lpbi)
{
return (lpbi + *(LPDWORD)lpbi + ::PaletteSize(lpbi));
}
/*************************************************************************
*
* 函數名稱：
* DIBWidth()
*
* 參數:
* LPSTR lpbi - 指向DIB對象的指針
*
* 返回值:
* DWORD - DIB中圖像的寬度
*
* 說明:
* 該函數返回DIB中圖像的寬度。對于Windows 3.0 DIB，返回BITMAPINFOHEADER
* 中的biWidth值；對于其它返回BITMAPCOREHEADER中的bcWidth值。
*
************************************************************************/
DWORD WINAPI DIBWidth(LPSTR lpDIB)
{
// 指向BITMAPINFO結構的指針（Win3.0）
LPBITMAPINFOHEADER lpbmi;
// 指向BITMAPCOREINFO結構的指針
LPBITMAPCOREHEADER lpbmc;
// 獲取指針
lpbmi = (LPBITMAPINFOHEADER)lpDIB;
lpbmc = (LPBITMAPCOREHEADER)lpDIB;
// 返回DIB中圖像的寬度
if (IS_WIN30_DIB(lpDIB))
{
// 對于Windows 3.0 DIB，返回lpbmi->biWidth
return lpbmi->biWidth;
}
else
{
// 對于其它格式的DIB，返回lpbmc->bcWidth
return (DWORD)lpbmc->bcWidth;
}
}
/*************************************************************************
*
* 函數名稱：
* DIBHeight()
*
* 參數:
* LPSTR lpDIB - 指向DIB對象的指針
*
* 返回值:
* DWORD - DIB中圖像的高度
*
* 說明:
* 該函數返回DIB中圖像的高度。對于Windows 3.0 DIB，返回BITMAPINFOHEADER
* 中的biHeight值；對于其它返回BITMAPCOREHEADER中的bcHeight值。
*
************************************************************************/
DWORD WINAPI DIBHeight(LPSTR lpDIB)
{
// 指向BITMAPINFO結構的指針（Win3.0）
LPBITMAPINFOHEADER lpbmi;
// 指向BITMAPCOREINFO結構的指針
LPBITMAPCOREHEADER lpbmc;
// 獲取指針
lpbmi = (LPBITMAPINFOHEADER)lpDIB;
lpbmc = (LPBITMAPCOREHEADER)lpDIB;
// 返回DIB中圖像的寬度
if (IS_WIN30_DIB(lpDIB))
{
// 對于Windows 3.0 DIB，返回lpbmi->biHeight
return lpbmi->biHeight;
}
else
{
// 對于其它格式的DIB，返回lpbmc->bcHeight
return (DWORD)lpbmc->bcHeight;
}
}
/*************************************************************************
*
* 函數名稱：
* DIBNumColors()
*
* 參數:
* LPSTR lpbi - 指向DIB對象的指針
*
* 返回值:
* WORD - 返回調色板中顏色的種數
*
* 說明:
* 該函數返回DIB中調色板的顏色的種數。對于單色位圖，返回2，
* 對于16色位圖，返回16，對于256色位圖，返回256；對于真彩色
* 位圖（24位），沒有調色板，返回0。
*
************************************************************************/
WORD WINAPI DIBNumColors(LPSTR lpbi)
{
WORD wBitCount;
// 對于Windows的DIB, 實際顏色的數目可以比象素的位數要少。
// 對于這種情況，則返回一個近似的數值。
// 判斷是否是WIN3.0 DIB
if (IS_WIN30_DIB(lpbi))
{
DWORD dwClrUsed;
// 讀取dwClrUsed值
dwClrUsed = ((LPBITMAPINFOHEADER)lpbi)->biClrUsed;
if (dwClrUsed != 0)
{
// 如果dwClrUsed（實際用到的顏色數）不為0，直接返回該值
return (WORD)dwClrUsed;
}
}
// 讀取象素的位數
if (IS_WIN30_DIB(lpbi))
{
// 讀取biBitCount值
wBitCount = ((LPBITMAPINFOHEADER)lpbi)->biBitCount;
}
else
{
// 讀取biBitCount值
wBitCount = ((LPBITMAPCOREHEADER)lpbi)->bcBitCount;
}
// 按照象素的位數計算顏色數目
switch (wBitCount)
{
case 1:
return 2;
case 4:
return 16;
case 8:
return 256;
default:
return 0;
}
}
/*************************************************************************
*
* 函數名稱：
* DIBBitCount()
*
* 參數:
* LPSTR lpbi - 指向DIB對象的指針
*
* 返回值:
* WORD - 返回調色板中顏色的種數
*
* 說明:
* 該函數返回DIBBitCount。
*
************************************************************************/
WORD WINAPI DIBBitCount(LPSTR lpbi)
{
WORD wBitCount;
// 讀取象素的位數
if (IS_WIN30_DIB(lpbi))
{
// 讀取biBitCount值
wBitCount = ((LPBITMAPINFOHEADER)lpbi)->biBitCount;
}
else
{
// 讀取biBitCount值
wBitCount = ((LPBITMAPCOREHEADER)lpbi)->bcBitCount;
}
// 返回wBitCount
return wBitCount;
}
/*************************************************************************
*
* 函數名稱：
* CopyHandle()
*
* 參數:
* HGLOBAL h - 要復制的內存區域
*
* 返回值:
* HGLOBAL - 復制后的新內存區域
*
* 說明:
* 該函數復制指定的內存區域。返回復制后的新內存區域，出錯時返回0。
*
************************************************************************/
HGLOBAL WINAPI CopyHandle (HGLOBAL h)
{
if (h == NULL)
return NULL;
// 獲取指定內存區域大小
DWORD dwLen = ::GlobalSize((HGLOBAL) h);
// 分配新內存空間
HGLOBAL hCopy = ::GlobalAlloc(GHND, dwLen);
// 判斷分配是否成功
if (hCopy != NULL)
{
// 鎖定
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -