henc · 객체·심볼·정보

객체 추출, 수심 정보, S-52 ENC 심볼, S-57/S-52 정보 조회

hencSelectObj

함수 원형

int hencSelectObj( HENCOBJECT obj )

기능

지정한 객체(Object)를 선택된 모양으로 전시하도록 설정한다.

인자

함수를 이용하여 검색한 객체 핸들값(Object handle)

반환값

= 0 : 성공
< 0 : 실패

hencPickObj

함수 원형

int hencPickObj( double x, double y, list &listObjs )

기능

검색되는 객체는 현재 화면의 전시 설정에 따라 대상이 제한된다. 지정된 좌표에서 현재 배율로 화면 상의 약 10 pixel 범위 이내의 점, 선, 영역이 검색된다.
단, 현재 표시하지 않고 있는 객체나 지도셀은 검색에서 제외된다.

인자

double x : IN (경도, degree)
double y : IN (위도, degree)
list &listObjs : IN, OUT (검색된 객체의 고유 핸들값 목록)

반환값

= 0 : 성공
< 0 : 실패

hencObjToString

함수 원형

void hencObjToString( HENCOBJECT obj, string &str )

기능

해당 객체에 대한 세부 정보를 문자열 형태로 변환해 준다.

인자

HENCOBJECT obj : IN (ENC 특성객체 핸들값)
hencPickObj()로부터 획득한 값이어야 한다.
string &str : IN, OUT (객체에 대한 상세 정보를 포함하고 있는 문자열)

반환값

없음

hencGetFilenameOfObj

함수 원형

const char *hencGetFilenameOfObj( HENCOBJECT obj )

기능

해당 객체를 포함하고 있는 파일을 검색하여 파일명을 추출한다.

인자

로부터 획득한 값이어야 한다.

반환값

!= NULL : 파일명, Null로 종료된 문자열
== NULL : 파일명을 찾을 수 없음(실패)

hencObjGetCode

함수 원형

EEncObject hencObjGetCode( HENCOBJECT obj )

기능

해당 객체의 S-57 객체코드(Object Code) 값을 알아낸다.

인자

hencPickObj()로부터 획득한 값이어야 한다.

반환값

S-57 특성객체 카탈로그(Feature Object Catalog) 참조

hencObjGetPrimType

함수 원형

EObjectPrimitiveType hencObjGetPrimType( HENCOBJECT obj )

기능

해당 객체의 S-57 객체의 Primitive Type(점, 선, 면)을 알아낸다.

인자

HENCOBJECT obj : IN (ENC 특성객체 핸들값)
로부터 획득한 값이어야 한다.

반환값

해당 객체의 S-57 특성객체 Primitive Type 참조

hencObjGetPoints

함수 원형

int hencObjGetPoints( HENCOBJECT obj, S_OBJ_POLYGON *data )

기능

해당 객체의 S-57 객체 좌표 정보를 획득한다.

인자

HENCOBJECT obj : IN (ENC 특성객체 핸들값)
로부터 획득한 값이어야 한다.
S_OBJ_POLYGON * data : IN, OUT (S_OBJ_POLYGON *data)
다음 형태의 구조체로, 폴리폴리곤의 정보를 담고 있다.

반환값

== 0 : 성공
< 0 : 실패

hencDepthmapGenerate

함수 원형

HENCDEPTHMAP hencDepthmapGenerate()

기능

현재 로드된 모든 ENC 지도셀(Map Cell)로부터 수심 정보 만을 수집한다.

인자

없음

반환값

!= 0 : 생성된 수심 정보의 핸들값
== 0 : 실패

hencDepthmapSave

함수 원형

int hencDepthmapSave( HENCDEPTHMAP hdd, const char *fn )

기능

생성된 수심 정보의 집합을 파일로 저장한다.

인자

HENCDEPTHMAP hdd : IN ( 함수로 생성한 수심 정보 핸들값)
const char * fn : IN (수심 정보 저장 파일명)

반환값

= 0 : 성공
< 0 : 실패

hencDepthmapLoad

함수 원형

HENCDEPTHMAP hencDepthmapLoad( const char *fn )

