Standard MIDI Files input/output. More...

#include <qsmf.h>

Inheritance diagram for QSmf:

Signals
void	signalSMFError (const QString &errorStr)
	Emitted for a SMF read or write error. More...

void	signalSMFHeader (int format, int ntrks, int division)
	Emitted after reading a SMF header. More...

void	signalSMFNoteOn (int chan, int pitch, int vol)
	Emitted after reading a Note On message. More...

void	signalSMFNoteOff (int chan, int pitch, int vol)
	Emitted after reading a Note Off message. More...

void	signalSMFKeyPress (int chan, int pitch, int press)
	Emitted after reading a Polyphonic Aftertouch message. More...

void	signalSMFCtlChange (int chan, int ctl, int value)
	Emitted after reading a Control Change message. More...

void	signalSMFPitchBend (int chan, int value)
	Emitted after reading a Bender message. More...

void	signalSMFProgram (int chan, int patch)
	Emitted after reading a Program change message. More...

void	signalSMFChanPress (int chan, int press)
	Emitted after reading a Channel Aftertouch message. More...

void	signalSMFSysex (const QByteArray &data)
	Emitted after reading a System Exclusive message. More...

void	signalSMFSeqSpecific (const QByteArray &data)
	Emitted after reading a Sequencer specific message. More...

void	signalSMFMetaUnregistered (int typ, const QByteArray &data)
	Emitted after reading an unregistered SMF Meta message. More...

void	signalSMFMetaMisc (int typ, const QByteArray &data)
	Emitted after reading any SMF Meta message. More...

void	signalSMFSequenceNum (int seq)
	Emitted after reading a Sequence number message. More...

void	signalSMFforcedChannel (int channel)
	Emitted after reading a Forced channel message. More...

void	signalSMFforcedPort (int port)
	Emitted after reading a Forced port message. More...

void	signalSMFText (int typ, const QString &data)
	Emitted after reading a SMF text message. More...

void	signalSMFSmpte (int b0, int b1, int b2, int b3, int b4)
	Emitted after reading a SMPT offset message. More...

void	signalSMFTimeSig (int b0, int b1, int b2, int b3)
	Emitted after reading a SMF Time signature message. More...

void	signalSMFKeySig (int b0, int b1)
	Emitted after reading a SMF Key Signature smessage. More...

void	signalSMFTempo (int tempo)
	Emitted after reading a Tempo Change message. More...

void	signalSMFendOfTrack ()
	Emitted after reading a End-Of-Track message.

void	signalSMFTrackStart ()
	Emitted after reading a track prefix.

void	signalSMFTrackEnd ()
	Emitted after a track has finished.

void	signalSMFWriteTempoTrack ()
	Emitted to request the user to write the tempo track. More...

void	signalSMFWriteTrack (int track)
	Emitted to request the user to write a track. More...

Public Member Functions
	QSmf (QObject *parent=0)
	Constructor. More...

virtual	~QSmf ()
	Destructor.

void	readFromStream (QDataStream *stream)
	Reads a SMF stream. More...

void	readFromFile (const QString &fileName)
	Reads a SMF stream from a disk file. More...

void	writeToStream (QDataStream *stream)
	Writes a SMF stream. More...

void	writeToFile (const QString &fileName)
	Writes a SMF stream to a disk file. More...

void	writeMetaEvent (long deltaTime, int type, const QByteArray &data)
	Writes a variable length Meta Event. More...

void	writeMetaEvent (long deltaTime, int type, const QString &data)
	Writes a Text Meta Event. More...

void	writeMetaEvent (long deltaTime, int type, int data)
	Writes a simple Meta event. More...

void	writeMetaEvent (long deltaTime, int type)
	Writes a simple Meta event. More...

void	writeMidiEvent (long deltaTime, int type, int chan, int b1)
	Writes a MIDI message with a single parameter. More...

void	writeMidiEvent (long deltaTime, int type, int chan, int b1, int b2)
	Writes a MIDI message with two parameters. More...

void	writeMidiEvent (long deltaTime, int type, int chan, const QByteArray &data)
	Writes a variable length MIDI message. More...

void	writeMidiEvent (long deltaTime, int type, long len, char *data)
	Writes a variable length MIDI message. More...

void	writeTempo (long deltaTime, long tempo)
	Writes a Tempo change message. More...

void	writeBpmTempo (long deltaTime, int tempo)
	Writes a Tempo change message. More...

void	writeTimeSignature (long deltaTime, int num, int den, int cc, int bb)
	Writes a Time Signature message. More...

