L_RectToBitmap (original) (raw)
Summary
Translates a Windows RECT structure from a specified view perspective to the bitmap's view perspective.
Syntax
#include "l_bitmap.h"
L_LTKRN_API L_INT L_RectToBitmap(pBitmap, nViewPerspective, lprc)
Parameters
pBITMAPHANDLE pBitmap
Pointer to the bitmap handle referencing the bitmap that contains the rectangle.
L_INT nViewPerspective
Source view perspective from which the rectangle should be translated.
L_RECT * lprc
Pointer to the RECT structure to be translated.
Returns
| Value | Meaning |
|---|---|
| SUCCESS | The function was successful. |
| < 1 | An error occurred. Refer to Return Codes. |
Comments
To use this function, do the following:
- Declare a Windows RECT structure and a pointer to it.
- Assign the values of the rectangle.
- Call this function, passing the pointer to the RECT structure, and specifying the source view perspective. (The function gets the destination view perspective from the bitmap handle.)
- Get the translated rectangle from the RECT structure, which this function has updated.
For general information about view perspectives, refer to Accounting for View Perspective.
Required DLLs and Libraries
- LTKRN
- For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.
Platforms
Win32, x64, Linux.
See Also
Functions
- L_PointFromBitmap
- L_PointToBitmap
- L_RectFromBitmap
- L_ChangeBitmapViewPerspective
- L_RotateBitmapViewPerspective
Topics
Example
This example finds out where the RECT {10,10,100,100 }
in the TOP_LEFT90 ViewPerspective actually is in the bitmap
L_INT RectToBitmapExample(pBITMAPHANDLE LeadBitmap,LPRECT rc)
{
L_INT nRet;
rc->top = 10;
rc->left = 10;
rc->bottom = 100;
rc->right = 100;
nRet = L_RectToBitmap ( LeadBitmap, TOP_LEFT90, rc );
if(nRet != SUCCESS)
return nRet;
return SUCCESS;
}
LEADTOOLS Raster Imaging C API Help