기능

수심 정보 파일로부터 수심 정보 집합을 읽어 들인다.

인자

const char *fn : IN (수심 정보 저장 파일명)

반환값

!= 0 : 읽어온 수심 정보의 핸들값
== 0 : 실패

hencDepthmapGetData

함수 원형

int hencDepthmapGetData( HENCDEPTHMAP hdd, double x, double y, double &dep1, double &dep2 )

기능

수심 정보 집합에서 특정 좌표의 수심 정보를 검색한다.

인자

HENCDEPTHMAP hdd : IN (수심 정보 집합의 핸들값)
double x : IN (수심 정보 검색 위치의 경도, degree)
double y : IN (수심 정보 검색 위치의 위도, degree)
double &dep1 : OUT (최저 수심)
double &dep2 : OUT (최대 수심)

반환값

= 0 : 성공
< 0 : 실패

hencDepthmapDelete

함수 원형

int hencDepthmapDelete( HENCDEPTHMAP hdd )

기능

수심 정보 집합이 점유하고 있는 메모리를 해제한다.

인자

HENCDEPTHMAP hdd : IN (수심 정보 집합의 핸들값)

반환값

= 0 : 성공
< 0 : 실패

hencGetEncSymbolCount

함수 원형

int hencGetEncSymbolCount()

기능

사용 가능한 S-52 심볼의 개수를 획득한다.

인자

없음

반환값

라이브러리에서 사용 가능한 심벌의 개수

hencGetEncSymbolName

함수 원형

const char *hencGetEncSymbolName( int no )

기능

S-52 심볼 번호에 대한 문자열의 이름을 획득한다.

인자

int no : IN (심볼 번호)

반환값

!= NULL : 심볼 이름, Null로 종료된 문자열
S-52 표준 문서에 명시된 이름과 동일
== NULL : 실패 (잘못된 심볼 번호)

hencDrawEncSymbol

함수 원형

int hencDrawEncSymbol( const char *name )

기능

S-52 심볼을 화면에 전시한다.

인자

const char *name : IN (Null로 종료된 문자열)
S-52 표준 문서에 명시된 이름과 동일

반환값

= 0 : 성공
< 0 : 실패

hencDrawEncSymbolAtGlPos

함수 원형

int hencDrawEncSymbolAtGlPos( const char *name, double x, double y, double z, double angle = 0, double scale = 1.0 )

기능

S-52 심볼을 화면에 전시한다.

인자

const char *name : IN (Null로 종료된 문자열, S-52 표준 문서에 명시된 이름과 동일)
double x : IN (OpenGL 좌표계 x값)
double y : IN (OpenGL 좌표계 y값)
double z : IN (OpenGL 좌표계 z값)
double angle : IN (CW, 회전 각도, degree)
double scale : IN (확대/축소 값)

반환값

= 0 : 성공
< 0 : 실패

hencDrawEncSymbolAtWinPos

함수 원형

int hencDrawEncSymbolAtWinPos( const char *name, double x, double y )

기능

S-52 심볼을 화면에 전시한다.

인자

const chat *name : IN (Null로 종료된 문자열, S-52 표준 문서에 명시된 이름과 동일)
double x : IN (Window GDI 좌표계 x값)
double y : IN (Window GDI 좌표계 y값)

반환값

= 0 : 성공
< 0 : 실패

hencDrawEncSymbolAtMapPos

함수 원형

int hencDrawEncSymbolAtMapPos( const char *name, double x, double y )

기능

S-52 심볼을 화면에 전시한다.

인자

const char *name : IN (Null로 종료된 문자열, S-52 표준 문서에 명시된 이름과 동일)
double x : IN (경도, degree)
double y : IN (위도, degree)

반환값

= 0 : 성공
< 0 : 실패

hencGetEncLineCount

함수 원형

int hencGetEncLineCount()

기능

사용 가능한 S-52 Complex Line의 개수를 획득한다.

인자

없음

반환값

라이브러리에서 사용이 가능한 Complex Line의 개수

hencGetEncLineName

함수 원형

const char *hencGetEncLineName( int no )

기능

