GUSOut Class Reference

#include <gusout.h>

Inheritance diagram for GUSOut:

Public Member Functions
	GUSOut (int d=0, int total=12)
	~GUSOut ()
virtual void	openDev (int sqfd)
virtual void	closeDev (void)
virtual void	initDev (void)
virtual void	noteOn (uchar chn, uchar note, uchar vel)
virtual void	noteOff (uchar chn, uchar note, uchar vel)
virtual void	keyPressure (uchar chn, uchar note, uchar vel)
virtual void	chnPatchChange (uchar chn, uchar patch)
virtual void	chnPressure (uchar chn, uchar vel)
virtual void	chnPitchBender (uchar chn, uchar lsb, uchar msb)
virtual void	chnController (uchar chn, uchar ctl, uchar v)
virtual void	sysex (uchar *data, ulong size)
void	setPatchesToUse (int *patchesused)
int	loadPatch (int pgm)
int	patch (int p)
Public Member Functions inherited from MidiOut
	MidiOut (int d=0)
virtual	~MidiOut ()
virtual void	openDev (int sqfd)
virtual void	closeDev ()
virtual void	initDev ()
int	deviceType () const
const char *	deviceName (void) const
void	setMidiMapper (MidiMapper *map)
virtual void	noteOn (uchar chn, uchar note, uchar vel)
virtual void	noteOff (uchar chn, uchar note, uchar vel)
virtual void	keyPressure (uchar chn, uchar note, uchar vel)
virtual void	chnPatchChange (uchar chn, uchar patch)
virtual void	chnPressure (uchar chn, uchar vel)
virtual void	chnPitchBender (uchar chn, uchar lsb, uchar msb)
virtual void	chnController (uchar chn, uchar ctl, uchar v)
virtual void	sysex (uchar *data, ulong size)
void	allNotesOff (void)
virtual void	channelSilence (uchar chn)
virtual void	channelMute (uchar chn, int b)
virtual void	setVolumePercentage (int volper)
int	ok (void)
const char *	midiMapFilename ()
void	sync (int i=0)

Static Public Member Functions
static void	setGUSPatchesDirectory (const char *dir)

Additional Inherited Members
Protected Member Functions inherited from MidiOut
void	seqbuf_dump (void)
void	seqbuf_clean (void)
Protected Attributes inherited from MidiOut
int	seqfd
int	device
int	devicetype
int	volumepercentage
MidiMapper *	map
uchar	chnpatch [16]
int	chnbender [16]
uchar	chnpressure [16]
uchar	chncontroller [16][256]
int	chnmute [16]
int	_ok

Detailed Description

Gravis Ultrasound synthesizer output class .

This class is used to send midi events to synthesizers on GUS cards.

GUSOut inherits MidiOut and supports the same simple API.

The recommended way to use this class is by using a DeviceManager object, and use the DeviceManager::setPatchesToUse() member which will call the setPatchesToUse() member in this class.

Sends MIDI events to GUS synths

Version

0.9.5 17/01/2000

Author

Antonio Larrosa Jimenez larro.nosp@m.sa@k.nosp@m.de.or.nosp@m.g

Definition at line 45 of file gusout.h.

Constructor & Destructor Documentation

GUSOut()

GUSOut::GUSOut	(	int	d = 0,
		int	total = 12
	)

Constructor.

See MidiOut::MidiOut() for more information.

Definition at line 112 of file gusout.cpp.

~GUSOut()

GUSOut::~GUSOut

(

)

Destructor.

Definition at line 124 of file gusout.cpp.

Member Function Documentation

chnController()

void GUSOut::chnController ( uchar  chn, uchar  ctl, uchar  v  )

virtual

See MidiOut::chnController()

Reimplemented from MidiOut.

Definition at line 301 of file gusout.cpp.

chnPatchChange()

void GUSOut::chnPatchChange ( uchar  chn, uchar  patch  )

virtual

See MidiOut::chnPatchChange()

Reimplemented from MidiOut.

Definition at line 270 of file gusout.cpp.

chnPitchBender()

void GUSOut::chnPitchBender ( uchar  chn, uchar  lsb, uchar  msb  )

virtual

See MidiOut::chnPitchBender()

Reimplemented from MidiOut.

Definition at line 291 of file gusout.cpp.

chnPressure()

void GUSOut::chnPressure ( uchar  chn, uchar  vel  )

virtual

See MidiOut::chnPressure()

Reimplemented from MidiOut.

Definition at line 281 of file gusout.cpp.

closeDev()

void GUSOut::closeDev ( void  )

virtual

See MidiOut::closeDev()

Reimplemented from MidiOut.

Definition at line 169 of file gusout.cpp.

initDev()

void GUSOut::initDev ( void  )

virtual

See MidiOut::initDev()

Reimplemented from MidiOut.

Definition at line 178 of file gusout.cpp.

keyPressure()

void GUSOut::keyPressure ( uchar  chn, uchar  note, uchar  vel  )

virtual

See MidiOut::keyPressure()

Reimplemented from MidiOut.

Definition at line 262 of file gusout.cpp.

loadPatch()

int GUSOut::loadPatch

(

int

pgm

)

Loads a single patch on the synthesizer memory.

Parameters

pgm	is the number of the GM patch when pgm is between 0 and 127. Values from 128 to 255 are used to represent the percussion instruments.

Returns

0 if OK and -1 if there was an error (patch not found, not enough memory, etc.)

See also

patch()

setPatchesToUse()

Definition at line 338 of file gusout.cpp.

noteOff()

void GUSOut::noteOff ( uchar  chn, uchar  note, uchar  vel  )

virtual

See MidiOut::noteOff()

Reimplemented from MidiOut.

Definition at line 247 of file gusout.cpp.

noteOn()

void GUSOut::noteOn ( uchar  chn, uchar  note, uchar  vel  )

virtual

See MidiOut::noteOn()

Reimplemented from MidiOut.

Definition at line 217 of file gusout.cpp.

openDev()

void GUSOut::openDev ( int  sqfd )

virtual

See MidiOut::openDev()

Reimplemented from MidiOut.

Definition at line 137 of file gusout.cpp.

patch()

int GUSOut::patch

(

int

p

)

Returns p if the patch with number p has been correctly loaded.

In the case it hasn't been loaded, it returns the number of another patch that is loaded and that should be used instead.

See also

loadPatch()

setPatchesToUse()

Definition at line 208 of file gusout.cpp.

setGUSPatchesDirectory()

void GUSOut::setGUSPatchesDirectory ( const char *  dir )

static

Sets the directory where the GUS patches are stored, that is, where the acpiano.pat, ... files can be found.

It will store a copy of the parameter, so you should delete the memory used by the parameter you passed.

Definition at line 322 of file gusout.cpp.

setPatchesToUse()

void GUSOut::setPatchesToUse

(

int *

patchesused

)

See DeviceManager::setPatchesToUse() .

All the information about this member is explained there because it's (for now) just a simple call to this function when the device used is a GUS device, and you're supposed to use a DeviceManager object instead of a GUSOut object except in rare ocassions.

See also

patch()

loadPatch()

Definition at line 525 of file gusout.cpp.

sysex()

void GUSOut::sysex ( uchar *  data, ulong  size  )

virtual

It's an empty function, as GUS synths don't support System Exclusive messages.

Reimplemented from MidiOut.

Definition at line 317 of file gusout.cpp.

---

The documentation for this class was generated from the following files:

• gusout.h
• gusout.cpp