home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / TCOMM / DMATFNTS.ZIP / STARGEN.DOC < prev    next >
Encoding:
Text File  |  1987-04-29  |  15.7 KB  |  394 lines
  1.  
  2.  
  3.  
  4.  
  5.                ╔═╗╔══╔╦╗  ╦╔══╔╦╗══════════════════════════╗
  6.                ╠╦╝╠═ ║║║  ║╠═ ║║║       Robert E. Mason    ║
  7.                ║╚═╚══║╩╚╚═╝╚══║╩╚       5360 Sideburn Rd.  ║
  8.                ║      SOFTWARE ─╥       Fairfax, VA 22032  ║
  9.                ║      ▀▀▀▀▀▀▀▀  ║       (703) 250-2654     ║
  10.                ╚════════════════╩══════════════════════════╝
  11.  
  12.                                   STARGEN
  13.  
  14.                                    V-1.0
  15.  
  16.                       COPYRIGHT 1987 REMJEM SOFTWARE
  17.  
  18.            A Download Character Generator for the Star NX-10/15.
  19.  
  20.                                 Written by:
  21.  
  22.                               Robert E. Mason
  23.                               5360 Sideburn Rd.
  24.                               Fairfax, VA 22032
  25.  
  26.  
  27.      This program is offered as "ShareWare" and, as such, may be freely 
  28.      copied and distributed for personal use.  A donation of $5.00 is 
  29.      requested to help support the operation of REMJEM Software.  Our 
  30.      products are all of the ShareWare type and will continue that way as 
  31.      long as we can afford it.  Reciept of your donation will make you a 
  32.      registered user and we will forward you the source code.
  33.  
  34.      STARGEN was written in April, 1987 in GWBASIC and compiled with 
  35.      MicroSoft's QuickBASIC 2.0.  The two opening screens were composed 
  36.      using Drew Olbrich's ANSIPAINT and saved using the BSAVE option.
  37.  
  38.  
  39.                            HARDWARE REQUIREMENTS
  40.  
  41.      IBM PC/XT/AT or close compatible with:
  42.  
  43.                Color Graphics or Enhanced Graphics adapter
  44.                that will run programs written for the CGA.
  45.  
  46.                Color monitor optional but recommended.
  47.  
  48.                At least 128 K of free memory.
  49.  
  50.                Hard disk desirable but not necessary.
  51.  
  52.                Of course, a Star NX-10 or NX-15 printer.
  53.  
  54.  
  55.                                   PAGE 1
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.    ╔══════════════════════════════════════════════════════════════════════╗
  72.    ║  TABLE OF CONTENTS  █                                                ║
  73.    ║                     █                                                ║
  74.    ║ ╔═╗╔══╔╦╗  ╦╔══╔╦╗  █  1. WHAT STARGEN DOES ..................... 3  ║
  75.    ║ ╠╦╝╠═ ║║║  ║╠═ ║║║  █                                                ║
  76.    ║ ║╚═╚══║╩╚╚═╝╚══║╩╚  █  2. INSTALLING STARGEN .................... 4  ║
  77.    ║ ║      SOFTWARE ─╥  █                                                ║
  78.    ║ ╚════════════════╝  █  3. STARGEN DIRECTORY/DRIVE SUPPORT ....... 5  ║
  79.    ║                     █                                                ║
  80.    ║                     █  4. DEFINING CHARACTERS ................... 5  ║
  81.    ║  5360 Sideburn Rd.  █                                                ║
  82.    ║  Fairfax, VA 22032  █  5. DOWNLOADING FONT (.DNL) FILES ......... 6  ║
  83.    ║  ┌──────────────┐   █                                                ║
  84.    ║  │(703) 250-2654│   █  6. USING BLOCK GRAPHICS CHARACTERS ....... 7  ║
  85.    ║  └──────────────┘   █                                                ║
  86.    ╟  Help Support the   █  7. CHECKING YOUR OUTPUT .................. 7  ║
  87.    ║  ShareWare Market.  █                                                ║
  88.    ║                     █                                                ║
  89.    ║                     █                                                ║
  90.    ╚══════════════════════════════════════════════════════════════════════╝
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.                                     PAGE 2
  112.  
  113.  
  114.       1.   WHAT STARGEN DOES
  115.  
  116.            The Star NX-10 and its bigger brother, the NX-15, are great 
  117.            printers for the money.  The low cost, coupled with the many 
  118.            features provided and the quality of the printed output have 
  119.            made these printers two of the most popular sellers in a 
  120.            very crowded market.
  121.  
  122.            The NX-10, (Hereafter, when I refer to the NX-10, I am also 
  123.            talking about the NX-15), has the capability to print out a 
  124.            complete set of "user-defined" characters, both in the draft 
  125.            and letter-quality modes.  Unfortunately, it is an extremely 
  126.            tedious task to define and download your desired characters 
  127.            if the directions given in the instructions are followed to 
  128.            the letter.  If you are an NX-10 owner, (and you probably 
  129.            wouldn't be reading this if you weren't), this powerful 
  130.            feature has likely gone unused due to the complexity of the 
  131.            process.  STARGEN can open up this feature to the user who 
  132.            is reluctant to spend the inordinate amount of time to 
  133.            manually define downloadable characters.  If you are like 
  134.            me, you'll find it fun instead of a chore.
  135.  
  136.            STARGEN supports creation and modification of all the 
  137.            printable characters on the NX-10 in the NLQ mode.  I tried 
  138.            making characters in the draft modes and found the results 
  139.            somewhat unsatisfactory.  The draft modes only support char- 
  140.            acters that can be defined in an 8 high by 11 wide pixel 
  141.            grid with an additional limitation that no two of the 
  142.            horizontal dots can be placed next to each other.  The user 
  143.            manual infers that the same limitation (on horizontal dot 
  144.            placement) is true for the NLQ mode.  DON'T YOU BELIEVE IT!  
  145.            The NLQ mode will accept and print a full 16-high by 11-wide 
  146.            character grid with ALL of the dots printing if you define 
  147.            them that way.  Take a good look at the print from the 
  148.            normal NLQ characters.  Most have adjacent horizontal dots.
  149.  
  150.            STARGEN allows easy definition of characters and creates a 
  151.            file on your disk drive that may be downloaded, from the DOS 
  152.            level, with a simple "TYPE" command. STARGEN is fully 
  153.            menu-driven and contains many error-checking features to 
  154.            assure good, usable output files. 
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.                                  PAGE 3
  168.  
  169.  
  170.      2.   INSTALLING STARGEN
  171.  
  172.           Downloading characters to the NX-10 requires that Dip Switch 2-1 
  173.           be set to the OFF position.  The disadvantage of this is that 
  174.           you lose the large print buffer normally in the printer, and 
  175.           revert to a one-line buffer.  Since the dip switches are 
  176.           somewhat difficult to access, you are faced with the choice of 
  177.           having a large buffer or being able to download special 
  178.           character sets.  There is an advantage to a one-line buffer, 
  179.           however.  Programs that print large files in the NLQ or bold 
  180.           print mode will not suffer DOS time-outs due to the buffer 
  181.           filling up.  (It seems that the NX-10 waits until the buffer is 
  182.           significantly emptied before accepting more characters.  This 
  183.           can cause time-outs in some operations when the printer is in 
  184.           one of the slow-printing modes.)
  185.  
  186.           STARGEN requires no special installation procedures.  It is 
  187.           recommended, however, that if you install it on your hard disk, 
  188.           it occupy a directory (or subdirectory) of its own.  After 
  189.           defining several font files, locating a particular file among 30 
  190.           or 40 other unrelated files could be unproductive.  It is also 
  191.           recommended that a batch file be constructed in your root 
  192.           directory to call STARGEN automatically.  Do this by entering 
  193.           (at the DOS level) the following:
  194.  
  195.                COPY CON SG.BAT         (Press RETURN after each line.)
  196.                ECHO OFF                (Optional)
  197.                CD\STARGEN              (or other directory name you want.)
  198.                STARGEN^Z               (Press F6 to bring up the "^Z".
  199.                                         This is the END-OF-FILE mark that
  200.                                         DOS needs to save the SG.BAT file
  201.                                         to your root directory.  Press
  202.                                         RETURN and the BAT file will be
  203.                                         saved.)
  204.  
  205.           Be sure that the two .SCN files: STARGEN1 and STARGEN2 are in 
  206.           the same directory as STARGEN.EXE.  
  207.  
  208.           STARGEN will also run from a floppy disk drive.  Again, be sure 
  209.           that both .SCN files are on the same floppy disk.
  210.  
  211.           STARGEN is totally menu-driven.  That is, every step in the 
  212.           process of building your font file is accompanied by a menu of 
  213.           choices to proceed to the next step.  The only exceptions are:
  214.  
  215.                If you do not have ANSI.SYS called up in your CONFIG.SYS 
  216.                file (DEVICE=ANSI.SYS), the opening screen, which normally 
  217.                flashes "PRESS ANY KEY TO CONTINUE" will not be visible. 
  218.                Just press a key and the second screen will come up. 
  219.  
  220.  
  221.  
  222.  
  223.                                   PAGE 4
  224.  
  225.  
  226.      3.   STARGEN DIRECTORY/DRIVE SUPPORT
  227.  
  228.           STARGEN supports multiple drives and/or directories.  If a file 
  229.           name is specified with drive and/or directory prefixes, the 
  230.           program will automatically go to those directories to load or 
  231.           save your font (.DNL) file.  To load or save font files to the 
  232.           default directory (or drive), just enter the name of your file, 
  233.           without an extender, at the prompt as:
  234.  
  235.                FILENAME            ( File will be loaded or saved in 
  236.                                      default drive and directory.)
  237.  
  238.           If you wish to load or save a font file to a different drive or 
  239.           directory, enter the file name as:
  240.  
  241.                A:FILENAME          ( Loads or saves file to default 
  242.                                      directory in A: drive.)
  243.  
  244.                \FONTS\FILENAME     ( Loads or saves file to a directory on 
  245.                                      the default drive named: FONTS )
  246.  
  247.                D:\FONTS\FILENAME   ( Loads or saves file to the FONTS 
  248.                                      directory on D: drive.)
  249.  
  250.           STARGEN automatically strips extenders from filenames and adds 
  251.           an extender of .DNL.  This is to assure consistency of file 
  252.           names and identifies the file as one that may be directly 
  253.           downloaded to the printer from the DOS level.  See page 6 for 
  254.           instructions for directly downloading font files from DOS.
  255.  
  256.  
  257.      4.   DEFINING CHARACTERS
  258.  
  259.           STARGEN makes the definition of custom characters easy and even 
  260.           fun to do.  A grid (NLQ CHARACTER MATRIX) of 11 pixels wide and 
  261.           16 pixels high is drawn on the screen.  To define your custom 
  262.           character, move the cursor around the matrix with the cursor 
  263.           keys and press the space bar to enter a pixel (printed dot), or 
  264.           to remove a pixel if one already exists.
  265.  
  266.           A very powerful feature of STARGEN allows you to copy to the 
  267.           matrix a previously-defined character and modify it to make your 
  268.           new character.  This is a great time-saver if used.  To activate 
  269.           the copy routine, press the C key any time that you are in the 
  270.           matrix.  The program will ask you for the character to copy.  
  271.           Enter a character from the keyboard or the equivalent ASCII code 
  272.           for the desired character and press RETURN.  If the character 
  273.           was previously defined, it will then be drawn on the matrix and 
  274.           can then be modified to the new character definition.  A hint: 
  275.           When creating a new font set, define the characters; B,O,I,8, 
  276.           and E first.  Many other characters can be constructed from 
  277.           minor modifications of these characters.
  278.  
  279.                                   PAGE 5
  280.  
  281.  
  282.           After defining your character, press RETURN to save that 
  283.           character in memory.  Please note that it is not saved to the 
  284.           disk file yet.  If you exit the program at this point, you will 
  285.           lose any character you have defined.  Press the S key to save 
  286.           your file or the M key to modify another character.
  287.  
  288.           You will note "tick marks" on the edges of the character 
  289.           matrix.  These define the normal character size and placement of 
  290.           the standard NX-10 NLQ characters.  It is recommended that you 
  291.           use these when defining a partial set of characters for the 
  292.           following reason:  
  293.  
  294.           The font files, created by STARGEN, copy the printer default 
  295.           characters into printer RAM when downloaded.  This is necessary 
  296.           when downloading to assure that all characters are defined.  
  297.           Otherwise, only those characters that you have defined will be 
  298.           printed.  The others will contain garbage bits.  ( A side note: 
  299.           The NX-10 does not copy the default definitions to ASCII 
  300.           characters 020 or 021.  If you want these characters to be 
  301.           printed correctly, you will have to define these as part of your 
  302.           set. )
  303.  
  304.  
  305.      5.   DOWNLOADING FONT (.DNL) FILES
  306.  
  307.           Font files created with STARGEN may be directly downloaded at 
  308.           the DOS level or may be downloaded from within the program.  To 
  309.           download from the program, select D from the opening menu and 
  310.           follow the menu prompts.  Downloading from the DOS level is done 
  311.           by entering:
  312.  
  313.                TYPE FILENAME.DNL >PRN
  314.  
  315.           Be sure your printer is on and on line.  You will observe that 
  316.           the printer will automatically go to the NLQ mode and any 
  317.           subsequent printing will be in the newly-defined font.  A sample 
  318.           file called TINYPRINT.DNL is included to start with.  Try it.
  319.  
  320.  
  321.      6.   USING BLOCK GRAPHICS CHARACTERS
  322.  
  323.           Another problem with downloading characters to the NX-10 is that 
  324.           the printer will not print the lower extensions to the box or 
  325.           block graphics characters (ASCII 176 to 223 and 244) that it 
  326.           prints in the normal (IBM) modes.  This results in those 
  327.           characters not merging with each other in the printed output.  
  328.           Vertical merging can be achieved by reducing the vertical 
  329.           spacing between lines to 7/72" with the command: (ESC) "1".  
  330.           Unless your text characters are small (as with TINYFONT.DNL), 
  331.           they will merge together, top to bottom and be generally 
  332.           unreadable.  The best approach is to not mix text and graphics 
  333.           characters in the same file.
  334.  
  335.                                   PAGE 6
  336.  
  337.  
  338.           A special downloadable file is included to set the printer to 
  339.           the 7/72" line spacing required to print block graphics 
  340.           characters.  This file is named: 7-72.DNL.  It is a special file 
  341.           that may be downloaded along with your font file to set the 
  342.           printer to the line spacing required to vertically merge the 
  343.           block characters. To use from DOS, enter:
  344.  
  345.                COPY FILENAME.DNL+7-72.DNL PRN:
  346.  
  347.           Subsequent printing will be at the reduced line spacing.  
  348.  
  349.  
  350.      7.   CHECKING YOUR OUTPUT
  351.  
  352.           A BASIC program, STARCHAR.BAS is included to check your output 
  353.           file. (It also prints out all of the NX-10 printable character 
  354.           set with the ASCII codes identified.)  To use it, bring up 
  355.           BASICA or GWBASIC and LOAD "STARCHAR". Before running STARCHAR, 
  356.           be sure the printer is on-line and at the top of a page.  
  357.  
  358.  
  359.  
  360.  
  361.                                  HAVE FUN!
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.                                   PAGE 7
  392.  
  393.   
  394.