S-52 Complex Line 번호에 대한 문자열의 이름을 획득한다.

인자

int no : IN (Complex Line 번호)

반환값

!= NULL : Complex Line 번호 문자열 이름, Null로 종료된 문자열
S-52 표준 문서에 명시된 이름과 동일
== NULL : 실패 (잘못된 번호)

hencDrawEncLineAtGlPos

함수 원형

int hencDrawEncLineAtGlPos( LPCTSTR name, double x1, double y1, double x2, double y2, double z )

기능

S-52 Complex Line을 화면에 전시한다.

인자

LPCTSTR name : IN (Null로 종료된 문자열, 으로 획득하는 이름을 사용)
double x1 : IN (라인 시점의 x값, OpenGL 좌표계)
double y1 : IN (라인 시점의 y값, OpenGL 좌표계)
double x2 : IN (라인 종점의 x값, OpenGL 좌표계)
double y2 : IN (라인 종점의 y값, OpenGL 좌표계)
double z : IN (라인의 z값, OpenGL 좌표계)

반환값

= 0 : 성공
< 0 : 실패

hencDrawEncLineAtWinPos

함수 원형

int hencDrawEncLineAtWinPos( const char *name, double x1, double y1, double x2, double y2, double z )

기능

S-52 Complex Line을 화면에 전시한다.

인자

LPCTSTR name : IN (Null로 종료된 문자열, 으로 획득하는 이름을 사용)
double x1 : IN (라인 시점의 x값, Windows GDI 좌표계)
double y1 : IN (라인 시점의 y값, Windows GDI 좌표계)
double x2 : IN (라인 종점의 x값, Windows GDI 좌표계)
double y2 : IN (라인 종점의 y값, Windows GDI 좌표계)
double z : IN (라인의 z값, OpenGL 좌표계)

반환값

= 0 : 성공
< 0 : 실패

hencDrawEncLineAtMapPos

함수 원형

int hencDrawEncLineAtMapPos( LPCTSTR name, double x1, double y1, double x2, double y2, double z )

기능

S-52 Complex Line을 화면에 전시한다.

인자

LPCTSTR name : IN (Null로 종료된 문자열, 으로 획득하는 이름을 사용)
double x1 : IN (라인 시점의 x값, degree, 위경도 좌표계)
double y1 : IN (라인 시점의 y값, degree, 위경도 좌표계)
double x2 : IN (라인 종점의 x값, degree, 위경도 좌표계)
double y2 : IN (라인 종점의 y값, degree, 위경도 좌표계)
double z : IN (라인의 z값, OpenGL 좌표계)

반환값

= 0 : 성공
< 0 : 실패

hencGetEncPatternCount

함수 원형

int hencGetEncPatternCount()

기능

사용 가능한 S-52 Fill 패턴의 개수를 획득한다.

인자

없음

반환값

라이브러리에서 사용이 가능한 Fill 패턴의 개수

hencGetEncPatternName

함수 원형

const char * hencGetEncPatternName( int no )

기능

S-52 Fill 패턴 번호에 대한 문자열 이름을 획득한다.

인자

int no : IN (Fill 패턴 번호)

반환값

!= NULL : 패턴 번호 문자열 이름, Null로 종료된 문자열
S-52 표준 문서에 명시된 이름과 동일
== NULL : 실패 (잘못된 패턴 번호)

hencDrawEncPatternFillAtGlPos

함수 원형

int hencDrawEncPatternFillAtGlPos( LPCTSTR name, int cntPts, double *x, double *y, double z )

기능

S-52 Fill 패턴으로 주어진 영역을 채운다.

인자

LPCTSTR name : IN (Null로 종료된 문자열, S-52 Fill 패턴 이름)
int cntPts : 영역 Polygon 좌표의 개수
double *x : IN (영역 Polygon x 좌표 배열, OpenGL 좌표계)
double *y : IN (영역 Polygon y 좌표 배열, OpenGL 좌표계)
double z : IN (라인의 z값, OpenGL 좌표계, 모든 좌표 동일)

반환값

= 0 : 성공
< 0 : 실패

hencDrawEncPatternFillAtWinPos

