home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 555a.lha / wbfed_v0.93 / readme.pp / readme
Text File  |  1991-10-05  |  12KB  |  283 lines
  1. Use this software at your own risk.  It is provided "as is" and author
  2. accepts no reponsibility or liability of any kind for it's use.
  3.  
  4. Your support (monetary, technical, moral, back, and Cubs) will be appreciated
  5. and reciprocated.  Without such support, any future release will be inferior
  6. to it's potential, non-existant, or crippled.
  7.  
  8. Please do not re-distribute the registered version.
  9.  
  10. © 1991, Patrick F. Clark
  11. 2545 30th Avenue Court
  12. Moline, IL  61265
  13. (309) 764-0199
  14. BIX: pclark
  15.  
  16. REMARKS
  17.  
  18.     Requires 2.04.
  19.     
  20.     This is a Bitmapped font editor only, and there are no plans to implement
  21.     outline font editing.  My reasoning is as follows: outline fonts are black
  22.     and white only and useful primarily for printed output.  The Amiga is most
  23.     useful in video work which requires color.  Outline fonts are available by
  24.     the thousands.  An outline font editor would be too expensive.
  25.  
  26.     Program requires fair amounts of chip memory. This effectively limits large
  27.     color fonts to machines with 1 or 2 mb chip memory.  A character set uses
  28.     chip memory in proportion to the max width, height, depth, and number of
  29.     defined characters.  New characters require more chip memory than existing
  30.     characters (because exact size is unknown at allocation), so if you are
  31.     short of memory in creating a new font, Saving may free up some space.
  32.  
  33.     Be sure you have a complete character set specified for "System Default
  34.     Text."  Font is used in buttons to indicate proper character forms.
  35.     I find Courier to be good.  Any reasonable size will work.
  36.  
  37. OPERATION
  38.  
  39.     Fonts can be retrieved from anywhere, and saved back where they came
  40.         from.  (Existing fonts do not require a font contents record, etc.)
  41.         New fonts can only be saved in FONTS directory and will create/
  42.         update font contents record as necessary.
  43.  
  44.     Keyboard (as well as buttons) selects character.
  45.     
  46.     A defined character's button is displayed in a highlighed manner.  A
  47.         character is "defined" if it has width or kerning.
  48.  
  49.     "Standard Character Set" menu item doesn't enforce such.  Just displays
  50.         fewer buttons.
  51.  
  52.     "Grid" menu item will auto deselect for very large characters.
  53.  
  54.     Top two actual-size text lines come and go as space permits.  Top line
  55.         shows the entire set from the character *before* the one you're on,
  56.         all the way to the end, as line space allows, so you can see the effect
  57.         of kerning.  Second line is some plain text.
  58.     
  59.     All changes to a character are "drawn" in the magnify window.  The width
  60.         of the window indicates the maximum horizontal extent of the bits of
  61.         the given character.  That extent varies by character.  A new character
  62.         has an extent a little larger than the maximum you specify in the New
  63.         Font request, or a little larger than the largest character in an
  64.         existing font.  In order to increase the width of an existing font by
  65.         a large amount, it will be necessary to save the font.
  66.     
  67.     There is a limit to the maximum and minimum kerning values that seemed
  68.         reasonable, and which I think would be capable of creating right to
  69.         left fonts.  However, I don't really know how such a font is supposed
  70.         to be stored, and it has not been tested in that usage.
  71.     
  72.     Save Font does an implicit re-load.
  73.         
  74.     The effects of changes to a character are shown on the magnified image and
  75.         on the top text line, if any.  Changes are not shown in the second
  76.         text line until it is redrawn.  (Kerning effects are shown in all
  77.         three places.)
  78.  
  79.     The "illegal character" character is supplied by the program and cannot be
  80.         edited.  It is not the commonly used rectangle, but a series of
  81.         vertical lines.
  82.  
  83.     The 1.3 default colors are right for the first 4 colors.  Didn't try to
  84.         find out what the remaining default colors are, if indeed they exist.
  85.  
  86.     Color fonts are saved with the colors in use at the time.  A complex color-
  87.         map of an existing font can thus be lost and be difficult to re-create.
  88.  
  89. New items in version 0.92
  90.  
  91.     Speed/smoothness enhancements.
  92.     
  93.     Import Font "merges" (see below) the characters of the imported font onto
  94.     the characters of the current font.  Used primarily as a substitute for
  95.     Save As (which doesn't exist) in order to create a new font based on an
  96.     existing one.  I chose to use Import instead of Save As because I have
  97.     been burned too often by choosing Save rather than Save As after having
  98.     changed a file, and damaged the original in so doing.  Note that the
  99.     characteristics of the New Font take precedence over the Import Font.  This
  100.     allows one to change the number of colors, the size, and the "fixedness" of
  101.     a font: use New to specify the characteristics you want, then use Import.
  102.     Characters are aligned at their upper left corners in the Import process,
  103.     but it may be preferable to align at the lower left -- let me know what you
  104.     think.
  105.                 
  106.     Uses custom screen with new look.  Attempts to display with raised buttons
  107.     using palette of loaded font.
  108.  
  109.     Allows color palette changes to color fonts.
  110.  
  111.     Drawing tools: select a group via menu
  112.         Normal Group
  113.             Freehand:   Dragging "paints" while mouse is down.
  114.  
  115.             Bezier:     Click one end point.  First point must be inside of
  116.                         magnify box.  Other 2 points need not be.
  117.                         Drag to second end point. ** see note
  118.                         Move mouse, generating desired curve.
  119.                         Click to complete.  ** see note
  120.                     
  121.                         Drawing tool is reset to Freehand by software
  122.                     
  123.                         ** Note: If pointer is off the window, press any key
  124.                         to complete.  Window may have to be resized and
  125.                         dragged in order to draw left-curving lines.  The
  126.                         curve will be clipped to the character box.
  127.  
  128.             Ellipse:    Drag out a rectangle and release.  Note that all
  129.                         ellipses are an odd number of bits in each direction.
  130.                         With small characters, it is more acurate to draw
  131.                         a guide ellipse (see below), and then draw manually.
  132.  
  133.             Filled ellipse: Same as above.
  134.  
  135.             Rectangle:  Same.
  136.  
  137.             Filled rectangle: Same.
  138.  
  139.             Line:       Drag out a line.
  140.  
  141.             Fill:       Point and click.  Drawing tool is reset to Freehand by
  142.                         software.
  143.         Splines Group
  144.             Freehand:   Same as normal.
  145.  
  146.             Fill:       Same as normal.
  147.  
  148.             Spline:     Draws a quadratic spline based on directrix lines made
  149.                         with the following 3 tools.  Splines proceed from the
  150.                         center of one line to the center of the next.  The
  151.                         direction of the lines is significant.  Note that the
  152.                         button is a "command" that is executed immediately.
  153.                         All other buttons are "modes" and do not do anything
  154.                         without further action.
  155.  
  156.             PolyDraw:   Draws connected directrix lines.  Click on each end
  157.                         point once, and on final end point twice.  The
  158.                         direction of the lines is maintained as drawn.
  159.  
  160.             Rectangle:  Draws a rectangular connected set of directrix lines.
  161.                         The direction of the lines is clockwise if you drag
  162.                         the rectangle down and right or up and left.  Other-
  163.                         wise counterclockwise.
  164.  
  165.             Line:       Draws a single drectrix line pointing from the
  166.                         starting point to the ending point.  The ending point
  167.                         is indicated with a "bulb" on it's end.
  168.             
  169.         Guide Lines Group: temporary drawing of several kinds for use in
  170.         guiding the drawing of "real" lines.
  171.             All tools are the same as normal, except filled tools are misssing.
  172.             
  173.  
  174.     Editing Tools: (editing tools do not use the clipboard)
  175.         Copy: copies the entire character to the copy buffer.
  176.         Cut: copies the entire character to the copy buffer and then clears
  177.             the character.
  178.         Copy Bits: stretch out a rectangle.  Bits so selected are copied to
  179.             the copy buffer.
  180.         Paste: If copy buffer was filled via Copy Bits, changes pointer to a
  181.             paste-pot brush: point and click to paste the bits where you want.
  182.             If copy buffer was filled va Cut or Copy, does an immediate paste
  183.             of the entire character.
  184.         Merge: copy buffer is "merged" with character. Operates as does Paste.
  185.         Undo: Replaces the character with the contents of the undo buffer.  The
  186.             undo-buufer is re-filled whenever you change to a new character and
  187.             whenever you *manually* select a drawing tool.  The undo is a
  188.             "single level" style, and there is no re-do.
  189.  
  190.     Re-sizing of window is available.  If window is sized below a certain
  191.         point, will switch to topaz for buttons.  Even smaller windows
  192.         have no buttons.  A window can be too small for any useful work, in
  193.         which case the program will complain.
  194.  
  195. TO DO LIST
  196.  
  197.     Use of system "scale" function and/or auto-scaled outline-based fonts.
  198.     
  199.     Implement re-do.
  200.  
  201.     Allow control over magnification.  Would require scrollable design box.
  202.  
  203.     Cause guide lines to stay longer
  204.  
  205.     Coordinate display
  206.  
  207.     Flip horizonally and vertically
  208.  
  209.     Big cross-hair pointer for rectangles, etc
  210.  
  211.     Circle/ellipse from center (?  The current way may be best for fonts.)
  212.  
  213.     Save as
  214.  
  215.     Color re-map
  216.  
  217.     Width/height changes, fixed/proportional changes, n-colors changes other
  218.     than via New followed by Import.
  219.  
  220.     Clipboard support
  221.         Cut/Copy/Paste are internal only.  Copy buffer does survive Save/Open/
  222.         New, so you can exchange characters that way.
  223.  
  224.     Automatic sizing window to minimum practical size.
  225.  
  226.     Allow user-supplied text to be displayed.
  227.  
  228.     Handle right to left fonts?
  229.  
  230. KNOWN BUGS
  231.  
  232.     Sometimes saves larger files than it loads.  I know why, but it's a pain
  233.         to fix.
  234.     
  235.     This is a preliminary release.  Don't save over only copy of a font.
  236.  
  237. GOTCHAs
  238.  
  239.     Workbench uses a different text texhnique than Intuition.  Color fonts have
  240.     color zero transparent on WB, but opaque on Intuition titlebar.  Don't know
  241.     about console.
  242.  
  243. HELP NEEDED
  244.  
  245.     Is there any doc on Color Fonts?  I worked only with .h file.  Be careful.
  246.     Does anyone have a right to left font?  I'd like to see one.  Are they
  247.         actually supported?
  248.  
  249. HELP RECEIVED
  250.  
  251.     --    Bix ID: JMBEZEAU for bezier and spline routines
  252.     --    Bix ID: LUKE.WOOD for helpful suggestions and another bezier routine
  253.  
  254. UPDATE LOG
  255.  
  256.     0.9     Initial release 8/4/91
  257.  
  258.     0.91    Well, that didn't take long!  Fixed fonts were screwed because of
  259.             a misunderstanding I had of how the space they occupy on the screen
  260.             is calculated.  The "fixedness" appears only to apply to quick
  261.             cursor calculations.  If the CharSpace array or the CharKern
  262.             array is present, then character display can easily turn out to be
  263.             proportional.  My old routine worked in all cases with any new or
  264.             existing font, but system routines would not work with my version
  265.             of a fixed font.  The existing font base follows the actual rules.
  266.             8/5/91
  267.  
  268.     0.911   Added user re-size 8/6/91
  269.             Added undo 8/6/91
  270.             Speeded up magnify 8/7/91 (BltBitMapRastPort() vs RectFill())
  271.             Smoothed operation of Cut/Copy/Paste 8/7/91 (no more big re-think)
  272.             Kept "shading" of defined characters more up to date 8/7/91
  273.  
  274.     0.92    Added drawing tools 8/8-9/91
  275.             Added custom screen etc 8/14/91
  276.             Added palette requester 8/15/91
  277.             Developed very fast magnify 8/16-18/91
  278.             Added Edit enhancements 8/21/91
  279.             Reduced memory usage 8/22-27/91
  280.             Added Import 9/13/91
  281.  
  282.     0.93    Added Color re-map 9/16/91
  283.