sdtudctool(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | USAGE | RESOURCES | SEE ALSO | NOTES

NAME

sdtudctool- Solaris gaiji tool

SYNOPSIS

/usr/dt/bin/sdtudctool [-f file]

DESCRIPTION

Beginning from Solaris 2.6, user–defined characters can be handled as separate font files without editing existing font files.

sdtudctool is a tool for registering user–defined characters at the above areas as separate font files on the Solaris Common Desktop Environment (Solaris CDE). Using sdtudctool, it is possible to register, all at once, user–defined characters for bitmap fonts of various sizes used on-screen. It can even be used to register user–defined characters for outline fonts. Fonts that are created on Solaris CDE can be also used on OpenWindows under Solaris 2.6 and later.

When the directory in which user–defined characters are saved is specified in DTUDCFONTPATH environment variable, stdudctool will edit font files in this directory. Otherwise, it will edit font files in the following directories. (If DTUDCFONTPATH is not specified or the directory is not existed, directories will be created automatically).

Directories which include font files for user–defined characters under Solaris 2.6 and later.

For end user

$HOME/.Xlocale/<locale>/fonts/UDC/

Bitmaps

Type1

CID

For superuser

$OPENWINHOME/lib/locale/<locale>/X11/fonts/UDC/

Bitmaps

Type1

CID

Note that if user–defined characters have registered by fontedit or fontmanager and user want to re–use them, those characters will need to be ported to the new environment. See NOTES below, sdtudc_extract(1), and sdtudc_convert(1).

Screen Configuration

sdtudctool consists of the following 3 basic windows.

• editor

• list

• reference list

It also includes optional dialog and print list dialog screens and so on.

editor

When sdtudctool is started, the following window appears first. If user–defined characters are usable, they will automatically be loaded and displayed.

The screen consists of the following items.

Edit Screen

Screen for editing user–defined characters.

Reference Screen

Screen for displaying a character to use as reference when creating a user–defined character. This screen may be displayed to the right of the Edit Screen either by selecting [Display] -> [Reference] or by pressing the [Reference] button at the right on the toolbar.

Confirmation Screens

Two screens displayed at lower left. The left screen displays the outline of the character, while the right screen displays a bitmap image of the character.

Draw Menu

You can draw graphics by selecting one of the Draw menus at left of edit screen and dragging the mouse on the edit screen.

However, how to operate drawing break lines and polygons are different from other drawing. You can click select button at every start and end point of a line segment on the edit screen, and new lie segment would be started drawing from the point. Fix the drawing by double click at the last line segment.

The following menus are available:

Free–hand

Draws free–hand lines.

Straight line

Draws straight lines.

Break line

Draws break lines.

Polygons

Draws polygons.

Rectangles

Draws rectangles.

Circles

Draws circles.

Eraser

Erases the region indicated by the cursor. However, it is not selected for outline fonts and then it must be selected edit menu for erasing.

Area specification

Specifies the region within which to edit. It must be specified the region first when user uses the command from edit menues. Objects in the specified region will be displayed small rectangles as control points.

To move objects, specify the region and drag the mouse on the center of the object.

For other editing , see EDIT below.

Save button

Select this button to register a user–defined character which has been created on the Edit Screen. Once selected, the user–defined character registered will be displayed in the list.

Next button

Sets the character to be edited to the next user–defined character in the list.

Previous button

Sets the character to be edited to the previous user–defined character in the list.

The following options are displayed on the toolbar.

[Outline]

Sets the display or edit mode for the Edit Screen to outline mode.

[Bitmap]

Sets the display or edit mode for the Edit Screen to bitmap mode.

[Reference]

Displays/Undisplays a Reference Screen to the right of the Edit Screen.

[List]

Displays a list of characters contained in the font file being edited.

The following menus are displayed on the menu bar.

[File]

[Open the user–defined characters. . .]

Loads the font files for user–defined characters under Solaris 2.6 and later and displays them. If the DTUDCFONTPATH environment variable is not valid, sdtudctool will open files in the following directories.

For end user

$HOME/.Xlocale/<locale>/fonts/UDC/

• Bitmaps
• Type1
• CID

For superuser

$OPENWINHOME/lib/locale/<locale>/X11/fonts/UDC/

• Bitmaps
• Type1
• CID

[Open. . .]

Used to load a specified font file. Registered files will not be saved as separate font files, and they will be written into the font files read directly. The font types that can be loaded are following;

• BDE format
• PCF format
• Type1 format (not editable)
• Type3 format (not editable)

[Save]

If the font files for user–defined characters under Solaris 2.6 and later was loaded, this saves it as a user–defined character and sdtudctool does setting required for using of it.

The setting required is setting font path and saving it. The setting font path can be omitted and see OPTION below.

If loaded by directly specifying a font file, changes are directly reflected in that font file. It is not Setting font path and saving it.

[Save as. . .]

Used when saving results of editing as a font file of a different name. This menu cannot be selected if the font files for user–defined characters under Solaris 2.6 and later was loaded. The font types that can be loaded are following;

• BDE format
• PCF format

[Open Dict Tool. . .]

Starts sdtudc_register that is intermediate utility for registering user–defined characters. sdtudc_register displays user–defined characters registered, and you can input and register the user–defined characters in dictionary in this window. See sdtudc_register(1).

[Options]

The following options can be specified.

Grid size

Specifies the grid size on editting for outline mode by point.

Align to grid

Specifies to align to grid the drawing location on editting for outline mode.

Set font path

Adds the directory which saved the user–defined characters. See xset(1).

Save font path

Sets font path to save the user–defined characters to the following files.

For end user:

$HOME/.OWfontpath

For superuser:

$OPENWINHOME/lib/locale/<locale>/OWfontpath

Generation size of the bitmap file

Specifies the size of the bitmap font file that generated automatically when the user–defined characters is saved.

It can generate the following sizes.

• 12, 14, 16, 20, 24

[Exit]

Exits sdtudctool.

[Edit]

Select the object after the region was specified. To move objects, drag the mouse on the center of the object.

[Undo]

Returns to the immediately preceding status.

[Cut]

Cuts the selected region and places it in a buffer. You can draw the contents of the buffer on a edit screen if paste operation will be done after cut.

[Copy]

Copies the selected region. You can draw the contents of the buffer on a edit screen if paste operation will be done after copy.

[Paste]

Pastes the contents of the buffer.

[Delete]

Deletes editing contents. The contents are not placed in a buffer, so paste operation is not available.

[Rotate]

Rotates the selected region.

[Diagonal]

Converts the selected region to a diagonal region.

[Reverse]

For outline mode:

Reverses the direction of the selected font path. sdtudctool draws by non–zero winding number rule for outline mode. Path direction is following;

Draws in the specified order.

free–hand, straight line, break line, polygons

Draws right–handed revolution.

rectangles, circles

For example, if you create whitewashed circles, draw a small circle in a large circle and reverse the small circle. Then the small circle reverses.

For bitmap mode:

Reverses black and white within the selected region.

See PostScript reference manual (Adobe Systems, Inc.) for non–zero winding number rule.

[Display]

[Fill]

Fills the region enclosed by an outline when in outline mode. The resulting image is the one actually used when displaying the outline font.

[Control]

Displays control points when drawing outlines. Area specification is available only if the specified region includes all control points in outline mode.

[Drag display]

Specifies the method to use to display intermediate images when changing the selected region (with Rotate or Diagonal).

[Grid]

Displays a grid on the Edit Screen. Grid can be changed the size by selecting [Grid size] in opetion dialog in outline mode.

[Reference]

Opens the Reference Screen.

[Help]

[Summary]

Displays the sdtudctool(1) this manual page.

[Using help]

Starts AnswerBook.

[About the Solaris gaiji tool]

Displays the version number for the Solaris gaiji tool.

list

This will give a list of characters registered in the font file. If you want to find out what type of characters are registered in a font file read in by sdtudctool.

The following items are displayed on the toolbar.

[Page]

Move to the desired page by moving the slider.

[Left arrow]

Go to the previous page.

[Right arrow]

Go to the next page.

The following items are displayed on the menu bar.

[File]

[Print. . .]

Opens the print dialog. Prints a list of user–defined character registered in the print dialog. The size of printing characters are 15 and 30 points. It is available to specify as follows;

printer name

Specifies the output printer name.

range

this page

Prints a list of user–defined character which is displayed currently.

all pages

Print a list of all user–defined character which is loaded currently.

[Close]

Closes the list window.

[Edit]

[Undo]

Returns to the immediately preceding status.

[Cut]

Cuts the selected region and places it in a buffer.

[Copy]

Copies the selected region in a buffer.

[Paste]

Pastes the contents of the buffer at the specified position.

[Delete]

Deletes the specified character.

[Display]

[Next page]

Goes forward one page if there is a next one.

[Previous page]

Goes backward one page if there is a previous one.

[Size]

Changes the font size being displayed. Size cannot be changed if a bitmap font file is loaded.

[Code]

Changes the code format of the character being displayed.

reference list

This is used when you wish to reference another character while editing a user–defined character. The character reference list window may be displayed by selecting the button at the upper left on the toolbar of the user–defined character editor and then the [Display] -> [Reference] buttons.

The following items are displayed on the toolbar.

[Page]

Move to the desired page by moving the slider.

[Left arrow]

Go to the previous page.

[Right arrow]

Go to the next page.

The following items are displayed on the menu bar.

[File]

[Open]

Opens a file selection list for specifying the font to access. You can specify BDF format, PCF format, Type1 format and Type3 format.

[Select from installed fonts]

Displays a list of fonts which can be used by the system. Select the desired font to view in on the reference list.

[Close]

Closes the reference list.

[Display]

[Next page]

Goes forward one page if there is a next one.

[Previous page]

Goes backward one page if there is a previous one.

[Size]

Changes the font size being displayed. Size cannot be changed if a bitmap font file is loaded.

[Code]

Changes the code format of the character being displayed.

[Other functions]

Solaris gaiji tool supports drag & drop operation; on the list, from the list to edit screen, from reference list to edit screen, and reference list to the list. You can drag & drop by selecting characters and drowing it to the target location.

OPTIONS

-f file

Specifies the font file to be edited.

USAGE

How to start Solaris gaiji tool is opening [desktop apprication] within apprication manager and selecting [Solaris gaiji tool], or entering the following command within terminal emulator and so on.

sun% /usr/dt/bin/sdtudctool

RESOURCES

utRefXFont

Specifies the font displayed in the reference window by XLFD name. Default is –sun–gothic–medium–r–normal––16–140–75–75–c–140–jisx0208.1983–0 .

utUDCPrefix

Specifies the prefix of bitmap/outline font file in which the user–defined character is saved. Default is UDC.

The font file in which the user–defined character is saved is as follows.

For bitmap font file:

<the value of utUDCPrefix><utBDFUDCSize>.pcf

For outline font file:

<the value of utUDCPrefix><utCIDUDCBase>–;<utCIDUDCRange>.ps

For example, the following font files are saved by default in Japanese.

For bitmap font file:

UDC{12,14,16,24}.pcf

For Type1 font file:

UDC[1–20].pfa

For outline font file of JIS encording:

• NewGothicBBB–Medium–{H,V}.ps
• NewGothicBBB–Medium–Hojo–{H,V}.ps
• NewRyumin–Light–{H,V}.ps
• NewRyumin–Light–Hojo–{H,V}.ps

For outline font file of EUC encording:

• NewGothicBBB–Medium–EUC–{H,V}.ps
• NewGothicBBB–Medium–Hojo–EUC–{H,V}.ps
• NewRyumin–Light–EUC–{H,V}.ps
• NewRyumin–Light–Hojo–EUC–{H,V}.ps

For outline font file of SJIS encording:

• NewGothicBBB–Medium–RKSJ–{H,V}.ps
• NewRyumin–Light–RKSJ–{H,V}.ps

For outline font file of 83pv–RKSJ encording:

• NewGothicBBB–Medium–83pv–RKSJ–{H,V}.ps
• NewRyumin–Light–83pv–RKSJ–{H,V}.ps

utUDCBDFSize

Specifies the size for the bitmap font from which to load user–defined characters. Defaults are 12, 14, 16, 20 and 24.

utUDCBDFCR:

Specifies Charset Registry for the user–defined character font. Default is sunudcja.1997.

utUDCBDFCE:

Specifies Charset encoding for the user–defined character font. Default is 0.

utUDCCIDPrefix

Specifies the prefix of outline font file from which to create and load user–defined characters. Default is New.

utUDCCIDBase

Specifies the outline font from which to load user–defined characters. Default is GothicBBB–Medium,Ryumin–Light.

utUDCBDFAliasTo

Specifies an alias for bitmap font in which the user–defined character is saved. Defaults are –sun–gothic–bold–r–normal–*,\ –sun–gothic–medium–r–normal–*,\ –dt–interface system–medium–r–normal–*–*–*–*–*–m–*,\–dt–interface user–medium–r–normal–*–*–*–*–*–m–*.

SEE ALSO

sdtudc_convert(1), sdtudc_extract(1), sdtudc_register(1), sdtudc_map(4)

NOTES

Be sure to perform the following porting procedures if there are user–defined characters which have been registered using fontedit , type3creator , and fontmanager under Solaris 2.5.1 and earlier environments. The following examples are for the default environment in ja locale for end user.

• If user–defined characters have been registered in an existing font file using fontedit

  Use sdtudc_extract to extract the user–defined characters already registered and output them as a separate font file. Be sure the font file name is of the format UDC<font size>.bdf. Next, move the generated file to the directory in which user–defined character are being saved, start sdtudctool, and save the file.

  The folowings are the examples of the default environment for end user in ja locale.

  Example : When extracting user–defined characters from gotm14.pcf

  % sdtudc_extract gotm14.pcf > UDC14.bdf % bdftopcf –o UDC14.pcf UDC14.bdf % mkdir –p ~/.Xlocale/ja/fonts/UDC/Bitmaps % mv UDC14.pcf ~/.Xlocale/ja/fonts/UDC/Bitmaps % /usr/dt/bin/sdtudctool

• If user–defined characters have been registered in an existing font file using type3creator and fontmanager

  Use sdtudc_extract to extract the user–defined characters already registered and output them as a separate font file. Next, move the generated file to the directory in which user–defined character are being saved, start sdtudctool, and save the file.

  Example : When using UDC.ps created using fontmanager

  % sdtudc_extract UDC.ps UDC1.pfa UDC2.pfa . . . % mkdir –p ~/.Xlocale/ja/fonts/UDC/Type1 % mv UDC*.pfa ~/.Xlocale/ja/fonts/UDC/Type1 % /usr/dt/bin/sdtudctool

SunOS 5.9  Last Revised 28 October 1999

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | USAGE | RESOURCES | SEE ALSO | NOTES