cedit(1)cedit(1)NAMEcedit - Invokes the UDC Manager utility
SYNOPSIScedit [-h] [-c old_db] [-r ref_db] [cur_db]
OPTIONS
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.
OPERANDS
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
default user and system databases are determined by the entry for the
udc service in the cp_dirs file (see cp_dirs(4)). The default path‐
names are /var/i18n/udc for the system database and ~/.udc for the user
database. 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 show‐
ing 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 selec‐
tions; however, you cannot create 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 dou‐
ble keystroke commands for editing. For more information about changing
character attributes and editing font glyphs, see the Menu Mode and
Font-Editing Mode sections in this reference page.
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
selected 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
either 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 display 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
change 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
attributes 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 pops up that allows 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, in
its real size, the font currently being edited. 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.).
There are four Edit modes (Cursor, Paste, Type, and Wrap) that you can
set to control the characteristics of the editing functions. The Cur‐
sor mode can be ON, OFF, ON/OFF or MOVE and controls whether cursor
movement turns on or off the pixel under the cursor. The Paste mode
can be OVERLAY or OVERWRITE and controls the outcome of paste opera‐
tion. 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.
There are three buffers in the Font Editor (EDIT, USE, and CUT and
PASTE) that are the areas where bitmaps are saved. 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 CUT
and PASTE buffer content is not visible, but users can cut a pattern
from the EDIT or USE 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. The USE and REFER functions can also be invoked
by keystroke; the SCALE function can only be invoked by menu.
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
attribute 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:
───────────────────────────────────────────────────────────────────
Editing Function Key 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 Depending on Cursor mode, moves
down & right
USE KP0 Displays font pattern in USE buf‐
fer
DISPLAY KP. Displays font pattern in real
size
TOGGLE 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 win‐
dow
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 corner
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 center
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 buf‐
fer
COPY GOLD REMOVE Copies selected area to paste
buffer
UP-ARROW Up Moves up
DOWN-ARROW Down Moves down
LEFT-ARROW 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 rectangle in
selected area
S-RECTANGLE R Draws an solid rectangle in
selected area
O-ELLIPSE e Draws an open ellipse in selected
area
S-ELLIPSE 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
MIRROR-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
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. When you
select a Character item from the Edit menu, you are prompted by a sub‐
menu with two possible choices: edit a new character or edit an exist‐
ing character. In either case, you must enter the character's codeset
value in hexadecimal. An error message is 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
database.
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
attributes can be edited under any locale. For example, under the Ja‐
panese locales, the collating value and input key sequence for a UDC
cannot be edited.
RESTRICTIONS
The dtterm terminal emulator does not support cedit functions. If you
attempt to use cedit under dtterm, the UDC Manager utility may hang.
Use the dxterm terminal emulator.
SEE ALSO
Commands: cgen(1)
Files: cp_dirs(4)
Others: i18n_intro(5), l10n_intro(5)
Writing Software for the International Market
cedit(1)