Return to readme.txt CVS log

Up to [WindowsNT SDKs] / mstools / samples / maskblt

Microsoft Windows NT Build 328 10-12-1992

Sample: MaskBlt Function Demonstration

Summary:

The MASKBLT sample is an easy-to-use demonstration of the
MaskBlt Win32 API function. The program presents a dialog
box on the top of the window; through this dialog box the
user can manipulate the parameters to MaskBlt. In the main
window, the source bitmap is displayed in the center third
of the window, the monochrome bitmap mask is displayed in
the right third of the window, and the destination bitmap is
displayed on the left.

More Information:

The destination rectangle may be changed directly in the
dialog box, or it may be changed by using the direct
manipulation object in the left third of the window.
Clicking and dragging the mouse in the upper-left corner
moves the rectangle; clicking and dragging the mouse in the
lower-right corner sizes the rectangle. The function
requires only a starting point (not a rectangle) for the
source and mask bitmaps. There is one additional direct
manipulation object for the source and one for the mask.
These objects may be moved by clicking and dragging with the
mouse.

The raster operation for the MaskBlt call may be changed by
altering the values in the right most entry fields. The
contents are interpreted to be in hexadecimal. There is a
combo box directly beneath these entry fields that lists all
of the standard raster operations. If the user selects a
standard ROP from this combo box, its contents are copied
into the ROP entry fields and are then used in the MaskBlt
call.

This sample provides clipboard support in the following manner.
Hitting <ctrl>+<insert> will copy the destination image into the
clipboard.  Hitting <shift>+<insert> will copy a bitmap from the
clipboard into the source region.  Hitting <alt>+<insert> will
do both; the destination image will be copied into the clipboard
and then down to the source region.

The following is a list of the Win32 API functions used in
this sample:

_lclose             DPtoLP           LineTo           ReleaseCapture
_lopen              EndPaint         LoadAccelerators ReleaseDC
_lread              FillRect         LoadIcon         SelectClipRgn
AngleArc            GetClassLong     LoadCursor       SelectObject
BeginPaint          GetClientRect    LocalAlloc       SendDlgItemMessage
BitBlt              GetClipboardData LocalFree        SendMessage
ClientToScreen      GetClipBox       LocalHandle      SetCapture
CloseClipBoard      GetDC            LPtoDP           SetClipboardData
CreateCompatibleBitmap GetDlgItemInt MaskBlt          SetCursorPos
CreateCompatibleDC  GetDlgItemtext   MessageBox       SetDlgItemInt
CreateDialog        GetFileSize      ModifyWorldTransform  SetDlgItemText
CreateDIBitmap      GetMessage       MoveToEx         SetROP2
CreatePen           GetObject        OpenClipboard    SetViewportOrgEx
CreateRectRgnIndirect GetStockObject OpenFile         SetWindowPos
CreateWindow        GetViewportOrgEx PostMessage      SetWorldTransform
DeleteDC            GetWorldTransform PostQuitMessage ShowWindow
DeleteObject        InvalidateRect   PtInRect         StretchBlt
DispatchMessage     IsWindow         Rectangle        

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.