Convert a screen coordinate into model coordinate in the current database.

    GSErrCode ACAPI_Database (
        APIDb_PointToCoordID,
        API_Point*     point,
        API_Coord*     coord
    );

 

Parameters

point

[in] the pixel screen coordinate to convert

coord

[out] the associated model space coordinate

 

Return Values

NoError

The function has completed with success.

APIERR_BADPARS

any of the parameters are nullptr

For other common API errors see the API Errors document.

 

Remarks

This function is used to determine the real (model space) coordinate of a screen pixel coordinate.

It is the inverse function of APIDb_CoordToPointID function. Note that different coordinates may be assigned to the same pixel. The conversion mainly depends on the window size, on the actual drawing scale and zoom settings (APIDb_GetDrawingScaleID, APIDb_GetZoomID) which means the projection is database dependent.

 

Example

API_Coord    c;
API_Point    p
GSErrCode    err;

c.x = 1.0;
c.y = 2.0;
err = ACAPI_Database (APIDb_CoordToPointID, &c, &p);
err = ACAPI_Database (APIDb_PointToCoordID, &p, &c);

 

Requirements

Version: API 4.1 or later

Header: APIdefs_Database.h

 

See Also

API_Point, API_Coord, APIDb_CoordToPointID,
ACAPI_Database, API Functions