Several of the LEADTOOLS functions for creating and working with a bitmap region use coordinates from an external representation of the region, such as a shape drawn in a device context.
To compensate for possible differences in view perspective, scaling, and display offsets, these LEADTOOLS functions require that you provide translation information in an RGNXFORM structure. (For details on how information is translated, refer to the structure description.)
In most cases, the external representation of a bitmap region is scaled and positioned relative to the display coordinates of a LEADTOOLS painting function. Therefore, the following table describes the fields to set in the RGNXFORM structure, based on the parameters of the L_PaintDC function:
Sample Field Name | Description |
---|---|
XForm.uViewPerspective | The view perspective of the external representation. With LEADTOOLS painting functions, the view perspective is always TOP_LEFT. |
XForm.nXScalarNum | The numerator for the X scaling factor. |
When translating information from the bitmap, you can use the width of the painting function's destination rectangle for this value. Functions that translate in this direction are L_FrameBitmapRgn, L_GetBitmapRgnBounds, and L_GetBitmapRgnHandle. | |
When translating information to the bitmap, you can use the width of the painting function's source rectangle for this value. (By default, it is the bitmap width.) Functions that translate in this direction are L_SetBitmapRgnEllipse, L_SetBitmapRgnHandle, L_SetBitmapRgnPolygon, L_SetBitmapRgnRect, and L_SetBitmapRgnRoundRect. | |
XForm.nXScalarDen | The denominator for the X scaling factor. |
When translating information from the bitmap, you can use the width of the painting function's source rectangle for this value. (By default, it is the bitmap width.) | |
When translating information to the bitmap, you can use the width of the painting function's destination rectangle for this value. | |
Refer to the nXScalarNum field to see which functions translate which direction. | |
XForm.nYScalarNum | The denominator for the Y scaling factor. |
When translating information from the bitmap, you can use the height of the painting function's destination rectangle for this value. | |
When translating information to the bitmap, you can use the height of the painting function's source rectangle for this value. (By default, it is the bitmap height.) | |
Refer to the nXScalarNum field to see which functions translate which direction. | |
XForm.nYScalarDen | The denominator for the Y scaling factor. |
When translating information from the bitmap, you can use the height of the painting function's source rectangle for this value. (By default, it is the bitmap height.) | |
When translating information to the bitmap, you can use the height of the painting function's destination rectangle for this value. | |
Refer to the nXScalarNum field to see which functions translate which direction. | |
XForm.nXOffset | The X offset of the external representation. |
When translating information from the bitmap, you can use the left value of the painting function's destination rectangle. | |
When translating information to the bitmap, you can negate the left value of the painting function's destination rectangle (-left). | |
Refer to the nXScalarNum field to see which functions translate which direction. | |
XForm.nYOffset | The Y offset of the external representation. |
When translating information from the bitmap, you can use the top value of the painting function's destination rectangle. | |
When translating information to the bitmap, you can negate the top value of the painting function's destination rectangle (-top). | |
Refer to the nXScalarNum field to see which functions translate which direction. |
All region functions accept a NULL pointer for this structure. In that case, no transformation occurs. The scalar fields default to 1, the offsets default to 0, and the view perspective defaults to the bitmap's view perspective.
Regions are not supported on Windows CE.
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
Your email has been sent to support! Someone should be in touch! If your matter is urgent please come back into chat.
Chat Hours:
Monday - Friday, 8:30am to 6pm ET
Thank you for your feedback!
Please fill out the form again to start a new chat.
All agents are currently offline.
Chat Hours:
Monday - Friday
8:30AM - 6PM EST
To contact us please fill out this form and we will contact you via email.