L_RectToBitmap
#include "l_bitmap.h"
L_LTKRN_API L_INT L_RectToBitmap(pBitmap, nViewPerspective, lprc)
pBITMAPHANDLE pBitmap; |
/* pointer to the bitmap handle */ |
L_INT nViewPerspective; |
/* source view perspective */ |
L_RECT* lprc; |
/* pointer to the RECT structure to be translated */ |
Translates a Windows RECT structure from a specified view perspective to the bitmap's view perspective.
Parameter |
Description |
pBitmap |
Pointer to the bitmap handle referencing the bitmap that contains the rectangle. |
nViewPerspective |
Source view perspective from which the rectangle should be translated. |
lprc |
Pointer to the RECT structure to be translated. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
To use this function, do the following:
1. |
Declare a Windows RECT structure and a pointer to it. |
2. |
Assign the values of the rectangle. |
3. |
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.) |
4. |
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
Windows 2000 / XP/Vista, Windows CE.
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; }