Home » Archimedes archive » Micro User » MU 1991-05.adf » PDStuff » Music/!PlayerMod/Bits/!PlaySpecs

Music/!PlayerMod/Bits/!PlaySpecs

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Micro User » MU 1991-05.adf » PDStuff
Filename: Music/!PlayerMod/Bits/!PlaySpecs
Read OK:
File size: 168C bytes
Load address: 0000
Exec address: 0000
File contents
| > !PlaySpecs
|   Information about James Procter's PlayList feature

---------------------------------------------------------------

Part of James Procter's excellent contributions to the PD
!PlayerMod application was that of a 'PlayList' file, and his
comments on it are included below.

Please do not separate this file from its application !

Nick Smith, 15-Feb-91

---------------------------------------------------------------

Initial implementation by James Procter 2nd January 1991   
                                                        
This is the specifications for the P.D. !PlayerMod Desktop
Soundtracker play 'manager' by Nick Smith, Matt Durys, and The
Mad Dog. It allows the creation of programmes of soundtrackers
to be played, and controls the method of switching from one
module to the next.

At the time of writing, the implementation allows fading in
two ways, either an autofade or a standard fade - the autofade
only occurring if the last event in the module has no
instruments active. In both cases the fadetime can be adjusted
and ....

Playlist Files : Filetype &444 (Provisional)
Commands       :

The commands fall into two types, those that apply to the
overall playlist where applicable, and those which apply to
only one song entry in the playlist.

General Commands
================

'|'             Rem statement, lines starting with this will
                be ignored.
'fadetime xx'   Set overall fadetime to xx polls. This means
                that any song entries which do not specify a
                fadetime, and do not disable fading will have
                this fadetime. If this command is not
                included, the overall fadetime will be set to
                that which is used for the fading when 
                'playing a directory'.
'version xx.xx' This is the minimum version number of
                !PlayerMod needed to use this playlist. This
                can be anywhere in the file, as long as it is
                not remmed out. !PlayerMod will give an error
                if no valid version number is given.
'"'             Start of a song entry.

The playlist interpreter will strip all leading spaces from
the lines, and command recognition is not case dependent.

Song Entries
============

These are lines starting with a quote : '"'
The general syntax is as follows :

"<Full Song Pathname>" [<fadetime>|{command}]

With just the song pathname, !PlayerMod will just play the
song and use the semi-intelligent autofade using the overall
fadetime.

<fadetime> is a value in polls, again as in the general
command 'fadetime', and will have the effect of causing the
player to play the song and fade using the semi-intelligent
fading system with the specified fadetime.

{command} can be one of the following :

'nofade'        This will turn all fading off, and the next
                song will be played immediately at the end
                of this song, with no fading out.
'fade [xx]'     This turns off the 'instrument detection'
                feature of the fading system, so that the
                module will fade out irrespective of the
                current instrument states at the end of the
                song. The fadetime can be set [xx] if wished
                but the overall setting will be used if not
                specified.

Notes
=====

If the song cannot be found, then an error will be generated
and the playlist will not be played.

Playlists with no song entries will not be played.

The song entries will be played in order of appearance in
the file, looping back to the first one, at the end; unless
the 'RND' option has been selected on the control panel,
using the '>>' and '<<' controls for flipping between songs
from directories will traverse the song entries.

Experimentation must be made with the best arrangements of
fading, and fadetimes. The fadetimes are not constant -
since they are affected by wimp polling speed - ie if it
is extremely slow the fadetime will appear to be higher.
Since "Wimp_PollIdle" is used, the fadetimes will be
generally constant.

Problems
========

Since the wimp is polling the program, if the wimp is
engaged in some time consuming task and the song reaches
it's end and wraps around the program will not realise
this; hence no changing of songs will take place.

The autofade get's caught out by those songs where there
is a repeating note played at the end of the last pattern,
filling-in before the wrap around. The fading system
actually starts when the wrap around occurs - and will
hence take place. In these situations it is best not to
have the fading on.

If there are volume change commands at the start of the
tune, when the fading system comes into action there will
be some odd effects since the playroutine will use
different volumes for some of the notes - instead of
using the default sample volumes which the !PlayerMod
volume system affects.

Future developments
===================

Inclusion of channel stereo position settings for songs.
(Isn't it annoying when soundtracker returns the channel
positions to the default everytime?).

A playlist creator utility, either as a separate wimp
application in the 'Bits' directory or as an extension to
the main program, allowing automatic logging of songs in
a playlist for saving, also previews and 'tweaking' of
fading whilst playing the list.

Better control of volume fading, including preciser
control of when to fade, time delay between each volume
decrement.

Song repeats, ie so that repeated successive entries of
a song with identical parameters are not needed.

That's about all I can say, hope you find this useful....

James Procter, 10-Feb-91

