home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / zip / music / musinv32.lzh / M_INV.DOC < prev   
Text File  |  1989-12-30  |  7KB  |  158 lines
  1.                    MUSIC INVENTORY version 3.0
  2.                        in GFA BASIC 3.0 
  3.                        by Larry D. Duke
  4.  
  5. I have a music collection that requires cataloging for insurance
  6. purposes.  For this reason, I wrote MUSIC INVENTORY in 1987 in
  7. GFA BASIC 2.0.  It served the purpose, but didn't have the "look
  8. and feel" of a good GEM program.
  9.  
  10. I recently rewrote this program using dialog boxes and windows. 
  11. This is the result of that work.  Since this is my first program
  12. of substance using dialog boxes, I wanted to try all kinds of
  13. things...changing dialog text and titles, button text, editable
  14. fields, and the like.  Let me know what you think.
  15.  
  16. ***************************************************************
  17. **             Medium and high resolution only!              **
  18. ***************************************************************
  19.  
  20. The program initialized itself by reserving memory for the data 
  21. array, the logical screen,  and the resource, which contains
  22. numerous dialog boxes and the menu.  The fact that it is a
  23. RAM-based data base should not cause too much of a problem,
  24. unless you are a 520 owner with lots of desk accessories and
  25. AUTO programs.  Each entry contains only 84 bytes, so as plan on
  26. 9K of RAM used for each 100 entries you have in the data base.
  27.  
  28. The menu selection is relatively self explanatory.  But, just in 
  29. case, we'll go over them anyway.
  30.  
  31. The letters in () are keystrokes for the command.  Some require
  32. an element to be selected in the window before they'll work.
  33.  
  34. DESK - THE DESK ACCESSORIES WORK!
  35.  
  36. DATA - 
  37.      ADD to Collection (A) - Adds a new entry into the collection 
  38.      list.  The program automatically checks for memory available, 
  39.      then draws a dialog box to assist you with the ADD.  The top 
  40.      part of the dialog box contains Radio Buttons for the Medium 
  41.      of the recording (CD, LP, etc.)  Click on the appropriate 
  42.      button.  The default cost will update when you do this.  Type 
  43.      the ARTIST NAME and ALBUM NAME, followed by the optional 
  44.      entries of REMARKS and COST.  The ARTIST NAME and ALBUM NAME 
  45.      are required entries.  The program will let you know if you 
  46.      have left one of these out.  When completed with the basic 
  47.      entries, press ENTER or click on the DO MUSIC TYPE button to 
  48.      further catagorize your new entry into type of music (Pop, 
  49.      rock, country, etc.).  The buttons on this are toggles, 
  50.      select and deselect them by clicking on the appropriate 
  51.      button.  OK accepts the entry, updates the array, and returns 
  52.      you for another add.  Click on CANCEL to stop the addition of 
  53.      more recordings.  CANCEL disregards the entry and terminates 
  54.      the ADD portion of the program.  
  55.  
  56.      UPDATE Recording (U) - Update a recording already in the 
  57.      list.  This option only works after you have selected an 
  58.      entry by clicking on it in the window below.  Allow you to 
  59.      update an entry in a manner similar to the ADD.
  60.  
  61.      VIEW Recording  (V) - View a recording already in the list.  
  62.      This option works as the UPDATE above, but does not allow you 
  63.      to edit any portion of the entry.  Click on the selection to 
  64.      view in the window below.
  65.  
  66.      DELETE Recording  (D) - Delete a recording in the list.  As 
  67.      above, you must first select the entry to delete by clicking 
  68.      on the entry with the mouse.  A dialog box appears showing 
  69.      artist and title.  Make sure this is the one you want to 
  70.      delete, the press RETURN or click on the OK button to delete 
  71.      the entry.  CANCEL leaves the data undisturbed.
  72.  
  73.      PRINT OPTIONS  (P) - Select this to get a printout of the 
  74.      entire data base, or specific portions.  Select the MEDIUM to 
  75.      print (CD, LP, ALL MEDIA) on the left half of the box.  The 
  76.      right half, labeled MUSIC FILTER, allows you to further 
  77.      specify what types of music to print.  Selecting ON brings up 
  78.      the familiar MUSIC TYPE dialog.  OFF will not filter any 
  79.      selection based on the type of music (all under the selected 
  80.      media will print).  Select the type of music within the 
  81.      selected medium to print.  OK completes this dialog and 
  82.      returns you to the original PRINT dialog.  Selecting PRINT 
  83.      starts the printout of the selected media and music types.
  84.  
  85.  
  86.      QUIT - Quits the program.  All data is saved if there has 
  87.      been a change, otherwise, you are returned back to GFA BASIC.
  88.  
  89. SEARCH & STATS
  90.  
  91.      SEARCH for ARTIST - A dialog appears prompting for the search 
  92.      value.  If the value appears anywhere within the ARTIST name, 
  93.      it will be marked as found.  Example: If you search for "E", 
  94.      all artists names that contain an "E" or "e" will be 
  95.      returned.  The program tells you how many it has found, then 
  96.      displays them in order.  Select NEXT to see the next entry, 
  97.      or CANCEL to stop the search.  CANCEL will bring the last 
  98.      entry found to the top of the window.
  99.  
  100.      SEARCH for TITLE - Works as above, except the TITLE area is 
  101.      searched.
  102.  
  103.      STATISTICS  (S) - Displays music statistics.  The number, 
  104.      total cost, and average cost of each medium and total 
  105.      collection is determined and displayed.  
  106.  
  107. ****************************************************************
  108.  
  109. Version 3.1 update corrects and improves the following:
  110.  
  111. The bug in QUIT that did not save the data is fixed.
  112.    (Actually, I accidentally uploaded a version that I didn't mean
  113.     to last time.  The bug was due to a typographical error...sorry)
  114.  
  115. The screen updates are much quicker.  The program now uses a logical
  116.     screen and bitblt's to make and move the data.  Much faster, looks
  117.     better, too.  Great, especially with the Blitter chip and QUICKST.
  118.  
  119. The resource file is now embedded within the program.  They said it
  120.     couldn't be done in GFA, but here's proof.  (Michtron said that
  121.     it wasn't possible, upon initial release of GFA 3.0)
  122.  
  123. With the addition of the GFA BASIC COMPILER, the run-time module is
  124.     included.
  125.  
  126. **************************************************************
  127.  
  128. Version 3.2 update corrects and improves the following:
  129.  
  130. A bug in the dialog management that caused a system bomb if you pressed
  131.     the DOWN ARROW key while on the last editable text of the ADD
  132.     resource has been corrected.  Thanks to T.KILBRIDE off GEnie who
  133.     pointed out this problem to me (The fix took just short of a 
  134.     program re_write).
  135.  
  136. The SCREEN update is faster yet, by setting flags on the logical screen
  137.     beginning and end, now FULL and redraws are MUCH quicker.  Also
  138.     corrected a minor bug when using desk accessories that use windows.
  139.  
  140. The resource has been changed to have extended object data, which is
  141.     used in resetting editable and selectable objects. 
  142.  
  143. The STATISTICS area has been cleaned up.  The previous version contained
  144.     a typographical error that caused erroneous readouts of total cost,
  145.     total number, and average cost.  Thanks again, T.KILBRIDE.
  146.  
  147. ***************************************************************
  148.  
  149. ASTRO BBS - Albuquerque, New Mexico
  150. (505) 243-5606
  151. Hours: 6:00 pm until 7:30 am weekdays
  152.        all day weekends
  153.        (all times are Mountain)
  154.  
  155. Larry D. Duke
  156. GEnie Mail - L.DUKE
  157.  
  158.