]]>
dtudcfonted
user cmd
dtudcfonted
Edit user-defined characters
dtudcfonted
DESCRIPTION
The dtudcfonted utility is a tool for editing user-defined
characters (UDCs). It runs only in GUI mode.
The procedure for editing user-defined characters is:
Start the font editor to display the Font Selection window.
Select the code set, style, and character size of the font to be edited.
The Font Selection window lists the fonts satisfying
these specifications. After specifying a font, select the
Open button to display the
Character Edit window.
Edit a character pattern in the Character Edit
window. You can register the code for the character to be edited, and
you can delete unnecessary characters.
After editing the character pattern, select Save from
the Font menu to register the edited character pattern
with the user-defined character file.
Edit another font by selecting Open
from the Font menu. The
Font Selection window is displayed.
Repeat steps 2 through 5.
Starting the Font Editor
Start the font editor by entering the
dtudcfonted command. The Font Selection
window appears.
Selecting the Font
The Font Selection window is displayed immediately
after the utility is started, or by choosing Open
from the Font menu on the Character Edit window. The
code sets for the editable font files are listed in Codeset Selection.
To list the applicable fonts (files), select the code set, style, and
definition character size of the desired font in the selection item field.
Specifying one font and then selecting the Open button
displays the Character Edit window. Selecting the
Cancel button closes the Font
Selection window and terminates the UDC font editor.
Editing Characters
Character patterns are edited on the Character Edit
window. The Character Edit window contains:
A list of the characters being edited
The editing pane, with each square corresponding to one dot
Drawing tools
The currently displayed character pattern in the exact size and its code
Select the code for the character to be edited from the
character list. This displays the associated character pattern
in the edit pane. If the character pattern has not been created in
the UDC area, nothing is displayed.
If the character code is not registered, add the code on the
Character Control window, or copy the pattern on the
Character Copy window. For details on how to add
character codes, see "Adding and Deleting Character Codes". For details
on how to copy character patterns, see "Copying Character Patterns".
Characters are edited on the edit pane using the following operations:
Marking Dots
To mark one dot at the cursor position:
Choose Pencil at the top of the drawing tools.
Move the cursor to the appropriate position.
Click the left mouse button.
Drawing Straight Lines
To draw a straight line (one dot wide):
Choose Straight line from the drawing tools.
Move the cursor to the line start position, and then press the left mouse button.
While holding down the left mouse button, move the cursor to the line
end position. Then release the left button.
To cancel the line after starting, move the cursor outside the edit
pane, then release the left button.
Drawing Rectangles
To draw a rectangle (one dot wide):
Choose Rectangle from the drawing tools.
Move the cursor to one corner of the rectangle, then press the left
mouse button.
While holding down the left mouse button, move the cursor to the
diagonally opposite corner. Then release the left button.
To cancel the rectangle after specifying one corner, move the cursor
outside the edit pane, then release the left button.
Drawing Circles
To draw a circle (one dot wide):
Choose Circle from the drawing tools.
Move the cursor to the center of the circle, then press the left mouse
button.
While holding down the left mouse button, move the cursor to a point on
the circumference of the circle. Then release the left button.
To cancel the circle after selecting the center point, move the cursor
outside the edit pane, then release the left button.
Selecting an Area for Editing
To select a rectangular area for editing:
Choose Select from the drawing tools.
Move the cursor to one corner of the rectangle, then press the left
mouse button.
While holding down the left mouse button, move the cursor to the
diagonally opposite corner. Then release the left button.
To cancel the rectangular area after specifying one corner, move the cursor
outside the edit pane, then release the left button.
Choose the desired function from the Edit menu.
Clearing an Area
To clear all the dots within a selected area, choose
Clear from the Edit menu.
Setting an Area
To set all the dots within a selected area,
choose Set from the Edit menu.
Reversing Video in an Area
To reverse the video (change black dots to white and vice cersa) within
a selected area, choose Reverse video from the
Edit menu.
Copying an Area
To copy a selected area:
Choose Copy from the Edit menu.
Choose Paste from the Edit menu.
Move the cursor to the copy destination within the edit pane.
The frame of the selected area moves with the cursor.
Click the left mouse button.
Moving an Area
To move a selected area:
Choose Cut from the Edit menu.
Choose Paste from the Edit menu.
Move the cursor to the copy destination within the edit pane.
The frame of the selected area moves with the cursor.
Click the left mouse button.
Rotating an Area
To rotate the contents of a selected area 90 degrees clockwise,
choose Rotate from the Edit menu.
Flipping an Area
To flip the contents of a selected area vertically,
choose Flip vertically from the Edit menu.
To flip the contents of a selected area horizontally,
choose Flip horizontally from the Edit menu.
Inverting Dots
To invert (change from black to white and vice versa) the dot at the
current cursor location, click the middle mouse button.
Canceling Edits
To cancel the results of the most recent edit operation,
choose Cancel from the Edit menu.
Adding and Deleting Character Codes
Character codes are added and deleted on the Character
Control window. To display this window,
choose Add/Delete from the Character menu.
Adding Character Codes
To add a character code, specify its four hexadecimal digits within the
user-defined character area. To add a range of characters, specify the
four hexadecimal digits for the last character code in the range in the
right input field. After specifying a single character code or a range,
select the Add button.
The character code is added to a list of the characters being edited on
the Character Edit window. The character to be edited
is the first character of the added character code (or the added
character code field). If already registered, the character pattern for
the specified character code is not changed.
Deleting Character Codes
To delete a character code, specify its four hexadecimal digits within
the user-defined character area. To delete a range of characters,
specify the four hexadecimal digits for the last character code in the
range in the right input field. After specifying a single character code
or a range, select the Delete button. The
Character Deletion Confirmation window appears.
Choose OK to delete the character. Choose
Cancel to cancel the deletion.
Deleting a character code removes it from the list of characters being
edited on the Character Edit window. The character
code following the deleted character code becomes the current editable
character code. Note that a deleted character code is not actually
removed from the user-defined character file until you choose
Save on the Font menu.
Entering Character Codes Graphically
To enter a character code graphically, choose the
Code button on the Character
Control window. The Character Code Input
window appears. On this window, click on the desired character, then
press the Apply button to insert the code for the
selected character in the code input field of the Character
Control window.
Copying Character Patterns
You can copy character patterns already registered or created using the
Character Copy window. To access this window, choose
Copy from the Character menu.
Copying adds the character code specified for the copy destination to
the list of the character list on the Editing window.
To copy a character pattern:
Select the size of the character to be copied from the character size
selection field, then enter the four-hexadecimal-digit code for the
character in the copy code field. To copy a range of character patterns
in a single operation, enter the code for the last character in the
range in the right input field.
Specify the four-hexadecimal-digit code for the copy destination.
Multiple character patterns are copied in a single
operation in ascending order of codes starting at the specified copy
destination code. A code in the user-defined character area can be
specified.
Select the Copy button. If the destination area
already contains the copied character pattern, the
Confirmation window appears. To replace the existing
pattern with the copy, select Close. To cancel the
copy, select Cancel.
Note that if the size of the copy source character differs from that of the copy
destination character, the pattern is automatically enlarged or reduced
for copying.
You can also perform a composite copy, which ORs the dots in the source
character pattern with the dots in the destination character pattern. To
copy a composite pattern, specify the copy source and the copy
destination, then choose the Copy Compositions button.
Getting Information
The Information menu provides explanations of the
following items:
XLFD name
Displays the XLFD name window,
which lists the file name and XLFD name of the font
being edited.
Code area
Displays the Code area window, which provides
information about the code area.
Saving Editing Results
To save your edits on a character pattern, you must save the
pattern in the user-defined character file. Choose Save
from the Font.
Exiting the Font Editor
To exit from the Font Editor, choose Exit from the
Font menu or Close from the window
menu. If you have not saved the edited pattern, the Termination
Confirmation window appears and asks whether you want to save
the pattern or not. Choose Save to save your edits,
Not Save to discard your edits, or
Cancel to abort the exit itself.
EXIT STATUS
0
The Font Editor exited successfully.
>1
An error occurred.
ENVIRONMENT VARIABLES
dtudcfonted references the DTUDCFONTPATH variable, which is a colon-separated list of directories
to search when looking for UDC font files.
RESOURCES
None.
ACTIONS/MESSAGES
None.
ERRORS/WARNINGS
The following errors can occur when the font file is read or saved:
Failed in reading the selected font file.
Failed in the registration of the selected font file.
The following errors can occur when the UDC is added, deleted, or copied:
The specified code is without the range of UDC code.
Because the memory allocation cannot be done, it is not possible to add.
The specified copy origin code is without the range of UDC code.
The specified copy target code is without the range of UDC code.
There is no character in the specified area.
The following errors can occur when the font file is opened:
Because the selected font file is already open for editing by another
user, it cannot be opened.
Failed to open the selected font file.
You have no right to access for the font file, or the format of the file
is not consistent.
FILES
None.
EXAMPLES
None.
SEE ALSO
&cdeman.dtudcexch;