home *** CD-ROM | disk | FTP | other *** search
/ CBM Funet Archive / cbm-funet-archive-2003.iso / cbm / crossplatform / converters / msdos / arklnx.readme < prev    next >
Text File  |  1993-09-25  |  6KB  |  146 lines
  1. arklnx BY pETER wEIGHILL
  2. ======
  3.    
  4.    arklnx IS A dos BASED PROGRAM WHICH CAN BE USED TO CREATE INFORMATION
  5. ABOUT .ark AND .lnx FILES CONTAINING SIDPLAYER .mus MUSIC FILES AND THEIR
  6. ASSOCIATED .str, .wds & .pic FILES.
  7.    
  8.    yOU CAN EITHER USE THE exeCUTABLE VERSION OR USE THE basIC VERSION WITH
  9. qbasic AS SUPPLIED WITH ms-dos 5 & 6.
  10.    
  11.    tHIS PROGRAM WILL HOPEFULLY MAKE KEEPING A RECORD OF MUSIC FILES STORED
  12. IN YOUR ARCHIVES EASIER.
  13.  
  14.    jUST TYPE IN THE NAME OF THE FILE TO BE VIEWED AND CHOOSE WHICH FORMAT
  15. YOU REQUIRE AND A REPORT FILE WILL BE CREATED WITH ONE OF THE FOLLOWING
  16. fILE EXTENSIONS:
  17.  .as - ark FILE, SHORT FORMAT
  18.  .al - ark FILE, LONG  FORMAT
  19.  .ls - lnx FILE, SHORT FORMAT
  20.  .ll - lnx FILE, LONG  FORMAT
  21.  
  22.    bELOW ARE EXAMPLES OF THE SHORT AND LONG FORMAT OUTPUT. bOTH SHOW THE
  23. FILENAME, THE EXENSIONS OF THAT FILENAME (.mus.str.wds.pic) AND THE TOTAL
  24. BLOCKS USED BY ALL THOSE FILES. tHE LONG FORMAT ALSO SHOWS THE DESCRIPTION
  25. WHICH IS CONTAINED IN THE *.mus FILES.
  26.  
  27. sHORT FORMAT:  
  28. ============
  29.  
  30.    9  lng tl sally .mus.str       
  31.    8  o holy night .mus.str.wds   
  32.   11  piper        .mus.str.wds   
  33.    7  peopleeater  .mus           
  34.   21  rock me.mus.wds
  35.  
  36. lONG  fORMAT:  
  37. ============
  38.    
  39.    9  lng tl sally .mus.str             /(c)apr{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}1987\
  40.                                         {$7c} ***** long tall sally ****** {$7c}
  41.                                         {$7c} recorded by 'little richard' {$7c}
  42.                                         {$7c}sidranged by jerry roth (dr j){$7c}
  43.                                         \-dec-stereoed{$fd}{$fd}mark ad ii{$fd}1987/
  44.  
  45.    8  o holy night .mus.str.wds         o holy night            .      .
  46.                                         wds j.s.dwight  mus a.adam   .
  47.                                         6 voice by dc star & cpr   #,  
  48.                                            {$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}{$fd}            /
  49.                                         -  december 1987  --------/{$7c}----
  50.  
  51.   11  piper        .mus.str.wds         /-------------------\ /--------\
  52.                                         {$7c}the piper from over{$7c} {$7c} stereo {$7c}
  53.                                         {$7c}      the way      {$7c} {$7c} sid by {$7c}
  54.                                         {$7c}  by may h. brahe  {$7c} {$7c} lyric  {$7c}
  55.                                         \-------------------/ \--------/
  56.  
  57.    7  peopleeater  .mus                 purple people eater        /..\
  58.                                         music by sheb wooley   #  / -- \
  59.                                                  -----------  --  {$7c}\''/{$7c}
  60.                                         sid kermit r. woodall  //  - {$7c}-
  61.                                         --------------------------------
  62.  
  63.   21  rock me      .mus    .wds         /--\            \  / \
  64.                                         {$7c}             \ {$7c}  {$7c} {$7c}   . \
  65.                                         {$7c} -\\-\/-\/-/ + {$7c}  {$7c} {$7c}-\ \ + /-\
  66.                                         {$7c}  {$7c}{$7c}  {$7c}-/{$7c} {$7c} {$7c} {$7c}/\{$7c} {$7c} {$7c} {$7c} {$7c} {$7c}-/
  67.                                         \--//  \-/\-\ \ \/\/ / \ \ \ \-/
  68.  
  69.  
  70.    bELOW i HAVE LISTED THE FORMAT OF THE .ark AND .lnx FILE FORMATS AS i
  71. BELIEVE THE ARE. tHIS IS JUST MY GUESS THOUGH FROM WHAT i HAVE SEEN OF THEM
  72. AND THE PROGRAMS lynx AND arkive MAY HAVE A DIFFERENT WAY OF WORKING OUT
  73. 'WHAT IS WHAT' IN EACH FILE.
  74.    tHE block SIZE IN THE FILES IS 254 BYTES LONG SINCE THE FIRST 2 BYTES
  75. ON EACH SECTOR OF A DISK IS NOT PART OF THE FILE AND IS USED BY THE DISK
  76. DRIVE.
  77.  
  78. .lnx
  79. {$7e}{$7e}{$7e}{$7e}
  80. hEADER:   jUNK UNTIL 3 OR MORE ZEROS ARE REACHED.
  81.           return ($0d)
  82.           nO. OF BLOCKS FOR HEADER (ASCII NUMBER FORMAT)
  83.                 + VERSION HEADER  EG.(lynx vii by will ...)
  84.           return ($0d)
  85.           nO. OF FILES IN .lnx FILE (ASCII NUMBER FORMAT)
  86.           return ($0d)
  87.  
  88. fILE:     no fixed length PER FILE HEADER SINCE 'nO. OF BLOCKS'
  89.           AND 'nO. OF BYTES IN LAST BLOCK' ARE NOT FIXED LENGTHS.
  90.           fILENAME, PADDED WITH SHIFTED SPACES ($a0) TO 16 CHARACTERS LONG
  91.           return ($0d)
  92.           nO. OF BLOCKS FOR FILE (ASCII NUMBER FORMAT)
  93.           return ($0d)
  94.           fILE TYPE (LETTER p FOR PRG, s FOR seq)
  95.           return ($0d)
  96.           nO. OF BYTES USED IN LAST BLOCK (ASCII NUMBER FORMAT)
  97.           return ($0d)
  98.           
  99. .ark
  100. {$7e}{$7e}{$7e}{$7e}
  101. hEADER:   bYTE FOR nO. OF FILES IN .ark FILE
  102.           ark FORMAT DOES NOT INCLUDE THE NUMBER OF BLOCKS USED FOR
  103.           THE HEADER SINCE THIS CAN BE CALCULATED BY MULTIPLYING THE
  104.           0NUMBER OF FILES BY 29, ADDING 1 AND ROUNDING UP TO NEAREST 254.
  105.  
  106. fILE:     fixed LENGTH OF 29 PER FILE HEADER.
  107.           bYTE FOR FILE TYPE (SAME METHOD AS DISK DRIVE EG $81 seq, $82 prg)
  108.           bYTE FOR nO. OF BYTES USED IN LAST BLOCK
  109.           rEST OF HEADER IS WHAT IS NORMALLY STORED IN THE DIRECTORY
  110.             HEADER ON A DISK FROM THE BEGINING OF THE FILENAME TO
  111.             THE SIZE OF THE FILE.
  112.           bYTE POSITON 3, FILENAME, PADDED WITH SHIFTED SPACES ($a0) TO
  113.             16 CHARACTERS LONG
  114.           bYTE POSTION 28/29, nO. OF BLOCKS FOR FILE IN LO/HI BYTE FORMAT.
  115.             * USUALLY HI BYTE NOT USED SINCE MOST FILES SMALLER THAN 256
  116.             BLOCKS.
  117.  
  118. .mus FORMAT
  119. {$7e}{$7e}{$7e}{$7e}{$7e}{$7e}{$7e}{$7e}{$7e}{$7e}{$7e}
  120. tWO METHODS TO LOCATE THE DESCRIPTION AT THE END OF A .mus FILE.
  121.  
  122. 1. pREFERED METHOD, SINCE QUICKER, WORKS MOST OF THE TIME AND WORKS MORE
  123.    OFTEN THAN METHOD 2.
  124.  
  125. bYTES $03/$04, LO/HI SIZE OF 1ST MUSIC VOICE
  126. bYTES $05/$06, LO/HI SIZE OF 2ND MUSIC VOICE
  127. bYTES $07/$08, LO/HI SIZE OF 3RD MUSIC VOICE
  128.  
  129. oFFSET FOR DESCRIPTION = SUM OF SIZE OF EACH VOICE + 8 EXTRA BYTES FOR
  130.                          THE SIZE BYTES & START ADDRESS.
  131.  
  132. cHECK TO SEE THAT BYTE BEFORE DESCRIPTION OFFSET IS AN "o", IF NOT THEN
  133. TRY METHOD 2.
  134.  
  135. 2. sKIP FIRST 8 BYTES OF HEADER INFORMATION.
  136.    tHEN FIND OFFSET FOR THIRD "o" IN FILE. dESCRIPTION USUALLY AFTER THIS
  137.    THIRD "o".
  138.    (mETHOD SOMETIMES FAILS AND FINDS THIRD "o" IN MUSIC AREA OF FILE, SINCE
  139.     i DO NOT KNOW THE EXACT FORMAT OF THE MUSIC DATA, i CANNOT WORK OUT
  140.     HOW TO GET AROUND THIS PROBLEN.)
  141.  
  142. 3. iF BOTH METHODS FAIL THEN DESCRIPTION SHOWN COULD EITHER BE BLANK OR BE
  143.    JUNK.
  144.  
  145. uPLOADED & WRITTEN BY STUCE@CSV.WARWICK.AC.UK
  146.