# File : sequencesHTML.conf

#########################################################
# Here is the configuration file for  sequencesHTML.cgi #
#########################################################

messagesFile ../etc/messages.conf

# Where are the images  for  the top bar ?

# You have to define  a  path available   from  the output page in   a
# browser, not from the standard Unix path in a shell.
# Warning: The last "/" is needed.

 DirTopBarImages ../images/forTheCGI/


# Where is the documentation ?
# Warning: The last "/" is needed.

 DirDocumentation ../doc/

# Where is the DrumPatterns home page ?

 DirHomePage ../

# Where is the images for the score ?

 DirScoreImages ./

# You need to adjust  the parameters to suit the  load of your machine
# and the lenght of the result page.
 
# Ligne beginning with # are ignored. Blank lines as well

# !!! WEBMASTER, READ THIS !!!
# Piece of advice for Real WWW Servers: 

# Avoid  setting  both values "PatternNumberMax" and "ResultLengthMax"
# to "unlimited"

# You can limit the number of pattern with  this parameter. Default is
# unlimited, a large one, not  dangerous if ResultLengthMax is defined
# with a "good" value.

# possible value : "PatternNumberMax unlimited"

 PatternNumberMax   unlimited

# You  can  prefer limit the output  with   the number  of kilo-octets
# generated. I prefer this one because computing is very efficient.

# possible value : "ResultLengthMax unlimited"

 ResultLengthMax 200

# You can  also limit the amount  of calculation  time (in seconds) for
# the users. Possible value : "TimeOutCalcul 0" means "unlimited".
# I suggest 0 because the midi stuff is not fully controled. I mean
# the sigalarm do not kill the tcl process. So let finish it.

 TimeOutCalcul 0

##############
# MIDI stuff #
##############

# The directory that stores the midi files.
# A relative path is from where stays the sequencesHTML.cgi script
# This directory must be writable by the http user, often "nobody",
# or by everybody ie :
#
# drwxrwxrwx  2 root     root    ../WWR # Not very secure
# drwx------  2 nobody   nobody  ../WWR # More secure but be carefull
#
# This directory must be known from a shell


 WorldWritableDirectory    ../WWR

# The same directory but accessed from a browser

 WorldWritableDirectoryFromBrowser ../WWR

# Where is tcl ?

 tclInterpreter /usr/bin/tcl

# Where is the tclmidi lib ?

 DirTclMidiLib ../lib/tclmidi

# The maximum size of this directory in KILO OCTETS.
# The oldest midi files are unlink in order to keep this limit.
# I think it is important this value  be upper than ResultLengthMax

 maxSizeWorldWritableDirectory 5000

# The compression tools you can offer.
# Uncomment those you do not have and adapt the path to yours
# I prefer let you tell it instead of searching them (for
# security reasons).

# The noneCompression allow the user to choose no compression.
# If you comment all compression style then "noneCompression"
# will be choosen automatically

# zip is for DOS
# gz is for UNIX and DOS
# bz2 is for UNIX only, I think.

# the most effective is "bz2", then "gz", then "zip", then "none" :)

 zipCompression   /usr/bin/zip -q
 gzCompression    /bin/gzip
 bz2Compression   /usr/bin/bzip2
 noneCompression  /bin/cat

 zipExtension   .zip
 gzExtension    .gz
 bz2Extension   .bz2
 noneExtension  .mid

# The maximum size of a none compressed midi file in KiloOctet

 ResultMidiLengthMax 500

# Debug modes
#

# debugMidi 1