함수 원형

int hencDrawEncPatternFillAtWinPos( LPCTSTR name, int cntPts, double *x, double *y )

기능

S-52 Fill 패턴으로 주어진 영역을 채운다.

인자

LPCTSTR name : IN (Null로 종료된 문자열, S-52 Fill 패턴 이름)
int cntPts : 영역 Polygon 좌표의 개수
double *x : IN (영역 Polygon x 좌표 배열, Windows GDI 좌표계)
double *y : IN (영역 Polygon y 좌표 배열, Windows GDI 좌표계)

반환값

= 0 : 성공
< 0 : 실패

hencDrawEncPatternFillAtMapPos

함수 원형

int hencDrawEncPatternFillAtMapPos( LPCTSTR name, int cntPts, double *x, double *y )

기능

S-52 Fill 패턴으로 주어진 영역을 채운다.

인자

LPCTSTR name : IN (Null로 종료된 문자열, S-52 Fill 패턴 이름)
int cntPts : 영역 Polygon 좌표의 개수
double *x : IN (영역 Polygon 경도 좌표 배열)
double *y : IN (영역 Polygon 위도 좌표 배열)

반환값

= 0 : 성공
< 0 : 실패

hencGetColor

함수 원형

COLORREF hencGetColor( EEncColor color )

기능

S-52 Color 참조

인자

EEncColor color : IN (S-52 색상(color) 코드 값)

반환값

색상 RGB 값

함수 원형

COLORREF hencGetColor( EEncColorset setNo, EEncColor color )

기능

S-52 Color 참조

인자

EEncColorset setNo : 취득을 원하는 색상 지정
EEncColor color : IN (S-52 색상(color) 코드 값)

반환값

색상 RGB 값

함수 원형

COLORREF hencGetColor( const char *acronym )

기능

S-52 Color 참조

인자

const char *acronym : IN (S-52 color acronym 문자열)

반환값

색상 RGB 값

hencGetColorName

함수 원형

const char * hencGetColorName( EEncColor color )

기능

색상 코드에 해당하는 acronym을 획득한다.

인자

EEncColor color : IN (S-52 색상 코드)

반환값

!= NULL : S-52 color acronym 문자열
== NULL : 실패 (잘못된 문자열)

hencGetPrimName

함수 원형

const char * hencGetPrimName( EObjectPrimitiveType t )

기능

S-57 ENC Object Primitive Type 참조

인자

EObjectPrimitiveType t : IN (S-57 ENC Object Primitive Type)

반환값

!= NULL : 문자열
== NULL : 실패

hencGetObjectName

함수 원형

const char * hencGetObjectName( EEncObject obj )

기능

S-57 Feature Object Code에 해당하는 acronym 문자열을 획득한다.

인자

EEncObject obj : IN (S-57 Feature Object Code)

반환값

!= NULL : 문자열
== NULL : 실패

hencGetObjectDesc

함수 원형

const char * hencGetObjectDesc( EEncObject obj )

기능

S-57 Feature Object Code에 해당하는 description 문자열을 획득한다.

인자

EEncObject obj : IN (S-57 Feature Object Code)

반환값

!= NULL : 문자열
== NULL : 실패

hencGetAttrName

함수 원형

const char * hencGetAttrName( EEncAttr attr )

기능

S-57 Feature Attribute Code에 해당하는 acronym 문자열을 획득한다.

인자

EEncAttr attr : IN (S-57 Feature Attribute Code)

반환값

!= NULL : 문자열
== NULL : 실패

hencEnumAttr

함수 원형

EEncAttr hencEnumAttr( const char *acronym )

기능

S-57 Feature Attribute acronym에 해당하는 코드값을 획득한다.

인자

const char *acronym : IN (S-57 Feature Attribute acronym 문자열)

반환값

S-57 Feature Attribute Code

hencEnumObjectName

함수 원형

EEncObject hencEnumObjectName( const char *acronym )

기능

S-57 Feature Object acronym에 해당하는 코드값을 획득한다.

인자

const char *acronym : IN (S-57 Feature Object acronym 문자열)

반환값

S-57 Feature Object Code