dtudcfonted(user cmd)

NAME
dtudcfonted — Edit user-defined characters

SYNOPSIS

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:

1.  Start the font editor to display the Font Selection window.

2.  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.

3.  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.

4.  After editing the character pattern, select Save from the Font menu to register the edited character pattern with the user-defined character file.

5.  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:

    6.  Choose Pencil at the top of the drawing tools.

    7.  Move the cursor to the appropriate position.

    8.  Click the left mouse button.

Drawing Straight Lines
    To draw a straight line (one dot wide):

    9.  Choose Straight line from the drawing tools.

    10. Move the cursor to the line start position, and then press the left mouse button.

    11. 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):

    12. Choose Rectangle from the drawing tools.

    13. Move the cursor to one corner of the rectangle, then press the left mouse button.

    14. 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):

    15. Choose Circle from the drawing tools.

    16. Move the cursor to the center of the circle, then press the left mouse button.

    17. 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:

    18. Choose Select from the drawing tools.

    19. Move the cursor to one corner of the rectangle, then press the left mouse button.

    20. 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.

    21. 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:

    22. Choose Copy from the Edit menu.

    23. Choose Paste from the Edit menu.

    24. Move the cursor to the copy destination within the edit pane. The frame of the selected area moves with the cursor.

    25. Click the left mouse button.

Moving an Area
    To move a selected area:

    26. Choose Cut from the Edit menu.

    27. Choose Paste from the Edit menu.

    28. Move the cursor to the copy destination within the edit pane. The frame of the selected area moves with the cursor.

    29. 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:

1.  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.

2.  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.

3.  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

dtudcexch(1)