package mozc.commands

Get desktop application:
View/edit binary Protocol Buffers messages

Annotation against a candidate.

Used in: CandidateWord, Candidates.Candidate

• optional string prefix = 1

  Annotation prepended to the value.

• optional string suffix = 2

  Annotation appended to the value.

• optional string description = 3

  Type of the candidate such as [HALF][KATAKANA], [GREEK], [Black square], etc...

• optional string shortcut = 4

  Shortcut key to select this candidate.

• optional bool deletable = 5

  Set to true if this candidate can be deleted from history.

Note there is another ApplicationInfo inside RendererCommand. Since Input is not using nested message, define ApplicationInfo here.

Used in: Input

• optional uint32 process_id = 1

• optional uint32 thread_id = 2

• optional int32 timezone_offset = 3

  The time difference between local time and UTC time in seconds. This field is not supported except for NaCl. We use this field in NaCl Mozc because we can't know the local timezone in NaCl environment.

Used in: Output

• optional uint32 focused_index = 1

  This value represents the focused position of the next |candidates|. If the |candidates| is a part of the whole candidate words (as a result of paging), this value indicates the position from the beginning of that part. (ex. where |candidates| contatins 10th to 18th candidates, focused_index=0 means the 10th candidate, but not 1st candidate. The existense of |focused_index| does not represents whether this candidate list is a 'suggestion' or not. |category| represents it.

• repeated CandidateWord candidates = 2

• optional Category category = 3

  Category of the candidates.

Used in: CandidateList

• optional int32 id = 1

  Unique number specifing the candidate. This may be a negative value.

• optional uint32 index = 2

  The first index should be zero and index numbers should increase by one.

• optional string key = 3

  Reading of the value. The value is only used when the key is different from the input composition (e.g. suggestion/prediction).

• optional string value = 4

  Converted value. (e.g. Kanji value).

• optional Annotation annotation = 5

TODO(komatsu) rename it to CandidateWindow.

Used in: Output, session.SessionState

• optional uint32 focused_index = 1

  TODO(komatsu): Use CandidateList. When has_focused_index() is true, this message contains predicted and normally converted candidates. Otherwise, when the field is not set, this message contains a 'suggestion'.

• required uint32 size = 2

  The size of the total candidates in this candidate list. The value does not include the size of subcandidate lists. Note, the next repeated-Candidate=3 may not contain all candidates. all_candidates contains the values of subcandidate lists.

• repeated group mozc.commands.Candidates.Candidate = 3

• required uint32 position = 6

  The position on the preedit. The number represents the left edge of the candidate window.

• optional Candidates subcandidates = 8

  Nested candidates aka cascading window.

• optional InformationList usages = 10

  Usages of candidates.

• optional Category category = 11

  TODO(komatsu): Use CandidateList. Category of the candidates

• optional DisplayType display_type = 12

  Information to be used for rendering.

• optional Footer footer = 13

  Footer of the GUI window.

• optional Candidates.Direction direction = 14

• optional Rectangle composition_rectangle = 15

  This position is used for suggest window position.

• optional Rectangle caret_rectangle = 16

• optional Candidates.CandidateWindowLocation window_location = 17

TODO(komatsu): Use CandidateList.

Used in: Candidates

• required uint32 index = 4

  The first index should be zero and index numbers should increase by one.

• required string value = 5

• optional int32 id = 9

  Unique number specifing the candidate.

• optional Annotation annotation = 7

• optional int32 information_id = 10

Used in: Candidates

• CARET = 0

  Shows candidate window under the caret. This is used for prediction and conversion

• COMPOSITION = 1

  Shows candidate window aligned with composition area. This is used for suggestion.

The direction of candidates in the window. This is just a suggestion from the server and client does not have to follow.

Used in: Candidates

• VERTICAL = 0

• HORIZONTAL = 1

Clients' capability. Users cannot modify this. The server has to obey this capability.

Used in: Input

• optional Capability.TextDeletionCapabilityType text_deletion = 1

Bit fields to notify what the client can do.

Used in: Capability

• NO_TEXT_DELETION_CAPABILITY = 0

• DELETE_PRECEDING_TEXT = 1

  Can delete preceding text which is adjacent to preedit.

Category describes the attribute of the words.

Used in: CandidateList, Candidates, InformationList

• CONVERSION = 0

• PREDICTION = 1

• SUGGESTION = 2

• TRANSLITERATION = 3

• USAGE = 4

Used in: CommandList

• required Input input = 1

• required Output output = 2

• repeated Command commands = 1

  This message is used for unittest.

This enum is used by SessionCommand::input_mode with CHANGE_INPUT_MODE and Output::mode.

Used in: KeyEvent, Output, SessionCommand, Status

• DIRECT = 0

• HIRAGANA = 1

• FULL_KATAKANA = 2

• HALF_ASCII = 3

• FULL_ASCII = 4

• HALF_KATAKANA = 5

• NUM_OF_COMPOSITIONS = 6

Used in: Input

• optional string preceding_text = 1

  Former part of surrounding text.

• optional string following_text = 2

  Latter part of surrounding text.

• optional bool suppress_suggestion = 3

  If this is true, suggestion feature is disabled regardless the congiguration. If this is false, suggestion feature is followed by the user's configuration. If you want to omit interim suggestions during the key typing, you might want to use request_suggestion. TODO(komatsu): Delete this field and use experimental_features.

• optional Context.InputFieldType input_field_type = 4

  Type of the input field being focused.

• optional int32 revision = 5

  An unique revision ID to specify one specific typing session. A client can use arbitrary value for this field. The converter is expected to clear its internal history segments whenever this value is changed. A client should use the same revision ID whenever the converter should keep it internal history segments. In order to avoid unexpected history learnings, a client should update the revision whenever the input focus is changed.

• repeated string experimental_features = 100

  Repeated fields to be used for experimental features.

Input field type. The types are based on the input types defined in HTML5. http://dev.w3.org/html5/spec/Overview.html#attr-input-type Other types are to be added later.

Used in: Context, session.SessionState

• NORMAL = 1

  No restrictions nor special functions. The IME operates as usual.

• PASSWORD = 2

  Password field. Text is hidden after input. For Android, In order to make the last character visible to the user, the IME must not hold more than 2 characters in preedit.

• TEL = 3

  Telephone number

• NUMBER = 4

  Number

This messsage contains which characters are to be deleted by client. E.g. if current composition and surrounding text are "この感じは漢字は" ^^^^^^ and we send DeletionRange with offset == -3 and length == 3, then they will be rendered like: "この漢字は" ^^^^^^

Used in: Output

• optional int32 offset = 1

  Offset of start of range.

• optional int32 length = 2

  Length of the range.

DisplayType is a hint to UI renderers describing how the words are displayed.

Used in: Candidates, InformationList

• MAIN = 0

• CASCADE = 1

Message representing the footer part of the candidate window.

Used in: Candidates

• optional string label = 1

  Message shown like a status bar.

• optional bool index_visible = 2

  Whether index (e.g. 10/120) is visible or not.

• optional bool logo_visible = 3

  Whether the logo image is visible or not.

• optional string sub_label = 4

  Message modestly shown. It is used for displaying the version on dev-channel now.

Used in: Input, Output

• optional GenericStorageEntry.StorageType type = 1

• optional string key = 2

• repeated bytes value = 3

  The type must be bytes instead of string because value might have U+0000 character as a terminator. In this case, characters after the terminator are undefined. Such byte stream cannot be treaed by Java's String class, which is used for PB's string type. Instead, PB's bytes type is converted into ByteString in Java, which can treat C laguage style string described above.

Used in: GenericStorageEntry

• SYMBOL_HISTORY = 0

• EMOTICON_HISTORY = 1

• EMOJI_HISTORY = 2

Additional information to a candidate word. This message is used for describing a word usage for instance.

Used in: InformationList

• optional int32 id = 1

  Unique number specifying the information.

• optional string title = 2

  Title string of the information. For usage, this value is probably equal to Candidate::value or its canonicalized value.

• optional string description = 3

  The content of the information. For usage, this value actually describes how to use the word.

• repeated int32 candidate_id = 4

  The IDs of candidates which connect with the information.

Used in: Candidates

• optional uint32 focused_index = 1

• repeated Information information = 2

• optional Category category = 3

  Category of the infolist.

• optional DisplayType display_type = 4

  Information to be used for rendering.

• optional uint32 delay = 5

  How long rendere needs to wait before the infolist is displayed. the default setting is 500 msec.

Used in: Command

• required Input.CommandType type = 1

• optional uint64 id = 2

  Session ID created by CREATE_SESSION.

• optional KeyEvent key = 3

  Key combinations used for SEND_KEY or TEST_SEND_KEY.

• optional SessionCommand command = 4

  Command sent to the session layer used with SEND_COMMAND.

• optional config.Config config = 5

  Input config

• optional Context context = 6

  Context data

• optional Capability capability = 7

  Client capability

• optional ApplicationInfo application_info = 8

  Application information, like process id. Server may be able to change the behavior by seeing the the program name.

• optional Request request = 9

  Client request

• optional GenericStorageEntry storage_entry = 10

  If the command is INSERT_TO_STORAGE, all the fields must be filled. If READ_ALL_FROM_STORAGE, key and value fields are ignored.

• repeated Input.TouchEvent touch_events = 12

• optional user_dictionary.UserDictionaryCommand user_dictionary_command = 13

• optional bool request_suggestion = 14

  A flag to control if the server should return suggest-results or not. If this is set to false, regardless of other configurations, the server won't return suggestion results. This is set to true by default. Note that even if this flag is set to false, when a suggestion is shown in the previous phase, it is possible from the client to submit it. This works only for suggestions for the key insersion, but not for others commands, such as predictions or conversions. This flag is used for the performance improvement in terms of the latency. If you want to suppress the suggestions for the UX improment, you may want to use suppress_suggestion in the Context message.

Used in: Input

• NONE = 0

• CREATE_SESSION = 1

• DELETE_SESSION = 2

• SEND_KEY = 3

• TEST_SEND_KEY = 4

  Check only if the key event will be consumed. This command is for TSF on Windows. You do not need to use this command, if it is not necessary.

• SEND_COMMAND = 5

  Evaluate the command specified by SessionCommand. The output format should be the same with an output of a SEND_KEY command.

• GET_CONFIG = 6

  Config accessors. There are three configurations. Stored config, Imposed config, One-shot config. Stored config : Set by SET_CONFIG command. Its lifetime is permanent (stored into a storage). GET_CONFIG returns stored config. Imposed config : Set by SET_IMPOSED_CONFIG. Its lifetime is the same as the process (*not* stored into a storage as opposed to Stored config). Imposed config is prioritized over Stored config. Only the values explicitly set are effective and override ones in Stored config. In typical usage, most fields are not set. GET_CONFIG's result is *not* affected by imposed config (stored config returns). One-shot config : Set by each key events. It is effective while the key event is processed. This is prioritized over Imposed config. Like as Imposed config, some fields can be omitted. TODO(matsuzakit): Rename (GET|SET)_CONFIG to (GET|SET)_STORED_CONFIG

• SET_CONFIG = 7

• SET_IMPOSED_CONFIG = 22

• SET_REQUEST = 17

  Set client's request

• SYNC_DATA = 8

  sync dictionary/history data to local file

• SHUTDOWN = 9

  shutdowon server safely

• RELOAD = 10

  reload mutable data (like config, user-dic, history)

• CLEAR_USER_HISTORY = 11

  clear user history data

• CLEAR_USER_PREDICTION = 12

  clear user prediction data

• CLEAR_UNUSED_USER_PREDICTION = 16

  clear unused prediction

• CLEANUP = 13

  clean up sessions shutdwon if session is empty and mozc_server is launched with timeout mode

• NO_OPERATION = 14

  no operation can be used for pinging the server

• OBSOLETE_START_CLOUD_SYNC = 18

  Sync feature is deprecated since 1.13 dev. TODO(mozc-team): Remove following variables.

• OBSOLETE_GET_CLOUD_SYNC_STATUS = 23

• OBSOLETE_ADD_AUTH_CODE = 24

• INSERT_TO_STORAGE = 20

• READ_ALL_FROM_STORAGE = 21

• CLEAR_STORAGE = 25

• SEND_USER_DICTIONARY_COMMAND = 26

  Send a command for user dictionary session.

• NUM_OF_COMMANDS = 27

  Number of commands. When new command is added, the command should use below number and NUM_OF_COMMANDS should be incremented. Note: This enum lack the value for 15 and 19 and it may cause a crash. Please reuse these value if you can. 15 have never been used before, and 19 was used to clear synced data on dev channel.

Used in: TouchPosition

• TOUCH_DOWN = 1

• TOUCH_MOVE = 2

• TOUCH_UP = 3

TouchEvent contains source_id and stroke. Touch_events contain all key touch event. Statistical information are collected for each source_id by SessionUsageObserver.

Used in: Input

• optional uint32 source_id = 1

  source_id specifies the user action such as "X button pressed". It must be unique within the same keyboard_name, which is set in Request message.

• repeated TouchPosition stroke = 2

Used in: TouchEvent

• optional TouchAction action = 1

• optional float x = 2

  x, y potision: keyboad left-top is (0, 0), right-bottom is (1, 1).

• optional float y = 3

• optional int64 timestamp = 4

  timestamp (in ms) is set to zero when the touch event starts.

Used in: Input, Output

• optional uint32 key_code = 1

  Printable key in UCS4. If key_code is empty, key_string is used as a raw input.

• optional uint32 modifiers = 2

  Going to be obsolete.

• optional KeyEvent.SpecialKey special_key = 3

  Unprintable key listed above.

• repeated KeyEvent.ModifierKey modifier_keys = 4

  ModifierKeys

• optional string key_string = 5

  String used for preedit. Kana characters and strings typed from a software keyboard are supposed to be stored here. If key_code is also set, key_code is treated as the raw input and key_string is treated as the composition input. For example, to set Kana value, when key_string is "ち", key_code should be 'a' (97). If key_code is empty, key_string is also treated as the raw input.

• optional KeyEvent.InputStyle input_style = 6

• optional CompositionMode mode = 7

  Input mode For histrical reasons, this field expects a temporary conversion mode rather than comeback input mode.

• repeated KeyEvent.ProbableKeyEvent probable_key_event = 8

  Probable key events Even if you can fill this field, don't omit Input.key_code and so on because preedit string is composed based on them.

• optional bool activated = 9

  IME on/off mode You can use this field to change the IME on/off mode indirectly without sending SpecialKey:ON or SpecialKey:OFF events. If the internal ImeContext::State is DIRECT and this field is true, the converter will change the state to PRECONPOSITION and then handles this key event. If the internal ImeContext::State is not DIRECT and this field is false, the converter will change the state to DIRECT and then handles this key event. Implementation note: We need both |mode| and |activated| to support indirect IME off, where |mode| should contain the next mode. If this field is not set, the server will act as if indirect on/off was not supported.

Used in: KeyEvent

• FOLLOW_MODE = 0

  Follow the current input mode (default).

• AS_IS = 1

  Do not transliterate key_string and use it as-is.

• DIRECT_INPUT = 2

  Immediately output key_string on the precomposition mode. Same with AS_IS on the preedit mode.

Used in: KeyEvent, ProbableKeyEvent

• CTRL = 1

• ALT = 2

• SHIFT = 4

• KEY_DOWN = 8

• KEY_UP = 16

• LEFT_CTRL = 32

• LEFT_ALT = 64

• LEFT_SHIFT = 128

• RIGHT_CTRL = 256

• RIGHT_ALT = 512

• RIGHT_SHIFT = 1024

• CAPS = 2048

Probable key event, mainly for touch screen. User's input has ambiguity (e.g. the touch position is merginal) so this message expresses the probable event.

Used in: KeyEvent

• optional uint32 key_code = 1

  message ID is the same as Input message.

• optional SpecialKey special_key = 3

  Unprintable key listed above.

• repeated ModifierKey modifier_keys = 4

  ModifierKeys

• optional double probability = 10

  Sum of probabilities must be lesser or equal than 1. 0<= probability <= 1

Used in: KeyEvent, ProbableKeyEvent

• NO_SPECIALKEY = 0

• DIGIT = 1

• ON = 2

  On Windows, SpecialKey::On and SpecialKey::OFF are obsolete. Use TURN_ON_IME session command should be used instead. See b/10216365. On other platforms, especially on Mac, please note that client/client.cc still relies on SpecialKey::On for session playback. We need to fix b/10250883 first. TODO(team): Unsupport SpecialKey::On and SpecialKey::OFF.

• OFF = 3

• SPACE = 4

• ENTER = 5

• LEFT = 6

• RIGHT = 7

• UP = 8

• DOWN = 9

• ESCAPE = 10

• DEL = 11

  not DELETE because DELETE is reserved in MSVC

• BACKSPACE = 12

• HENKAN = 13

• MUHENKAN = 14

• KANA = 15

  VK_DBE_HIRAGANA(Win), kVK_JIS_Kana(Mac)

• HOME = 16

  TODO(toshiyuki): It is better to rename this to HIRAGANA In Windows, we have Katakana and it may confusing.

• END = 17

• TAB = 18

• F1 = 19

• F2 = 20

• F3 = 21

• F4 = 22

• F5 = 23

• F6 = 24

• F7 = 25

• F8 = 26

• F9 = 27

• F10 = 28

• F11 = 29

• F12 = 30

• PAGE_UP = 31

• PAGE_DOWN = 32

• INSERT = 33

• F13 = 34

• F14 = 35

• F15 = 36

• F16 = 37

• F17 = 38

• F18 = 39

• F19 = 40

• F20 = 41

• F21 = 42

• F22 = 43

• F23 = 44

• F24 = 45

• EISU = 46

  alphanumeric VK_DBE_ALPHANUMERIC(Win), kVK_JIS_Eisu(Mac)

• NUMPAD0 = 47

• NUMPAD1 = 48

• NUMPAD2 = 49

• NUMPAD3 = 50

• NUMPAD4 = 51

• NUMPAD5 = 52

• NUMPAD6 = 53

• NUMPAD7 = 54

• NUMPAD8 = 55

• NUMPAD9 = 56

• MULTIPLY = 57

  Numpad [*]

• ADD = 58

  Numpad [+]

• SEPARATOR = 59

  Numpad [enter]

• SUBTRACT = 60

  Numpad [-]

• DECIMAL = 61

  Numpad [.]

• DIVIDE = 62

  Numpad [/]

• EQUALS = 63

  Numpad [=]

• TEXT_INPUT = 64

  Meta key event representing any text input.

• HANKAKU = 65

• KANJI = 66

• KATAKANA = 67

  VK_DBE_KATAKANA(Win)

• CAPS_LOCK = 68

• UNDEFINED_KEY = 69

  Unsupported keys (e.g. PrtSc, Pause) fall back to UNDEFINED_KEY.

• COMMA = 70

  Numpad [,]

• CLEAR = 71

  Numpad [5] without NUMLOCK

• NUM_SPECIALKEYS = 72

Used in: Command, RendererCommand

• optional uint64 id = 1

• optional CompositionMode mode = 2

  This variable is going to be obsolete.

• optional bool consumed = 3

• optional Result result = 4

• optional Preedit preedit = 5

• optional Candidates candidates = 6

• optional KeyEvent key = 7

• optional string url = 8

  when URL is non empty, UI can open the page with a browser, after finishing the all rendering part. We are using this feature for bug-report system.

• optional config.Config config = 9

  Output config

• optional Output.PreeditMethod preedit_method = 10

• optional Output.ErrorCode error_code = 11

• optional Status status = 13

  The current IME status.

• optional CandidateList all_candidate_words = 14

  All flatten candidate words stored in 1D array. This value is filled only when the content is changed.

• optional DeletionRange deletion_range = 16

  Range of characters to be deleted by client.

• optional Output.ToolMode launch_tool_mode = 17

• optional Output.Callback callback = 18

• optional GenericStorageEntry storage_entry = 19

  Used when the command is READ_ALL_FROM_STORAGE.

• optional user_dictionary.UserDictionaryCommandStatus user_dictionary_command_status = 21

Callback request to the client.

Used in: Output

• optional SessionCommand session_command = 1

  Callback command to be sent from the client to the server. The optional values such as id and composition_mode can be modified or added by the client.

• optional uint32 delay_millisec = 2

  Callback command should be sent after this delay.

ErrorCode: if SessionHandler::EvalCommand() returns false, return output with error_code = SESSION_FAILURE;

Used in: Output

• SESSION_SUCCESS = 0

• SESSION_FAILURE = 1

PreeditMethod: this is the default input mode of the session. If the user's config is "kana-input", it returns KANA. Only CreateSession response will have this field.

Used in: Output

• ASCII = 0

• KANA = 1

if launch_tool_mode is set, MozcTool is supposed to be launched by client.

Used in: Output

• NO_TOOL = 0

  no need to launch tool

• CONFIG_DIALOG = 1

• DICTIONARY_TOOL = 2

• WORD_REGISTER_DIALOG = 3

Preedit represents a composition data, which is rendered on the host application by the ime client. On Japanese IME, the both Preedit and Conversion statuses are represented by this message.

Used in: Output, session.SessionState

• required uint32 cursor = 1

• repeated group mozc.commands.Preedit.Segment = 2

• optional uint32 highlighted_position = 3

  The position of the first segment whose annotation is 'HIGHLIGHT'. Not set if there are no such segments.

The string data of Preedit is separated into Segment messages presenting the ime server's status. On Preedit status of Japanese IME, there are up to three segments; left side chars of cursor, forcused char, right side chars of cursor. On Conversion status of Japanese IME, the messages literally represent the segments of the conversion.

Used in: Preedit

• required Segment.Annotation annotation = 3

• required string value = 4

• required uint32 value_length = 5

  The length of value in characters. This is NOT a number in bytes or logical character units. So, the length of "abc" and "あいう" should be 3, "ヴ" should be 1 and "ｳﾞ" and "う゛" should be 2.

• optional string key = 6

  Source of the value. It is almost always the reading of the value.

Used in: Segment

• NONE = 0

• UNDERLINE = 1

• HIGHLIGHT = 2

TODO(nona): merge to RendererCommand::Rectangle

Used in: Candidates, SessionCommand

• required int32 x = 1

• required int32 y = 2

• required int32 width = 3

• required int32 height = 4

• optional RendererCommand.CommandType type = 1

• optional bool visible = 2

  set visibility if visible is false, the content of output is basically ignored.

• optional Output output = 3

• optional RendererCommand.Rectangle preedit_rectangle = 4

  Preedit rectangle

• optional RendererCommand.ApplicationInfo application_info = 5

Application information Mozc UI is attaching

Used in: RendererCommand

• optional uint32 process_id = 1

• optional uint32 thread_id = 2

• optional uint32 receiver_handle = 3

  used in Windows: WHND of the message-only window:

• optional uint32 target_window_handle = 4

  used in Windows: HWND of the window where composition is displayed.

• optional WinLogFont composition_font = 5

  used in Windows: Preffered font for composition string.

• optional ApplicationInfo.InputFrameworkType input_framework = 6

  Specifies which IM Framework is used in the client.

• optional CompositionForm composition_form = 7

  used in Windows: Specifies where and how the renderer process shows the composition window (if necessary).

• optional CandidateForm candidate_form = 8

  used in Windows: Specifies where and how the renderer process shows the candidate window (if necessary). Currently only one candidate window is supported. TODO(yukawa): support multiple candidate windows.

• optional int32 ui_visibilities = 9

  used in Windows:

  ShowUIDefault

• optional CharacterPosition composition_target = 10

  used in Windows: Specifies the target position in composition window.

• optional CaretInfo caret_info = 11

  used in Windows: Represents caret information.

• optional ApplicationInfo.MessageSenderType message_sender_type = 12

• optional string pango_font_description = 13

  A string representation of PangoFontDescription http://developer.gnome.org/pango/stable/pango-Fonts.html#pango-font-description-from-string This field is not application specific information but temporaly locate here. TODO(nona): Make new message if necessary.

• optional IndicatorInfo indicator_info = 14

  used in Windows:

Represents IM Framework used in the client. Currently only Windows IM frameworks are supported.

Used in: ApplicationInfo

• UNKNOWN_FRAMEWORK = 0

  Default. For backward compatibility.

• TSF = 1

• IMM32 = 2

• IMKit = 3

• IBus = 4

Renderer sends RendererCommand to renderer itself in order to extend InfoList.

Used in: ApplicationInfo

• CLIENT = 0

• RENDERER = 1

used in Windows: Indicates if a UI element is expected to be displayed or not. Note taht |RendererCommand::visible| should be prior to these flags, that is, you should hide all UI elements if |RendererCommand::visible| is false regardless of the visibility specified in this field.

• ShowUIDefault = 0

• ShowCompositionWindow = 1

• ShowCandidateWindow = 2

• ShowSuggestWindow = 4

An equivalent to CANDIDATEFORM in IMM32. (For Windows only) TODO(yukawa): make a common candidate form format for all platforms.

Used in: ApplicationInfo

• optional CandidateForm.Style DEPRECATED_style = 1

  Use |style_bits| instead in case there is an applications which specifies a combination of style bits.

• optional Point current_position = 2

• optional Rectangle area = 3

• optional uint32 style_bits = 4

  0 means Style::DEFAULT

These constants correspond to CFS_* in Imm.h

Used in: CandidateForm

• DEFAULT = 0

  CFS_DEFAULT

• CANDIDATEPOS = 64

  CFS_CANDIDATEPOS

• EXCLUDE = 128

  CFS_EXCLUDE

This message is a subset of Win32 GUITHREADINFO. (For Windows only) TODO(yukawa): make a common candidate form format for all platforms.

Used in: ApplicationInfo

• optional bool blinking = 1

• optional Rectangle caret_rect = 2

• optional uint32 target_window_handle = 3

An equivalent to IMECHARPOSITION in IMM32. (For Windows only) TODO(yukawa): make a common candidate form format for all platforms.

Used in: ApplicationInfo

• optional uint32 position = 1

• optional Point top_left = 2

• optional uint32 line_height = 3

• optional Rectangle document_area = 4

Used in: RendererCommand

• NOOP = 0

  No operation

• UPDATE = 1

  Update the current window

• SHUTDOWN = 2

  shutdown renderer

An equivalent to COMPOSITIONFORM in IMM32. (For Windows only) TODO(yukawa): make a common composition form format for all platforms.

Used in: ApplicationInfo

• optional CompositionForm.Style DEPRECATED_style = 1

  Use |style_bits| instead because there are some applications which specify a combination of style bits like CFS_RECT + CFS_POINT.

• optional Point current_position = 2

• optional Rectangle area = 3

• optional uint32 style_bits = 4

  0 means Style::DEFAULT

These constants correspond to CFS_* in Imm.h

Used in: CompositionForm

• DEFAULT = 0

  CFS_DEFAULT

• RECT = 1

  CFS_RECT

• POINT = 2

  CFS_POINT

• FORCE_POSITION = 32

  CFS_FORCE_POSITION

Visual information about mode indicator.

Used in: ApplicationInfo

• optional Status status = 1

Used in: CandidateForm, CharacterPosition, CompositionForm

• optional int32 x = 1

• optional int32 y = 2

Used in: RendererCommand, CandidateForm, CaretInfo, CharacterPosition, CompositionForm

• optional int32 left = 1

• optional int32 top = 2

• optional int32 right = 3

• optional int32 bottom = 4

TODO(yukawa): make a common font format for all platforms.

Used in: ApplicationInfo

• optional int32 height = 1

• optional int32 width = 2

• optional int32 escapement = 3

• optional int32 orientation = 4

• optional int32 weight = 5

  FW_DONTCARE

• optional bool italic = 6

• optional bool underline = 7

• optional bool strike_out = 8

• optional int32 char_set = 9

  DEFAULT_CHARSET

• optional int32 out_precision = 10

  OUT_DEFAULT_PRECIS

• optional int32 clip_precision = 11

  CLIP_DEFAULT_PRECIS

• optional int32 quality = 12

  DEFAULT_QUALITY

• optional int32 pitch_and_family = 13

  DEFAULT_PITCH

• optional string face_name = 14

  should be within 32 TCHARs (w/ '\0')

Clients' request to the server. Users cannot modify this. In the future each request may be able to be overwirtten by Config. The server does not have to obey this request.

Used in: Input, session.SessionState

• optional bool zero_query_suggestion = 1

  Enable zero query suggestion.

  true for android

• optional bool mixed_conversion = 2

  Conversion's candidate includes suggestion, prediction and conversion.

  true for android

• optional bool combine_all_segments = 3

  Combine all segments like mobile IME.

  true for android

• optional Request.SpecialRomanjiTable special_romanji_table = 4

  Use special Romanji table.

  TWELVE_KEYS_TO_HIRAGANA for android.

• optional Request.SpaceOnAlphanumeric space_on_alphanumeric = 6

• optional string keyboard_name = 7

  Keyboard name for touch devices. For example, "TWELVE_KEY_TOGGLE_KANA", "QWERTY_KANA_NUMBER". It is used to analyze touch event usage stats.

• optional bool update_input_mode_from_surrounding_text = 8

  Enables Composer's input mode auto updating by using surrounding text. For example, when a composition string is "ad", a carret is at the end, and a user selects HIRAGANA mode, if the user moves the carret to between "a" and "d" the mode will be automatically switch to ASCII (temporarily). See details in the Composer::UpdateInputMode.

• optional bool kana_modifier_insensitive_conversion = 9

  Enables Kana-modifier-insensitive conversion as follows: 1) Voiced/Semi-voiced kana will be hit by non-modified kana. e.g.) "ば" and "ぱ" will be hit by key "は". 2) Geminate consonant "っ" will be hit by non-modified kana "つ". 3) Palatalized kana will be hit by non-modified kana. e.g.) "ゃ" will be hit by key "や". Here is an example of the search: "学校" ("がっこう") will be hit by "かつこう".

