home *** CD-ROM | disk | FTP | other *** search
/ Sound Sensations! / sound_sensations.iso / miscprog / fit_10 / fit.doc < prev    next >
Text File  |  1991-12-18  |  5KB  |  119 lines
  1.         FIT version 1.0  12/18/91
  2.  
  3.         WHAT IT IS
  4.  
  5.         FIT is a program determine a list of songs that will fit on a
  6.         tape.  In attempting to record songs on a cassette, it is not
  7.         unusual to have too much space on one side and a truncated song
  8.         on the other.  Manually trying to figure out which songs to put
  9.         where quickly becomes a difficult task, but one ideally suited
  10.         for a computer.
  11.  
  12.         WHAT IT DOES
  13.  
  14.         The program accepts a file with song durations and titles plus
  15.         some information about max and min acceptable times and
  16.         generates another file with the titles that fit.  It will ask
  17.         if you wish to continue, and if there are songs left from the
  18.         first pass, it will produce a second file with a listing for
  19.         the next side.  This process continues until all songs are
  20.         accounted for.
  21.  
  22.         A word about max and min acceptable times:  The max time is
  23.         just that - the maximum time you will  accept.  For a
  24.         45 minute tape, you should set this to 44:00 to 44:30 to
  25.         account for the delays between songs.  The min time is the
  26.         least amount of time you will accept.  While the max and min
  27.         may be set equal, the only combination that would be acceptable
  28.         would be a combination of songs whose duration was EXACTLY
  29.         equal to the max.  In most cases this would require the program
  30.         to examine ALL combinations, a process which, on a 4.77 mHz XT
  31.         might take a while.  It is generally recommended that a min time
  32.         slightly less than the max, say 30 seconds to a minute be set.
  33.  
  34.         If the program does not find a combination that will fit in the
  35.         min to max window, it will produce a listing representing the
  36.         combination having the longest time without exceeding the max.
  37.  
  38.         The output files will have the same name as your source file
  39.         with extensions of .000, .001, .002 etc,  If a file already
  40.         exists with the name and extension that the program is
  41.         trying to create, that particular extension will be skipped
  42.         and your existing file will not be overwritten.
  43.  
  44.         WHAT YOU WILL NEED
  45.  
  46.         You will need an ascii text file (no control characters) with
  47.         the following format:
  48.  
  49.         The first line of the file must be the max time in mm:ss format.
  50.         The second line must be the min time in mm:ss format.
  51.         Starting with the third line, songs are entered, one per line,
  52.         with the following format:
  53.         mm:ss Title....... to 75 characters.
  54.         Enter "end" at the end of the list.
  55.         All lines must begin in column one.  Any line after the max/min
  56.         lines that does not begin with a number is regarded as the end
  57.         of the list.
  58.  
  59.         Please examine the file "RAGS" as an example.
  60.  
  61.         HOW TO USE IT
  62.  
  63.         Run the program with no command line arguments - the program
  64.         will prompt you to enter the name of the source file.  After that
  65.         follow the prompts.
  66.  
  67.         Included in the archive is a file, "RAGS" which is a list of songs
  68.         from two albums by the Red Rose Ragtime Band, a group from Chicago
  69.         with a great ragtime sound.  Examine the format of this file and
  70.         run the program on it.  Try changing the max/min times to see
  71.         the differences in the results.
  72.  
  73.         WHAT YOU GET
  74.  
  75.         After the program runs there will be files with names like
  76.         SRC.000, SRC.001 etc. (assuming that your source file has the
  77.         name "SRC".  These are ascii text files that can be viewed or
  78.         printed with LIST or your favorite editor.
  79.  
  80.         WHAT ARE THE LIMITATIONS
  81.  
  82.         This version is limited to 32 titles.  That may not seem like
  83.         very many, but do you really have tapes with more than 32 titles?
  84.         The limitation was imposed for two reasons:
  85.         1) Programming convenience.  You have to draw the line somewhere.
  86.         2) Thirty two titles represents over four billion combinations.
  87.         The simple algorithm used isn't realistic for larger numbers.
  88.  
  89.         This program was initially written for my own amusement and
  90.         convenience.  There is only a modest amount of error checking.
  91.  
  92.         TECHNICAL STUFF
  93.  
  94.         FIT is written in assembler and uses a straight forward,
  95.         examine all combinations, algorithm.  If anyone has some
  96.         suggestions for a faster one, I would appreciate any
  97.         comments.
  98.  
  99.         WHAT'S IT COST
  100.  
  101.         Nothing.  I keep the copyright, you use it for free.  Send me
  102.         a post card with comments - pro and con.  You are, however, not
  103.         allowed to sell this program or bundle it with other program
  104.         without written permission from the author.  You may give it
  105.         to anyone you like, but only in its original form with the
  106.         complete documentation.
  107.  
  108.         LEGAL STUFF
  109.  
  110.         I will not be held liable for any misfortune that may or may not
  111.         happen to you, which may or may not be the result of using or not
  112.         using this program. In other words, the usual disclaimer applies here.
  113.  
  114.         Bob Fehrenbach
  115.         1460 Church Street
  116.         Wauwatosa, WI 53213
  117.  
  118.         I log on to Exec-PC regularly if you wish to leave a message.
  119.