NAME

htt − X input method server

SYNOPSIS

htt [ options ]

AVAILABILITY

SUNWxim

DESCRIPTION

htt is an X input method server which interfaces internationalized X Window applications and the language specific conversion engines.  When users input texts that require dictionary lookup, htt provides an interface for the text input, based on X Input Method specification in X11R5 and X11R6.  htt uses XIMP4.0 (protocol) , which complies with the XIM specification which is a part of X11R5 and X11R6.  htt also supports XIMCP (protocol), which complies with the XIM specification of X11R6.  htt provides a graphical user interface to customize the input method behavior. The graphical user interface part is a separate program htt_props , which is automatically started by htt. 

OPTIONS

Most command-line options have counterparts in the resource database.  A command-line option will override any setting from the resource database. 

−bd border_color
Specify a string value for the border color for the htt root window; default is "black".

−bg background_color
Specify a string value for the background color for the htt window; default is "white".

−bp background_pixmap_file_name
Specify the bitmap file from which a pixmap is created. htt uses this pixmap for its root window background. 

−display host:display.screen
Specify the screen where the htt window is to be displayed.

−fg foreground_color
Specify a string value for the foreground color for the htt window; default is "black".

−fn fontset_name
Specify the fontset for the characters htt uses in pre-edit areas and status areas. 

−help
Display help information for htt. 

−lc_basiclocale locale
htt starts itself in the specified language. 

−lucbg lookup_choice_background_color
Specify a string value for the background color of popup windows that display choices for converting characters (that is, lookup choice popup windows). The default color string is "light gray".

−lucfn lookup_choice_font_name
Specify a string value naming the font set htt uses to display converted characters in lookup choice popup windows.  Specify using font-name in the same way as with −fn . 

−lucstyle lookup_style
Specify where to display the choices of converted characters, in either lookup choice popup window (default) or htt root window:

popup: display the list in a lookup choice popup window
rootwindow: display the list in an htt window

−nosm
When this option is specified, htt does not respond to the session manager. In default, htt responds to the session manager, when WM_SAVW_YOURSELF protocol is sent. 

−root_geom <width>x<height>{+|-}<xoffset>{+|-}<yoffset>
Specify the size and location of an htt root window.

−so Server only mode. Starts htt without the graphical user interface.  When htt is started with this option, users can attach the graphical user interface by starting htt_props afterwards. 

−xrm resource_name
Specify an additional resource database file for htt. 

RESOURCES

ximp40 (class Ximp40)
When this resource value is true, htt provides support for Ximp4.0 XIM protocols.

ximcp (class Ximcp)
When this resource value is true, htt provides support for XIMCP XIM protocols.

language (class Language)
Htt supports multiple locales. This specifies the primary locale used as default in the window titles and icon name. If neither of the language nor languageList resource is specified, a locale will be retrieved by the LC_CTYPE category of the current environment.

languageList (class LanguageList)
Htt supports multiple locales. This specifies a list of the locale that Htt supports. If the language resource is not specified, the first locale in the languageList list will be used as a primary locale. The value can be specified by using ’:’ as a separator. For example, when specified like, ja:ko htt is started to service ja locale and ko locale at the same time. Also, in this example, ja will be the primary locale (equivalent to language resource). If the first list in this resource is not the same as language resource, htt issues a warning message and honors the language resource. If any of the locales specified in the list are not system supported locales, htt just ignores those entries.

eventFlow (class EventFlow)
This specifies the event flow control models, the static event flow control or dynamic event flow control models. A static event flow control lets Htt handle events regardless of the event flow mode. A dynamic event flow control lets Xlib bypass Htt whenever possible.

eventMethod (class EventMethod)
This specifies the event handling method, the front-end or back-end methods. A front-end method intercepts events from the X server before they reach the application. A back-end method filters events from the application, before the application has processed them.

eventSync (class EventSync)
This specifies whether or not the event synchronize the XIM protocols.

filterEventMask (class FilterEventMask)
his resource requests that Htt is interested in the events associated with the specified event mask. Some language engine needs to know the events other than KeyPress.

conversionOnKeys (class ConversionOnKeys)
This specifies the key sequence which enables the conversion mode on.

conversionOffKeys (class ConversionOffKeys)
This specifies the key sequence which enables the conversion mode off. While the conversionOnKeys resource is specified, if this conversionOffKeys resource is not specified, the conversionOnKeys resource is also used as the conversionOffKeys resource.

interfaceModule (class InterfaceModule)
This specifies the language interface module which is loaded dynamically into Htt core module. The HTT_IF_NAME environment variable can be used to specify the same value, but this resource value overrides it.

iconic (class Iconic)
This specifies whether or not Htt is started as an icon. If the value is true, htt is started as an icon. If the value is false, htt’s property window opens when htt is started.

iconName (class IconName)
This specifies the icon name.

foreground (class Foreground)
This specifies the foreground color of any Htt windows.

