home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / Information / SIDNEWS9.TXT < prev    next >
Encoding:
Text File  |  2019-04-13  |  5.9 KB  |  108 lines
  1. DPLAYER NEWS #9  March 1987 
  2.  
  3. SIDPLAYER FILE TYPES AND SELF-DISSOLVING LIBRARY FILES 
  4.  
  5. This documentation file explains the various types of song files, identified by 
  6. the .MUS, .WDS, and .PIC filename extensions, as well as the self-dissolving 
  7. library files identified by the .SAL, .PIL, and .WPL filename extensions.  It 
  8. also gives instructions on how to use the WPLMAKER utility to create 
  9. self-dissolving library files. 
  10.  
  11. SIDPLAYER SONGS 
  12. A Sidplayer music file is identified by a .MUS filename extension.  To play a 
  13. Sidplayer music file you need a song player program.  The .MUS file contains 
  14. only data and no code, so you cannot just LOAD and RUN or use SYS to hear the 
  15. music.  Existing players include KPLAY (with a piano keyboard display), MPLAY 
  16. ("Multiplay" with autoplaying feature), Magic Sid Machine, SIDPIC, and the 
  17. Enhanced Player. 
  18.  
  19. Sidplayer songs are created by the Sid Editor program published in the books 
  20. "All About the Commodore 64, Volume Two" and "The Complete 64" (a book and disk 
  21. combination) by COMPUTE! Books.  The new Enhanced Editor, and the Enhanced 
  22. Player, are published in "COMPUTE!'s Music System for the Commodore 128 and 64: 
  23. The Enhanced Sidplayer."  The Sid Editor programs and the Enhanced Player are 
  24. copyrighted and are not in the Public Domain.  See SIDNEWS #7 for more 
  25. information about the Enhanced Sidplayer book. 
  26.  
  27. SINGALONG SONGS 
  28. Singalong songs are songs which have an accompanying words file.  The filename 
  29. for the words file is the same as the filename for the music file, except that 
  30. the .MUS filename extension is replaced with a .WDS extension.  To play a 
  31. Singalong song you need the Singalong player, the SIDPIC player, or the 
  32. Enhanced Player program, and both the .MUS and .WDS files must be on the disk.  
  33. The player will load the two files and play the music while displaying the 
  34. words.  You may also listen to just the music file of a Singalong song by using 
  35. any of the regular song player programs. 
  36.  
  37. The words file for a Singalong song must be created by a special utility 
  38. program to insure the correct file format.  The utility program and 
  39. instructions for creating Singalong songs can be found in the Enhanced 
  40. Sidplayer book. 
  41.  
  42. SONGS WITH PICTURES 
  43. Some songs have an accompanying picture file, identified by a .PIC filename 
  44. extension.  This is a full screen bitmap picture in Doodle or Koala format that 
  45. is displayed while the music plays.  The SIDPIC and Enhanced Player programs 
  46. can accommodate picture files. 
  47.  
  48. As explained in the Enhanced Sidplayer book, a .PIC file can be created by 
  49. simply renaming a Doodle or Koala format picture to the name of the music file 
  50. but with the .PIC extension. 
  51.  
  52. SELF-DISSOLVING LIBRARY FILES 
  53. Since a music file may also have a words or picture file or both, two or three 
  54. separate files could have to be downloaded to get a complete song.  For your 
  55. downloading convenience, songs with words or a picture are available in a 
  56. bundled format called a "library" file.  You can download one library file for 
  57. a song and then "dissolve" it into the separate files on your computer. 
  58.  
  59. A self-dissolving library file is one which does not require that you run a 
  60. library utility program to dissolve the library file.  You just LOAD the 
  61. self-dissolving library file and then RUN it, and it writes the separate files 
  62. to your disk.  After the individual files have been written, you can scratch 
  63. the library file.  Because the self-dissolving library file is actually a 
  64. program loaded into memory, you do not need to have the library file on the 
  65. same disk that the separate files are written to. 
  66.  
  67. MUSIC AND WORDS (.SAL) LIBRARY FILES 
  68. A file with the .SAL filename extension is a self-dissolving library file that 
  69. consists of the music and words files for one Sidplayer song.  Download the 
  70. .SAL file and then LOAD and RUN it, and it will write the .MUS and .WDS files 
  71. to your disk and then give you the option of scratching the .SAL file.  Be sure 
  72. to have as many free blocks on the disk as there are in the .SAL file before 
  73. you dissolve the file. 
  74.  
  75. MUSIC AND PICTURE (.PIL) LIBRARY FILES 
  76. A file with a .PIL extension consists of the music and picture files for one 
  77. song.  A simple data compression technique is used in the .PIL file to reduce 
  78. the size of the picture data.  The picture data is uncompressed to normal size 
  79. when the .PIL file is dissolved.  Because of the data compression, the two 
  80. separate files may together take up more disk blocks than the .PIL file. 
  81.  
  82. MUSIC, WORDS, AND PICTURE (.WPL) LIBRARY FILES 
  83. A file with a .WPL extension consists of the music, words, and picture files 
  84. for one song.  Again, data compression is used for the picture data. 
  85.  
  86. THE WPLMAKER UTILITY 
  87. Use the WPLMAKER utility program to create a .SAL, .PIL, or .WPL file for a 
  88. Sidplayer song.  Just LOAD the program and RUN it, insert the disk with the 
  89. song to be libraried, and enter the name of that song at the filename prompt.  
  90. The program will first read the .MUS file for that song, then read the .WDS 
  91. file if it exists, and finally read the .PIC file if it exists.  The program 
  92. will next prompt you to insert the destination disk and press any key, and then 
  93. write the .SAL, .PIL, or .WPL file as appropriate. 
  94.  
  95. A words or picture file must exist in order to create a library file.  If only 
  96. a music file for the specified song is on the disk, the WPLMAKER program will 
  97. print an error message and stop. 
  98.  
  99. If you are going to create several self-dissolving library files and you have a 
  100. second disk drive as device number 9, change the statement DW=8 at the 
  101. beginning of the WPLMAKER program to DW=9 and the library files will be written 
  102. to the second drive. 
  103.  
  104. The WPLMAKER utility replaces the earlier SALMAKER and PILMAKER programs and 
  105. should be used instead.  The library files written by WPLMAKER contain the 
  106. revised disk I/O routines with the improved error detection. 
  107.