home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / HP95_100 / UTILITY / FONTSTUF / PFE.ZIP / PFE.DOC next >
Encoding:
Text File  |  1995-06-19  |  11.3 KB  |  356 lines
  1.          ============================================
  2.          PFE, The PAL Font Editor. Vr.1.02 [06/15/95]
  3.          ============================================
  4.  
  5.  
  6.  PFE is a small font editor which supports character sets
  7. from 4x4 to 16x16 bits of size. PFE can load any .HFN, .VFN,
  8. or FCL font file, and save it in any of these 3 formats:
  9.  
  10.  - HFN: PAL's (Palmtop Application Library) horizontal fonts.
  11.  - VFN: Gilles Kohl's VR (Vertical reader) vertical fonts.
  12.  - FCL: FCL definition file, ready to be compiled by
  13.         Gilles Kohl's FCL font compiler/loader.
  14.  
  15.  * VR and FCL are copyrighted shareware programs written
  16.    by Gilles Kohl.
  17.  
  18.  
  19. What's new in Vr1.02:
  20. ---------------------
  21.  
  22.  + PFE can now edit VR font files created by the VREDIT
  23.    editor. Previous versions of PFE would crash the palmtop
  24.    when a VR font created by VREDIT was loaded in PFE.
  25.  
  26.    VREDIT is a VR editor written by Stefan Peichl and
  27.    can be found in the VRFONT.ZIP in LIB:11 of HPHAND.
  28.  
  29.  + Fixed right scrolling that was producing unnecessary
  30.    pixels.
  31.  
  32.  + The "Open font" window "remembers" the last opened
  33.    filename.
  34.  
  35.  + Added hotkeys in dialog windows.
  36.  
  37. ______________
  38. 1. Running PFE
  39.  
  40.  When you invoke PFE from the command line without any
  41. arguments, PFE will display its internal font. You can
  42. specify the font filename at the command line if you
  43. wish as follows:
  44.  
  45.  pfe <FontName>
  46.  
  47. where <FontName> is the filename of a valid .HFN, .VFN or
  48. .FCL font file. When no extension is given, PFE looks for
  49. the .HFN extension. If the specified filename is not
  50. found, the internal (resident) font will be displayed.
  51.  
  52.  PFE can also load .FCL files for editing. However, there are
  53. a few limitations when loading FCL files in PFE. First,
  54. PFE will ignore any duplicated character definitions in
  55. the FCL file, even if the font size is different. This means
  56. that the FCL file must have character definitions for one
  57. font size only, since PFE can edit only one font at a time.
  58.  
  59.  What you can do when you have an FCL file with different
  60. font definitions is to split it up into one file per font.
  61. You can use FCL's 'include' command in one of the font
  62. files if you want to compile everything in a single .COM
  63. See your FCL.DOC for more details.
  64.  
  65. ________________
  66. 2. Moving around
  67.  
  68.  Once you have loaded a font in PFE, you will notice the
  69. following on the screen:
  70.  
  71.  First, on your left is the Edit window grid. It's inside
  72. that grid that character bitmaps can be edited. On your
  73. right the complete character set of the loaded font is
  74. displayed. On the middle top of the screen you will find
  75. the current ASCII code and display of the selected
  76. character on the set, and the character size. On the top
  77. right the filename of the font will be displayed.
  78.  
  79.  You can press [F1] to get a quick help view of the most
  80. used options.
  81.  
  82.  
  83.  a) Character selection:
  84.  -----------------------
  85.  You can select the character to be edited by using the 4
  86. arrows. A small cursor will guide you through the set, and
  87. the grid will display the bitmap of the selected character.
  88. If the cursor falls on an undefined character bitmap, the
  89. sizing rectangle won't appear on the grid.
  90.  
  91.  
  92.  You can also select a character by pressing the actual
  93. key on the keyboard. For example, pressing 'a' will
  94. bring the cursor to the character 'a'. If you press
  95. SHIFT-A, the cursor will fall on the 'A' character.
  96. Same goes for numbers, and any other character on the
  97. keyboard.
  98.  
  99.  Another alternative for selecting characters is using
  100. the ALT-MENU key combination. By holding down both ALT
  101. and MENU keys, you can enter the ASCII code of the
  102. desired character on the numeric keypad, release the
  103. buttons, and the cursor will go to the selected character.
  104.  
  105.  
  106.  b) New Font [F2]:
  107.  -----------------
  108.  
  109.  Pressing F2 will delete the current font from memory and
  110.  clean up the font area. You will be prompted to enter the
  111.  new font size.
  112.  
  113.  
  114.  c) Edit character [F3] or [ENTER]:
  115.  ----------------------------------
  116.  This brings you to the Edit mode (See section 3 below).
  117.  
  118.  
  119.  d) Set font global size [F4]:
  120.  -----------------------------
  121.  Use this option  if you wish to change the size of all
  122.  the characters in the loaded font. Note that reducing
  123.  the size to smaller than the character's size, the
  124.  characters will be truncated.
  125.  
  126.  If you enter 0 as a width or height value, the original
  127.  width or height of each character will be preserved.
  128.  This is usefull if you are working with proportional
  129.  fonts.
  130.  
  131.  
  132.  e) Copy [F5] & Paste [F6]:
  133.  --------------------------
  134.  You can copy any selected character of the set in the buffer
  135.  by pressing F5 (Copy). You can later use the Paste function
  136.  (F6) to paste the buffer on any other selected character.
  137.  
  138.  
  139.  f) Convert from ISO latin to IBM code page 850 [F7]:
  140.  ----------------------------------------------------
  141.  Use this option if you wish to convert some fonts from
  142.  ISO Latin to IBM code page 850. Once the font is converted
  143.  with this option, it can't be converted back.
  144.  
  145.  
  146.  g) Rotate complete font [F8]:
  147.  -----------------------------
  148.  This function allows you to rotate all the characters
  149.  of the loaded font. Every time you press it, the characters
  150.  will be rotated 90 degrees clockwise.
  151.  
  152.  
  153.  h) Open a font file [F9]:
  154.  -------------------------
  155.  This option will allow you to load a font in PFE. You must
  156.  specify extensions (.HFN, .VFN or .FCL). If no extension is
  157.  given, PFE will default to .HFN
  158.  
  159.  
  160.  i) Save the font [F10]:
  161.  -----------------------
  162.  Once you have finished editing the loaded font, use this
  163.  option to save it. PFE will prompt you to enter the filename,
  164.  the font I.D. number (depending on the font style) and
  165.  to select the format output, HFN, VFN or FCL.
  166.  
  167.  
  168.  j) Delete character from font [DEL]:
  169.  ------------------------------------
  170.  You can remove any character from the font by pressing the
  171.  DELETE button. The selected character will be completely
  172.  removed from the font.
  173.  
  174.  
  175.  k) Quitting PFE [ESC] or [MENU-Q]:
  176.  ----------------------------------
  177.  Before quitting you will be asked if you wish to save the
  178.  current font.
  179.  
  180.  
  181. ______________________________________
  182. 3. Editing a character [F3] or [ENTER]
  183.  
  184.  Once you have selected the character you wish to edit, press
  185. F3 (Edit-mode). The cursor will now appear inside the grid.
  186. Again, you can move around the grid using the arrows, and draw
  187. using the SPACE-BAR. The drawn character will also appear
  188. in real size on the right of the screen inside the set.
  189.  
  190.  
  191.  a) Rotate character [F1]:
  192.  -------------------------
  193.  This simply rotates the selected character 90 degrees clockwise
  194.  every time F1 is pressed.
  195.  
  196.  
  197.  b) Invert character [F2]:
  198.  -------------------------
  199.  This function will invert all pixels of the selected character,
  200.  and produce a 'negative image' of it. Note that only the bits
  201.  inside the sizing rectangle will be inverted.
  202.  
  203.  
  204.  c) Adjust Width [F3]/[Shift-F3]:
  205.  --------------------------------
  206.  You can adjust the logical width of each character by pressing
  207.  F3 / Shift-F3 till you get the desired width.
  208.  
  209.  
  210.  d) Adjust Height [F4]/[Shift-F4]:
  211.  ---------------------------------
  212.  You can adjust the logical height of each character by pressing
  213.  F4 / Shift-F4 till you get the desired height.
  214.  
  215.  e) Scroll Left [F5]:
  216.  --------------------
  217.  Scrolls the character inside the sizing rectangle to the left.
  218.  Note that the limits of the scrolling area are defined
  219.  by the sizing rectangle.
  220.  
  221.  f) Scroll Right [F6]:
  222.  --------------------
  223.  Scrolls the character inside the sizing rectangle to the right.
  224.  
  225.  
  226.  g) Scroll Up [F7]:
  227.  ------------------
  228.  Scrolls the character inside the sizing rectangle upwards.
  229.  
  230.  
  231.  h) Scroll Down [F8]:
  232.  --------------------
  233.  Scrolls the character inside the sizing rectangle downwards.
  234.  
  235.  
  236.  i) Restore character [F9]:
  237.  --------------------------
  238.  Restores the character definition the way it was before
  239.  entering the Edit-Mode (undo).
  240.  
  241.  
  242.  j) Exit Edit mode [F10] or [ENTER]:
  243.  -----------------------------------
  244.  Pressing F10 will save the current definition in the font
  245.  and exit Edit-mode. You must press F10 again to save the
  246.  font to the file.
  247.  
  248.  
  249.  k) Clear character bitmap [DEL]:
  250.  --------------------------------
  251.  Clears the character definition area (all white).
  252.  
  253.  
  254. _________________
  255. 4. Saving a font.
  256.  
  257.  When you exit the Edit-mode, you can then save your font
  258. to a file, by pressing [F10]. PFE will prompt you for
  259. the filename, font I.D. number (depending on the font style)
  260. and the file format you wish your file to be saved in.
  261. Currently, there are 3 file formats, HFN for horizontal
  262. fonts, VFN for vertical fonts, and FCL definition file
  263. for the FCL font compiler/loader. There's no need to
  264. specify an extension, PFE will add the required extensions
  265. depending on the selected file format.
  266.  
  267.  
  268.  
  269.                          ******
  270.  
  271.  
  272.  
  273. IMPORTANT NOTES:
  274.  
  275. * All undefined characters are displayed as 'dots'. PFE
  276.   automatically defines undefined characters to spaces,
  277.   between the ASCII minimum and ASCII maximum range.
  278.   FCL & some existing VR fonts may have such undefined
  279.   characters in that range. so PFE fills them up before
  280.   saving (HFN or VFN format only) with space characters.
  281.  
  282. * When saving to .VFN format, the font must not be rotated
  283.   in PFE. PFE will automatically rotate & flip it for you.
  284.   Note that VR (.VFN) fonts are always 8 or 16 bits of
  285.   height.
  286.  
  287. * When saving a font in .FCL format, font characters that
  288.   exceed 12 bits of height will be truncated. This is
  289.   because the maximum allowable height in FCL definitions
  290.   is 12 (16x12 size).
  291.  
  292.  
  293. * Here's a suggestion for the 16-bit font I.D. (style)
  294.   numbers. You can enter any number as an I.D., but it's
  295.   better to enter something more meaningfull like this:
  296.  
  297.  
  298.              BIT  DESCRIPTION
  299.              --------------------------------
  300.              15 : Proportional flag (1=prop.)
  301.              14 : Bold flag.
  302.              13 : Italic flag.
  303.              12 : Underlined flag.
  304.              11 : Reverse (negative) flag.
  305.              10 : Special flag.
  306.  
  307.              9,8: Unused for the moment.
  308.  
  309.              7-0: Font type ID.
  310.  
  311.  * For normal text all the bits 8-15 are cleared.
  312.  
  313.  The bits 0-7 can describe the type of font which can be one of the
  314.  following:
  315.  
  316.              0 =  ?
  317.              1 = Courier.
  318.              2 = Roman.
  319.              3 = Sans Serif.
  320.              4 = Prestige.
  321.              5 = Script.
  322.              6 = Orator.
  323.              . =  ?
  324.              . =  ?
  325.              . =  ?
  326.            255 = Special.
  327. ________
  328. CREDITS:
  329.  
  330.  Many thanks to the PAL group for creating the wonderfull
  331. PAL library, on which PFE was written with, Andreas Garzotto
  332. for suggesting PFE in the first place, and also for his
  333. suggestions and testing.
  334.  
  335.  Many thanks to Jini Scammell-Tinling for testing PFE and
  336. finding the bugs that have been corrected in this version.
  337. I also want to thank Eric Greenspoon for his suggestions.
  338.  
  339.  And finally, I would like to thank Gilles Kohl for providing
  340. the info on the VFN and FCL file formats.
  341.  
  342.  
  343.   * PFE is copyrighted freeware.
  344.     Portions Copyright 1994, The PAL Group.
  345.  
  346.     Harry Konstas, June 18, 1995, CIS ID: 72540,620.
  347.             Email : 72540.620@compuserve.com
  348.  
  349.   * FCL is copyrighted shareware, written by Gilles Kohl.
  350.  
  351.   * VR (Vertical Reader) is also copyrighted shareware,
  352.     written by Gilles Kohl.
  353.  
  354.   * VREDIT is a VR editor written by Stefan Peichl.
  355.  
  356.