void	writeKeySignature (long deltaTime, int tone, int mode)
	Writes a key Signature message. More...

void	writeSequenceNumber (long deltaTime, int seqnum)
	Writes a MIDI Sequence number. More...

long	getCurrentTime ()
	Gets the current time in ticks. More...

long	getCurrentTempo ()
	Gets the current tempo. More...

long	getRealTime ()
	Gets the real time in seconds. More...

long	getFilePos ()
	Gets the position in the SMF stream. More...

int	getDivision ()
	Gets the resolution. More...

void	setDivision (int division)
	Sets the resolution. More...

int	getTracks ()
	Gets the number of tracks. More...

void	setTracks (int tracks)
	Sets the number of tracks. More...

int	getFileFormat ()
	Gets the SMF file format. More...

void	setFileFormat (int fileFormat)
	Sets the SMF file format. More...

QTextCodec *	getTextCodec ()
	Gets the text codec used for text meta-events I/O. More...

void	setTextCodec (QTextCodec *codec)
	Sets the text codec for text meta-events. More...

Detailed Description

Standard MIDI Files input/output.

This class is used to parse and encode Standard MIDI Files (SMF)

Examples:: buildsmf.cpp, dumpsmf.cpp, guiplayer.cpp, and playsmf.cpp.

Definition at line 83 of file qsmf.h.

Constructor & Destructor Documentation

◆ QSmf()

QSmf ( QObject * parent = 0 )

Constructor.

Parameters

parent Optional parent object

Definition at line 99 of file qsmf.cpp.

Member Function Documentation

◆ getCurrentTempo()

long getCurrentTempo ( )

Gets the current tempo.

Returns: Tempo in us per quarter

Definition at line 1123 of file qsmf.cpp.

◆ getCurrentTime()

long getCurrentTime ( )

Gets the current time in ticks.

Returns: Time in ticks

Definition at line 1114 of file qsmf.cpp.

◆ getDivision()

int getDivision ( )

Gets the resolution.

Returns: Resolution in ticks per quarter note

Definition at line 1141 of file qsmf.cpp.

◆ getFileFormat()

int getFileFormat ( )

Gets the SMF file format.

Returns: File format (0, 1, or 2)

Definition at line 1177 of file qsmf.cpp.

◆ getFilePos()

long getFilePos ( )

Gets the position in the SMF stream.

Returns: Position offset in the stream

Definition at line 1195 of file qsmf.cpp.

◆ getRealTime()

long getRealTime ( )

Gets the real time in seconds.

Returns: Time in seconds

Definition at line 1132 of file qsmf.cpp.

◆ getTextCodec()

QTextCodec * getTextCodec ( )

Gets the text codec used for text meta-events I/O.

Returns: QTextCodec pointer

Since: 0.2.0

Definition at line 1205 of file qsmf.cpp.

◆ getTracks()

int getTracks ( )

Gets the number of tracks.

Returns: Number of tracks

Definition at line 1159 of file qsmf.cpp.

◆ readFromFile()

void readFromFile ( const QString & fileName )

Reads a SMF stream from a disk file.

Parameters

fileName Name of an existing file.

Definition at line 434 of file qsmf.cpp.

References QSmf::readFromStream().

◆ readFromStream()

void readFromStream ( QDataStream * stream )

Reads a SMF stream.

Parameters

stream Pointer to an existing and opened stream

Definition at line 424 of file qsmf.cpp.

Referenced by QSmf::readFromFile().

◆ setDivision()

void setDivision ( int division )

Sets the resolution.

Parameters

division Resolution in ticks per quarter note

Definition at line 1150 of file qsmf.cpp.

◆ setFileFormat()

void setFileFormat ( int fileFormat )

Sets the SMF file format.

Parameters

fileFormat File format (0, 1, or 2)

Definition at line 1186 of file qsmf.cpp.

◆ setTextCodec()

void setTextCodec ( QTextCodec * codec )

Sets the text codec for text meta-events.

The engine doesn't take ownership of the codec instance.

Parameters

codec QTextCodec pointer

Since: 0.2.0

Definition at line 1217 of file qsmf.cpp.

◆ setTracks()

void setTracks ( int tracks )

Sets the number of tracks.

Parameters

tracks Number of tracks

Definition at line 1168 of file qsmf.cpp.

◆ signalSMFChanPress

void signalSMFChanPress	(	int	chan,
		int	press
	)

signal

Emitted after reading a Channel Aftertouch message.

Parameters

chan	MIDI Channel
press	Pressure amount

Definition at line 495 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFCtlChange

void signalSMFCtlChange	(	int	chan,
		int	ctl,
		int	value
	)

