L_PointFromBitmap (original) (raw)
Summary
Translates a point (x,y) from the bitmap's view perspective to the specified view perspective.
Syntax
#include "l_bitmap.h"
L_LTKRN_API L_INT L_PointFromBitmap(pBitmap, ViewPerspective, px, py)
Parameters
pBITMAPHANDLE pBitmap
Pointer to the bitmap handle referencing the bitmap that contains the point.
L_INT ViewPerspective
Destination view perspective to which the point should be translated.
L_INT* px
Address of variable for the X coordinate of the point.
L_INT* py
Address of variable for the Y coordinate of the point.
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 variables for the X and Y coordinates of a point.
- Assign the values of a known point in the bitmap.
- 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.)
- 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
Win32, x64, Linux.
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;
}
LEADTOOLS Raster Imaging C API Help