cml/libcm
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

cmMidiFile.h/c Added cmMIdiFileTickToSamples()

Browse Source
This commit is contained in:
kevin 2012-11-17 17:32:21 -08:00
parent bf8fceead1
commit 37c2599982
2 changed files with 165 additions and 137 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
cmMidiFile.c
View File

@ -796,6 +796,30 @@ void cmMidiFileTickToMicros( cmMidiFileH_t h )
} }
void cmMidiFileTickToSamples( cmMidiFileH_t h, double srate, bool absFl )
{
_cmMidiFile_t* p;
unsigned mi;
//bool fl = true;
if((p = _cmMidiFileHandleToPtr(h)) == NULL )
return;
cmMidiFileTickToMicros(h);
unsigned absSmp = 0;
for(mi=0; mi<p->msgN; ++mi)
{
cmMidiTrackMsg_t* mp = p->msgV[mi];
unsigned delta = floor((mp->dtick*srate)/1000000.0);
mp->dtick = absFl ? absSmp : delta;
absSmp += delta;
}
}
typedef struct _cmMidiVoice_str typedef struct _cmMidiVoice_str
{ {
const cmMidiTrackMsg_t* mp; const cmMidiTrackMsg_t* mp;

278
cmMidiFile.h
View File

@ -5,168 +5,172 @@
extern "C" { extern "C" {
#endif #endif
// MIDI file timing: // MIDI file timing:
// Messages in the MIDI file are time tagged with a delta offset in 'ticks' // Messages in the MIDI file are time tagged with a delta offset in 'ticks'
// from the previous message in the same track. // from the previous message in the same track.
// //
// A 'tick' can be converted to microsends as follows: // A 'tick' can be converted to microsends as follows:
// //
// microsecond per tick = micros per quarter note / ticks per quarter note // microsecond per tick = micros per quarter note / ticks per quarter note
// //
// MpT = MpQN / TpQN // MpT = MpQN / TpQN
// //
// TpQN is given as a constant in the MIDI file header. // TpQN is given as a constant in the MIDI file header.
// MpQN is given as the value of the MIDI file tempo message. // MpQN is given as the value of the MIDI file tempo message.
// //
// See cmMidiFileSeekUSecs() for an example of converting ticks to milliseconds. // See cmMidiFileSeekUSecs() for an example of converting ticks to milliseconds.
// //
// As part of the file reading process, the status byte of note-on messages // As part of the file reading process, the status byte of note-on messages
// with velocity=0 are is changed to a note-off message. See _cmMidiFileReadChannelMsg(). // with velocity=0 are is changed to a note-off message. See _cmMidiFileReadChannelMsg().
typedef cmHandle_t cmMidiFileH_t; typedef cmHandle_t cmMidiFileH_t;
typedef unsigned cmMfRC_t; typedef unsigned cmMfRC_t;
typedef struct typedef struct
{
cmMidiByte_t hr;
cmMidiByte_t min;
cmMidiByte_t sec;
cmMidiByte_t frm;
cmMidiByte_t sfr;
} cmMidiSmpte_t;
typedef struct
{
cmMidiByte_t num;
cmMidiByte_t den;
cmMidiByte_t metro;
cmMidiByte_t th2s;
} cmMidiTimeSig_t;
typedef struct
{
cmMidiByte_t key;
cmMidiByte_t scale;
} cmMidiKeySig_t;
typedef struct
{
cmMidiByte_t ch;
cmMidiByte_t d0;
cmMidiByte_t d1;
unsigned durTicks; // note duration calc'd by
} cmMidiChMsg_t;
typedef struct cmMidiTrackMsg_str
{
unsigned dtick; // delta ticks
cmMidiByte_t status; // ch msg's have the channel value removed (it is stored in u.chMsgPtr->ch)
cmMidiByte_t metaId; //
unsigned short trkIdx; //
unsigned byteCnt; // length of data pointed to by u.voidPtr (or any other pointer in the union)
struct cmMidiTrackMsg_str* link; // link to next record in this track
union
{ {
cmMidiByte_t bVal; cmMidiByte_t hr;
unsigned iVal; cmMidiByte_t min;
unsigned short sVal; cmMidiByte_t sec;
const char* text; cmMidiByte_t frm;
const void* voidPtr; cmMidiByte_t sfr;
const cmMidiSmpte_t* smptePtr; } cmMidiSmpte_t;
const cmMidiTimeSig_t* timeSigPtr;
const cmMidiKeySig_t* keySigPtr;
const cmMidiChMsg_t* chMsgPtr;
const cmMidiByte_t* sysExPtr;
} u;
} cmMidiTrackMsg_t;
enum typedef struct
{ {
kOkMfRC = cmOkRC, // 0 cmMidiByte_t num;
kSysFopenFailMfRC, // 1 cmMidiByte_t den;
kSysFreadFailMfRC, // 2 cmMidiByte_t metro;
kSysFseekFailMfRC, // 3 cmMidiByte_t th2s;
kSysFtellFailMfRC, // 4 } cmMidiTimeSig_t;
kSysFcloseFailMfRC, // 5
kNotAMidiFileMfRC, // 6
kMemAllocFailMfRC, // 7
kFileCorruptMfRC, // 8
kMissingEoxMfRC, // 9
kUnknownMetaIdMfRC, // 10
kInvalidHandleMfRC, // 11
kMissingNoteOffMfRC, // 12
kInvalidStatusMfRC // 13
};
extern cmMidiFileH_t cmMidiFileNullHandle; typedef struct
{
cmMidiByte_t key;
cmMidiByte_t scale;
} cmMidiKeySig_t;
cmMfRC_t cmMidiFileOpen( const char* fn, cmMidiFileH_t* hPtr, cmCtx_t* ctx ); typedef struct
cmMfRC_t cmMidiFileClose( cmMidiFileH_t* hp ); {
cmMidiByte_t ch;
cmMidiByte_t d0;
cmMidiByte_t d1;
unsigned durTicks; // note duration calc'd by
} cmMidiChMsg_t;
// Returns track count or kInvalidCnt if 'h' is invalid.
unsigned cmMidiFileTrackCount( cmMidiFileH_t h );
// Return midi file format id (0,1,2) or kInvalidId if 'h' is invalid. typedef struct cmMidiTrackMsg_str
unsigned cmMidiFileType( cmMidiFileH_t h ); {
unsigned dtick; // delta ticks
cmMidiByte_t status; // ch msg's have the channel value removed (it is stored in u.chMsgPtr->ch)
cmMidiByte_t metaId; //
unsigned short trkIdx; //
unsigned byteCnt; // length of data pointed to by u.voidPtr (or any other pointer in the union)
struct cmMidiTrackMsg_str* link; // link to next record in this track
// Returns ticks per quarter note or kInvalidMidiByte if 'h' is invalid or 0 if file uses SMPTE ticks per frame time base. union
unsigned cmMidiFileTicksPerQN( cmMidiFileH_t h ); {
cmMidiByte_t bVal;
unsigned iVal;
unsigned short sVal;
const char* text;
const void* voidPtr;
const cmMidiSmpte_t* smptePtr;
const cmMidiTimeSig_t* timeSigPtr;
const cmMidiKeySig_t* keySigPtr;
const cmMidiChMsg_t* chMsgPtr;
const cmMidiByte_t* sysExPtr;
} u;
} cmMidiTrackMsg_t;
// The file name used in an earlier call to midiFileOpen() or NULL if this enum
// midi file did not originate from an actual file. {
const char* cmMidiFileName( cmMidiFileH_t h ); kOkMfRC = cmOkRC, // 0
kSysFopenFailMfRC, // 1
kSysFreadFailMfRC, // 2
kSysFseekFailMfRC, // 3
kSysFtellFailMfRC, // 4
kSysFcloseFailMfRC, // 5
kNotAMidiFileMfRC, // 6
kMemAllocFailMfRC, // 7
kFileCorruptMfRC, // 8
kMissingEoxMfRC, // 9
kUnknownMetaIdMfRC, // 10
kInvalidHandleMfRC, // 11
kMissingNoteOffMfRC, // 12
kInvalidStatusMfRC // 13
};
// Returns SMPTE ticks per frame or kInvalidMidiByte if 'h' is invalid or 0 if file uses ticks per quarter note time base. extern cmMidiFileH_t cmMidiFileNullHandle;
cmMidiByte_t cmMidiFileTicksPerSmpteFrame( cmMidiFileH_t h );
// Returns SMPTE format or kInvalidMidiByte if 'h' is invalid or 0 if file uses ticks per quarter note time base. cmMfRC_t cmMidiFileOpen( const char* fn, cmMidiFileH_t* hPtr, cmCtx_t* ctx );
cmMidiByte_t cmMidiFileSmpteFormatId( cmMidiFileH_t h ); cmMfRC_t cmMidiFileClose( cmMidiFileH_t* hp );
// Returns count of records in track 'trackIdx' or kInvalidCnt if 'h' is invalid. // Returns track count or kInvalidCnt if 'h' is invalid.
unsigned cmMidiFileTrackMsgCount( cmMidiFileH_t h, unsigned trackIdx ); unsigned cmMidiFileTrackCount( cmMidiFileH_t h );
// Returns base of record chain from track 'trackIdx' or NULL if 'h' is invalid. // Return midi file format id (0,1,2) or kInvalidId if 'h' is invalid.
const cmMidiTrackMsg_t* cmMidiFileTrackMsg( cmMidiFileH_t h, unsigned trackIdx ); unsigned cmMidiFileType( cmMidiFileH_t h );
// Returns the total count of records in the midi file and the number in the array returned by cmMidiFileMsgArray(). // Returns ticks per quarter note or kInvalidMidiByte if 'h' is invalid or 0 if file uses SMPTE ticks per frame time base.
// Return kInvalidCnt if 'h' is invalid. unsigned cmMidiFileTicksPerQN( cmMidiFileH_t h );
unsigned cmMidiFileMsgCount( cmMidiFileH_t h );
// Returns a pointer to the base of an array of pointers to each record in the file sorted in ascending time order. // The file name used in an earlier call to midiFileOpen() or NULL if this
// Returns NULL if 'h' is invalid. // midi file did not originate from an actual file.
const cmMidiTrackMsg_t** cmMidiFileMsgArray( cmMidiFileH_t h ); const char* cmMidiFileName( cmMidiFileH_t h );
// Return a pointer to the first msg at or after 'usecsOffs' or kInvalidIdx if no // Returns SMPTE ticks per frame or kInvalidMidiByte if 'h' is invalid or 0 if file uses ticks per quarter note time base.
// msg exists after 'usecsOffs'. Note that 'usecOffs' is an offset from the beginning cmMidiByte_t cmMidiFileTicksPerSmpteFrame( cmMidiFileH_t h );
// of the file.
// On return *'msgUsecsPtr' is set to the actual time of the msg.
// (which will be equal to or greater than 'usecsOffs').
unsigned cmMidiFileSeekUsecs( cmMidiFileH_t h, unsigned usecsOffs, unsigned* msgUsecsPtr, unsigned* newMicrosPerTickPtr );
double cmMidiFileDurSecs( cmMidiFileH_t h ); // Returns SMPTE format or kInvalidMidiByte if 'h' is invalid or 0 if file uses ticks per quarter note time base.
cmMidiByte_t cmMidiFileSmpteFormatId( cmMidiFileH_t h );
// Convert the track message 'dtick' field to delta-microseconds. // Returns count of records in track 'trackIdx' or kInvalidCnt if 'h' is invalid.
void cmMidiFileTickToMicros( cmMidiFileH_t h ); unsigned cmMidiFileTrackMsgCount( cmMidiFileH_t h, unsigned trackIdx );
// Calculate Note Duration // Returns base of record chain from track 'trackIdx' or NULL if 'h' is invalid.
void cmMidiFileCalcNoteDurations( cmMidiFileH_t h ); const cmMidiTrackMsg_t* cmMidiFileTrackMsg( cmMidiFileH_t h, unsigned trackIdx );
// Set the delay prior to the first non-zero msg. // Returns the total count of records in the midi file and the number in the array returned by cmMidiFileMsgArray().
void cmMidiFileSetDelay( cmMidiFileH_t h, unsigned ticks ); // Return kInvalidCnt if 'h' is invalid.
unsigned cmMidiFileMsgCount( cmMidiFileH_t h );
// This function packs a track msg into a single consecutive // Returns a pointer to the base of an array of pointers to each record in the file sorted in ascending time order.
// block of memory buf[ bufByteCnt ]. Call cmMidiFilePackTracMsgBufByteCount() // Returns NULL if 'h' is invalid.
// to get the required buffer length for any given cmMidiTrackMsg_t instance. const cmMidiTrackMsg_t** cmMidiFileMsgArray( cmMidiFileH_t h );
cmMidiTrackMsg_t* cmMidiFilePackTrackMsg( const cmMidiTrackMsg_t* m, void* buf, unsigned bufByteCnt );
unsigned cmMidiFilePackTrackMsgBufByteCount( const cmMidiTrackMsg_t* m );
void cmMidiFilePrint( cmMidiFileH_t h, unsigned trkIdx, cmRpt_t* rpt ); // Return a pointer to the first msg at or after 'usecsOffs' or kInvalidIdx if no
bool cmMidiFileIsNull( cmMidiFileH_t h ); // msg exists after 'usecsOffs'. Note that 'usecOffs' is an offset from the beginning
void cmMidiFileTest( const char* fn, cmCtx_t* ctx ); // of the file.
// On return *'msgUsecsPtr' is set to the actual time of the msg.
// (which will be equal to or greater than 'usecsOffs').
unsigned cmMidiFileSeekUsecs( cmMidiFileH_t h, unsigned usecsOffs, unsigned* msgUsecsPtr, unsigned* newMicrosPerTickPtr );
double cmMidiFileDurSecs( cmMidiFileH_t h );
// Convert the track message 'dtick' field to delta-microseconds.
void cmMidiFileTickToMicros( cmMidiFileH_t h );
// Convert the track message 'dtick' field to samples.
// If the absFl is set then the delta times are converted to absolute time.
void cmMidiFileTickToSamples( cmMidiFileH_t h, double srate, bool absFl );
// Calculate Note Duration
void cmMidiFileCalcNoteDurations( cmMidiFileH_t h );
// Set the delay prior to the first non-zero msg.
void cmMidiFileSetDelay( cmMidiFileH_t h, unsigned ticks );
// This function packs a track msg into a single consecutive
// block of memory buf[ bufByteCnt ]. Call cmMidiFilePackTracMsgBufByteCount()
// to get the required buffer length for any given cmMidiTrackMsg_t instance.
cmMidiTrackMsg_t* cmMidiFilePackTrackMsg( const cmMidiTrackMsg_t* m, void* buf, unsigned bufByteCnt );
unsigned cmMidiFilePackTrackMsgBufByteCount( const cmMidiTrackMsg_t* m );
void cmMidiFilePrint( cmMidiFileH_t h, unsigned trkIdx, cmRpt_t* rpt );
bool cmMidiFileIsNull( cmMidiFileH_t h );
void cmMidiFileTest( const char* fn, cmCtx_t* ctx );
#ifdef __cplusplus #ifdef __cplusplus
} }