signal

Emitted after reading a Control Change message.

Parameters

chan	MIDI Channel
ctl	MIDI Controller
value	Control value

Definition at line 474 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFError

void signalSMFError ( const QString & errorStr )

signal

Emitted for a SMF read or write error.

Parameters

errorStr Error string

Definition at line 439 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFforcedChannel

void signalSMFforcedChannel ( int channel )

signal

Emitted after reading a Forced channel message.

Parameters

channel MIDI Channel

Definition at line 537 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFforcedPort

void signalSMFforcedPort ( int port )

signal

Emitted after reading a Forced port message.

Parameters

port	Port number

Definition at line 544 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFHeader

void signalSMFHeader	(	int	format,
		int	ntrks,
		int	division
	)

signal

Emitted after reading a SMF header.

Parameters

format	SMF format (0/1)
ntrks	Number pof tracks
division	Division (resolution in ticks per quarter note)

Definition at line 446 of file moc_qsmf.cpp.

Referenced by QSmf::~QSmf().

◆ signalSMFKeyPress

void signalSMFKeyPress	(	int	chan,
		int	pitch,
		int	press
	)

signal

Emitted after reading a Polyphonic Aftertouch message.

Parameters

chan	MIDI Channel
pitch	MIDI Note
press	Pressure amount

Definition at line 467 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFKeySig

void signalSMFKeySig	(	int	b0,
		int	b1
	)

signal

Emitted after reading a SMF Key Signature smessage.

Parameters

b0	Number of alterations (negative=flats, positive=sharps)
b1	Scale Mode (0=major, 1=minor)

Definition at line 572 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFMetaMisc

void signalSMFMetaMisc	(	int	typ,
		const QByteArray &	data
	)

signal

Emitted after reading any SMF Meta message.

Parameters

typ	Message type
data	Message data

Definition at line 523 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFMetaUnregistered

void signalSMFMetaUnregistered	(	int	typ,
		const QByteArray &	data
	)

signal

Emitted after reading an unregistered SMF Meta message.

Parameters

typ	Message type
data	Message data

Since: 0.2.0

Definition at line 516 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFNoteOff

void signalSMFNoteOff	(	int	chan,
		int	pitch,
		int	vol
	)

signal

Emitted after reading a Note Off message.

Parameters

chan	MIDI Channel
pitch	MIDI Note
vol	Velocity

Definition at line 460 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFNoteOn

void signalSMFNoteOn	(	int	chan,
		int	pitch,
		int	vol
	)

signal

Emitted after reading a Note On message.

Parameters

chan	MIDI Channel
pitch	MIDI Note
vol	Velocity

Definition at line 453 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFPitchBend

void signalSMFPitchBend	(	int	chan,
		int	value
	)

signal

Emitted after reading a Bender message.

Parameters

chan	MIDI Channel
value	Bender value

Definition at line 481 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFProgram

void signalSMFProgram	(	int	chan,
		int	patch
	)

signal

Emitted after reading a Program change message.

Parameters

chan	MIDI Channel
patch	Program number

Definition at line 488 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFSeqSpecific

void signalSMFSeqSpecific ( const QByteArray & data )

signal

Emitted after reading a Sequencer specific message.

Parameters

data	Message data

Definition at line 509 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFSequenceNum

void signalSMFSequenceNum ( int seq )

signal

Emitted after reading a Sequence number message.

Parameters

seq	Sequence number

Definition at line 530 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFSmpte

void signalSMFSmpte	(	int	b0,
		int	b1,
		int	b2,
		int	b3,
		int	b4
	)

signal

Emitted after reading a SMPT offset message.

Parameters

b0	Hours
b1	Minutes
b2	Seconds
b3	Frames
b4	Fractional frames

Definition at line 558 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFSysex

void signalSMFSysex ( const QByteArray & data )

signal

Emitted after reading a System Exclusive message.

Parameters

data	Sysex bytes

Definition at line 502 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFTempo

void signalSMFTempo ( int tempo )

signal

Emitted after reading a Tempo Change message.

Parameters

tempo Microseconds per quarter note

Definition at line 579 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFText

void signalSMFText	(	int	typ,
		const QString &	data
	)

signal

Emitted after reading a SMF text message.

Parameters

typ	Text type
data	Text data

Definition at line 551 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFTimeSig

void signalSMFTimeSig	(	int	b0,
		int	b1,
		int	b2,
		int	b3
	)

signal

Emitted after reading a SMF Time signature message.

Parameters

b0	Numerator
b1	Denominator (exponent in a power of two)
b2	Number of MIDI clocks per metronome click
b3	Number of notated 32nd notes per 24 MIDI clocks

