L_PointFromBitmap
#include "l_bitmap.h"
L_LTKRN_API L_INT L_PointFromBitmap(pBitmap, ViewPerspective, px, py)
pBITMAPHANDLE pBitmap; |
/* pointer to the bitmap handle */ |
L_INT ViewPerspective; |
/* destination view perspective */ |
L_INT* px; |
/* address of the x coordinate variable */ |
L_INT* py; |
/* address of the y coordinate variable */ |
Translates a point (x,y) from the bitmap's view perspective to the specified view perspective.
Parameter |
Description |
pBitmap |
Pointer to the bitmap handle referencing the bitmap that contains the point. |
ViewPerspective |
Destination view perspective to which the point should be translated. |
px |
Address of variable for the X coordinate of the point. |
py |
Address of variable for the Y coordinate of the point. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
To use this function, do the following:
1. |
Declare variables for the X and Y coordinates of a point. |
2. |
Assign the values of a known point in the bitmap. |
3. |
Call this function, passing the addresses of the variables, and specifying the destination view perspective. (The function gets the source view perspective from the bitmap handle.) |
4. |
Get the translated point from the variables, 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_PointToBitmap, L_RectFromBitmap, L_RectToBitmap, L_ChangeBitmapViewPerspective, L_RotateBitmapViewPerspective |
Topics: |
Example
This example finds out where the origin of the bitmap would be in a TOP_LEFT90 ViewPerspective
L_INT PointFromBitmapExample(pBITMAPHANDLE LeadBitmap, L_INT* nX, L_INT* nY) { L_INT nRet; nRet = L_PointFromBitmap ( LeadBitmap, TOP_LEFT90, nX, nY ); if(nRet != SUCCESS) return nRet; return SUCCESS; }