• optional bool auto_partial_suggestion = 10

  Enables Auto partial suggestion. For Auto partial suggestion, we can see first segment only candidates adding to normal realtime conversion suggestion results. If we commit that candidate, we will show suggestions for remaining part of key. Note: This feature can be enabled only for mobile due to UX design.

• optional int32 available_emoji_carrier = 11

  By default, UNICODE emoji is available.

• optional int32 emoji_rewriter_capability = 12

  By default, Emoji rewriter works on conversion mode only.

• optional Request.CrossingEdgeBehavior crossing_edge_behavior = 13

• optional Request.LanguageAwareInputBehavior language_aware_input = 14

Controls the behavior when a user types the left/right key at the edge of the preedit string (in more precise, the left key at the beginning of the preedit string, or the right key at the end).

Used in: Request

• DO_NOTHING = 0

  This is the default behavior. The cursor movement at the edge will make nothing, i.e., keeping the current cursor position (at the edge), consume the key event.

• COMMIT_WITHOUT_CONSUMING = 1

  This is the behavior, especially designed for alphabet keyboards on mobile devices. Assuming the following text: XXXXabcde|YYYYY where XXXX is preceding text, abcde is composing text, YYYYY is following text and '|' is the caret, when a user sends "RIGHT" cursor key, we'd like to commit the abcde and move the caret to right. So the user will get: XXXXabcdeY|YYYY Here, what we need is commiting the "abcde" with the appropriate caret position. (Note that we need to handle the left cursor key, too). Also, we should *NOT* consume the key, so that the key event will be handled appropriately by the target application.