Definition at line 565 of file moc_qsmf.cpp.

Referenced by QSmf::writeKeySignature().

◆ signalSMFWriteTempoTrack

void signalSMFWriteTempoTrack ( )

signal

Emitted to request the user to write the tempo track.

This is the first track in a format 1 SMF.

Definition at line 604 of file moc_qsmf.cpp.

Referenced by QSmf::~QSmf().

◆ signalSMFWriteTrack

void signalSMFWriteTrack ( int track )

signal

Emitted to request the user to write a track.

Parameters

track Track number

Definition at line 610 of file moc_qsmf.cpp.

Referenced by QSmf::writeToFile().

◆ writeBpmTempo()

void writeBpmTempo	(	long	deltaTime,
		int	tempo
	)

Writes a Tempo change message.

Parameters

deltaTime	Time offset in ticks
tempo	Tempo expressed in quarter notes per minute

Definition at line 748 of file qsmf.cpp.

References QSmf::writeTempo().

◆ writeKeySignature()

void writeKeySignature	(	long	deltaTime,
		int	tone,
		int	mode
	)

Writes a key Signature message.

Parameters

deltaTime	Time offset in ticks
tone	Number of alterations (positive=sharps, negative=flats)
mode	Scale mode (0=major, 1=minor)

Definition at line 780 of file qsmf.cpp.

References channel_aftertouch, control_change, copyright_notice, cue_point, end_of_track, forced_channel, forced_port, instrument_name, key_signature, lyric, marker, meta_event, midi_channel_mask, midi_command_mask, note_off, note_on, pitch_wheel, poly_aftertouch, program_chng, sequence_name, sequence_number, sequencer_specific, set_tempo, QSmf::signalSMFChanPress(), QSmf::signalSMFCtlChange(), QSmf::signalSMFendOfTrack(), QSmf::signalSMFError(), QSmf::signalSMFforcedChannel(), QSmf::signalSMFforcedPort(), QSmf::signalSMFKeyPress(), QSmf::signalSMFKeySig(), QSmf::signalSMFMetaMisc(), QSmf::signalSMFMetaUnregistered(), QSmf::signalSMFNoteOff(), QSmf::signalSMFNoteOn(), QSmf::signalSMFPitchBend(), QSmf::signalSMFProgram(), QSmf::signalSMFSeqSpecific(), QSmf::signalSMFSequenceNum(), QSmf::signalSMFSmpte(), QSmf::signalSMFSysex(), QSmf::signalSMFTempo(), QSmf::signalSMFText(), QSmf::signalSMFTimeSig(), smpte_offset, text_event, and time_signature.

◆ writeMetaEvent() [1/4]

void writeMetaEvent	(	long	deltaTime,
		int	type,
		const QByteArray &	data
	)

Writes a variable length Meta Event.

Parameters

deltaTime	Time offset in ticks
type	Meta event type
data	Message data

Definition at line 516 of file qsmf.cpp.

References meta_event.

◆ writeMetaEvent() [2/4]

void writeMetaEvent	(	long	deltaTime,
		int	type,
		const QString &	data
	)

Writes a Text Meta Event.

Parameters

deltaTime	Time offset in ticks
type	Meta event type
data	Message text

Definition at line 533 of file qsmf.cpp.

References meta_event.

◆ writeMetaEvent() [3/4]

void writeMetaEvent	(	long	deltaTime,
		int	type,
		int	data
	)

Writes a simple Meta event.

Parameters

deltaTime	Time offset in ticks
type	Meta event type
data	Meta event data

Since: 0.2.0

Definition at line 555 of file qsmf.cpp.

References meta_event.

◆ writeMetaEvent() [4/4]

void writeMetaEvent	(	long	deltaTime,
		int	type
	)

Writes a simple Meta event.

Parameters

deltaTime	Time offset in ticks
type	Meta event type

Definition at line 569 of file qsmf.cpp.

References meta_event.

◆ writeMidiEvent() [1/4]

void writeMidiEvent	(	long	deltaTime,
		int	type,
		int	chan,
		int	b1
	)

Writes a MIDI message with a single parameter.

Parameters

deltaTime	Time offset in ticks
type	MIDI event type
chan	MIDI Channel
b1	Message parameter

Definition at line 629 of file qsmf.cpp.

References end_of_sysex, and system_exclusive.

◆ writeMidiEvent() [2/4]

void writeMidiEvent	(	long	deltaTime,
		int	type,
		int	chan,
		int	b1,
		int	b2
	)

