@DATABASE Csound.guide

@WIDTH 80

@AUTHOR{Michael Cheng}

@NODE MAIN {Csound.guide}

Csound 100796-A1

Original C source by SongLab

amiga compile by @{" Michael Cheng " link "Author"}

@{" Introduction " link "Introduction"}
@{" History " link "History"}
@{" Requirements " link "Requirements"}
@{" Usage " link "Usage"}
@{" Problems " link "Problems"}
@{" Future " link "Future"}
@{" Acknowledgements " link "Acknowledgements"}
@{" Author " link "Author"}

@ENDNODE

@NODE "Introduction" "Introduction"

Csound is a platform independant program for audio processing.  There exist
executables for many unix platforms as well as Windows, Macintosh and Atari.

Given two prepared files describing the orchestra(instruments) and the
score, Csound will generate a soundfile of 8 or 16bit sound.

Csound also does audio processing of soundfiles
    - basic soundfile info
    - hetrodyne filter analysis
    - linear predictive analysis
    - fourier analysis

The full usage and documentation etc can be found on
   http://www.inx.de/%7Erubo/songlab/midi2cs/csound.html

Binary versions for other platforms, as well as source, soundfiles and example
files can be found on
    ftp://ftp.maths.bath.ac.uk/pub/dream

@ENDNODE

@NODE "History" "History"

Amiga compile version: A1
15 July 1996
    - compiled Csound source with amiga gcc2.7.2
        see CHANGES.amiga for things I tweaked to get it working.
 
@ENDNODE

@NODE "Requirements" "Requirements"

    - compiled for 020 and 030+881

    - ixemul43+

@ENDNODE

@NODE "Usage" "Usage"

The full usage and documentation etc can be found on
   http://www.inx.de/%7Erubo/songlab/midi2cs/csound.html

Binary versions for other platforms, as well as source, soundfiles and example
files can be found on
    ftp://ftp.maths.bath.ac.uk/pub/dream

Also see the file  Csound.manual

Quick usage info:
    Csound -o output.sound -u file.orc file.sco

    look in the 'examples' dir for .sco and .orc files.

    The generated soundfile (output.sound) can be played with oplay
        oplay output.sound
    or with play16
        play16 RAW bits=8 header=0 ulaw output.sound

    Sound data in output file can be specified with flags. Read Csound.manual
for more info.

(For example:
    csound -o bach.snd -u bach.orc bach.src

    This takes about 7 minutes on my 25MHz 030/881)

@ENDNODE

@NODE "Problems" "Problems"

    - My 'quick fix' solution for the errors in wave.c and aiff.c means that
trying to write AIFF and WAV files probably isn't working properly.

    - Lots of stuff hasn't been tested yet. ie all the utils and the midi
        support etc etc.

    - It's probably safest to explicitly specify all filenames. Do NOT trust
        there to be a default.

    - There's talk in the manual about 'rtaudio' in which the program decodes
        the sound in real time to the audio device. I am not going to include
        this, because   (a) I can't program
                        (b) a 25MHz 030/881 takes greater than real time to
                            encode the signal.

    - Mail me bug reports.

@ENDNODE

@NODE "Future" "Future"

    - If the AmiWin devt kit is ever released for gcc, then I could compile
        Csound to use the X screen driver.  (The cruddy ascii outputs of
        waveforms are supposed to be graphical)

    - Working on a compilation of BashFest4Csound.  This is a drum simulator.

    - Maybe compile Midi2Cs. (midifile to csound score convertor)

@ENDNODE

@NODE "Acknowledgements" "Acknowledgements"

    - SongLab
    - Paulina

@ENDNODE

@NODE "Author" "Author"

Michael Cheng
memfc@alinga.newcastle.edu.au
http://joffre.newcastle.edu.au/
Cstar on #amiga

@ENDNODE