henc · Viewport & Map Area
Center / zoom / scale / rotation / map area configuration
hencSetCenter
Section titled “hencSetCenter”Prototype
Section titled “Prototype”int hencSetCenter( double cx, double cy )Function
Section titled “Function”Used to specify the center point of map display.
Parameters
Section titled “Parameters”- double cx : IN (longitude, degree)
- double cy : IN (latitude, degree)
Return Value
Section titled “Return Value”- = 0 : Success
- < 0 : Fail
hencGetCenter
Section titled “hencGetCenter”Prototype
Section titled “Prototype”int hencGetCenter( double &cx, double &cy )Function
Section titled “Function”It is used to obtain the current map center point.
Parameters
Section titled “Parameters”- double &cx : OUT (longitude, degree)
- double &cy : OUT (latitude, degree)
Return Value
Section titled “Return Value”- = 0 : Success
- < 0 : Fail
hencGetCenterX
Section titled “hencGetCenterX”Prototype
Section titled “Prototype”double hencGetCenterX()Function
Section titled “Function”Obtain the longitude value of the current map center point.
Parameters
Section titled “Parameters”None
Return Value
Section titled “Return Value”Longitude value of the map center point
hencGetCenterY
Section titled “hencGetCenterY”Prototype
Section titled “Prototype”double hencGetCenterY()Function
Section titled “Function”Obtain the latitude value of the current map center point.
Parameters
Section titled “Parameters”None
Return Value
Section titled “Return Value”Latitude value of the map center point
hencSetZoom
Section titled “hencSetZoom”Prototype
Section titled “Prototype”int hencSetZoom( double scale )Function
Section titled “Function”- This function is used to specify the magnification ratio of the map. It specifies the ratio of one angle of latitude and longitude to one pixel of the screen.
- It works in conjunction with the function, only in units..
Parameters
Section titled “Parameters”scale : IN (magnification ratio)
Return Value
Section titled “Return Value”- = 0 : Success
- < 0 : Fail
hencGetZoom
Section titled “hencGetZoom”Prototype
Section titled “Prototype”double hencGetZoom()Function
Section titled “Function”- As a function that obtain zoom ratio of map, set the ratio between lat/lng 1 degree and 1 pixel in screen.
- It is linked with function, and there is only difference in unit.
Parameters
Section titled “Parameters”None
Return Value
Section titled “Return Value”Map zoom ratio value
hencGetScale
Section titled “hencGetScale”Prototype
Section titled “Prototype”double hencGetScale()Function
Section titled “Function”- This value is a value indicating the ratio of the actual distance to the pixel size on the actual screen specified by the function.
Parameters
Section titled “Parameters”None
Return Value
Section titled “Return Value”Scale value N in 1:N
hencSetScale
Section titled “hencSetScale”Prototype
Section titled “Prototype”int hencSetScale( double value )Function
Section titled “Function”- This function is used to specify the scale value of the map. It specifies the value of N in the map scale value expressed by 1: N.
- This value determines the reduction ratio of the screen by calculating the appropriate ratio from the pixel size on the actual screen specified by the or function.
- It is interlocked with the function, and only the units are different.
Parameters
Section titled “Parameters”value : IN (Scale)
Return Value
Section titled “Return Value”- = 0 : Success
- < 0 : Fail
hencSetRotation
Section titled “hencSetRotation”Prototype
Section titled “Prototype”int hencSetRotation( double deg )Function
Section titled “Function”Specify the angle of rotation of the map on the screen.
Parameters
Section titled “Parameters”deg : IN (CW, degree)
Return Value
Section titled “Return Value”- = 0 : Success
- < 0 : Fail
hencGetRotation
Section titled “hencGetRotation”Prototype
Section titled “Prototype”double hencGetRotation()Function
Section titled “Function”Obtain the angle of rotation of the map currently displayed on the screen.
Parameters
Section titled “Parameters”None
Return Value
Section titled “Return Value”Map rotation angle. CW(Unit: Degree)
hencSetMapArea
Section titled “hencSetMapArea”Prototype
Section titled “Prototype”int hencSetMapArea( double minx, double miny, double maxx, double maxy )Function
Section titled “Function”Set the map scale value so that the area of the specified square block is displayed in the map display area. At this time, the rotation value is set to zero.
Parameters
Section titled “Parameters”- double minx : IN (longitude, Minimum longitude value in the area)
- double miny : IN (latitude, Minimum latitude value in the area값)
- double maxx : IN (longitude, Maximum longitude value in the area)
- double maxy : IN (latitude, Maximum latitude value in the area)
Return Value
Section titled “Return Value”- = 0 : Success
- < 0 : Fail
hencGetMapArea
Section titled “hencGetMapArea”Prototype
Section titled “Prototype”int hencGetMapArea( double &minx, double &miny, double &maxx, double &maxy )Function
Section titled “Function”Obtains the latitude and longitude coordinates of the map currently displayed on the screen.
Parameters
Section titled “Parameters”- double &minx : OUT (longitude, Minimum longitude value in the area)
- double &miny : OUT (latitude, Minimum latitude value in the area)
- double &maxx : OUT (longitude, Maximum longitude value in the area)
- double &maxy : OUT (latitude, Maximum latitude value in the area)
Return Value
Section titled “Return Value”- = 0 : Success
- < 0 : Fail
The value obtained by this function may be different from the value set by function.
hencSetMapParameter
Section titled “hencSetMapParameter”Prototype
Section titled “Prototype”int hencSetMapParameter( double cx, double cy, double zoom, double rotation)Function
Section titled “Function”- Center coordinates, magnification ratio, and rotation are set at once.
Parameters
Section titled “Parameters”- double cx : IN (Center longitude of display area, degree)
- double cy : IN (Center latitude of display area, degree)
- double zoom : IN (Map scaling rate, Ratio of 1 latitude to 1 pixel on screen)
- double rotation : IN (Map rotation angle, CW, degree)
Return Value
Section titled “Return Value”- = 0 : Success
- < 0 : Fail
hencGetMapParameter
Section titled “hencGetMapParameter”Prototype
Section titled “Prototype”int hencGetMapParameter( double &cx, double &cy, double &zoom, double &rotation )Function
Section titled “Function”Obtains screen settings collectively.
Parameters
Section titled “Parameters”- double &cx : OUT (Center longitude of display area, degree)
- double &cy : OUT (Center latitude of display area, degree)
- double &zoom : OUT (Map zoom ration, Ratio of 1 latitude to 1 pixel on screen)
- double &rotation : OUT (Map rotation angle, CW, degree)
Return Value
Section titled “Return Value”- = 0 : Success
- < 0 : Fail
hencIsMapRectInView
Section titled “hencIsMapRectInView”Prototype
Section titled “Prototype”bool hencIsMapRectInView( double minx, double miny, double maxx, double maxy )Function
Section titled “Function”It is checked whether or not the specified area is partially included in the display area.
Parameters
Section titled “Parameters”- double minx : IN (longitude, Minimum longitude value in the area)
- double miny : IN (latitude, Minimum latitude value in the area)
- double maxx : IN (longitude, Maximum longitude value in the area)
- double maxy : IN (latitude, Maximum latitude value in the area)
Return Value
Section titled “Return Value”- true : Indicates that the specified area is partially contained within the screen
- false : Indicates that the specified area is out of the screen
hencIsGlRectInView
Section titled “hencIsGlRectInView”Prototype
Section titled “Prototype”bool hencIsGlRectInView( double minx, double miny, double maxx, double maxy )Function
Section titled “Function”It is checked whether or not the specified area is partially included in the display area.
Parameters
Section titled “Parameters”- double minx : IN (GIPos, Minimum x value in the area)
- double miny : IN (GIPos, Minimum y value in the area)
- double maxx : IN (GIPos, Maximum x value in the area)
- double maxy : IN (GIPos, Maximum y value in the area)
Return Value
Section titled “Return Value”- true : Indicates that the specified area is partially contained within the screen
- false : Indicates that the specified area is out of the screen