gblt.h

某中文手写输入法公司的手写识别输入的实例源程序。

//Create at 2003-5-20 19:59:42 by abing
#ifndef __EBEN_H_
#define __EBEN_H_

//#pragma warning(disable:4103)
//#pragma	pack(1)

#include "GBLt_def.h"

/*
ENInputStruct : is the data tranfering between engine and engine's user.
*/
typedef struct __en_input_struct
{
    /*
    (in)inputString : the input number string.
    number '0' matches punctuations like ' and - in word.
    for example if you want to input A-bomb, you should 
    input number 202662. AAfter you changed inputString, 
    firstly you should fill inputLen with the length of 
    inputString, secondly you should invoke EnFirstHeader
    to get a header. Thirdly you should invoke EnFirstPage 
    /EnNextPage/EnPrevPage to get some candidates.
    */
    EN_WORD             inputString;

    /*
    (in)inputLen : the len of inpuString
    it should be smaller than EN_INPUT_MAX_LEN
    */
    unsigned char       inputLen;
#if LATIN_ENCODE_LENGTH == 2
	unsigned char 		unused1;
#endif

    /*
    (out)header: a string which is match the inputString 
    and at least one valid word is begin with. 
    engine's user should not modify this member. 
    for example : when user input "23", the first header will 
    be "be", and candidates is "be", "bedroom", "bedbug"....
    */
    EN_WORD             header;
    /*
    (in)candidateDesireLen : the max of sum length of all 
    candidates. when calculating the sum engine will add 1 byte 
    length between each candidate 
    for example : if the candidates are "able" "absent" "abandon" 
    the sum length is 4 + 1 + 6 + 1 + 7 = 19. Generally speaking 
    if you want to display candidates in one line horizontally,
    you should set this member with the count of charaters which 
    you can display in one time. Before you invoke EnStartup, 
    you must set this member with a value between 0 and 
    EN_MAX_DESIRE_LEN. if you specify 0 to this member when 
    you invoke EnStartup, the engine will not care about this 
    member when finding candidates. so engine will try to find as 
    many as candidateDesireCount describe candidates. When invoke 
    EnStartUp, at least one of candidateDesireLen and 
    candidateDesireCount is to be greater than 0. this value should 
    not be changed after invoking EnStartup
    */
    unsigned char       candidateDesireLen;
    /*
    (in)candidateDesireCount :   at least one of 
    candidateDesireLen and candidateDesireCount should be greater than 0.
    */
	unsigned char		candidateDesireCount;
    /*
    (out)candidateCount :       store the count of all candidates.
    */
    unsigned char       candidateCount;
#if LATIN_ENCODE_LENGTH == 2
        unsigned char 		unused2;
#endif
        /*
    (out)candidates :           store each candidate
    */
    EN_WORD             candidates[EN_CANDIDATE_MAX_COUNT + 1];
    /*
    (out)headerIsAWord :  1 indicate the string store in header is a word, 
    otherwise will be 0.
    */
    unsigned char       headerIsAWord;
#if LATIN_ENCODE_LENGTH == 2
        unsigned char 		unused3;
#endif
    
    /*
    (in)
    EN_OPTION_DONT_ADJUST_CHAR_ORDER :  
        在输出字母候选的时候不要根据语言的特性进行候选的顺序调整
    EN_OPTION_OUTPUT_NORMAL :
        输出的时候使用智能大小写的形式，单个字母的时候小写在前
    EN_OPTION_OUTPUT_FCC : 
        输出的时候使用首字母大写的形式
    EN_OPTION_OUTPUT_CAPITAL : 
        输出的时候使用全部大写的使用，单个字母的时候大写在前
    EN_OPTION_OUTPUT_LOWER:
        输出的时候全部使用小写
    EN_OPTION_OUTPUT_LOWER_CHAR:
        单个字母的时候只输出小写字母，其他时候输出普通的单词
    EN_OPTION_OUTPUT_CAPITAL_CHAR:
        单个字母的时候只输出大写字母，其他时候输出普通的单词
	EN_OPTION_DONT_ADD_HEADER:
		header不要出现在候选
    */
    unsigned short      option;

} ENInputStruct, * pENInputStruct;


#include "GBLt_func.h"

#endif