home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 2 / ctrom_ii_b.zip / ctrom_ii_b / PROGRAM / ASSEMBLE / MODEX104 / FONTEDIT / CSEDIT.DOC < prev    next >
Text File  |  1993-05-14  |  9KB  |  197 lines
  1.  
  2. CSEDIT - A Simple Font Editor by Matt Pritchard
  3.  
  4.  
  5. CSEDIT is distributed with MODEXnnn.ZIP, the general purpose MODE X
  6. Library for VGA Graphics.
  7.  
  8. WHAT YOU NEED TO RUN CSEDIT:
  9.  
  10.     * A Vga Monitor
  11.     * A Microsoft Compatible Mouse
  12.  
  13.     A Mouse is most definitely required, as the keyboard is used for
  14.     nothing except entering file names.
  15.  
  16. FILES NEEDED IN THE CURRENT DIRECTORY:
  17.  
  18.     CSEDIT.EXE  - The Font Editor Program
  19.     CHARSETS.CS - The Font Editor's Internal Fonts
  20.     PALETTE.CS  - The Font Editor's Palette
  21.     MOUSEIMG.CS - The Font Editor's Mouse Pointer
  22.  
  23. SAMPLE FONT FILE THAT SHOULD BE INCLUDED:
  24.  
  25.     SYSTEM.FNT   - The Font used by CSEDIT.EXE
  26.     INVERSE.FNT  - An Inverted version of SYSTEM.FNT
  27.     SPACEAGE.FNT - A Futuristic, Tech style font
  28.     ROM_8X8.FNT  - The Lower 128 characters from the VGA BIOS Rom
  29.  
  30. WHAT IT EDITS:
  31.  
  32.     8 by 8 character fonts, 128 characters at a time. 2 fonts at a time.
  33.  
  34. HOW IT WORKS/FEATURES:
  35.  
  36.     CSEDIT allows the user to edit 2 different font groups at a time,
  37.     which may be loaded and saved separately.
  38.  
  39.     A enlarged character grid allows the user to edit individual pixels
  40.     on a selected character.
  41.  
  42.     The Following operations can be performed on a single character or
  43.     simultaneously on a selected block of characters.
  44.  
  45.        * Shift the selected character(s) in any direction
  46.          with or without clipping at the edges.
  47.        * Vertically Flip the selected character(s)
  48.        * Horizontally Flip the selected character(s)
  49.        * Rotate the selected character(s) 90 Degrees Clockwise
  50.        * Rotate the selected character(s) 90 Degrees Counterclockwise
  51.        * Clear the selected character(s)
  52.        * Invert the selected character(s)
  53.        * XOR the selected character(s) with other character(s)
  54.        * AND the selected character(s) with other character(s)
  55.        * OR the selected character(s) with other character(s)
  56.        * Copy the selected character(s) to another position or font.
  57.  
  58.     An UNDO feature allows the reversal of the most recent operation.
  59.  
  60. DESCRIPTION OF OBJECTS/FEATURES FROM THE TOP DOWN:
  61.  
  62.     Character Grid:  (RED) Box in Upper Left corner of screen.  This is
  63.         where you edit an individual character. The Left Button sets the
  64.         pixel the mouse pointer is on, while the Right Button clears that
  65.         pixel.
  66.  
  67.     Scroll Buttons:  The Four Scroll Buttons are labeled with directional
  68.         arrows, and arranged in a diamond pattern.  Left Clicking on a
  69.         directional button will scroll the currently selected character
  70.         in that direction, with the pixels on the edge rolling off and
  71.         appearing on the other size.  Right Clicking will prevent the
  72.         pixels from rolling to the other side.
  73.  
  74.     Vertical Flip Button:
  75.     Horizontal Flip Button:  Clicking these buttons will flip the pattern
  76.         of the currently selected character(s) around the indicated axis.
  77.         i.e. the top row will be swapped with the bottom row, etc. or the
  78.         left row column will be swapped with right column, etc.
  79.         depending upon which button you push.
  80.  
  81.     Invert Button:  Clicking this button causes all pixels in the selected
  82.         character(s) to flip flop between on and off.
  83.  
  84.     Clear Button: Clicking this button erases the selected characters
  85.  
  86.     Rotate Buttons: Clicking these buttons will rotate the pattern in the
  87.         selected character(s) 90 degrees in the indicated direction.
  88.  
  89.     XOR Button: Clicking this button will let you XOR the currently
  90.         selected character(s) with other character(s) in either font.
  91.         The Button will turn RED, indicating that it is waiting for
  92.         you to click on the desired character (or upper left corner
  93.         of the desired block of characters) in either the Red or Green
  94.         Character Set Displays.  Clicking anywhere else will abort this
  95.         process without doing anything.  If you click on (any of) the
  96.         selected character(s) the operation is aborted.  If a block is
  97.         selected and the character you click on is in a position where
  98.         it can't represent the upper left corner of a block of the same
  99.         size, then the operation is not performed.
  100.  
  101.     AND Button & OR Button:  These buttons work just like the XOR Button
  102.         except that the Binary operation performed is either an AND or OR
  103.         depending upon which button you have selected.
  104.  
  105.     COPY Button: This button lets you copy a character or selected block
  106.         of characters to another area in the current font or the other
  107.         font.  After clicking, the button turns RED and works much like
  108.         the XOR Button.  Clicking on a valid position in either font
  109.         window will copy the selected character(s) to that location.
  110.  
  111.     MODE Button: Clicking this button toggles the editor between BLOCK
  112.         mode and CHARACTER mode.  The current mode is displayed on a plate
  113.         at the top of the screen, just to the right of the enlarged
  114.         character grid.  In character mode the plate will read "CHAR" and
  115.         the currently selected character is displayed just to the right
  116.         of the plate.  In Block mode the plate will read "BLOCK" and the
  117.         enlarged character grid is disabled.
  118.  
  119.     UNDO Button: Clicking this Button will UNDO or reverse the effects of
  120.         the most recent operation.
  121.  
  122.     QUIT Button: Clicking this button will return you to DOS.  Any loaded
  123.         fonts are not saved, and no confirmation is given.
  124.  
  125.  
  126.     GREEN FONT AREA:  This area displays one of the current fonts which
  127.         can be edited.  The characters are display in order from #0 to #127
  128.         from the upper left, going right, then down.  The Font Box is 32
  129.         characters wide and 4 characters Tall.  When the editor is in
  130.         character mode, just point at and Left Click on the character you
  131.         wish to edit and a Cyan box will appear around that character.
  132.  
  133.       * If you Right Click on a character, the last current character,
  134.         which will still appear in the enlarged character grid, will be
  135.         copied onto the character you pointed at, replacing it.  This is
  136.         a shortcut for copying characters: You can hold the right button
  137.         down an fill in a large area with a single character pattern.
  138.         When the editor is in Block Mode, you select an area by clicking
  139.         on any corner of the desired block.  Then drag the mouse to the
  140.         opposite corner while holding down the left button.  A Cyan Box
  141.         will stretch to surround the selected block of characters.
  142.  
  143.     GREEN FONT FILE NAME BOX:  This Text Box is used to enter the name
  144.         of a font file to load or the name to save the current Green font
  145.         as.  Just click on the Box, and it will change color and a
  146.         flashing cursor will appear.  Now you type in a filename or edit
  147.         the existing filename.  Press <RETURN> or click outside the text
  148.         box to end editing.
  149.  
  150.     GREEN FONT LOAD BUTTON:  Clicking this button will load the font file
  151.         that is named in the Green File name box.  If no name is given or
  152.         no such file exists, then nothing will be loaded.
  153.  
  154.     GREEN FONT SAVE BUTTON:  Clicking this button will save the current
  155.         font in the Green Font Area under the name given in the File Name
  156.         Box.  If a Valid name is not provided, nothing will be saved.
  157.  
  158.     RED FONT AREA:  This is just the same as the GREEN FONT AREA; providing
  159.         you with the ability to copy and edit between multiple fonts.
  160.  
  161.     RED FONT FILE NAME BOX:  This works just like the GREEN FONT FILE
  162.         NAME BOX.
  163.  
  164.     RED FONT LOAD BUTTON:  This works just like the GREEN FONT LOAD BUTTON.
  165.  
  166.     RED FONT SAVE BUTTON:  This works just like the GREEN FONT SAVE BUTTON.
  167.  
  168.     Message Bar:  At the very bottom of the screen, this Bar will display
  169.         information and messages for various functions.
  170.  
  171.  
  172. FONT FILE FORMAT:
  173.  
  174.     BINARY Image, in order of character.  The format is identical to that
  175.     used by the VGA ROM.  The Files will be exactly 1024 (128 * 8) bytes
  176.     long.
  177.  
  178.     CHARACTER: 8 Bytes
  179.  
  180.     FONT: Array (0 to 127) of CHARACTER
  181.  
  182.  
  183. COMMENTS, QUESTIONS, BUG REPORTS, etc:
  184.  
  185.     Send the to the Author:  Matt Pritchard
  186.  
  187.     Through the 80xxx Fidonet Echo or
  188.  
  189.     Matt Pritchard
  190.     P.O. Box 140264
  191.     Irving, TX  75014
  192.  
  193. CREDITS:
  194.  
  195.     This Font Editor was written in QuickBASIC 4.5
  196.  
  197.