fluidEngine
Prev | Orchestra Opcodes and Operators | Next

## fluidEngine

fluidEngine — Instantiates a fluidsynth engine.

## Syntax

    ienginenum fluidEngine [iReverbEnabled] [, iChorusEnabled] [,iNumChannels] [, iPolyphony]

## Description

Instantiates a fluidsynth engine, and returns ienginenum to identify the engine. ienginenum is passed to other other opcodes for loading and playing SoundFonts and gathering the generated sound.

## Initialization

ienginenum -- engine number assigned from fluidEngine.

iReverbEnabled -- optionally set to 0 to disable any reverb effect in the loaded SoundFonts.

iChorusEnabled -- optionally set to 0 to disable any chorus effect in the loaded SoundFonts.

iNumChannels -- number of channels to use; range is 16-256 and Csound default is 256 (Fluidsynth's default is 16).

iPolyphony -- number of voices to be played in parallel; range is 16-4096 and Csound default is 4096 (Fluidsynth's default is 256). Note: this is not the number of notes played at the same time as a single note may use create multiple voices depending on instrument zones and velocity/key of played note.

## Examples

Here is example of the fluidsynth opcodes using 2 engines. It uses the file fluidEngine.csd and midichn_advanced.mid.

    <CsoundSynthesizer>
    <CsOptions>
    ; Select audio/midi flags here according to platform
    -odac  -F  midichn_advanced.mid ;;;reatime audio out and midifile in
    ;-iadc    ;;;uncomment -iadc if realtime audio input is needed too
    ; For Non-realtime ouput leave only the line below:
    ; -o fluidEngine.wav -W ;;; for file output any platform
    </CsOptions>
    <CsInstruments>

    sr = 44100
    ksmps = 32
    nchnls = 2
    0dbfs  = 1

    ; LOAD SOUNDFONTS
    gienginenum1	fluidEngine
    gienginenum2	fluidEngine
    isfnum1	fluidLoad "sf_GMbank.sf2", gienginenum1, 1
                    ; Piano 2, program 1, channel 1
    		fluidProgramSelect	gienginenum1, 1, isfnum1, 0, 1
                    ; Piano 3, program 2, channel 2
    		fluidProgramSelect	gienginenum1, 2, isfnum1, 0, 2
    isfnum2	fluidLoad "19Trumpet.sf2", gienginenum2, 1
                    ; Trumpet, program 56, channel 3
    		fluidProgramSelect	gienginenum2, 3, isfnum2, 0, 56

    ;Look for midifile in folder manual/examples
    ;"midichn_advanced.mid" sends notes to the soundfonts

    instr 1 ; GM soundfont
      ; INITIALIZATION
    	mididefault	60, p3 ; Default duration of 60 -- overridden by score.
    	midinoteonkey	p4, p5 ; Channels MIDI input to pfields.
      ; Use channel assigned in fluidload.
      ichannel   = 1
      ikey       = p4
      ivelocity  = p5
    	fluidNote gienginenum1, ichannel, ikey, ivelocity
    endin

    instr 2 ; GM soundfont
      ; INITIALIZATION
             mididefault   60, p3 ; Default duration of 60 -- overridden by score.
             midinoteonkey p4, p5 ; Channels MIDI input to pfields.
      ; Use channel assigned in fluidload.
      ichannel   = 2
      ikey       = p4
      ivelocity  = p5
             fluidNote gienginenum1, ichannel, ikey, ivelocity
    endin

    instr 3 ; Trumpet
      ; INITIALIZATION
             mididefault   60, p3 ; Default duration of 60 -- overridden by score.
             midinoteonkey p4, p5 ; Channels MIDI input to pfields.
      ; Use channel assigned in fluidload.
      ichannel   = 3
      ikey       = p4
      ivelocity  = p5
             fluidNote gienginenum2, ichannel, ikey, ivelocity
    endin

    ; COLLECT AUDIO FROM ALL SOUNDFONTS

    instr 100 ; Fluidsynth output

      iamplitude1 = 7
      iamplitude2 = 7

    ; AUDIO
    aleft1, aright1 fluidOut   gienginenum1
    aleft2, aright2 fluidOut   gienginenum2
                    outs       (aleft1 * iamplitude1) + (aleft2 * iamplitude2),  \
                               (aright1 * iamplitude1) + (aright2 * iamplitude2)
    endin
    </CsInstruments>
    <CsScore>

    i 1 0 3  60  100
    i 2 1 3  60  100
    i 3 3 3  63  100
    i 100 0 10		;run for 10 seconds
    e
    </CsScore>
    </CsoundSynthesizer>

## See Also

fluidNote, fluidLoad

More information on soundfonts in the Floss Manuals: http://en.flossmanuals.net/csound/ch048_d-reading-midi-files

Other information on soundfonts on Wikipedia: http://en.wikipedia.org/wiki/Soundfont

## Credits

Michael Gogins (gogins at pipeline dot com), Steven Yi. Thanks to Peter Hanappe for Fluidsynth.

Optional iNumChannels and iPolyphony parameters added in 5.07

Prev | Up | Next
fluidControl | Home | fluidLoad