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)