StretchBlt

StretchBlt

函數名稱
StretchBlt是一個函數,函數從源矩形中複制一個位圖到目标矩形,必要時按目标設備設置的模式進行圖像的拉伸或壓縮。StretchBlt函數将pSrcDC源設備中的位圖移動到目标矩形,該矩形用成員函數正在調用的設備上下文來表示。PATPAINT:通過使用布爾OR(或)操作符将源矩形區域取反後的顔色值與特定模式的顔色合并。xSrc,ySrc,nSrcWidth和nSrcHeight 參數定義了源矩形的左上角和尺寸。StretchBlt函數在内存中對源位圖進行擴展或壓縮,然後将結果拷貝到目标矩形中。
    中文名:StretchBlt 外文名: 别名: WindowsNT:3.1 WindowsCE:1.0 Windows:95

參數

BOOL StretchBlt(HDC hdcDest, int nXOriginDest, int nYOriginDest, int nWidthDest, int nHeightDest, HDC hdcSrc, int nXOriginSrc, int nYOriginSrc, int nWidthSrc, int nHeightSrc, DWORD dwRop);

hdcDest:指向目标設備環境的句柄。

nXOriginDest:指定目标矩形左上角的X軸坐标,按邏輯單位表示坐标。

nYOriginDest:指定目标矩形左上角的Y軸坐标,按邏輯單位表示坐标。

nWidthDest:指定目标矩形的寬度,按邏輯單位表示寬度。

nHeightDest:指定目标矩形的高度,按邏輯單位表示高度。

hdcSrc:指向源設備環境的句柄。

nXOriginSrc:指向源矩形區域左上角的X軸坐标,按邏輯單位表示坐标。

nYOriginSrc:指向源矩形區域左上角的Y軸坐标,按邏輯單位表示坐标。

nWidthSrc:指定源矩形的寬度,按邏輯單位表示寬度。

nHeightSrc:指定源矩形的高度,按邏輯單位表示高度。

dwRop:指定要進行的光栅操作。光栅操作碼定義了系統如何在輸出操作中組合顔色,這些操作包括刷子、源位圖和目标位圖等對象。參考BITBlt可了解常用的光栅操作碼列表。

下面列出了一些常見的光栅操作代碼:

BLACKNESS:表示使用與物理調色闆的索引0相關的色彩來填充目标矩形區域,(對缺省的物理調色闆而言,該顔色為黑色)。

DSTINVERT:表示使目标矩形區域顔色取反。

MERGECOPY:表示使用布爾型的AND(與)操作符将源矩形區域的顔色與特定模式組合一起。

MERGEPAINT:通過使用布爾型的OR(或)操作符将反向的源矩形區域的顔色與目标矩形區域的顔色合并。

NOTSRCCOPY:将源矩形區域顔色取反,再拷貝到目标矩形區域。

NOTSRCERASE:使用布爾類型的OR(或)操作符組合源和目标矩形區域的顔色值,然後将合成的顔色取反。

PATCOPY:将特定的模式拷貝到目标位圖上。

PATPAINT:通過使用布爾OR(或)操作符将源矩形區域取反後的顔色值與特定模式的顔色合并。然後使用OR(或)操作符将該操作的結果與目标矩形區域内的顔色合并。

PATINVERT:通過使用XOR(異或)操作符将源和目标矩形區域内的顔色合并。

SRCAND:通過使用AND(與)操作符來将源和目标矩形區域内的顔色合并。

SRCCOPY:将源矩形區域直接拷貝到目标矩形區域。

SRCERASE:通過使用AND(與)操作符将目标矩形區域顔色取反後與源矩形區域的顔色值合并。

SRCINVERT:通過使用布爾型的XOR(異或)操作符将源和目标矩形區域的顔色合并。

SRCPAINT:通過使用布爾型的OR(或)操作符将源和目标矩形區域的顔色合并。

WHITENESS:使用與物理調色闆中索引1有關的顔色填充目标矩形區域。(對于缺省物理調色闆來說,這個顔色就是白色)。

BOOL StretchBlt( int x, int y, int nWidth, int nHeight, CDC* pSrcDC, int xSrc, int ySrc, int nSrcWidth, int nSrcHeight, DWORD dwRop );

x:邏輯單元x軸左上角坐标;

y:邏輯單元y軸左上角坐标;

nWidth: 設備矩形寬度;

nHeight:設備矩形高度;

pSrcDC: 源設備上下文;

xSrc :源矩形x軸左上角坐标;

ySrc: 源矩形y軸左上角坐标;

Specifies the x-coordinate (in logical units) of the upper-left corner of the source rectangle.

nSrcWidth:源矩形寬度;

nSrcHeight:源矩形高度

dwRop:指定要進行的光栅操作。(和第一個函數一樣标示)

返回值

如果函數執行成功,那麼返回值為非零,如果函數執行失敗,那麼返回值為零。Windows NT:若想獲得更多的 錯誤信息,請調用GetLastError函數。

速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:1.0及以上版本;頭文件:wingdi.h:庫文件:gdi32.lib。

說明

将源矩形中的位圖拷貝到目标矩形中,如果有必要,可以擴展或壓縮該位圖使其與目标矩形尺寸吻合。函數使用目标設備上下文(由SetStretchBltMode設置)的擴展模式來決定如何擴展或壓縮位圖。StretchBlt函數将pSrcDC源設備中的位圖移動到目标矩形,該矩形用成員函數正在調用的設備上下文來表示。xSrc,ySrc,nSrcWidth和nSrcHeight 參數定義了源矩形的左上角和尺寸。x,yc,nWidth和nHeight參數定義了目标矩形的左上角和尺寸。

相關詞條

相關搜索

其它詞條