background (class Background)
This specifies the background color of any Htt windows.

backgroundPixmap (class BackgroundPixmap)
This specifies the background pixmap of any Htt windows.

borderColor (class BorderColor)
This specifies the border color of any Htt windows.

borderWidth (class BorderWidth)
This specifies the border width of any Htt windows.

fontSet (class FontSet)
This specifies the base font name of the font set in the Htt windows.

lineSpace (class LineSpace)
This specifies the line space value in pixels when a pre-edit string exceeding one line. If this value is smaller than current font’s maximum height, then Htt will use maximum height of the font as a line space value.

rootGeometry (class RootGeometry)
This indicates the initial position and size of the root window. If the offsets are not provided, the default value will be used. The units for width and height are columns and rows. If either the width or the height is zero, htt interprets the value to full width/height of the screen.

rootStatusGeometry (class RootStatusGeometry)
The geometry of the status relative to the root window.

rootPreeditGeometry (class RootPreeditGeometry)
The geometry of the preedit relative to the root window.

rootLookupGeometry (class RootLookupGeometry)
The geometry of the lookup relative to the root window.

rootPlacement (class RootPlacement)
This resource indicates the policy of the root window of htt (in case of XIMPreeditNothing or XIMStatusNothing). The possible values are root   - Place on the root window of the screen. client - Place near the current client window. cursor - Place near the cursor. As for the direction of where the root window will be placed based on the rootPlacement resource, the rootPosition resource will be used. If this values is root, all clients that use PreeditNothinng or StatusNothing will share a single window.

rootPosition (class RootPosition)
This specifies the root window position based on the rootPlacement resource. The resource value has the following syntax: primary_layout  secondary_layout The layout values are one of the following: top      Place at the top side. bottom   Place at the bottom side. left     Place at the left side. right    Place at the right side.

rootTitle (class RootTitle)
This specifies whether or not the root window has the window title.

rootTitleName (class RootTitleName)
This specifies the window title of the root window. This is a combination of the Name, Version, Locale and user specified text.

rootAlwaysMapped (class RootAlwaysMapped)
If true, root window is mapped always. Otherwise, root window is mapped only when there are at least one client that requires the root window. This resource is valid only when rootPlacement is root.

preeditAutoWrap (class PreeditAutoWrap)
This specifies whether or not the preedit is wrapped at the edge of the client window. This resource is valid when the pre-edit style is overTheSpot.

preeditCaret (class PreeditCaret)
If none is set, no preedit carets are shown. Otherwise, the shape of the caret is specified by this resource. This resource is valid when the pre-edit style is not onTheSpot.

preeditCaretColor  (class PreeditCaretColor)
This specifies the color of the preedit caret used when preeditShowCaret is true. This resource is valid when the pre-edit style is not onTheSpot.

lookupForeground (class LookupForeground)
This specifies the foreground color of the lookup window.

lookupBackground (class LookupBackground)
This specifies the background color of the lookup window.

lookupRow (class LookupRow)
This specifies the number of display rows in the lookup window.

lookupColumn (class LookupColumn)
This specifies the number of display columns in the lookup window.

This specifies the number of display columns in the
lookup window.

lookupLabelType (class LookupLabelType)
This specifies the type of characters that is used to label the candidates in the lookup window.

lookupWindowType  (class LookupWindowType)
This specifies where Htt displays the candidates of converted characters, in the either lookup window or htt root window, or the area for the status window. When statusarea is set, and if the client is using XIMStatusArea input style, lookup menu takes over the area for status rendering.

lookupSaveUnder (class LookupSaveUnder)
This specifies whether to save the image under the lookup window display.

lookupMovable (class LookupMovable)
This specifies whether the lookup window is movable or not.

lookupFont (class LookupFont)
This specifies the font set used in the lookup window.

lookupGeometry (class LookupGeometry)
This specifies the geometry of the lookup window. The lookup window size is not effective if specified.

lookupPlacement (class LookupPlacement)
This specifies the base point for the lookup window popup. The window position is relative to the mouse pointer or the current client window, or the spotlocation of the preedit (if the client is XIMPreeditPosition input style.)

lookupPosition (class LookupPosition)
This specifies the direction of where the lookup window is to be placed based on the lookupPlacement resource.

lookupBorderWidth (class LookupBorderWidth)
This specifies the border width of the lookup window.

lookupTitle (class LookupTitle)
This specifies whether or not the lookup window has the window title.

lookupTitleName (class LookupTitleName)
This specifies the window title of the lookup window. The ID is used to indicate how many lookup window is being displayed.

lookupNextPageKey (class LookupNextPageKey)
The keybinding to show the next page of the lookup. This resource is valid only when the engine does not control this operation.

lookupPrevPageKey (class LookupPrevPageKey)
The keybinding to show the previous page of the lookup. This resource is valid only when the engine does not control this operation.

SunOS 5.6  —  Last change: 04 June 1996