区域和裁减区域-Window GDI

区域的创建和选择

一个应用程序通过调用指定形状的函数来创建一个区域。下表显示了创建标准图形的函数

形状	函数
矩形区域	CreateRectRgn, CreateRectRgnIndirect, SetRectRgn
圆角的矩形区域	CreateRoundRectRgn
椭圆区域	CreateEllipticRgn, CreateEllipticRgnIndirect
多边形区域	CreatePolygonRgn, CreatePolyPolygonRgn

每个区域创建函数返回一个HANDLE来标示新创建的区域。一个应用程序可以通过调用SelectObject函数并将这个HANDLE作为第二个参数来将一个区域选择进设备内容中。在一个区域被选择进设备内容之后，应用程序可以对其执行各种操作。

区域操作

应用程序能够合并区域、比较区域、着色和返回区域内部、给区域画边框、得到区域的大小和测试光标是否位于区域的范围。

 

 

合并区域

应用程序通过调用CombineRgn函数来合并两个区域。使用这个函数，应用程序能够合并两个区域的交集、两个区域除交集之外的区域、两个区域的并集等等。下面5个值定理了区域合并的类型。

值	意义
RGN_AND	两个区域的交集
RGN_COPY	两个区域的第一个区域作为新的区域
RGN_DIFF	第一个区域的部分减去两个区域的交集
RGN_OR	两个区域的并集
RGN_XOR	两个区域的并集减去两个区域的交集

下面图形显示了5种使用CombineRgn来操作正方形和圆合并的可能结果：

比较区域

应用程序通过调用EqualRgn来比较两个区域来判断他们是否一样。EqualRgn认为如果两个区域在形状和大小上相等就认为他们相等。

填充区域

应用程序可以通过调用FillRgn并提供一个刷子来填充某区域的内部。当程序调用FillRgn时，系统使用特定的设备内容的当前填充模式刷子来填充区域。有良种填充模式：交替的和缠绕的。程序能调用SetPolyFillMode函数来设置一个设备内容的填充模式。应用程序调用GetPolyFillMode函数来得到设备内容的当前填充模式。

下图描述了良种填充模式，一种使用交替模式，另一种使用缠绕模式。

交替模式

在交替模式下，为了判断那些像素需要高亮，执行下面的测试：

1.在区域内部选择一个像素

2.延正X轴方向画一条虚设的光线，从像素开始到无穷远

3.每次光线和边界线相交的，增加一个记数值

系统高亮那些记数值是奇数的像素。

 

 

缠绕模式

为了判断缠绕模式下那些像素需要高亮，需要执行下面测试：

1.在画每个边界线的时候判断方向

2.在区域的内部选择一个像素

3.画一条光线，延正X方向，从像素点到无穷远

4.每次光线与边界线在正Y部分正交的时候，增加记数值，如果在Y负方向，减记数值。

所有非0的像素被高亮。

AA

A

B

在交替模式下：

A发出的光线经过了三条边界，那么记数值为3，B经过了两条边界，记数值为2，所以A所在的区域为高亮，B所在的区域不是。

 

 

区域着色

应用程序使用当前选进设备内容的刷子来填充区域的内部，刷子通过PaintRgn函数来选择的，这个函数使用当前的多边形填充模式(交替和缠绕)。

 

 

反转区域

程序通过调用InvertRgn函数来使区域的颜色反色。在单色的显示设备上，InvertRgn是白色像素变黑，黑色像素变白。在彩色屏幕上，这个反转依赖于产生屏幕颜色的技术类型。

 

 

为区域增加框架

应用程序可以调用FrameRgn函数来为区域周围画一个边界，并指定边界的宽度和刷子的模式。

 

 

得到区域的矩形范围

应用程序通过调用GetRgnBox函数来得到区域边界矩形的大小。如果区域是规则的，GetRgnBox返回区域的大小；如果区域是椭圆形，函数返回包围在椭圆周围的最小矩形的大小，长边的长度和椭圆的主轴相等，短边和椭圆的次轴相同。如果区域是多边形，GetRgnBox返回最小的包围多边形的矩形。

 

 

移动区域

应用程序调用OffsetRgn函数来移动区域。给定的延X和Y轴防线的偏移决定了左右上下移动的逻辑单位。

 

 

点击测试区域

