Optional API


Summary

인식엔진 내부에서 사용하는 외부 리소스의 경로를 설정하거나, 인식엔진의 버전을 리턴하는 API 등으로 구성되어 있습니다.

Functions List

// 엔진내부에서 사용하는 외부리소스(*.hdb 등)의 경로 설정
unsigned long DHWRSetExternalResourcePath(const char *path)
// 엔진내부에서 사용하는 외부라이브러리의 경로 설정
unsigned long DHWRSetExternalLibraryPath(const char *path)
// 특정 타입의 파라미터 값을 반환함
unsigned long DHWRGetParam(const unsigned long type, void *param)
// 특정 타입의 파라미터 값을 설정함
unsigned long DHWRSetParam(const unsigned long type, const void *param)
// 엔진의 빌드넘버를 반환함
unsigned long DHWRGetRevision(char **revision)
// License key에 설정된 엔진의 due date를 반환함
unsigned long DHWRGetDueDate(int *due_date)
DHWRSetExternalResourcePath

엔진내부에서 사용하는 외부리소스(*.hdb 등)의 경로 설정

Parameters
# Name Description Type
[in] path 리소스 경로 const char *
Returns

Error Code

Example
unsigned long status = ERR_SUCCESS;
status = DHWRSetExternalResourcePath("./hdb");
Note
리소스의 경로는 상대경로 또는 절대경로 둘다 사용가능하다.
DHWRSetExternalLibraryPath

엔진내부에서 사용하는 외부라이브러리의 경로 설정

Parameters
# Name Description Type
[in] path 외부라이브러리의 경로 const char *
Returns

Error Code

Example
unsigned long status = ERR_SUCCESS;
status = DHWRSetExternalLibraryPath("./lib");
Note
라이브러리의 경로는 상대경로 또는 절대경로 둘다 사용가능하다.
DHWRGetParam

특정 타입의 파라미터 값을 반환함

Parameters
# Name Description Type
[in] type 파라미터 타입 const unsigned long
[out] param 파리미터 값의 포인터 void *
Returns

Error Code

DHWRSetParam

특정 타입의 파라미터 값을 설정함

Parameters
# Name Description Type
[in] type 파라미터 타입 const unsigned long
[in] param 파리미터 값의 포인터 const void *
Returns

Error Code

DHWRGetRevision

엔진의 빌드넘버를 반환함

Parameters
# Name Description Type
[out] revision 엔진 빌드넘버 char **
Returns

Error Code

Example
char *revision = NULL;
DHWRGetRevision(&revision);
DHWRGetDueDate

License key에 설정된 엔진의 due date를 반환함

Parameters
# Name Description Type
[out] due_date License key의 due date int *
Returns

Error Code

Example
int due_date = -1;
DHWRGetDueDate(&due_date);
Note
•  License key의 due date가 존재하지 않을 경우 due date 초기 값 = 0
•  due date는 년월일을 나타내는 8자리의 integer 값 (ex 20161206)
// 엔진내부에서 사용하는 외부리소스(*.hdb 등)의 경로 설정
public static extern int SetExternalResourcePath(String path)
// 엔진내부에서 사용하는 외부라이브러리의 경로 설정
public static extern int SetExternalLibraryPath(String path)
// 특정 타입의 파라미터 값을 반환함
public static extern int GetParam(int type, [In, Out] ref int param)
// 특정 타입의 파라미터 값을 설정함
public static extern int SetParam(int type, [In, Out] ref int param)
// 엔진의 빌드넘버 스트링의 포인터를 반환함
public static extern int GetRevisionPtr(IntPtr[] revision)
// GetRevisionPtr()와 동일한 기능을 하며, GetRevisionPtr()를 사용하기 쉽도록 wrapping한 함수
public static String GetRevision()
// License key에 설정된 엔진의 due date를 반환함
public static extern int GetDueDate([In, Out] ref int due_date)
SetExternalResourcePathstatic

엔진내부에서 사용하는 외부리소스(*.hdb 등)의 경로 설정

Parameters
# Name Description Type
[in] path 리소스 경로 String
Returns

Error Code

Example
int status = Hwr.ERR_SUCCESS;
status = Hwr.SetExternalResourcePath("./hdb");
Note
리소스의 경로는 상대경로 또는 절대경로 둘다 사용가능하다.
SetExternalLibraryPathstatic

엔진내부에서 사용하는 외부라이브러리의 경로 설정

Parameters
# Name Description Type
[in] path 외부라이브러리의 경로 String
Returns

Error Code

