Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
dtudcfonted(user cmd)					 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-de-
	     fined 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 Se-
       lection 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 Charac-
       ter Edit	window contains:

	  o  A list of the characters being edited

	  o  The editing pane, with each square	corresponding to one dot

	  o  Drawing tools

	  o  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 dis-
       played.

       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 Charac-
       ter 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 cur-
		       sor  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 cur-
		       sor 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 cur-
		       sor 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 but-
		 ton.

       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 cur-
		       sor 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	clock-
		 wise, 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 but-
		 ton.

       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, spec-
       ify 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  Con-
       firmation  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  but-
       ton  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 destina-
	     tion code.	A code in the user-defined character area can be spec-
	     ified.

	  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 can-
	     cel 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  des-
       tination, 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)

							 dtudcfonted(user cmd)

NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | ENVIRONMENT VARIABLES | RESOURCES | ACTIONS/MESSAGES | ERRORS/WARNINGS | FILES | EXAMPLES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dtudcfonted&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help