/**
* @ingroup hangulic
* @brief 키 입력을 처리하여 실제로 한글 조합을 하는 함수
* @param hic @ref HangulInputContext 오브젝트
* @param ascii 키 이벤트
* @return @ref HangulInputContext 가 이 키를 사용했으면 true,
* 사용하지 않았으면 false
*
* ascii 값으로 주어진 키 이벤트를 받아서 내부의 한글 조합 상태를
* 변화시키고, preedit, commit 스트링을 저장한다.
*
* libhangul의 키 이벤트 프로세스는 ASCII 코드 값을 기준으로 처리한다.
* 이 키 값은 US Qwerty 자판 배열에서의 키 값에 해당한다.
* 따라서 유럽어 자판을 사용하는 경우에는 해당 키의 ASCII 코드를 직접
* 전달하면 안되고, 그 키가 US Qwerty 자판이었을 경우에 발생할 수 있는
* ASCII 코드 값을 주어야 한다.
* 또한 ASCII 코드 이므로 Shift 상태는 대문자로 전달이 된다.
* Capslock이 눌린 경우에는 대소문자를 뒤바꾸어 보내주지 않으면
* 마치 Shift가 눌린 것 처럼 동작할 수 있으므로 주의한다.
* preedit, commit 스트링은 hangul_ic_get_preedit_string(),
* hangul_ic_get_commit_string() 함수를 이용하여 구할 수 있다.
*
* 이 함수의 사용법에 대한 설명은 @ref hangulicusage 부분을 참조한다.
*
* @remarks 이 함수는 @ref HangulInputContext 의 상태를 변화 시킨다.
*/
bool
hangul_ic_process(HangulInputContext *hic, int ascii)
{
ucschar c;
if (hic == NULL)
return false;
hic->preedit_string[0] = 0;
hic->commit_string[0] = 0;
c = hangul_keyboard_get_mapping(hic->keyboard, 0, ascii);
if (hic->on_translate != NULL)
hic->on_translate(hic, ascii, &c, hic->on_translate_data);
if (ascii == '\b') {
return hangul_ic_backspace(hic);
}
int type = hangul_keyboard_get_type(hic->keyboard);
switch (type) {
case HANGUL_KEYBOARD_TYPE_JASO:
case HANGUL_KEYBOARD_TYPE_JASO_YET:
return hangul_ic_process_jaso(hic, c);
case HANGUL_KEYBOARD_TYPE_ROMAJA:
return hangul_ic_process_romaja(hic, ascii, c);
default:
return hangul_ic_process_jamo(hic, c);
}
}
/**
* @ingroup hangulic
* @brief 키 입력을 처리하여 실제로 한글 조합을 하는 함수
* @param hic @ref HangulInputContext 오브젝트
* @param ascii 키 이벤트
* @return @ref HangulInputContext가 이 키를 사용했으면 true,
* 사용하지 않았으면 false
*
* ascii 값으로 주어진 키 이벤트를 받아서 내부의 한글 조합 상태를
* 변화시키고, preedit, commit 스트링을 저장한다.
*
* libhangul의 키 이벤트 프로세스는 ASCII 코드 값을 기준으로 처리한다.
* 이 키 값은 US Qwerty 자판 배열에서의 키 값에 해당한다.
* 따라서 유럽어 자판을 사용하는 경우에는 해당 키의 ASCII 코드를 직접
* 전달하면 안되고, 그 키가 US Qwerty 자판이었을 경우에 발생할 수 있는
* ASCII 코드 값을 주어야 한다.
* 또한 ASCII 코드 이므로 Shift 상태는 대문자로 전달이 된다.
* Capslock이 눌린 경우에는 대소문자를 뒤바꾸어 보내주지 않으면
* 마치 Shift가 눌린 것 처럼 동작할 수 있으므로 주의한다.
* preedit, commit 스트링은 hangul_ic_get_preedit_string(),
* hangul_ic_get_commit_string() 함수를 이용하여 구할 수 있다.
*
* 이 함수의 사용법에 대한 설명은 @ref hangulicusage 부분을 참조한다.
*
* @remarks 이 함수는 @ref HangulInputContext의 상태를 변화 시킨다.
*/
bool
hangul_ic_process(HangulInputContext *hic, int ascii)
{
ucschar c;
if (hic == NULL)
return false;
hic->preedit_string[0] = 0;
hic->commit_string[0] = 0;
c = hangul_keyboard_get_value(hic->keyboard, ascii);
if (hic->on_translate != NULL)
hic->on_translate(hic, ascii, &c, hic->on_translate_data);
if (hangul_keyboard_get_type(hic->keyboard) == HANGUL_KEYBOARD_TYPE_JAMO)
return hangul_ic_process_jamo(hic, c);
else if (hangul_keyboard_get_type(hic->keyboard) == HANGUL_KEYBOARD_TYPE_JASO)
return hangul_ic_process_jaso(hic, c);
else
return hangul_ic_process_romaja(hic, ascii, c);
}