Nowadays, four kinds of emoji characters are used in Japan. - Unicode: Unicode based emoji (since Unicode 6.0). - Docomo: Docomo's carrier emoji. - Softbank: Softbank's carrier emoji. - Kddi: Kddi's carrier emoji. Note that especially latter three kinds are used on Mobile phones. So, it is necessary to control what kinds of emoji can be used or not based on client's (or connected application's) information. For example, on Android; - Unicode emoji characters are available only on Android 4.1 or later only. - JP mobile carriers' emoji characters depend on the devices. Also, we need to check the text field's attribute for them. The following bit set tells the emoji availability to EmojiRewriter.

• UNICODE_EMOJI = 1

• DOCOMO_EMOJI = 2

• SOFTBANK_EMOJI = 4

• KDDI_EMOJI = 8

Controls the behavior of language aware input. Language aware input guesses the actual language regardless the input mode. For example, if user type "てｓｔ" it will be treated as "test".

Used in: Request

• DEFAULT_LANGUAGE_AWARE_BEHAVIOR = 0

  Performs the default behavior considering the platform and channel.

• NO_LANGUAGE_AWARE_INPUT = 1

  Does not perform this functionarity.

• LANGUAGE_AWARE_SUGGESTION = 2

  Adds a language aware candidate to the suggestion.

For emoji rewriter, it is necessary to control when the rewriter runs based on the clients. The following bit set is sync'ed to RewriterInterface::CapabilityType (see rewriter_interface.h, too), so that clients can fill the value.

• NOT_AVAILABLE = 0

• CONVERSION = 1

• PREDICTION = 2

• SUGGESTION = 4

• ALL = 7

  CONVERSION | PREDICTION | SUGGESTION.

Used in: Request

• SPACE_OR_CONVERT_KEEPING_COMPOSITION = 0

  The first input is treated as a space, double input is treated as a conversion. If a character is input after the first input, the composition will remain. For example, "ab<space>dc" becomes "ab dc" as a single composition.

• SPACE_OR_CONVERT_COMMITING_COMPOSITION = 1

  The first input is treated as a space, double input is treated as a conversion. If a character is input after the first input, the previous composition will be committed. For example, "ab<space>dc" results "ab " as a committed string and "dc" as a composition.

• COMMIT = 2

  Commit the composition and a space.

Used in: Request

• DEFAULT_TABLE = 0

  Do not use special table. Romanji table is selected based on Config.

• TWELVE_KEYS_TO_HIRAGANA = 10

  Use special table for 12keys (to hiragana).

• TWELVE_KEYS_TO_HALFWIDTHASCII = 11

  Use special table for 12keys (to half-width ascii).

• TWELVE_KEYS_TO_NUMBER = 12

  Use special table for 12keys (to number).

• FLICK_TO_HIRAGANA = 13

  Use special table for flick (to hiragana).

• FLICK_TO_HALFWIDTHASCII = 14

  Use special table for flick (to half-width ascii).

• FLICK_TO_NUMBER = 15

  Use special table for flick (to number).

• TOGGLE_FLICK_TO_HIRAGANA = 16

  Use special table for both toggle and flick (to hiragana).

• TOGGLE_FLICK_TO_HALFWIDTHASCII = 17

  Use special table for both toggle and flick (to half-width ascii).

• TOGGLE_FLICK_TO_NUMBER = 18

  Use special table for both toggle and flick (to number).

• QWERTY_MOBILE_TO_HIRAGANA = 20

  Use special table for Qwerty (for Mobile) (to hiragana).

• QWERTY_MOBILE_TO_HIRAGANA_NUMBER = 21

  Use special table for Qwerty (for Mobile) (to hiragana's number).

• QWERTY_MOBILE_TO_HALFWIDTHASCII = 22

  Use special table for Qwerty (for Mobile) (to half-width ascii).

• GODAN_TO_HIRAGANA = 30

  Use special table for Godan (to hiragana).

• GODAN_TO_HALFWIDTHASCII = 31

  Use special table for Godan (to half-width ascii).

• GODAN_TO_NUMBER = 32

  Use special table for Godan (to number).

Result contains data to be submitted to the host application by the ime client.

Used in: Output, session.SessionState

• required Result.ResultType type = 1

• required string value = 2

  The result of conversion.

• optional string key = 3

  Source of the value. It is almost always the reading of the value.

• optional int32 cursor_offset = 4

  The caret position after the result submission. "0" means the end of the result, and a positive value means moving forward and a negative value backward. e.g.) "-s", where s is the length of value, means the caret position after the committing should be the beginning of the committed value.

Used in: Result

• NONE = 0

• STRING = 1

Used in: Input, Output.Callback

• required SessionCommand.CommandType type = 1

• optional int32 id = 2

  Unique number specifying a candidate word.

• optional CompositionMode composition_mode = 3

  This is used with SWITCH_INPUT_MODE, TURN_ON_IME and TURN_OFF_IME.

• optional string text = 4

  Text argument. This is used by CONVERT_REVERSE at this moment.

• optional uint32 cursor_position = 5

  New cursor position in preedit. Used with MOVE_CURSOR.

• optional SessionCommand.UsageStatsEvent usage_stats_event = 7

• optional Rectangle caret_rectangle = 8

  Specify the current caret location, this is used for suggest window position calculation. Used with SEND_CARET_LOCATION.

• optional int32 asynchronous_request_id = 10

  Unique number specifying an asynchronous request.

Used in: SessionCommand

• REVERT = 1

  Revert the session, this is usually similar to type ESC several times.

• SUBMIT = 2

  Commit the session, this is usually similar to type Enter. SUBMIT session command is accepted in any status. Pre-condition: - Any states of IME are acceptable. Post-condition: - Preedit text becomes empty.

• SELECT_CANDIDATE = 3

  Select the specified candidate word by id. This command is usually used with mouse clicking.

• HIGHLIGHT_CANDIDATE = 4

  Set the focus to the candidate by id. This is usually used with mouse dragging. The difference from SELECT_CANDIDATE is that HIGHLIGHT_CANDIDATE does not close the candidate window while SELECT_CANDIDATE closes the candidate window.

• SWITCH_INPUT_MODE = 5

  Specify the input mode. This command should be used with composition_mode.

• GET_STATUS = 6

  Return the current status such as composition mode, preedit method, etc.

• SUBMIT_CANDIDATE = 7

  This command is typically used for mobile IME's partial conversion, but currently it is on the way. This description is for current spec. This command requires that candidates exist. If there is a focused candidate (Conversion or Prediction state), the candidate matched with the given id in the first segment is submitted, even though the selected segment is not the first segment (Important thing is whether focused candidate exists or not. Focused index itself is ignored). This behavior should be updated because current cursor position and position of focused segment affects nothing. We should fix this non-intuitive behavior. Intuitive behavior might be submitting segments from first one to focused one (inclusive). If no focused candidate (Suggestion, including ZeroQuery suggestion), first (and only) segment's candiadte of which id is equal to id field of Input message is submitted. This behavior should be fixed because current cursor position affects nothing. In future, the characters after the cursor should be kept as preedit. This command's pre- and post- conditions are differenct from SUBMIT command's. Following conditions will be kept after updating the behavior. Pre-condition: - There should be candidate. Post-condition: - No guarantee on preedit text. TODO(yamaguchi): Update corresponding implementation please.

• CONVERT_REVERSE = 8

  Perform reverse conversion.

• UNDO = 9

  Perform Undo.

• RESET_CONTEXT = 10

  Reset convert history and revert current composition. This is usually used by moving cursor with mouse clicking.

• MOVE_CURSOR = 11

  Change cursor position in preedit.

• SWITCH_INPUT_FIELD_TYPE = 12

  Specify the input field type.

• USAGE_STATS_EVENT = 13

  Client side event information for collecting usage statistics

• UNDO_OR_REWIND = 14

  This command is used in only Android. Works UNDO or rewind HIRAGANA characters based on the state.

• EXPAND_SUGGESTION = 15

  Expand suggestion candidates. Usual suggestion algorithm is not "rich" but "fast" because suggestion is executed every key event (On the other hand predicition is "rich" because prediction is executed only when a user types TAB key). This command expands suggestion candidate but IME state is kept as is (Note : PredictAndConvert key command does almost the same thing but it changes IME state to prediction).

• SEND_CARET_LOCATION = 16

  The client can send the current caret position whenever the caret position is changed. The caret position is used for suggest window position calculation. This is an optional message. If client can show suggest window on the correct position, this message can be ignored.

• OBSOLETE_SEND_LANGUAGE_BAR_COMMAND = 17

  Obsolete command. Don't simply remove this command for NUM_OF_COMMANDS. TODO(team): Replace this command by useful one.

• GET_ASYNC_RESULT = 18

  When the server is hadling asynchronous request, the server returns the message with callback request which session_command is GET_ASYNC_RESULT. After the delay_millisec, the client sends this command to the server.

• COMMIT_RAW_TEXT = 19

  Commit the raw text of the composed string.

• CONVERT_PREV_PAGE = 20

  Call ConvertPrevPage session command to show the previous page of candidates.

• CONVERT_NEXT_PAGE = 21

  Call ConvertNextPage session command to show the next page of candidates.

• TURN_ON_IME = 22

  Make sure IME is turned on. Optionally you can also provide new input mode in |composition_mode| (but you must not set DIRECT to it). |composition_mode| is honored even when IME is already turned on.

• TURN_OFF_IME = 23

  Make sure IME is turned off. Optionally you can also provide new input mode in |composition_mode| (but you must not set DIRECT to it). If IME |composition_mode| is honored even when IME is already turned off.

• NUM_OF_COMMANDS = 24

  Number of commands. When new command is added, the command should use below number and NUM_OF_COMMANDS should be incremented.

Client side event for collecting usage statistics

Used in: SessionCommand

• INFOLIST_WINDOW_SHOW = 1

• INFOLIST_WINDOW_HIDE = 2

• HANDWRITING_OPEN_EVENT = 3

• HANDWRITING_COMMIT_EVENT = 4

• CHARACTER_PALETTE_OPEN_EVENT = 5

• CHARACTER_PALETTE_COMMIT_EVENT = 6

Used in: Output, RendererCommand.IndicatorInfo

• optional bool activated = 1

  Whether IME is ON or OFF

• optional CompositionMode mode = 2

  Visible composition mode when IME is activated. This mode may come from a temporary composition mode. See |comeback_mode|. TODO(yukawa): Rename this field to "visible_mode".

• optional CompositionMode comeback_mode = 3

  True composition mode that is suitable for system global and permanent composition mode. When a temporary composition mode exists, |comeback_mode| can be different from |mode|. TODO(yukawa): Use more appropriate name.