Writes a MIDI message with two parameters.

Parameters

deltaTime	Time offset in ticks
type	MIDI event type
chan	MIDI Channel
b1	Message parameter 1
b2	Message parameter 2

Definition at line 658 of file qsmf.cpp.

References end_of_sysex, and system_exclusive.

◆ writeMidiEvent() [3/4]

void writeMidiEvent	(	long	deltaTime,
		int	type,
		int	chan,
		const QByteArray &	data
	)

Writes a variable length MIDI message.

Parameters

deltaTime	Time offset in ticks
type	MIDI event type
chan	MIDI Channel
data	Message data

Definition at line 584 of file qsmf.cpp.

References end_of_sysex, and system_exclusive.

◆ writeMidiEvent() [4/4]

void writeMidiEvent	(	long	deltaTime,
		int	type,
		long	len,
		char *	data
	)

Writes a variable length MIDI message.

Parameters

deltaTime	Time offset in ticks
type	MIDI event type
len	Message length
data	Message data

Definition at line 687 of file qsmf.cpp.

References end_of_sysex, and system_exclusive.

◆ writeSequenceNumber()

void writeSequenceNumber	(	long	deltaTime,
		int	seqnum
	)

Writes a MIDI Sequence number.

Parameters

deltaTime	Time offset in ticks
seqnum	Sequence number

Definition at line 716 of file qsmf.cpp.

References meta_event, and sequence_number.

◆ writeTempo()

void writeTempo	(	long	deltaTime,
		long	tempo
	)

Writes a Tempo change message.

Parameters

deltaTime	Time offset in ticks
tempo	Tempo in microseconds per quarter note

Definition at line 732 of file qsmf.cpp.

References meta_event, and set_tempo.

Referenced by QSmf::writeBpmTempo().

◆ writeTimeSignature()

void writeTimeSignature	(	long	deltaTime,
		int	num,
		int	den,
		int	cc,
		int	bb
	)

Writes a Time Signature message.

Parameters

deltaTime	Time offset in ticks
num	Numerator
den	Denominator (exponent for a power of two)
cc	Number of MIDI clocks in a metronome click
bb	Number of notated 32nd notes in 24 MIDI clocks

Definition at line 762 of file qsmf.cpp.

References meta_event, and time_signature.

◆ writeToFile()

void writeToFile ( const QString & fileName )

Writes a SMF stream to a disk file.

Parameters

fileName File name

Definition at line 457 of file qsmf.cpp.

References MThd, MTrk, QSmf::signalSMFWriteTrack(), and QSmf::writeToStream().

◆ writeToStream()

void writeToStream ( QDataStream * stream )

Writes a SMF stream.

Parameters

stream Pointer to an existing and opened stream

Definition at line 447 of file qsmf.cpp.

Referenced by QSmf::writeToFile().

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

Signals

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ QSmf()

Member Function Documentation

◆ getCurrentTempo()

◆ getCurrentTime()

◆ getDivision()

◆ getFileFormat()

◆ getFilePos()

◆ getRealTime()

◆ getTextCodec()

◆ getTracks()

◆ readFromFile()

◆ readFromStream()

◆ setDivision()

◆ setFileFormat()

◆ setTextCodec()

◆ setTracks()

◆ signalSMFChanPress

◆ signalSMFCtlChange

◆ signalSMFError

◆ signalSMFforcedChannel

◆ signalSMFforcedPort

◆ signalSMFHeader

◆ signalSMFKeyPress

◆ signalSMFKeySig

◆ signalSMFMetaMisc

◆ signalSMFMetaUnregistered

◆ signalSMFNoteOff

◆ signalSMFNoteOn

◆ signalSMFPitchBend

◆ signalSMFProgram

◆ signalSMFSeqSpecific

◆ signalSMFSequenceNum

◆ signalSMFSmpte

◆ signalSMFSysex

◆ signalSMFTempo

◆ signalSMFText

◆ signalSMFTimeSig

◆ signalSMFWriteTempoTrack

◆ signalSMFWriteTrack

◆ writeBpmTempo()

◆ writeKeySignature()

◆ writeMetaEvent() [1/4]

◆ writeMetaEvent() [2/4]

◆ writeMetaEvent() [3/4]

◆ writeMetaEvent() [4/4]

◆ writeMidiEvent() [1/4]

◆ writeMidiEvent() [2/4]

◆ writeMidiEvent() [3/4]

◆ writeMidiEvent() [4/4]

◆ writeSequenceNumber()

◆ writeTempo()

◆ writeTimeSignature()

◆ writeToFile()

◆ writeToStream()