home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / DPSX / TC-COLOR.ZIP / TC-COLOR.DOC next >
Encoding:
Text File  |  1988-08-27  |  8.8 KB  |  193 lines
  1.                                     TC-COLOR
  2.                                         
  3.              Copywrite 1988 by Ramon Martinez.  All rights reserved.
  4.  
  5.              Written by Ramon Martinez - SYSOP of PC Treasure Chest
  6.  
  7.                                  August 26, 1988
  8.  
  9.      -----------------------------------------------------------------------
  10.  
  11.  
  12.      WHAT  THIS PROGRAM DOES:   Simply stated,  this program will  add  ANSI
  13.      colors  to colorless text type files.  It colors whole lines only,  and
  14.      will  not color one part of a line one color and another  part  another
  15.      color.
  16.  
  17.  
  18.      PURPOSE OF PROGRAM:   To make adding color to colorless files easy.   I
  19.      use  this  program to add colors to my game bulletins that do not  have
  20.      color, and other colorless file, like my directory files.
  21.  
  22.  
  23.      HOW TO SETUP THE PROGRAM:   This program is very easy to use.   To  use
  24.      it, simply type in the EXE file name (TC-Color) followed by the name of
  25.      a  configuration file.   The configuration file is a simple  text  file
  26.      that must be in the format described below,  and MUST have an extension
  27.      of  "CFG".   An  example of a valid  configuration  filename  would  be
  28.      "GBLT7.CFG".  The format of the CFG file is outlined below:
  29.  
  30.                Line  1:  complete drive/path/filename of  existing
  31.                          input file.
  32.  
  33.                Line 2:  complete drive/path/filename of the output                           
  34.                         file to be created.
  35.  
  36.                Line  3+:  number of lines to color followed  by  a
  37.                           comma, then the color to be used.
  38.  
  39.      Lines  one  and two do not have to contain the drive designation  or  a
  40.      path, but many times you will wish to include one.
  41.  
  42.      Line three needs more explaining.  Below is an example of what a proper
  43.      CFG file might look like:
  44.  
  45.                c:\pcb\games\gblt7
  46.                c:\pcb\games\gblt7g
  47.                2,yellow
  48.                5,blue
  49.                1,red
  50.  
  51.      What this would do is input a total of 8 lines from the file GBLT7  and
  52.      add  the ANSI color codes for yellow to the first two,  the ANSI  color
  53.      codes for blue to the next five line,  and the ANSI color codes of  red
  54.      to the next line and write the file GBLT7G.
  55.  
  56.      The valid colors are BLACK, BLUE, WHITE, YELLOW, RED, GREEN, CYAN,  and
  57.      MAGENTA.   The  program always uses the bold version of  these  colors. 
  58.      The program actually only uses the first three letters of every  color,
  59.      and case is not important.   This will make it easy for you to be  able
  60.      to read the CFG txt file to check and modify as you please.
  61.  
  62.      This is all fine and dandy for text files that you absolutely know  the
  63.      length of.  It is possible that an input file may change length!  Well,
  64.      I have provided a simple solution to this problem.  If you enter a zero
  65.      for the number of lines in the last line color specification,  followed
  66.      by  a  color,  the program will color ALL of the remaining  lines  that
  67.      color.   This way, you will not have to change the CFG file every time. 
  68.      Lets  say that you had a bulletin generated by your BBS that varied  in
  69.      length  and had no color version generated.   With TC-COLOR  you  could
  70.      color  the  titles,  lines,  etc.  as you like and then have  the  data
  71.      colored  a  different color.   Below is an example of a CFG  file  that
  72.      would allow you to color a text file of varying length:
  73.  
  74.                c:\pcb\games\gblt7
  75.                c:\pcb\games\gblt7g
  76.                1,red
  77.                1,white
  78.                1,blue
  79.                1,yellow
  80.                0,green
  81.  
  82.      The  about  configuration file would color the first three  lines  red,
  83.      white,  and  blue,  respectively,  the  fourth  line  yellow,  and  all
  84.      REMAINING lines green.   This would allow you to color the headers  and
  85.      titles to your taste, and still have color for the rest of the data.
  86.  
  87.  
  88.      HOW TO USE THE PROGRAM:   I would suggest that you put the EXE file  in
  89.      some  sort of Utility directory that has a DOS path to it.   This  will
  90.      allow you to only need one copy of the EXE file on your hard disk.   If
  91.      you  do  not do this,  you will need a copy of the EXE  file  in  every
  92.      directory where you have CFG files for the EXE file.   A proper command
  93.      to  use the program would be "TC-COLOR GBLT7",  where  TC-COLOR.EXE  is
  94.      either  in a DOS path directory,  or is in the current  directory,  and
  95.      GBLT7.CFG  is  in the CURRENT directory.  By naming your CFG  file  the
  96.      same name as the input or output file (but with the CFG extension), you
  97.      will always be able to tell at a glance what file is to be operated  on
  98.      with the CFG file.   NOTE:  when telling TC-Color what CFG file to use,
  99.      do  not actually include the CFG extenstion!   If you do,  the  program
  100.      will abort.  CAUTION: MAKE SURE YOU HIT THE  CARRIAGE  RETURN  IN  YOUR
  101.      TEXT EDITOR AT THE END OF THE LAST LINE.   IF YOU FAIL TO DO THIS,  THE
  102.      THE PROGRAM WILL PARTIALLY PROCESS YOUR FILES AND ABORT!
  103.  
  104.  
  105.      BBS ON-LINE USE:   As far as I know,  this program can be used on-line. 
  106.      It should not cause a BBS to drop carrier.  I use it in some of my game
  107.      door   batch  files  to  create  color  versions  of  the   scoreboards
  108.      immediately after the door program creates the fresh bulletin.   Simply
  109.      put include the proper dos command in the batch file.
  110.  
  111.  
  112.      FUTURE  PLANS:   My next version of this program will include at  least
  113.      one  more  feature.   Besides  letting you  specify  a  color  for  the
  114.      remaining lines of a variable length file, it will allow you to specify
  115.      a set of ALTERNATING colors so that every other line is the same color. 
  116.      This will allow for easier reading for long lists.   This will kind  of
  117.      be like the "green bar" effect used on some computer paper.  
  118.  
  119.  
  120.      SUGGESTIONS:   I will gladly accept suggestions about how to  make  the
  121.      program better.   Right now it was merely a simple, readable program to
  122.      do a simple job.  If you have an idea that can make it better and still
  123.      be simple, by all means, let me know!
  124.  
  125.  
  126.      DISTRIBUTION OF TC-COLOR:   I claim a copywrite to this program.   This
  127.      program may be freely distributed as long as there is no charge for  it
  128.      by anyone other than myself.  Basically,  I don't want anyone profiting
  129.      off  my work.   This program may not be sold by anyone other  than  the
  130.      author.
  131.  
  132.  
  133.      PAYMENT TO AUTHOR:   If you like the program, I request that you do one
  134.      of the following:
  135.  
  136.                1: Send $5 to the author at the address below:
  137.  
  138.                                       Ramon Martinez
  139.                                   1501 East Chapman #338
  140.                                     Fullerton, Ca 92631
  141.  
  142.                2: Upload a file to my BBS listed below:
  143.  
  144.                                      PC Treasure Chest
  145.                                    Fullerton, California
  146.                                       (714) 738-0841
  147.                                    300/1200/2400 24 Hrs.
  148.  
  149.                3: Leave a comment to me at my BBS about a bug or
  150.                   suggestion.
  151.  
  152.  
  153.      I  am not trying to become rich,  so please do one of the  three  above
  154.      choices if you like and use my simple program.
  155.  
  156.  
  157.  
  158.      -----------------------------------------------------------------------
  159.  
  160.  
  161.      The following six files should be included in the ARC file:
  162.     
  163.           TC-COLOR.EXE         Program file
  164.           TC-COLOR.DOC         This file
  165.           TEST                 Example text input file
  166.           TEST1                Example text input file
  167.           TEST.CFG             CFG file to input "TEST" & output "TESTG"
  168.           TEST1.CFG            CFG file to input "TEST1" & output "TEST1G"
  169.                                This CFG gives and example of using a  zero
  170.                                in the last line of the CFG file.
  171.  
  172.  
  173.      -----------------------------------------------------------------------
  174.  
  175.   
  176.  
  177.      This ARC file originated from  the  PC-Treasure  Chest  in   Fullerton,
  178.      California.   The BBS runs 24 hours a day, currently has one node,  and
  179.      currently supports up to 2400 baud.   We currently have 120 meg of hard
  180.      disk  space.   I used currently a lot there because any  one  of  those
  181.      items  may be upgraded soon.   We run PCBoard software,  and  are  very
  182.      pleased with it.
  183.       
  184.                       Thank you for your time,
  185.       
  186.  
  187.                                       Ramon Martinez
  188.                                       SYSOP-PC Treasure Chest
  189.                                       OWNER-Ramsoft Enterprises
  190.  
  191.  
  192.      --------------------------END OF DOCUMENTATION-------------------------
  193.