virtual L_INT LBitmapRgn::SetRgnPolygon(pPoints, uPoints, uFillMode=L_POLY_WINDING)
Creates or updates the associated class object's bitmap region by adding a polygonal region.
Pointer to an array of POINT structures. The points in the array must be in the order in which the vertices of the polygon are connected. To create the line that closes the polygon, the last point in the array is connected to the first point of the array.
The number of points in the array specified by the pPoints parameter.
Flag that indicates how to handle complex crossing lines. The following are valid values, which are illustrated below:
Value | Meaning |
---|---|
L_POLY_WINDING | [0] All pixels that are inside the resulting exterior lines are in the region. |
L_POLY_ALTERNATE | [1] The region includes the area between odd-numbered and even-numbered polygon sides on each scan line. |
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
To update an existing region, you specify how the new region is to be combined with the existing one. For descriptions of the possibilities, refer to Creating a Bitmap Region.
Win32, x64.
L_INT LBitmapRgn__SetRgnPolygonExample(HWND hWnd)
{
RGNXFORM XFormBtmp; // Structure for transforming display coordinates
RECT rClientArea; // Client area of the current window
L_INT nRet = 0;
LBitmapRgn lBmpRgn ;
LBitmapBase BmpBase;
LBitmapBase BmpMask;
HRGN hRgn ;
POINT PolyPt[5]; // Array of points that defines the polygon
POINT *pPolyPt = PolyPt; // Pointer to the array of points
// Get the client area of the current window
GetClientRect(hWnd,&rClientArea);
// Load a bitmap
nRet = BmpBase.Load(MAKE_IMAGE_PATH(TEXT("IMAGE1.CMP")), 32, ORDER_BGR);
if (nRet == SUCCESS)
{
lBmpRgn.SetBitmap(&BmpBase) ;
L_UINT uCombineMode = lBmpRgn.GetRgnCombineMode() ;
uCombineMode |= L_RGN_OR ;
lBmpRgn.SetRgnCombineMode(uCombineMode) ;
nRet =lBmpRgn.SetRgnColor(RGB(0,0,0)) ;
if(nRet !=SUCCESS)
return nRet;
// create mask region from bitmap
nRet = lBmpRgn.CreateMaskFromBitmapRgn(&BmpMask, sizeof(BITMAPHANDLE)) ;
if (nRet == SUCCESS)
{
// set region from mask bitmap
lBmpRgn.SetRgnFromMask(BmpMask) ;
}
else
return nRet;
// get the region transform used with region function
lBmpRgn.GetRgnXForm(&XFormBtmp) ;
/* Set RGNXFORM fields, assuming that the display rectangle is the same
as the client area of the current window */
XFormBtmp.uViewPerspective = TOP_LEFT;
XFormBtmp.nXScalarNum = BmpBase.GetWidth();
XFormBtmp.nXScalarDen = rClientArea.right;
XFormBtmp.nYScalarNum = BmpBase.GetHeight() ;
XFormBtmp.nYScalarDen = rClientArea.bottom;
XFormBtmp.nXOffset = 0;
XFormBtmp.nYOffset = 0;
// set the region transform to be used in region functions
nRet =lBmpRgn.SetRgnXForm(&XFormBtmp) ;
if(nRet !=SUCCESS)
return nRet;
// Specify the vertices of the polygon (a 5-pointed star)
pPolyPt[0].x = 0;
pPolyPt[0].y = 0;
pPolyPt[1].x = rClientArea.right / 3;
pPolyPt[1].y = rClientArea.bottom / 2;
pPolyPt[2].x = rClientArea.right / 3;
pPolyPt[2].y = 0;
pPolyPt[3].x = 0;
pPolyPt[3].y = rClientArea.bottom / 3;
pPolyPt[4].x = rClientArea.right / 2;
pPolyPt[4].y = rClientArea.bottom / 3;
// Create a polygonal region
nRet =lBmpRgn.SetRgnPolygon( pPolyPt, 5, L_POLY_ALTERNATE);
if(nRet !=SUCCESS)
return nRet;
// Save the first polygonal region
hRgn = lBmpRgn.GetRgnHandle();
// Free the region
nRet =lBmpRgn.Free();
if(nRet !=SUCCESS)
return nRet;
// Add the saved region to the new one
nRet =lBmpRgn.SetRgnHandle(hRgn);
if(nRet !=SUCCESS)
return nRet;
/*
...
...
...
*/
// Delete the HRGN object
DeleteObject(hRgn);
}
return nRet;
}
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document