Example
int status = Hwr.ERR_SUCCESS;
status = Hwr.SetExternalLibraryPath("./lib");
Note
라이브러리의 경로는 상대경로 또는 절대경로 둘다 사용가능하다.
GetParamstatic

특정 타입의 파라미터 값을 반환함

Parameters
# Name Description Type
[in] type 파라미터 타입 int
[out] param 파리미터 값의 포인터 ref int
Returns

Error Code

SetParamstatic

특정 타입의 파라미터 값을 설정함

Parameters
# Name Description Type
[in] type 파라미터 타입 int
[in] param 파리미터 값의 포인터 ref int
Returns

Error Code

GetRevisionPtrstatic

엔진의 빌드넘버 스트링의 포인터를 반환함

Parameters
# Name Description Type
[out] revision 엔진 빌드넘버 IntPtr[]
Returns

Error Code

Example
IntPtr[] version = new IntPtr[1];
Hwr.GetRevisionPtr(version);
return Marshal.PtrToStringAnsi(version[0]);
GetRevisionstatic

엔진의 빌드넘버 스트링을 반환함
GetRevisionPtr()와 동일한 기능을 하며, GetRevisionPtr()를 사용하기 쉽도록 wrapping한 함수

Returns

엔진의 빌드넘버 스트링

GetDueDatestatic

License key에 설정된 엔진의 due date를 반환함

Parameters
# Name Description Type
[out] due_date License key의 due date ref int
Returns

Error Code

Example
int dueDate = -1;
Hwr.GetDueDate(ref dueDate);
Note
•  License key의 due date가 존재하지 않을 경우 due date 초기 값 = 0
•  due date는 년월일을 나타내는 8자리의 integer 값 (ex 20161206)
// 엔진내부에서 사용하는 외부리소스(*.hdb 등)의 경로 설정
public final static native int SetExternalResourcePath(char[] path)
// 엔진내부에서 사용하는 외부라이브러리의 경로 설정
public final static native int SetExternalLibraryPath(char[] path)
// 특정 타입의 파라미터 값을 반환함
public final static native int GetParam(int type, byte[] param)
// 특정 타입의 파라미터 값을 설정함
public final static native int SetParam(int type, byte[] param)
// 엔진의 빌드넘버를 반환함
public final static native int GetRevision(char[] revision)
// License key에 설정된 엔진의 due date를 반환함
public final static native int GetDueDate(int[] dueDate)
SetExternalResourcePathstatic

엔진내부에서 사용하는 외부리소스(*.hdb 등)의 경로 설정

Parameters
# Name Description Type
[in] path 리소스 경로 char[]
Returns

Error Code

Example
int status = DHWR.ERR_SUCCESS;
final String filesPath = getFilesDir().getAbsolutePath();
status = DHWR.SetExternalResourcePath(filesPath.toCharArray());
Note
리소스의 경로는 상대경로 또는 절대경로 둘다 사용가능하다.
SetExternalLibraryPathstatic

엔진내부에서 사용하는 외부라이브러리의 경로 설정

Parameters
# Name Description Type
[in] path 외부라이브러리의 경로 char[]
Returns

Error Code

Example
int status = DHWR.ERR_SUCCESS;
status = DHWR.SetExternalLibraryPath(getApplicationInfo().nativeLibraryDir.toCharArray());
Note
라이브러리의 경로는 상대경로 또는 절대경로 둘다 사용가능하다.
GetParamstatic

특정 타입의 파라미터 값을 반환함

Parameters
# Name Description Type
[in] type 파라미터 타입 int
[out] param 파리미터 값 byte[]
Returns

Error Code

SetParamstatic

특정 타입의 파라미터 값을 설정함

Parameters
# Name Description Type
[in] type 파라미터 타입 int
[in] param 파리미터 값 byte[]
Returns

Error Code

GetRevisionstatic

엔진의 빌드넘버 스트링을 반환함

Parameters
# Name Description Type
[out] revision 엔진 빌드넘버 char[]
Returns

Error Code

Example
final int MAX_VERSION_LENGTH = 64;
char[] version = new char[MAX_VERSION_LENGTH];
DHWR.GetRevision(version);
return String.valueOf(version).trim();
GetDueDatestatic

License key에 설정된 엔진의 due date를 반환함

Parameters
# Name Description Type
[out] dueDate License key의 due date int[]
Returns

Error Code

Example
int[] dueDate = new int[1];
DHWR.GetDueDate(dueDate);
return dueDate[0];
Note
•  License key의 due date가 존재하지 않을 경우 due date 초기 값 = 0
•  due date는 년월일을 나타내는 8자리의 integer 값 (ex 20161206)