应用在区域上执行点击测试来判断当前光标位置的坐标。然后传递这些坐标和区域的HANDLE给PtInRegion函数。光标的坐标可以由多种鼠标操作得到，例如WM_LBUTTONDOWN、WM_LBUTTONUP、WM_RBUTTONDOWN和WM_RBUTTONUP。PtInRegion函数的返回值指出当前光标位置是否在给定的区域内。

 

 

使用区域来裁减输出

本节包含一个简单的例子，介绍你怎么样使用区域是用户可以定义这样输出客户区域的一部分。用作这个目的的区域被叫做裁减区域。

本节的例子，用户可以通过程序来抓获整个桌面为一位图，但能保存图象的一部分作为BMP文件。

通过单击Define Clip Region菜单，用户能够通过单击鼠标左键并拖动鼠标来选择一个裁减区域。当用户拖动鼠标的时候，应用程序画一个相对于新裁减区域的矩形。

通过单击Clip菜单，用户能够重画指定矩形边界内的图像独立部分。

本节提供下面的主题：

定义裁减区域

当用户单击Define Clip Region时，系统产生一个WM_COMMAND消息。该消息的wParam参数包含了程序自定义常量IDM_DEFINE，这指出用户选择了菜单，程序通过处理该输出并设置布尔变量fDefineRegion，如下面的代码：

