henc · 좌표·뷰포트

중심 좌표·줌·스케일·회전·지도 영역 설정

hencSetCenter

함수 원형

int hencSetCenter( double cx, double cy )

기능

지도 전시의 중심점을 지정하기 위해 사용한다.

인자

double cx : IN (경도, degree)
double cy : IN (위도, degree)

반환값

= 0 : 성공
< 0 : 실패

hencGetCenter

함수 원형

int hencGetCenter( double &cx, double &cy )

기능

현재 지도의 중심점을 획득하기 위해 사용한다.

인자

double &cx : OUT (경도, degree)
double &cy : OUT (위도, degree)

반환값

= 0 : 성공
< 0 : 실패

hencGetCenterX

함수 원형

double hencGetCenterX()

기능

현재 지도의 중심점의 경도값을 획득한다.

인자

없음

반환값

지도 중심점의 경도값

hencGetCenterY

함수 원형

double hencGetCenterY()

기능

현재 지도의 중심점의 위도값을 획득한다.

인자

없음

반환값

지도 중심점의 위도값

hencSetZoom

함수 원형

int hencSetZoom( double scale )

기능

지도의 확대 비율을 지정하기 위한 함수로서 위경도 1도와 화면 1픽셀의 비율을 지정한다.
함수와 연동되며, 오직 단위만 다르다.

인자

scale : IN (확대 비율)

반환값

= 0 : 성공
< 0 : 실패

hencGetZoom

함수 원형

double hencGetZoom()

기능

지도의 확대 비율을 획득하기 위한 함수로서 위경도 1도와 화면 1 pixel의 비율을 지정한다.
함수와 연동이 되며, 단위만 차이가 있다.

인자

없음

반환값

지도 확대 비율값

hencGetScale

함수 원형

double hencGetScale()

기능

이 값은 또는 함수로 지정된 실제 화면 상의 픽셀 크기 대비 실제 거리의 비율을 나타내는 값이다.

인자

없음

반환값

축적값

hencSetScale

함수 원형

int hencSetScale( double value )

기능

지도의 축척값을 지정하기 위한 함수로서 1:N 으로 표현되는 지도 축적 값에서의 N 값을 지정한다.
이 값은 또는 함수로 지정된 실제 화면상의 픽셀 크기로부터 적절한 비율을 계산하여 화면의 축소 비율을 결정한다.
함수와 연동이 되며, 단위만 차이가 있다.

인자

value : IN (축척 값)

반환값

= 0 : 성공
< 0 : 실패

hencSetRotation

함수 원형

int hencSetRotation( double deg )

기능

화면상에서 지도의 회전 각도를 지정한다.

인자

deg : IN (CW 방향, degree 단위의 회전 각도)

반환값

= 0 : 성공
< 0 : 실패

hencGetRotation

함수 원형

double hencGetRotation()

기능

현재 화면에 표시되고 있는 지도의 회전 각도를 획득한다.

인자

없음

반환값

지도 회전 값. CW(단위 degree)

hencSetMapArea

함수 원형

int hencSetMapArea( double minx, double miny, double maxx, double maxy )

기능

지정한 사각 블럭의 영역이 지도 전시 영역에 표시되도록 지도 배율 값을 설정한다. 이 때 회전값은 0으로 지정된다.

인자

double minx : IN (경도, 영역 내 최소 경도 값)
double miny : IN (위도, 영역 내 최소 위도 값)
double maxx : IN (경도, 영역 내 최대 경도 값)
double maxy : IN (위도, 영역 내 최대 위도 값)

반환값

= 0 : 성공
< 0 : 실패

hencGetMapArea

함수 원형

int hencGetMapArea( double &minx, double &miny, double &maxx, double &maxy )

기능

현재 화면에서 지도 정보가 있는 영역 전체의 위경도 좌표를 획득한다.

인자

double &minx : OUT (경도, 영역 내 최소 경도 값)
double &miny : OUT (위도, 영역 내 최소 위도 값)
double &maxx : OUT (경도, 영역 내 최대 경도 값)
double &maxy : OUT (위도, 영역 내 최대 위도 값)

반환값

= 0 : 성공
< 0 : 실패

주의사항

이 함수가 획득하는 값은 로 설정된 값과는 다를 수도 있다.

hencSetMapParameter

함수 원형

int hencSetMapParameter( double cx, double cy, double zoom, double rotation)

기능

중심 좌표, 확대 비율, 회전을 한꺼번에 설정

인자

double cx : IN (지도 전시 중심점 경도, degree)
double cy : IN (지도 전시 중심점 위도, degree)
double zoom : IN (지도 확대 비율  경위도 1도와 화면 1픽셀의 비율)
double rotation : IN (지도 화면 각도, CW, degree)

반환값

= 0 : 성공
< 0 : 실패

hencGetMapParameter

함수 원형

int hencGetMapParameter( double &cx, double &cy, double &zoom, double &rotation )

기능

화면 설정을 일괄적으로 획득한다.

인자

double &cx : OUT (지도 전시 중심점 경도, degree)
double &cy : OUT (지도 전시 중심점 위도, degree)
double &zoom : OUT (지도 확대 비율  경위도 1도와 화면 1픽셀의 비율)
double &rotation : OUT (지도 화면 각도, CW, degree)

반환값

= 0 : 성공
< 0 : 실패

hencIsMapRectInView

함수 원형

bool hencIsMapRectInView( double minx, double miny, double maxx, double maxy )

기능

지정 영역이 전시 화면내에 일부라도 포함되어 있는 지 여부를 검사한다.

인자

double minx : IN (경도, 영역 내 최소 경도 값)
double miny : IN (위도, 영역 내 최소 위도 값)
double maxx : IN (경도, 영역 내 최대 경도 값)
double maxy : IN (위도, 영역 내 최대 위도 값)

반환값

true : 지정 영역이 화면 내에 일부라도 포함되어 있음을 의미
false : 지정 영역이 화면을 벗어나 있음을 의미

hencIsGlRectInView

함수 원형

bool hencIsGlRectInView( double minx, double miny, double maxx, double maxy )

기능

지정 영역이 전시 화면내에 일부라도 포함되어 있는 지 여부를 검사한다.

인자

double minx : IN (GIPos, 영역 내 최소 x 값)
double miny : IN (GIPos, 영역 내 최소 y 값)
double maxx : IN (GIPos, 영역 내 최대 x 값)
double maxy : IN (GIPos, 영역 내 최대 y 값)

반환값

true : 지정 영역이 화면 내에 일부라도 포함되어 있음을 의미
false : 지정 영역이 화면을 벗어나 있음을 의미