---------------------------------------------------------------
end.
00000000  7c 20 3e 20 21 50 6c 61  79 53 70 65 63 73 0a 7c  || > !PlaySpecs.||
00000010  20 20 20 49 6e 66 6f 72  6d 61 74 69 6f 6e 20 61  |   Information a|
00000020  62 6f 75 74 20 4a 61 6d  65 73 20 50 72 6f 63 74  |bout James Proct|
00000030  65 72 27 73 20 50 6c 61  79 4c 69 73 74 20 66 65  |er's PlayList fe|
00000040  61 74 75 72 65 0a 0a 2d  2d 2d 2d 2d 2d 2d 2d 2d  |ature..---------|
00000050  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000080  2d 2d 2d 2d 2d 2d 0a 0a  50 61 72 74 20 6f 66 20  |------..Part of |
00000090  4a 61 6d 65 73 20 50 72  6f 63 74 65 72 27 73 20  |James Procter's |
000000a0  65 78 63 65 6c 6c 65 6e  74 20 63 6f 6e 74 72 69  |excellent contri|
000000b0  62 75 74 69 6f 6e 73 20  74 6f 20 74 68 65 20 50  |butions to the P|
000000c0  44 0a 21 50 6c 61 79 65  72 4d 6f 64 20 61 70 70  |D.!PlayerMod app|
000000d0  6c 69 63 61 74 69 6f 6e  20 77 61 73 20 74 68 61  |lication was tha|
000000e0  74 20 6f 66 20 61 20 27  50 6c 61 79 4c 69 73 74  |t of a 'PlayList|
000000f0  27 20 66 69 6c 65 2c 20  61 6e 64 20 68 69 73 0a  |' file, and his.|
00000100  63 6f 6d 6d 65 6e 74 73  20 6f 6e 20 69 74 20 61  |comments on it a|
00000110  72 65 20 69 6e 63 6c 75  64 65 64 20 62 65 6c 6f  |re included belo|
00000120  77 2e 0a 0a 50 6c 65 61  73 65 20 64 6f 20 6e 6f  |w...Please do no|
00000130  74 20 73 65 70 61 72 61  74 65 20 74 68 69 73 20  |t separate this |
00000140  66 69 6c 65 20 66 72 6f  6d 20 69 74 73 20 61 70  |file from its ap|
00000150  70 6c 69 63 61 74 69 6f  6e 20 21 0a 0a 4e 69 63  |plication !..Nic|
00000160  6b 20 53 6d 69 74 68 2c  20 31 35 2d 46 65 62 2d  |k Smith, 15-Feb-|
00000170  39 31 0a 0a 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |91..------------|
00000180  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000001b0  2d 2d 2d 0a 0a 49 6e 69  74 69 61 6c 20 69 6d 70  |---..Initial imp|
000001c0  6c 65 6d 65 6e 74 61 74  69 6f 6e 20 62 79 20 4a  |lementation by J|
000001d0  61 6d 65 73 20 50 72 6f  63 74 65 72 20 32 6e 64  |ames Procter 2nd|
000001e0  20 4a 61 6e 75 61 72 79  20 31 39 39 31 20 20 20  | January 1991   |
000001f0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00000200  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000220  20 20 20 20 20 20 20 20  20 0a 54 68 69 73 20 69  |         .This i|
00000230  73 20 74 68 65 20 73 70  65 63 69 66 69 63 61 74  |s the specificat|
00000240  69 6f 6e 73 20 66 6f 72  20 74 68 65 20 50 2e 44  |ions for the P.D|
00000250  2e 20 21 50 6c 61 79 65  72 4d 6f 64 20 44 65 73  |. !PlayerMod Des|
00000260  6b 74 6f 70 0a 53 6f 75  6e 64 74 72 61 63 6b 65  |ktop.Soundtracke|
00000270  72 20 70 6c 61 79 20 27  6d 61 6e 61 67 65 72 27  |r play 'manager'|
00000280  20 62 79 20 4e 69 63 6b  20 53 6d 69 74 68 2c 20  | by Nick Smith, |
00000290  4d 61 74 74 20 44 75 72  79 73 2c 20 61 6e 64 20  |Matt Durys, and |
000002a0  54 68 65 0a 4d 61 64 20  44 6f 67 2e 20 49 74 20  |The.Mad Dog. It |
000002b0  61 6c 6c 6f 77 73 20 74  68 65 20 63 72 65 61 74  |allows the creat|
000002c0  69 6f 6e 20 6f 66 20 70  72 6f 67 72 61 6d 6d 65  |ion of programme|
000002d0  73 20 6f 66 20 73 6f 75  6e 64 74 72 61 63 6b 65  |s of soundtracke|
000002e0  72 73 0a 74 6f 20 62 65  20 70 6c 61 79 65 64 2c  |rs.to be played,|
000002f0  20 61 6e 64 20 63 6f 6e  74 72 6f 6c 73 20 74 68  | and controls th|
00000300  65 20 6d 65 74 68 6f 64  20 6f 66 20 73 77 69 74  |e method of swit|
00000310  63 68 69 6e 67 20 66 72  6f 6d 20 6f 6e 65 0a 6d  |ching from one.m|
00000320  6f 64 75 6c 65 20 74 6f  20 74 68 65 20 6e 65 78  |odule to the nex|
00000330  74 2e 0a 0a 41 74 20 74  68 65 20 74 69 6d 65 20  |t...At the time |
00000340  6f 66 20 77 72 69 74 69  6e 67 2c 20 74 68 65 20  |of writing, the |
00000350  69 6d 70 6c 65 6d 65 6e  74 61 74 69 6f 6e 20 61  |implementation a|
00000360  6c 6c 6f 77 73 20 66 61  64 69 6e 67 20 69 6e 0a  |llows fading in.|
00000370  74 77 6f 20 77 61 79 73  2c 20 65 69 74 68 65 72  |two ways, either|
00000380  20 61 6e 20 61 75 74 6f  66 61 64 65 20 6f 72 20  | an autofade or |
00000390  61 20 73 74 61 6e 64 61  72 64 20 66 61 64 65 20  |a standard fade |
000003a0  2d 20 74 68 65 20 61 75  74 6f 66 61 64 65 0a 6f  |- the autofade.o|
000003b0  6e 6c 79 20 6f 63 63 75  72 72 69 6e 67 20 69 66  |nly occurring if|
000003c0  20 74 68 65 20 6c 61 73  74 20 65 76 65 6e 74 20  | the last event |
000003d0  69 6e 20 74 68 65 20 6d  6f 64 75 6c 65 20 68 61  |in the module ha|
000003e0  73 20 6e 6f 0a 69 6e 73  74 72 75 6d 65 6e 74 73  |s no.instruments|
000003f0  20 61 63 74 69 76 65 2e  20 49 6e 20 62 6f 74 68  | active. In both|
00000400  20 63 61 73 65 73 20 74  68 65 20 66 61 64 65 74  | cases the fadet|
00000410  69 6d 65 20 63 61 6e 20  62 65 20 61 64 6a 75 73  |ime can be adjus|
00000420  74 65 64 0a 61 6e 64 20  2e 2e 2e 2e 0a 0a 50 6c  |ted.and ......Pl|
00000430  61 79 6c 69 73 74 20 46  69 6c 65 73 20 3a 20 46  |aylist Files : F|
00000440  69 6c 65 74 79 70 65 20  26 34 34 34 20 28 50 72  |iletype &444 (Pr|
00000450  6f 76 69 73 69 6f 6e 61  6c 29 0a 43 6f 6d 6d 61  |ovisional).Comma|
00000460  6e 64 73 20 20 20 20 20  20 20 3a 0a 0a 54 68 65  |nds       :..The|
00000470  20 63 6f 6d 6d 61 6e 64  73 20 66 61 6c 6c 20 69  | commands fall i|
00000480  6e 74 6f 20 74 77 6f 20  74 79 70 65 73 2c 20 74  |nto two types, t|
00000490  68 6f 73 65 20 74 68 61  74 20 61 70 70 6c 79 20  |hose that apply |
000004a0  74 6f 20 74 68 65 0a 6f  76 65 72 61 6c 6c 20 70  |to the.overall p|
000004b0  6c 61 79 6c 69 73 74 20  77 68 65 72 65 20 61 70  |laylist where ap|
000004c0  70 6c 69 63 61 62 6c 65  2c 20 61 6e 64 20 74 68  |plicable, and th|
000004d0  6f 73 65 20 77 68 69 63  68 20 61 70 70 6c 79 20  |ose which apply |
000004e0  74 6f 0a 6f 6e 6c 79 20  6f 6e 65 20 73 6f 6e 67  |to.only one song|
000004f0  20 65 6e 74 72 79 20 69  6e 20 74 68 65 20 70 6c  | entry in the pl|
00000500  61 79 6c 69 73 74 2e 0a  0a 47 65 6e 65 72 61 6c  |aylist...General|
00000510  20 43 6f 6d 6d 61 6e 64  73 0a 3d 3d 3d 3d 3d 3d  | Commands.======|
00000520  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 0a 0a 27 7c 27 20  |==========..'|' |
00000530  20 20 20 20 20 20 20 20  20 20 20 20 52 65 6d 20  |            Rem |
00000540  73 74 61 74 65 6d 65 6e  74 2c 20 6c 69 6e 65 73  |statement, lines|
00000550  20 73 74 61 72 74 69 6e  67 20 77 69 74 68 20 74  | starting with t|
00000560  68 69 73 20 77 69 6c 6c  0a 20 20 20 20 20 20 20  |his will.       |
00000570  20 20 20 20 20 20 20 20  20 62 65 20 69 67 6e 6f  |         be igno|
00000580  72 65 64 2e 0a 27 66 61  64 65 74 69 6d 65 20 78  |red..'fadetime x|
00000590  78 27 20 20 20 53 65 74  20 6f 76 65 72 61 6c 6c  |x'   Set overall|
000005a0  20 66 61 64 65 74 69 6d  65 20 74 6f 20 78 78 20  | fadetime to xx |
000005b0  70 6f 6c 6c 73 2e 20 54  68 69 73 20 6d 65 61 6e  |polls. This mean|
000005c0  73 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |s.              |
000005d0  20 20 74 68 61 74 20 61  6e 79 20 73 6f 6e 67 20  |  that any song |
000005e0  65 6e 74 72 69 65 73 20  77 68 69 63 68 20 64 6f  |entries which do|
000005f0  20 6e 6f 74 20 73 70 65  63 69 66 79 20 61 0a 20  | not specify a. |
00000600  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 66  |               f|
00000610  61 64 65 74 69 6d 65 2c  20 61 6e 64 20 64 6f 20  |adetime, and do |
00000620  6e 6f 74 20 64 69 73 61  62 6c 65 20 66 61 64 69  |not disable fadi|
00000630  6e 67 20 77 69 6c 6c 20  68 61 76 65 0a 20 20 20  |ng will have.   |
00000640  20 20 20 20 20 20 20 20  20 20 20 20 20 74 68 69  |             thi|
00000650  73 20 66 61 64 65 74 69  6d 65 2e 20 49 66 20 74  |s fadetime. If t|
00000660  68 69 73 20 63 6f 6d 6d  61 6e 64 20 69 73 20 6e  |his command is n|
00000670  6f 74 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |ot.             |
00000680  20 20 20 69 6e 63 6c 75  64 65 64 2c 20 74 68 65  |   included, the|
00000690  20 6f 76 65 72 61 6c 6c  20 66 61 64 65 74 69 6d  | overall fadetim|
000006a0  65 20 77 69 6c 6c 20 62  65 20 73 65 74 20 74 6f  |e will be set to|
000006b0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000006c0  20 74 68 61 74 20 77 68  69 63 68 20 69 73 20 75  | that which is u|
000006d0  73 65 64 20 66 6f 72 20  74 68 65 20 66 61 64 69  |sed for the fadi|
000006e0  6e 67 20 77 68 65 6e 20  0a 20 20 20 20 20 20 20  |ng when .       |
000006f0  20 20 20 20 20 20 20 20  20 27 70 6c 61 79 69 6e  |         'playin|
00000700  67 20 61 20 64 69 72 65  63 74 6f 72 79 27 2e 0a  |g a directory'..|
00000710  27 76 65 72 73 69 6f 6e  20 78 78 2e 78 78 27 20  |'version xx.xx' |
00000720  54 68 69 73 20 69 73 20  74 68 65 20 6d 69 6e 69  |This is the mini|
00000730  6d 75 6d 20 76 65 72 73  69 6f 6e 20 6e 75 6d 62  |mum version numb|
00000740  65 72 20 6f 66 0a 20 20  20 20 20 20 20 20 20 20  |er of.          |
00000750  20 20 20 20 20 20 21 50  6c 61 79 65 72 4d 6f 64  |      !PlayerMod|
00000760  20 6e 65 65 64 65 64 20  74 6f 20 75 73 65 20 74  | needed to use t|
00000770  68 69 73 20 70 6c 61 79  6c 69 73 74 2e 20 54 68  |his playlist. Th|
00000780  69 73 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |is.             |
00000790  20 20 20 63 61 6e 20 62  65 20 61 6e 79 77 68 65  |   can be anywhe|
000007a0  72 65 20 69 6e 20 74 68  65 20 66 69 6c 65 2c 20  |re in the file, |
000007b0  61 73 20 6c 6f 6e 67 20  61 73 20 69 74 20 69 73  |as long as it is|
000007c0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000007d0  20 6e 6f 74 20 72 65 6d  6d 65 64 20 6f 75 74 2e  | not remmed out.|
000007e0  20 21 50 6c 61 79 65 72  4d 6f 64 20 77 69 6c 6c  | !PlayerMod will|
000007f0  20 67 69 76 65 20 61 6e  20 65 72 72 6f 72 0a 20  | give an error. |
00000800  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 69  |               i|
00000810  66 20 6e 6f 20 76 61 6c  69 64 20 76 65 72 73 69  |f no valid versi|
00000820  6f 6e 20 6e 75 6d 62 65  72 20 69 73 20 67 69 76  |on number is giv|
00000830  65 6e 2e 0a 27 22 27 20  20 20 20 20 20 20 20 20  |en..'"'         |
00000840  20 20 20 20 53 74 61 72  74 20 6f 66 20 61 20 73  |    Start of a s|
00000850  6f 6e 67 20 65 6e 74 72  79 2e 0a 0a 54 68 65 20  |ong entry...The |
00000860  70 6c 61 79 6c 69 73 74  20 69 6e 74 65 72 70 72  |playlist interpr|
00000870  65 74 65 72 20 77 69 6c  6c 20 73 74 72 69 70 20  |eter will strip |
00000880  61 6c 6c 20 6c 65 61 64  69 6e 67 20 73 70 61 63  |all leading spac|
00000890  65 73 20 66 72 6f 6d 0a  74 68 65 20 6c 69 6e 65  |es from.the line|
000008a0  73 2c 20 61 6e 64 20 63  6f 6d 6d 61 6e 64 20 72  |s, and command r|
000008b0  65 63 6f 67 6e 69 74 69  6f 6e 20 69 73 20 6e 6f  |ecognition is no|
000008c0  74 20 63 61 73 65 20 64  65 70 65 6e 64 65 6e 74  |t case dependent|
000008d0  2e 0a 0a 53 6f 6e 67 20  45 6e 74 72 69 65 73 0a  |...Song Entries.|
000008e0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 0a 0a 54 68  |============..Th|
000008f0  65 73 65 20 61 72 65 20  6c 69 6e 65 73 20 73 74  |ese are lines st|
00000900  61 72 74 69 6e 67 20 77  69 74 68 20 61 20 71 75  |arting with a qu|
00000910  6f 74 65 20 3a 20 27 22  27 0a 54 68 65 20 67 65  |ote : '"'.The ge|
00000920  6e 65 72 61 6c 20 73 79  6e 74 61 78 20 69 73 20  |neral syntax is |
00000930  61 73 20 66 6f 6c 6c 6f  77 73 20 3a 0a 0a 22 3c  |as follows :.."<|
00000940  46 75 6c 6c 20 53 6f 6e  67 20 50 61 74 68 6e 61  |Full Song Pathna|
00000950  6d 65 3e 22 20 5b 3c 66  61 64 65 74 69 6d 65 3e  |me>" [<fadetime>|
00000960  7c 7b 63 6f 6d 6d 61 6e  64 7d 5d 0a 0a 57 69 74  ||{command}]..Wit|
00000970  68 20 6a 75 73 74 20 74  68 65 20 73 6f 6e 67 20  |h just the song |
00000980  70 61 74 68 6e 61 6d 65  2c 20 21 50 6c 61 79 65  |pathname, !Playe|
00000990  72 4d 6f 64 20 77 69 6c  6c 20 6a 75 73 74 20 70  |rMod will just p|
000009a0  6c 61 79 20 74 68 65 0a  73 6f 6e 67 20 61 6e 64  |lay the.song and|
000009b0  20 75 73 65 20 74 68 65  20 73 65 6d 69 2d 69 6e  | use the semi-in|
000009c0  74 65 6c 6c 69 67 65 6e  74 20 61 75 74 6f 66 61  |telligent autofa|
000009d0  64 65 20 75 73 69 6e 67  20 74 68 65 20 6f 76 65  |de using the ove|
000009e0  72 61 6c 6c 0a 66 61 64  65 74 69 6d 65 2e 0a 0a  |rall.fadetime...|
000009f0  3c 66 61 64 65 74 69 6d  65 3e 20 69 73 20 61 20  |<fadetime> is a |
00000a00  76 61 6c 75 65 20 69 6e  20 70 6f 6c 6c 73 2c 20  |value in polls, |
00000a10  61 67 61 69 6e 20 61 73  20 69 6e 20 74 68 65 20  |again as in the |
00000a20  67 65 6e 65 72 61 6c 0a  63 6f 6d 6d 61 6e 64 20  |general.command |
00000a30  27 66 61 64 65 74 69 6d  65 27 2c 20 61 6e 64 20  |'fadetime', and |
00000a40  77 69 6c 6c 20 68 61 76  65 20 74 68 65 20 65 66  |will have the ef|
00000a50  66 65 63 74 20 6f 66 20  63 61 75 73 69 6e 67 20  |fect of causing |
00000a60  74 68 65 0a 70 6c 61 79  65 72 20 74 6f 20 70 6c  |the.player to pl|
00000a70  61 79 20 74 68 65 20 73  6f 6e 67 20 61 6e 64 20  |ay the song and |
00000a80  66 61 64 65 20 75 73 69  6e 67 20 74 68 65 20 73  |fade using the s|
00000a90  65 6d 69 2d 69 6e 74 65  6c 6c 69 67 65 6e 74 0a  |emi-intelligent.|
00000aa0  66 61 64 69 6e 67 20 73  79 73 74 65 6d 20 77 69  |fading system wi|
00000ab0  74 68 20 74 68 65 20 73  70 65 63 69 66 69 65 64  |th the specified|
00000ac0  20 66 61 64 65 74 69 6d  65 2e 0a 0a 7b 63 6f 6d  | fadetime...{com|
00000ad0  6d 61 6e 64 7d 20 63 61  6e 20 62 65 20 6f 6e 65  |mand} can be one|
00000ae0  20 6f 66 20 74 68 65 20  66 6f 6c 6c 6f 77 69 6e  | of the followin|
00000af0  67 20 3a 0a 0a 27 6e 6f  66 61 64 65 27 20 20 20  |g :..'nofade'   |
00000b00  20 20 20 20 20 54 68 69  73 20 77 69 6c 6c 20 74  |     This will t|
00000b10  75 72 6e 20 61 6c 6c 20  66 61 64 69 6e 67 20 6f  |urn all fading o|
00000b20  66 66 2c 20 61 6e 64 20  74 68 65 20 6e 65 78 74  |ff, and the next|
00000b30  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00000b40  20 73 6f 6e 67 20 77 69  6c 6c 20 62 65 20 70 6c  | song will be pl|
00000b50  61 79 65 64 20 69 6d 6d  65 64 69 61 74 65 6c 79  |ayed immediately|
00000b60  20 61 74 20 74 68 65 20  65 6e 64 0a 20 20 20 20  | at the end.    |
00000b70  20 20 20 20 20 20 20 20  20 20 20 20 6f 66 20 74  |            of t|
00000b80  68 69 73 20 73 6f 6e 67  2c 20 77 69 74 68 20 6e  |his song, with n|
00000b90  6f 20 66 61 64 69 6e 67  20 6f 75 74 2e 0a 27 66  |o fading out..'f|
00000ba0  61 64 65 20 5b 78 78 5d  27 20 20 20 20 20 54 68  |ade [xx]'     Th|
00000bb0  69 73 20 74 75 72 6e 73  20 6f 66 66 20 74 68 65  |is turns off the|
00000bc0  20 27 69 6e 73 74 72 75  6d 65 6e 74 20 64 65 74  | 'instrument det|
00000bd0  65 63 74 69 6f 6e 27 0a  20 20 20 20 20 20 20 20  |ection'.        |
00000be0  20 20 20 20 20 20 20 20  66 65 61 74 75 72 65 20  |        feature |
00000bf0  6f 66 20 74 68 65 20 66  61 64 69 6e 67 20 73 79  |of the fading sy|
00000c00  73 74 65 6d 2c 20 73 6f  20 74 68 61 74 20 74 68  |stem, so that th|
00000c10  65 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |e.              |
00000c20  20 20 6d 6f 64 75 6c 65  20 77 69 6c 6c 20 66 61  |  module will fa|
00000c30  64 65 20 6f 75 74 20 69  72 72 65 73 70 65 63 74  |de out irrespect|
00000c40  69 76 65 20 6f 66 20 74  68 65 0a 20 20 20 20 20  |ive of the.     |
00000c50  20 20 20 20 20 20 20 20  20 20 20 63 75 72 72 65  |           curre|
00000c60  6e 74 20 69 6e 73 74 72  75 6d 65 6e 74 20 73 74  |nt instrument st|
00000c70  61 74 65 73 20 61 74 20  74 68 65 20 65 6e 64 20  |ates at the end |
00000c80  6f 66 20 74 68 65 0a 20  20 20 20 20 20 20 20 20  |of the.         |
00000c90  20 20 20 20 20 20 20 73  6f 6e 67 2e 20 54 68 65  |       song. The|
00000ca0  20 66 61 64 65 74 69 6d  65 20 63 61 6e 20 62 65  | fadetime can be|
00000cb0  20 73 65 74 20 5b 78 78  5d 20 69 66 20 77 69 73  | set [xx] if wis|
00000cc0  68 65 64 0a 20 20 20 20  20 20 20 20 20 20 20 20  |hed.            |
00000cd0  20 20 20 20 62 75 74 20  74 68 65 20 6f 76 65 72  |    but the over|
00000ce0  61 6c 6c 20 73 65 74 74  69 6e 67 20 77 69 6c 6c  |all setting will|
00000cf0  20 62 65 20 75 73 65 64  20 69 66 20 6e 6f 74 0a  | be used if not.|
00000d00  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000d10  73 70 65 63 69 66 69 65  64 2e 0a 0a 4e 6f 74 65  |specified...Note|
00000d20  73 0a 3d 3d 3d 3d 3d 0a  0a 49 66 20 74 68 65 20  |s.=====..If the |
00000d30  73 6f 6e 67 20 63 61 6e  6e 6f 74 20 62 65 20 66  |song cannot be f|
00000d40  6f 75 6e 64 2c 20 74 68  65 6e 20 61 6e 20 65 72  |ound, then an er|
00000d50  72 6f 72 20 77 69 6c 6c  20 62 65 20 67 65 6e 65  |ror will be gene|
00000d60  72 61 74 65 64 0a 61 6e  64 20 74 68 65 20 70 6c  |rated.and the pl|
00000d70  61 79 6c 69 73 74 20 77  69 6c 6c 20 6e 6f 74 20  |aylist will not |
00000d80  62 65 20 70 6c 61 79 65  64 2e 0a 0a 50 6c 61 79  |be played...Play|
00000d90  6c 69 73 74 73 20 77 69  74 68 20 6e 6f 20 73 6f  |lists with no so|
00000da0  6e 67 20 65 6e 74 72 69  65 73 20 77 69 6c 6c 20  |ng entries will |
00000db0  6e 6f 74 20 62 65 20 70  6c 61 79 65 64 2e 0a 0a  |not be played...|
00000dc0  54 68 65 20 73 6f 6e 67  20 65 6e 74 72 69 65 73  |The song entries|
00000dd0  20 77 69 6c 6c 20 62 65  20 70 6c 61 79 65 64 20  | will be played |
00000de0  69 6e 20 6f 72 64 65 72  20 6f 66 20 61 70 70 65  |in order of appe|
00000df0  61 72 61 6e 63 65 20 69  6e 0a 74 68 65 20 66 69  |arance in.the fi|
00000e00  6c 65 2c 20 6c 6f 6f 70  69 6e 67 20 62 61 63 6b  |le, looping back|
00000e10  20 74 6f 20 74 68 65 20  66 69 72 73 74 20 6f 6e  | to the first on|
00000e20  65 2c 20 61 74 20 74 68  65 20 65 6e 64 3b 20 75  |e, at the end; u|
00000e30  6e 6c 65 73 73 0a 74 68  65 20 27 52 4e 44 27 20  |nless.the 'RND' |
00000e40  6f 70 74 69 6f 6e 20 68  61 73 20 62 65 65 6e 20  |option has been |
00000e50  73 65 6c 65 63 74 65 64  20 6f 6e 20 74 68 65 20  |selected on the |
00000e60  63 6f 6e 74 72 6f 6c 20  70 61 6e 65 6c 2c 0a 75  |control panel,.u|
00000e70  73 69 6e 67 20 74 68 65  20 27 3e 3e 27 20 61 6e  |sing the '>>' an|
00000e80  64 20 27 3c 3c 27 20 63  6f 6e 74 72 6f 6c 73 20  |d '<<' controls |
00000e90  66 6f 72 20 66 6c 69 70  70 69 6e 67 20 62 65 74  |for flipping bet|
00000ea0  77 65 65 6e 20 73 6f 6e  67 73 0a 66 72 6f 6d 20  |ween songs.from |
00000eb0  64 69 72 65 63 74 6f 72  69 65 73 20 77 69 6c 6c  |directories will|
00000ec0  20 74 72 61 76 65 72 73  65 20 74 68 65 20 73 6f  | traverse the so|
00000ed0  6e 67 20 65 6e 74 72 69  65 73 2e 0a 0a 45 78 70  |ng entries...Exp|
00000ee0  65 72 69 6d 65 6e 74 61  74 69 6f 6e 20 6d 75 73  |erimentation mus|
00000ef0  74 20 62 65 20 6d 61 64  65 20 77 69 74 68 20 74  |t be made with t|
00000f00  68 65 20 62 65 73 74 20  61 72 72 61 6e 67 65 6d  |he best arrangem|
00000f10  65 6e 74 73 20 6f 66 0a  66 61 64 69 6e 67 2c 20  |ents of.fading, |
00000f20  61 6e 64 20 66 61 64 65  74 69 6d 65 73 2e 20 54  |and fadetimes. T|
00000f30  68 65 20 66 61 64 65 74  69 6d 65 73 20 61 72 65  |he fadetimes are|
00000f40  20 6e 6f 74 20 63 6f 6e  73 74 61 6e 74 20 2d 0a  | not constant -.|
00000f50  73 69 6e 63 65 20 74 68  65 79 20 61 72 65 20 61  |since they are a|
00000f60  66 66 65 63 74 65 64 20  62 79 20 77 69 6d 70 20  |ffected by wimp |
00000f70  70 6f 6c 6c 69 6e 67 20  73 70 65 65 64 20 2d 20  |polling speed - |
00000f80  69 65 20 69 66 20 69 74  0a 69 73 20 65 78 74 72  |ie if it.is extr|
00000f90  65 6d 65 6c 79 20 73 6c  6f 77 20 74 68 65 20 66  |emely slow the f|
00000fa0  61 64 65 74 69 6d 65 20  77 69 6c 6c 20 61 70 70  |adetime will app|
00000fb0  65 61 72 20 74 6f 20 62  65 20 68 69 67 68 65 72  |ear to be higher|
00000fc0  2e 0a 53 69 6e 63 65 20  22 57 69 6d 70 5f 50 6f  |..Since "Wimp_Po|
00000fd0  6c 6c 49 64 6c 65 22 20  69 73 20 75 73 65 64 2c  |llIdle" is used,|
00000fe0  20 74 68 65 20 66 61 64  65 74 69 6d 65 73 20 77  | the fadetimes w|
00000ff0  69 6c 6c 20 62 65 0a 67  65 6e 65 72 61 6c 6c 79  |ill be.generally|
00001000  20 63 6f 6e 73 74 61 6e  74 2e 0a 0a 50 72 6f 62  | constant...Prob|
00001010  6c 65 6d 73 0a 3d 3d 3d  3d 3d 3d 3d 3d 0a 0a 53  |lems.========..S|
00001020  69 6e 63 65 20 74 68 65  20 77 69 6d 70 20 69 73  |ince the wimp is|
00001030  20 70 6f 6c 6c 69 6e 67  20 74 68 65 20 70 72 6f  | polling the pro|
00001040  67 72 61 6d 2c 20 69 66  20 74 68 65 20 77 69 6d  |gram, if the wim|
00001050  70 20 69 73 0a 65 6e 67  61 67 65 64 20 69 6e 20  |p is.engaged in |
00001060  73 6f 6d 65 20 74 69 6d  65 20 63 6f 6e 73 75 6d  |some time consum|
00001070  69 6e 67 20 74 61 73 6b  20 61 6e 64 20 74 68 65  |ing task and the|
00001080  20 73 6f 6e 67 20 72 65  61 63 68 65 73 0a 69 74  | song reaches.it|
00001090  27 73 20 65 6e 64 20 61  6e 64 20 77 72 61 70 73  |'s end and wraps|
000010a0  20 61 72 6f 75 6e 64 20  74 68 65 20 70 72 6f 67  | around the prog|
000010b0  72 61 6d 20 77 69 6c 6c  20 6e 6f 74 20 72 65 61  |ram will not rea|
000010c0  6c 69 73 65 0a 74 68 69  73 3b 20 68 65 6e 63 65  |lise.this; hence|
000010d0  20 6e 6f 20 63 68 61 6e  67 69 6e 67 20 6f 66 20  | no changing of |
000010e0  73 6f 6e 67 73 20 77 69  6c 6c 20 74 61 6b 65 20  |songs will take |
000010f0  70 6c 61 63 65 2e 0a 0a  54 68 65 20 61 75 74 6f  |place...The auto|
00001100  66 61 64 65 20 67 65 74  27 73 20 63 61 75 67 68  |fade get's caugh|
00001110  74 20 6f 75 74 20 62 79  20 74 68 6f 73 65 20 73  |t out by those s|
00001120  6f 6e 67 73 20 77 68 65  72 65 20 74 68 65 72 65  |ongs where there|
00001130  0a 69 73 20 61 20 72 65  70 65 61 74 69 6e 67 20  |.is a repeating |
00001140  6e 6f 74 65 20 70 6c 61  79 65 64 20 61 74 20 74  |note played at t|
00001150  68 65 20 65 6e 64 20 6f  66 20 74 68 65 20 6c 61  |he end of the la|
00001160  73 74 20 70 61 74 74 65  72 6e 2c 0a 66 69 6c 6c  |st pattern,.fill|
00001170  69 6e 67 2d 69 6e 20 62  65 66 6f 72 65 20 74 68  |ing-in before th|
00001180  65 20 77 72 61 70 20 61  72 6f 75 6e 64 2e 20 54  |e wrap around. T|
00001190  68 65 20 66 61 64 69 6e  67 20 73 79 73 74 65 6d  |he fading system|
000011a0  0a 61 63 74 75 61 6c 6c  79 20 73 74 61 72 74 73  |.actually starts|
000011b0  20 77 68 65 6e 20 74 68  65 20 77 72 61 70 20 61  | when the wrap a|
000011c0  72 6f 75 6e 64 20 6f 63  63 75 72 73 20 2d 20 61  |round occurs - a|
000011d0  6e 64 20 77 69 6c 6c 0a  68 65 6e 63 65 20 74 61  |nd will.hence ta|
000011e0  6b 65 20 70 6c 61 63 65  2e 20 49 6e 20 74 68 65  |ke place. In the|
000011f0  73 65 20 73 69 74 75 61  74 69 6f 6e 73 20 69 74  |se situations it|
00001200  20 69 73 20 62 65 73 74  20 6e 6f 74 20 74 6f 0a  | is best not to.|
00001210  68 61 76 65 20 74 68 65  20 66 61 64 69 6e 67 20  |have the fading |
00001220  6f 6e 2e 0a 0a 49 66 20  74 68 65 72 65 20 61 72  |on...If there ar|
00001230  65 20 76 6f 6c 75 6d 65  20 63 68 61 6e 67 65 20  |e volume change |
00001240  63 6f 6d 6d 61 6e 64 73  20 61 74 20 74 68 65 20  |commands at the |
00001250  73 74 61 72 74 20 6f 66  20 74 68 65 0a 74 75 6e  |start of the.tun|
00001260  65 2c 20 77 68 65 6e 20  74 68 65 20 66 61 64 69  |e, when the fadi|
00001270  6e 67 20 73 79 73 74 65  6d 20 63 6f 6d 65 73 20  |ng system comes |
00001280  69 6e 74 6f 20 61 63 74  69 6f 6e 20 74 68 65 72  |into action ther|
00001290  65 20 77 69 6c 6c 0a 62  65 20 73 6f 6d 65 20 6f  |e will.be some o|
000012a0  64 64 20 65 66 66 65 63  74 73 20 73 69 6e 63 65  |dd effects since|
000012b0  20 74 68 65 20 70 6c 61  79 72 6f 75 74 69 6e 65  | the playroutine|
000012c0  20 77 69 6c 6c 20 75 73  65 0a 64 69 66 66 65 72  | will use.differ|
000012d0  65 6e 74 20 76 6f 6c 75  6d 65 73 20 66 6f 72 20  |ent volumes for |
000012e0  73 6f 6d 65 20 6f 66 20  74 68 65 20 6e 6f 74 65  |some of the note|
000012f0  73 20 2d 20 69 6e 73 74  65 61 64 20 6f 66 0a 75  |s - instead of.u|
00001300  73 69 6e 67 20 74 68 65  20 64 65 66 61 75 6c 74  |sing the default|
00001310  20 73 61 6d 70 6c 65 20  76 6f 6c 75 6d 65 73 20  | sample volumes |
00001320  77 68 69 63 68 20 74 68  65 20 21 50 6c 61 79 65  |which the !Playe|
00001330  72 4d 6f 64 0a 76 6f 6c  75 6d 65 20 73 79 73 74  |rMod.volume syst|
00001340  65 6d 20 61 66 66 65 63  74 73 2e 0a 0a 46 75 74  |em affects...Fut|
00001350  75 72 65 20 64 65 76 65  6c 6f 70 6d 65 6e 74 73  |ure developments|
00001360  0a 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |.===============|
00001370  3d 3d 3d 3d 0a 0a 49 6e  63 6c 75 73 69 6f 6e 20  |====..Inclusion |
00001380  6f 66 20 63 68 61 6e 6e  65 6c 20 73 74 65 72 65  |of channel stere|
00001390  6f 20 70 6f 73 69 74 69  6f 6e 20 73 65 74 74 69  |o position setti|
000013a0  6e 67 73 20 66 6f 72 20  73 6f 6e 67 73 2e 0a 28  |ngs for songs..(|
000013b0  49 73 6e 27 74 20 69 74  20 61 6e 6e 6f 79 69 6e  |Isn't it annoyin|
000013c0  67 20 77 68 65 6e 20 73  6f 75 6e 64 74 72 61 63  |g when soundtrac|
000013d0  6b 65 72 20 72 65 74 75  72 6e 73 20 74 68 65 20  |ker returns the |
000013e0  63 68 61 6e 6e 65 6c 0a  70 6f 73 69 74 69 6f 6e  |channel.position|
000013f0  73 20 74 6f 20 74 68 65  20 64 65 66 61 75 6c 74  |s to the default|
00001400  20 65 76 65 72 79 74 69  6d 65 3f 29 2e 0a 0a 41  | everytime?)...A|
00001410  20 70 6c 61 79 6c 69 73  74 20 63 72 65 61 74 6f  | playlist creato|
00001420  72 20 75 74 69 6c 69 74  79 2c 20 65 69 74 68 65  |r utility, eithe|
00001430  72 20 61 73 20 61 20 73  65 70 61 72 61 74 65 20  |r as a separate |
00001440  77 69 6d 70 0a 61 70 70  6c 69 63 61 74 69 6f 6e  |wimp.application|
00001450  20 69 6e 20 74 68 65 20  27 42 69 74 73 27 20 64  | in the 'Bits' d|
00001460  69 72 65 63 74 6f 72 79  20 6f 72 20 61 73 20 61  |irectory or as a|
00001470  6e 20 65 78 74 65 6e 73  69 6f 6e 20 74 6f 0a 74  |n extension to.t|
00001480  68 65 20 6d 61 69 6e 20  70 72 6f 67 72 61 6d 2c  |he main program,|
00001490  20 61 6c 6c 6f 77 69 6e  67 20 61 75 74 6f 6d 61  | allowing automa|
000014a0  74 69 63 20 6c 6f 67 67  69 6e 67 20 6f 66 20 73  |tic logging of s|
000014b0  6f 6e 67 73 20 69 6e 0a  61 20 70 6c 61 79 6c 69  |ongs in.a playli|
000014c0  73 74 20 66 6f 72 20 73  61 76 69 6e 67 2c 20 61  |st for saving, a|
000014d0  6c 73 6f 20 70 72 65 76  69 65 77 73 20 61 6e 64  |lso previews and|
000014e0  20 27 74 77 65 61 6b 69  6e 67 27 20 6f 66 0a 66  | 'tweaking' of.f|
000014f0  61 64 69 6e 67 20 77 68  69 6c 73 74 20 70 6c 61  |ading whilst pla|
00001500  79 69 6e 67 20 74 68 65  20 6c 69 73 74 2e 0a 0a  |ying the list...|
00001510  42 65 74 74 65 72 20 63  6f 6e 74 72 6f 6c 20 6f  |Better control o|
00001520  66 20 76 6f 6c 75 6d 65  20 66 61 64 69 6e 67 2c  |f volume fading,|
00001530  20 69 6e 63 6c 75 64 69  6e 67 20 70 72 65 63 69  | including preci|
00001540  73 65 72 0a 63 6f 6e 74  72 6f 6c 20 6f 66 20 77  |ser.control of w|
00001550  68 65 6e 20 74 6f 20 66  61 64 65 2c 20 74 69 6d  |hen to fade, tim|
00001560  65 20 64 65 6c 61 79 20  62 65 74 77 65 65 6e 20  |e delay between |
00001570  65 61 63 68 20 76 6f 6c  75 6d 65 0a 64 65 63 72  |each volume.decr|
00001580  65 6d 65 6e 74 2e 0a 0a  53 6f 6e 67 20 72 65 70  |ement...Song rep|
00001590  65 61 74 73 2c 20 69 65  20 73 6f 20 74 68 61 74  |eats, ie so that|
000015a0  20 72 65 70 65 61 74 65  64 20 73 75 63 63 65 73  | repeated succes|
000015b0  73 69 76 65 20 65 6e 74  72 69 65 73 20 6f 66 0a  |sive entries of.|
000015c0  61 20 73 6f 6e 67 20 77  69 74 68 20 69 64 65 6e  |a song with iden|
000015d0  74 69 63 61 6c 20 70 61  72 61 6d 65 74 65 72 73  |tical parameters|
000015e0  20 61 72 65 20 6e 6f 74  20 6e 65 65 64 65 64 2e  | are not needed.|
000015f0  0a 0a 54 68 61 74 27 73  20 61 62 6f 75 74 20 61  |..That's about a|
00001600  6c 6c 20 49 20 63 61 6e  20 73 61 79 2c 20 68 6f  |ll I can say, ho|
00001610  70 65 20 79 6f 75 20 66  69 6e 64 20 74 68 69 73  |pe you find this|
00001620  20 75 73 65 66 75 6c 2e  2e 2e 2e 0a 0a 4a 61 6d  | useful......Jam|
00001630  65 73 20 50 72 6f 63 74  65 72 2c 20 31 30 2d 46  |es Procter, 10-F|
00001640  65 62 2d 39 31 0a 0a 2d  2d 2d 2d 2d 2d 2d 2d 2d  |eb-91..---------|
00001650  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001680  2d 2d 2d 2d 2d 2d 0a 65  6e 64 2e 0a              |------.end..|
0000168c