case WM_COMMAND:

    switch (wParam)

    {

 

        case IDM_DEFINE:

            fDefineRegion = TRUE;

            break;

在Define Clipping Region之后，用户开始通过鼠标的单击和拖动来画矩形。

当用户按下鼠标左键时，系统产生WM_LBUTTONDOWN消息，lParam参数包含了光标的位置，它对应于裁减区域矩形的左上角。程序处理WM_LBUTTONDOWN消息如下：

// These variables are required for clipping. 

static POINT ptUpperLeft; 

static POINT ptLowerRight; 

static POINT aptRect[5]; 

static POINT ptTmp; 

static POINTS ptsTmp; 

static BOOL fDefineRegion; 

static BOOL fRegionExists; 

static HRGN hrgn; 

static RECT rctTmp; 

int i; 

switch (message) 

{ 

    case WM_LBUTTONDOWN: 

        if (fDefineRegion) 

        { 

        // Retrieve the new upper left corner. 

            ptsTmp = MAKEPOINTS(lParam); 

            ptUpperLeft.x = (LONG) ptsTmp.x; 

            ptUpperLeft.y = (LONG) ptsTmp.y; 

        } 

        if (fRegionExists) 

        { 

            // Erase the previous rectangle. 

            hdc = GetDC(hwnd); 

            SetROP2(hdc, R2_NOTXORPEN); 

            if (!Polyline(hdc, (CONST POINT *) aptRect, 5)) 

                errhandler("Polyline Failed", hwnd); 

            ReleaseDC(hwnd, hdc); 

            // Clear the rectangle coordinates. 

            for (i = 0; i < 4; i++) 

            { 

                aptRect[i].x = 0; 

                aptRect[i].y = 0; 

            } 

            // Clear the temporary point structure. 

            ptTmp.x = 0; 

            ptTmp.y = 0; 

            // Clear the lower right coordinates. 

            ptLowerRight.x = 0; 

            ptLowerRight.y = 0; 

            // Reset the flag. 

            fRegionExists = FALSE; 

            fDefineRegion = TRUE; 

            // Retrieve the new upper left corner. 

            ptsTmp = MAKEPOINTS(lParam); 

            ptUpperLeft.x = (LONG) ptsTmp.x; 

            ptUpperLeft.y = (LONG) ptsTmp.y; 

        } 

    break; 

}

当用户拖动鼠标的时候，系统产生WM_MOUSEMOVE消息并存储新的光标位置到lParam参数中。每次应用程序接收到WM_MOUSEMOVE消息时，它都删除先前的矩形（如果存在的话）并通过PolyLine函数来画一个新的区域，以矩形的四个角的坐标，程序执行下面的工作。

// These variables are required for clipping. 

static POINT ptUpperLeft; 

static POINT ptLowerRight; 

static POINT aptRect[5]; 

static POINT ptTmp; 

static POINTS ptsTmp; 

static BOOL fDefineRegion; 

static BOOL fRegionExists; 

static HRGN hrgn; 

static RECT rctTmp; 

int i; 

switch (message) 

{ 

    case WM_MOUSEMOVE: 

    if (wParam & MK_LBUTTON && fDefineRegion) 

    { 

        // Get a window DC. 

        hdc = GetDC(hwnd); 

        if (!SetROP2(hdc, R2_NOTXORPEN)) 

            errhandler("SetROP2 Failed", hwnd); 

        // If previous mouse movement occurred, store the original 

        // lower right corner coordinates in a temporary structure. 

       //如果先前鼠标移动了，原来较小的右下角坐标到ptLowerRight

        if (ptLowerRight.x) 

        { 

            ptTmp.x = ptLowerRight.x; 

            ptTmp.y = ptLowerRight.y; 

        } 

        // Get the new coordinates of the clipping region's lower 

        // right corner. 

        //取得新的右下角的坐标

        ptsTmp = MAKEPOINTS(lParam); 

        ptLowerRight.x = (LONG) ptsTmp.x; 

        ptLowerRight.y = (LONG) ptsTmp.y; 

        // If previous mouse movement occurred, erase the original 

        // rectangle. 

        //如果鼠标已经移动了，删除原来的矩形

        if (ptTmp.x) 

        { 

            aptRect[0].x = ptUpperLeft.x; 

            aptRect[0].y = ptUpperLeft.y; 

            aptRect[1].x = ptTmp.x; 

            aptRect[1].y = ptUpperLeft.y; 

            aptRect[2].x = ptTmp.x; 

            aptRect[2].y = ptTmp.y; 

            aptRect[3].x = ptUpperLeft.x; 

            aptRect[3].y = ptTmp.y; 

            aptRect[4].x = aptRect[0].x; 

            aptRect[4].y = aptRect[0].y; 

            if (!Polyline(hdc, (CONST POINT *) aptRect, 5)) 

                errhandler("Polyline Failed", hwnd); 

        } 

        aptRect[0].x = ptUpperLeft.x; 

        aptRect[0].y = ptUpperLeft.y; 

        aptRect[1].x = ptLowerRight.x; 

        aptRect[1].y = ptUpperLeft.y; 

        aptRect[2].x = ptLowerRight.x; 

        aptRect[2].y = ptLowerRight.y; 

        aptRect[3].x = ptUpperLeft.x; 

        aptRect[3].y = ptLowerRight.y; 

        aptRect[4].x = aptRect[0].x; 

        aptRect[4].y = aptRect[0].y; 

        if (!Polyline(hdc, (CONST POINT *) aptRect, 5)) 

             errhandler("Polyline Failed", hwnd); 

        ReleaseDC(hwnd, hdc); 

    } 

    break; 

 

 

裁减输出

在用户选择Clip菜单之后，应用程序使用用户创建的裁减区域的矩形坐标，在定义裁减区域后，将它选进程序的设备内容中，程序重画位图，程序执行下面的工作：

// These variables are required for clipping. 

static POINT ptUpperLeft; 

static POINT ptLowerRight; 

static POINT aptRect[5]; 

static POINT ptTmp; 

static POINTS ptsTmp; 

static BOOL fDefineRegion; 

static BOOL fRegionExists; 

static HRGN hrgn; 

static RECT rctTmp; 

int i; 

case WM_COMMAND: 

    switch (wParam) 

    { 

    case IDM_CLIP: 

    hdc = GetDC(hwnd); 

    // Retrieve the application's client rectangle and paint 

// with the default (white) brush. 

//得到程序的客户区矩形，并用白刷子填充

    GetClientRect(hwnd, &rctTmp); 

    FillRect(hdc, &rctTmp, GetStockObject(WHITE_BRUSH)); 

// Use the rect coordinates to define a clipping region. 

//使用rect的坐标来定义一个裁减区域

    hrgn = CreateRectRgn(aptRect[0].x, aptRect[0].y, 

        aptRect[2].x, aptRect[2].y); 

    SelectClipRgn(hdc, hrgn); 

// Transfer (draw) the bitmap into the clipped rectangle. 

//将位图画到裁减矩形中

    BitBlt(hdc, 

       0, 0, 

       bmp.bmWidth, bmp.bmHeight, 

       hdcCompatible, 

       0, 0, 

       SRCCOPY); 

    ReleaseDC(hwnd, hdc); 

    break; 

    }