include/unihan_im.h

Go to the documentation of this file.

//
// Unihan Input Method
//
// Copyright © 2002-2007 Sun Wah Linux Ltd.
//
//
// This library is free software; you can redistribute it and/or modify
// it under the terms of the GNU Lesser General Public License as
// published by the Free Software Foundation; either version 2.1 of the
// License, or (at your option) any later version.
//
// This library is distributed in the hope that it will be useful, but
// WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this program; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307
// USA
//
// $Id: unihan_im.h 815 2007-08-22 03:16:28Z roger $
//

#ifndef __UNIHAN_IM_H
#define __UNIHAN_IM_H

#include <stdlib.h>
#if NEW_PROPERTY
#include "unihan_property.h"
#endif

#ifdef __cplusplus
extern "C" {
#endif

typedef struct _UnihanIM UnihanIM;            
typedef struct _UnihanMethods UnihanMethods;  
typedef struct _UnihanStyleList UnihanStyleList;
typedef struct _UnihanStyle UnihanStyle;
typedef struct _UnihanLookupDraw UnihanLookupDraw;
typedef struct _UnihanLookupStart UnihanLookupStart;

typedef enum {
    UNIHAN_TCSC_NO_CONV = 0,
    UNIHAN_TCSC_TO_SIMPLIFIED = 1,
    UNIHAN_TCSC_TO_TRADITIONAL = 2,
    UNIHAN_TCSC_AUTO_TO_SIMPLIFIED = 3,     
    UNIHAN_TCSC_AUTO_TO_TRADITIONAL = 4     
} UnihanTCSCMode;

typedef enum {
    UserName = 1,
    HostName = 2,
    ProtocolType = 3,
    ClientType = 4,
    DisplayID = 5,
    OSName = 6,
    OSVersion = 7,
    OSArch = 8
} UnihanClientInfoType;

typedef enum {
    UNIHAN_LOG_LEVEL_ERROR      = 1 << 2,
    UNIHAN_LOG_LEVEL_CRITICAL   = 1 << 3,
    UNIHAN_LOG_LEVEL_WARNING    = 1 << 4,
    UNIHAN_LOG_LEVEL_MESSAGE    = 1 << 5,
    UNIHAN_LOG_LEVEL_INFO       = 1 << 6,
    UNIHAN_LOG_LEVEL_DEBUG      = 1 << 7
} UnihanLogLevelFlags;

struct _UnihanMethods {
    int (*send_buffer)          (UnihanIM *uim,
                                 void *buf,
                                 size_t buf_size);

    int (*config_get)           (UnihanIM *uim,
                                 char *key,
                                 char **value,
                                 long *len);

    int (*config_set)           (UnihanIM *uim,
                                 char *key,
                                 char *value,
                                 long len);

    int (*preedit_draw)         (UnihanIM *uim, 
                                 char *s, 
                                 UnihanStyleList *styles);

    int (*preedit_caret_pos)    (UnihanIM *uim, 
                                 int caretPos);

    int (*preedit_change)       (UnihanIM *uim, 
                                 char *s, 
                                 UnihanStyleList *styles,
                                 int pos, 
                                 int len, 
                                 int caretPos);

    int (*preedit_erase)        (UnihanIM *uim);

    int (*lookup_start)         (UnihanIM *uim,
                                 UnihanLookupStart *lustart);

    int (*lookup_draw)          (UnihanIM *uim,
                                 UnihanLookupDraw *ludraw);

    int (*lookup_done)          (UnihanIM *uim);

    int (*status_draw)          (UnihanIM *uim, 
                                 char *s, 
                                 UnihanStyleList *styles);

    int (*commit_string)        (UnihanIM *uim, 
                                 char *s);

    int (*locale_get)           (UnihanIM *uim,
                                 char **locale);

    int (*tcsc_mode_get)        (UnihanIM *uim,
                                 UnihanTCSCMode *tcscMode);

    int (*tcsc_do_conv)         (UnihanIM *uim,
                                 UnihanTCSCMode tcscMode,
                                 char *orig,
                                 char **converted);

    int (*mem_alloc)            (UnihanIM *uim,
                                 size_t len,
                                 void **mem);

    int (*client_info_get)      (UnihanIM *uim,
                                 UnihanClientInfoType type,
                                 char **info);

    int (*is_fullwidth)         (UnihanIM *uim);

    int (*is_chinesepunc)       (UnihanIM *uim);

    int (*is_shuangpin)         (UnihanIM *uim);

    int (*beep)                 (UnihanIM *uim);

    int (*match_phrase)         (UnihanIM *uim,
                                 char *s);

    void (*log)                 (UnihanIM *uim,
                                 UnihanLogLevelFlags log_level,
                                 const char *format,
                                 ...);

#if NEW_PROPERTY
    int (*properties_register)  (UnihanIM *uim,
                                 const UnihanPropertyList *property_list, 
                                 char* imid);
    int (*properties_update)    (UnihanIM *uim,
                                 const UnihanPropertyList *property_list);
#endif
};

struct _UnihanIM {
    void *privateData;  // privateData is just the im-sdk session struct
    char *id;           
    char *module_id;    
    char *host_name;
    char *user_name;

    void *imUserData;

    void *desktopUserData;

    void *sessionUserData;

    UnihanMethods *m;   
};

typedef enum {
    SHIFT_MODIFIER = 1,
    CTRL_MODIFIER = 2,
    META_MODIFIER = 4,
    ALT_MODIFIER = 8,
    ALT_GRAPH_MODIFIER = 32
} IMKeyModifier;

typedef enum {
    IM_NOTHING = -1,
    IM_FOCUS = 1,
    IM_KEY = 2,
    IM_CONFIG_CHANGE = 3,
    IM_SWITCH = 4,
    IM_PROPERTY_TOGGLED = 5,
    IM_PROPERTY_REGISTER = 6,
    IM_USER_TABLE = 7,
    IM_LOOKUP_PAGE_TURN = 8,
    IM_LOOKUP_SELECT = 9
} IMEventType;

typedef struct _IMKeyEvent {
    IMEventType type;
    int keyCode;
    int keyChar;
    int modifier;
} IMKeyEvent;

typedef struct _IMFocusEvent {
    IMEventType type;
    int focused;
} IMFocusEvent;

typedef struct _IMConfigChangeEvent {
    IMEventType type;
    char *key;
    int value;
} IMConfigChangeEvent;

typedef struct _IMSwitchEvent {
    IMEventType type;
    int on;
} IMSwitchEvent;

typedef struct _IMPropertyToggledEvent {
    IMEventType type;
    char *key;
} IMPropertyToggledEvent;

typedef struct _IMPropertyRegisterEvent {
    IMEventType type;
    char *imid;
} IMPropertyRegisterEvent;

typedef struct _IMUserTableEvent {
    IMEventType type;
    void *table;
    int numItem;
} IMUserTableEvent;

typedef struct _IMLookupPageTurn {
    IMEventType type;
    int direction;
} IMLookupPageTurnEvent;

typedef struct _IMLookupSelect {
    IMEventType type;
    int num;
} IMLookupSelectEvent;

typedef union _IMEvent {
    IMEventType type;
    IMKeyEvent key;
    IMFocusEvent focus;
    IMConfigChangeEvent configChange;
    IMSwitchEvent switched;
    IMPropertyToggledEvent propertyToggled;
    IMPropertyRegisterEvent propertyRegister;
    IMUserTableEvent table;
    IMLookupPageTurnEvent lookupPageTurn;
    IMLookupSelectEvent lookupSelect;
} IMEvent;

typedef struct _IMMethods {
    int (*init)(UnihanIM *);
    int (*done)(UnihanIM *);
    int (*create_session)(UnihanIM *);
    int (*destroy_session)(UnihanIM *);
    int (*handle_event)(UnihanIM *, IMEvent *);
} IMMethods;

typedef struct _IMInfo IMInfo;
struct _IMInfo {
    char *id;
    char *name;
    char *version;
    void *imUserData;
    IMMethods *methodTable;
    IMInfo *next;
#if NEW_PROPERTY
    UnihanPropertyArgList proplist;
    IMConfig *config;
#endif
};

typedef enum {
    UNIHAN_IM_API_VERSION = 1,
    UNIHAN_IM_MODULE_ID = 2,
    UNIHAN_IM_MODULE_NAME = 3,
    UNIHAN_IM_MODULE_VERSION = 4,
    UNIHAN_IM_MODULE_IM_LIST = 5
} UnihanIMModuleArgID;

typedef struct {
    UnihanIMModuleArgID id;
    void *value;
} UnihanIMModuleArgList;

struct _UnihanStyleList {
    unsigned int numStyles;
    UnihanStyle *style;
};

typedef enum {
    UNIHAN_STYLE_DECORATION = 0,
    UNIHAN_STYLE_FOREGROUND_RGB = 1,
    UNIHAN_STYLE_BACKGROUND_RGB = 2
} UnihanStyleType;

#define UNIHAN_RGB_COLOR(red,green,blue)  (int)((red<<16) + (green<<8) + blue)

struct _UnihanStyle {
    UnihanStyleType type;
    int value;
};

typedef enum {
    UNIHAN_LOOKUP_DIRECTION_RIGHT = 0,
    UNIHAN_LOOKUP_DIRECTION_DOWN = 1
} UnihanLookupDirection;

struct _UnihanLookupStart {
    int choicePerWindow;
    int numColumns;
    int numRows;
    UnihanLookupDirection direction;
};

typedef enum {
    UNIHAN_LOOKUP_MODE_NORMAL = 0,
    UNIHAN_LOOKUP_MODE_PHRASE = 1
} UnihanLookupMode;

struct _UnihanLookupDraw {
    UnihanLookupMode mode;
    int numChoices;
    int selected;
    int currentChoice;
    int totalChoices;
    char *title;
    char **label;
    UnihanStyleList *labelStyles;
    char **value;
    UnihanStyleList *valueStyles;
};

typedef struct _SymbolUserTable {
    int modifier;
    int keyCode;
    char *symbol;
} SymbolUserTable;

typedef struct _WordUserTable {
    char *key;
    char *word;
} WordUserTable;

#ifndef TRUE
# define TRUE 1
#endif

#ifndef FALSE
# define FALSE 0
#endif

#ifdef __cplusplus
}
#endif

#endif /* __UNIHAN_IM_H */

// vi:ts=4:sw=4:nowrap:cin:expandtab

---