*** UNIX MANUAL PAGE BROWSER ***

cedit(1) General Commands Manual cedit(1) NAME cedit - Invokes the UDC Manager utility SYNOPSIS cedit [ -h ] [ -c old_db ] [ -r ref_db ] [ cur_db ] FLAGS Displays the usage message. Copies and converts old format font file or character attribute database to the new format used by cedit. Sets the reference attribute database rather than using the system default. PARAMETERS Specifies the UDC attribute database to be edited. If this parameter is not given, the default user database is used or, if user databases are not enabled, the system database is used. The location of the de- fault user and system databases are determined by the entry for the udc service in the cp_dirs file (see cp_dirs(4)). The default pathnames are /var/i18n/udc for the system database and ~/.udc for the user data- base. When the user pathname field in the udc entry contains a hyphen (-), user databases are disabled for the system. DESCRIPTION The cedit command invokes the UDC Manager utility, which manages the attributes of user-defined characters (UDCs). You can run UDC Manager to create or edit a font glyph for the character and to manipulate the following character attributes: Symbolic name Bitmap font size (16x18, 24x24, 32x32, 40x40) and style Codeset value Collating value Input key sequences for some of the supported input methods Character classes The actual number and type of character attributes that you can manipu- late for each language depends on the corresponding character configu- ration files. The utility has two modes of operation, menu mode and font-editing mode. When you start the utility, it is in menu mode. In menu mode, the screen is divided into 3 parts. The upper half of the screen is the work space for the menu system. Below that is the status area for showing the current codeset and language. The bottom two lines form the user input and message display area. In menu mode, you manipulate character attributes through menu selections; however, you cannot cre- ate or change the font glyph. To edit the glyph, you must select the Font item in the Edit menu. This selection changes the utility to font- editing mode, where you use single and double keystroke commands for editing. For more information about changing character attributes and editing font glyphs, see the Menu Mode and Font-Editing Mode sections, respectively. The UDC attribute database is not used directly by system utilities. Information in this database must be processed by the cgen command to create data files that are used by system utilities. Refer to cgen(1) for information about processing information in the UDC attribute data- base. Menu Mode The UDC Manager provides a menu navigation system for command selection and activation. In the menu mode, there is a horizontal main menu bar at the top of the screen. This menu bar has several different menu items for you to select and activate. A menu item can be in one of the following states: inactive active se- lected activated An inactive menu item does not have a highlighted and underlined letter and cannot be selected. An active menu item has a highlighted and underlined letter and can be selected. The highlighted letter specifies the hot key for fast selec- tion and activation of this menu item. A selected menu item appears in inverse video. It is ready for subse- quent activation. An activated menu item is the one whose submenu has popped up on the screen or one whose function has started. You can use one of two methods to navigate within the menu system. You can use the four arrow keys to move the location cursor to various parts of the menu, or you can press the hot key for fast selection and activation of menu item. For the horizontal main menu bar, you can press the Down-arrow, Space, or Return key to activate a selected item. A pull-down submenu appears for the activated menu item. Pressing the Left-arrow or Right-arrow key selects and activates the corresponding menu item on the main menu bar. To activate a selected item in a pull-down menu, you can use ei- ther the Return or the Space key. When >> characters follow a menu item, activating that item causes a submenu to pop up. To return to a higher menu level without activating an item on the current level, press Ctrl/X. To elicit short help for each menu item, press the Help key. The main menu bar has the following pull-down menus: File Edit Delete Show Commands Options Help The File menu allows you to exit or quit the UDC Manager as well as changing the reference character attribute database. This menu also lets you save changes made to the current character or cancel all the changes made to that character. The Edit menu allows you to select the current character and edit each individual attribute of that character. Activation of the Font item changes the UDC Manager to font-editing mode. The Delete menu allows you to delete previously defined attributes of the current character. The Show menu allows you to show the status and values of character at- tributes already defined. (However, you cannot view the font glyph through this menu.) The Commands menu lets you scale a number of font records of a certain font size, list all the characters available in the current database for the current codeset and language, and copy a number of character records from the reference character attribute database to the current database. The Options menu allows you to change the current codeset and language. These options do not change the language of the utility's user inter- face. Your options for the user interface language are limited to Eng- lish and the language determined by the locale setting at utility startup time. The Help menu provides online information about the utility. For some menu items, a selection list will be popped up for you to choose one or more of the character attributes. To choose or mark a character attribute, press the space bar or the Return key. Font Editing Mode The UDC Manager provides a full screen font editor for creating and modifying character font patterns. The following paragraphs give a brief introduction to the screen layout and features available to the user. On the top left corner of the font editor, there are three small win- dows under the heading "Reference". They are used by the Refer mecha- nism to display other font patterns in their real size so that users can use these fonts as a reference when designing new fonts. The Display window under the three Refer windows is for displaying the font currently being edited in its real size. The main window on the right side of the editor is the Edit window on which users can create or modify fonts using cursor movements and editing functions. Each dot inside the window represents one pixel. The patterns in the Display and Edit windows may not match. To make them match, press the DISPLAY key (KP.) should be pressed. There are four Edit modes that you can set to control the characteris- tics of the editing functions. The Cursor mode can be ON, OFF, ON/OFF or MOVE. It controls whether cursor movement turns on or off the pixel under the cursor. The Paste mode can be OVERLAY or OVERWRITE and con- trols the outcome of paste operation. The Type mode can be BODY or LETTER and specifies whether a boundary is kept around the character. The Wrap mode can be ON or OFF to enable or disable wrapping of the cursor. Buffers in the Font Editor are the areas where bitmaps are saved. There are four of them. The EDIT buffer is the main buffer where you edit the font glyph. This is the buffer that normally appears in the Edit window. The USE buffer is the buffer that appears in the Edit window when the USE function is invoked. The third buffer is the CUT and PASTE buffer. The content of this buffer is not visible, but users can cut a pattern from the other two buffers to this buffer or paste its contents into the EDIT buffer. Most of the editing functions are invoked by pressing a single key on the keypad of the keyboard. But some functions are invoked by pressing PF1, called the GOLD key, and another key. The GOLD key changes the editing function that is mapped by default to the second key. The Font Editor also provides a small pop-up menu for the SCALE, USE and REFER functions. Except the SCALE function, these functions can also be invoked by keystroke. The SCALE function allows users to scale the current font to other sizes supported by the system. The USE function allows users to retrieve a font from the character at- tribute databases or from one of the Reference windows for a cut and paste operation. The REFER function allows users to save either the current edited font or a font from the one of the databases into one of the three reference windows in a round-robin fashion. For more information about each individual function, you can invoke the HELP function within the Font Editor. The following table specifies the terminal key bindings for all the editing functions: tab(+); lfHBw(1.0i) lfHBw(1.0i) lfHBw(1.75i) lfHBw(1.0i) lfHBw(1.0i) lfHBw(1.75i) lw(1.0i) lw(1.0i) lw(1.75i) . _ Editing+Key+ Function+Binding+Description _ HELP+Help,PF2+Provides help on various edit functions GOLD+PF1+Toggles GOLD state CURSOR-MODE+PF3+Toggles Cursor mode PASTE-MODE+PF4+Toggles Paste mode TYPE-MODE+KP-+Toggles Type mode WRAP-MODE+KP,+Toggles Wrap mode U&L+KP7+Depending on Cursor mode, moves up & left UP+KP8+Depending on Cursor mode, moves up U&R+KP9+Depending on Cursor mode, moves up & right LEFT+KP4+Depending on Cursor mode, moves left RIGHT+KP6+Depending on Cursor mode, moves right D&L+KP1+Depending on Cursor mode, moves down & left DOWN+KP2+Depending on Cursor mode, moves down D&R+KP3+De- pending on Cursor mode, moves down & right USE+KP0+Displays font pat- tern in USE buffer DISPLAY+KP.+Displays font pattern in real size TOG- GLE+KP5+Toggles ON/OFF state of pixel under cursor EXIT+Enter+Saves changes and exit editor QUIT+GOLD Enter+Quits editor without saving changes CLEAR+GOLD KP,+Clears font pattern on Edit window REFER+GOLD KP.+Displays font pattern in Refer windows RETUSE+GOLD KP0+Returns to EDIT buffer from USE buffer ULCORNER+GOLD KP7+Jumps to upper left cor- ner TOP+GOLD KP8+Jumps to top URCORNER+GOLD KP9+Jumps to upper right corner LSIDE+GOLD KP4+Jumps to left side CENTER+GOLD KP5+Jumps to cen- ter RSIDE+GOLD KP6+Jumps to right side LLCORNER+GOLD KP1+Jumps to lower left corner BOTTOM+GOLD KP2+Jumps to bottom LRCORNER+GOLD KP3+Jumps to lower right corner SELECT+SELECT+Toggles start/cancel selected area PASTE+INSERT+Inserts content of paste buffer CUT+REMOVE+Cuts selected area to paste buffer COPY+GOLD REMOVE+Copies selected area to paste buffer UP-ARROW+Up+Moves up DOWN-ARROW+Down+Moves down LEFT-AR- ROW+Left+Moves up RIGHT-ARROW+Right+Moves down SHIFT-UP+GOLD Up+Shifts up by one line SHIFT-DOWN+GOLD Down+Shifts down by one line SHIFT- LEFT+GOLD Left+Shifts left by one column SHIFT-RIGHT+GOLD Right+Shifts right by one column LINE+l,L+Draws line connecting two selected points CIRCLE+c,C+Draws circle with center at selected point O-RECTANGLE+r+Draws an open rec- tangle in selected area S-RECTANGLE+R+Draws an solid rectangle in se- lected area O-ELLIPSE+e+Draws an open ellipse in selected area S-EL- LIPSE+E+Draws an solid ellipse in selected area MIRROR-X+x,X+Mirrors pattern along X-axis MIRROR-Y+y,Y+Mirrors pattern along Y-axis MIR- ROR-45+/+Mirrors pattern along 45-deg diagonal MIRROR-135+\+Mirrors pattern along 135-deg diagonal FILL+f,F+Depending on Cursor mode, fills area INVERT+t,T+Inverts the pixel state of all pixels UNDO+u,U+Undoes the previous function REDRAW+Ctrl/L+Redraws the screen B SUSPEND+Ctrl/Z+Suspends the program MENU+Do+Invokes the menu subsystem _ The following keypad diagrams show the key assignments for the cursor and application keypads. In these diagrams, the GOLD key functions are preceded by an asterisk. +--------+---------+--------++----------+---------+----------+---------+ | | | *Copy || | | | | | | Paste | Cut || Gold | Help | Curs Mo. |Paste Mo.| +--------+---------+--------++----------+---------+----------+---------+ | | | ||*UL Corner| *Top |*UR Corner| | | Select | | || U&L | Up | U&R |Type Mo. | +--------+---------+--------++----------+---------+----------+---------+ |*Shift Up| || *L Side | *Center | *R Side |*Clear | | Up | || Left | Toggle | Right | Wrap Mo.| +--------+---------+--------++----------+---------+----------+---------+ |*Shift L| *Shift D|*Shift R||*LL Corner| *Bottom |*LR Corner| | | Left | Down | Right || D&L | Down | D&R | *Quit | +--------+---------+--------++----------+---------+----------+ Exit | | *Return from Use | *Refer | | | Use | Display | | +--------------------+----------+---------+ Starting an Edit Session An edit session is normally started by selecting the codeset value of the UDC character to be edited under the current locale. By selecting Character item from the Edit menu, you are prompted by a submenu with two possible choices: edit a new character or edit an existing charac- ter. In either case, you must enter the character's codeset value in hexadecimal. An error message is be displayed if you choose to edit a new character whose value already exists in the database, or if you choose to edit an existing character when it doesn't exist in the data- base. Under the Japanese locales, automatic UDC code point mapping is per- formed. This means that when you enter a new UDC's codeset value for the current locale, the value is also mapped, whenever possible, to corresponding values in codesets for other Japanese locales. If you later decide to modify the codeset value of a Japanese UDC character, you are prompted to determine if the character value in other codesets should be changed accordingly. The following diagram shows the mapping between UDC regions in the four supported Japanese codesets. +-----------------+-------------------+-----------------+ | deck- anji/ | eucJP | SJIS | | sdeckanji | | | +-----------------+-------------------+-----------------+ | 0xA121-0xAA7E | 0xF5A1-0XFEFE | 0xF040-0xF4FC | | 0xAB21-0xB47E | 0x8FF5A1-0x8FFEFE | 0xF540-0xF9FC | | 0xB521-0xBA7E | 0x8FEEA1-0x8FF3FE | 0xFA40-0xFCFC | | 0xBB21-0xBB7E | 0x8FF4A1-0x8FF4FE | ----- | | 0xBC21-0xFE7E | ----- | ----- | +-----------------+-------------------+-----------------+ If a value in a particular codeset cannot be mapped to another codeset, the value is left unchanged or unspecified. After specifying the codeset value, you can proceed to add, modify, or delete other editable character attributes. Not all the character at- tributes can be edited under any locale. For example, under the Japan- ese locales, the collating value and input key sequence for a UDC can- not be edited. RELATED INFORMATION Commands: cgen(1) Files: cp_dirs(4) Others: i18n_intro(5), l10n_intro(5) Writing Software for the International Market delim off cedit(1)