libcm is a C development framework with an emphasis on audio signal processing applications.
Du kan inte välja fler än 25 ämnen Ämnen måste starta med en bokstav eller siffra, kan innehålla bindestreck ('-') och vara max 35 tecken långa.

cmScore.h 8.3KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235
  1. #ifndef cmScore_h
  2. #define cmScore_h
  3. #ifdef __cplusplus
  4. extern "C" {
  5. #endif
  6. enum
  7. {
  8. kOkScRC = cmOkRC,
  9. kCsvFailScRC,
  10. kSyntaxErrScRC,
  11. kInvalidIdxScRC,
  12. kTimeLineFailScRC,
  13. kInvalidDynRefCntScRC
  14. };
  15. enum
  16. {
  17. kInvalidEvtScId = 0,
  18. kTimeSigEvtScId,
  19. kKeySigEvtScId,
  20. kTempoEvtScId,
  21. kTrackEvtScId,
  22. kTextEvtScId,
  23. kEOTrackEvtScId,
  24. kCopyEvtScId,
  25. kBlankEvtScId,
  26. kBarEvtScId,
  27. kPgmEvtScId,
  28. kCtlEvtScId,
  29. kNonEvtScId
  30. };
  31. // Flags used by cmScoreEvt_t.flags
  32. enum
  33. {
  34. kEvenScFl = 0x01, // This note is marked for evenness measurement
  35. kDynScFl = 0x02, // This note is marked for dynamics measurement
  36. kTempoScFl = 0x04, // This note is marked for tempo measurement
  37. kSkipScFl = 0x08, // This isn't a real event (e.g. tied note) skip over it
  38. kGraceScFl = 0x10, // This is a grace note
  39. kInvalidScFl = 0x20 // This note has a calculated time
  40. };
  41. // Id's used by cmScoreSet_t.varId and as indexes into
  42. // cmScoreSection_t.vars[].
  43. enum
  44. {
  45. kEvenVarScId,
  46. kDynVarScId,
  47. kTempoVarScId,
  48. kScVarCnt
  49. };
  50. struct cmScoreLoc_str;
  51. struct cmScoreSet_str;
  52. // The score can be divided into arbitrary non-overlapping sections.
  53. typedef struct
  54. {
  55. const cmChar_t* label; // section label
  56. unsigned index; // index of this record in the internal section array
  57. struct cmScoreLoc_str* locPtr; // location where this section starts
  58. unsigned begEvtIndex; // score element index where this section starts
  59. unsigned setCnt; // Count of elements in setArray[]
  60. struct cmScoreSet_str** setArray; // Ptrs to sets which are applied to this section.
  61. double vars[ kScVarCnt ]; // Set to DBL_MAX by default.
  62. } cmScoreSection_t;
  63. typedef struct
  64. {
  65. unsigned type; // Event type
  66. double secs; // Time location in seconds
  67. double durSecs; // Duration in seconds
  68. unsigned index; // Index of this event in the event array.
  69. unsigned locIdx; // Index of the location containing this event
  70. cmMidiByte_t pitch; // MIDI pitch of this note
  71. unsigned flags; // Attribute flags for this event
  72. unsigned dynVal; // Dynamcis value pppp to ffff (1 to 11) for this note.
  73. double frac; // Note's time value for tempo and non-grace evenness notes.
  74. unsigned barNumb; // Bar id of the measure containing this event.
  75. unsigned barNoteIdx; // Index of this note in this bar
  76. unsigned csvRowNumb; // File row number (not index) from which this record originated
  77. unsigned perfSmpIdx; // Time this event was performed or cmInvalidIdx if the event was not performed.
  78. unsigned perfVel; // Velocity of the performed note or 0 if the note was not performed.
  79. unsigned perfDynLvl; // Index into dynamic level ref. array assoc'd with perfVel
  80. } cmScoreEvt_t;
  81. typedef struct cmScoreSet_str
  82. {
  83. unsigned varId; // See kXXXVarScId flags above
  84. cmScoreEvt_t** eleArray; // Events that make up this set in time order
  85. unsigned eleCnt; //
  86. bool doneFl;
  87. double value;
  88. struct cmScoreSet_str* llink; // cmScoreLoc_t setList link
  89. } cmScoreSet_t;
  90. // All events which are simultaneous are collected into a single
  91. // cmScoreLoc_t record.
  92. typedef struct cmScoreLoc_str
  93. {
  94. unsigned index; // index of this location record
  95. double secs; // Time of this location
  96. unsigned evtCnt; // Count of events in evtArray[].
  97. cmScoreEvt_t** evtArray; // Events which occur at this time.
  98. unsigned barNumb; // Bar number this event is contained by.
  99. cmScoreSet_t* setList; // Set's which end on this time location (linked through cmScoreSet_t.llink)
  100. cmScoreSection_t* begSectPtr; // NULL if this location does not start a section
  101. } cmScoreLoc_t;
  102. typedef void (*cmScCb_t)( void* arg, const void* data, unsigned byteCnt );
  103. typedef cmRC_t cmScRC_t;
  104. typedef cmHandle_t cmScH_t;
  105. typedef void (*cmScCb_t)( void* arg, const void* data, unsigned byteCnt );
  106. extern cmScH_t cmScNullHandle;
  107. const cmChar_t* cmScEvtTypeIdToLabel( unsigned id );
  108. const cmChar_t* cmScDynIdToLabel( unsigned id );
  109. // Initialize a score object from a CSV File generated from a score spreadsheet.
  110. // The dynRefArray[dynRefCnt] and cbFunc(cbArg) are optional if these
  111. // features are not used.
  112. // If provided the dynRefArray[] is copied into an internal array.
  113. // The physical array passed here therefore does not need to remain valid.
  114. // Set 'srate' to zero if the score will not be used to perform measurement calculations.
  115. cmScRC_t cmScoreInitialize( cmCtx_t* ctx, cmScH_t* hp, const cmChar_t* fn, double srate, const unsigned* dynRefArray, unsigned dynRefCnt, cmScCb_t cbFunc, void* cbArg );
  116. cmScRC_t cmScoreFinalize( cmScH_t* hp );
  117. // Filename of last successfuly loaded score file.
  118. const cmChar_t* cmScoreFileName( cmScH_t h );
  119. // Sample rate as set in cmScoreInitialize()
  120. double cmScoreSampleRate( cmScH_t h );
  121. // Validate the score handle
  122. bool cmScoreIsValid( cmScH_t h );
  123. // Access the score data.
  124. unsigned cmScoreEvtCount( cmScH_t h );
  125. cmScoreEvt_t* cmScoreEvt( cmScH_t h, unsigned idx );
  126. // Access section records
  127. unsigned cmScoreSectionCount( cmScH_t h );
  128. cmScoreSection_t* cmScoreSection( cmScH_t h, unsigned idx );
  129. // Access the score location data
  130. unsigned cmScoreLocCount( cmScH_t h );
  131. cmScoreLoc_t* cmScoreLoc( cmScH_t h, unsigned idx );
  132. void cmScorePrintLoc( cmScH_t h );
  133. // Return the count of sets.
  134. unsigned cmScoreSetCount( cmScH_t h );
  135. // Make callbacks for all events in the score. The callbacks
  136. // contain cmScMsg_t records serialized as a byte stream.
  137. // Use cmScoreDecode() to convert the byte string to a
  138. // cmScMsg_t record.
  139. cmScRC_t cmScoreSeqNotify( cmScH_t h );
  140. void cmScoreClearPerfInfo( cmScH_t h );
  141. // Assign 'smpIdx' and 'vel' to the event matching 'pitch' at 'locIdx'
  142. // but do not trigger any variable calculations. Return true if as a
  143. // result of this call all events assigned to 'locIdx' have been received
  144. // otherwise return false.
  145. bool cmScoreSetPerfEvent( cmScH_t h, unsigned locIdx, unsigned smpIdx, unsigned pitch, unsigned vel );
  146. // Assign 'smpIdx' and 'vel' to the event matching 'pitch' at 'locIdx'
  147. // but and trigger any variable calculations which may happen on, or before, 'locIdx'.
  148. void cmScoreExecPerfEvent( cmScH_t h, unsigned locIdx, unsigned smpIdx, unsigned pitch, unsigned vel );
  149. // Assign 'value' to the section at, or before, 'locIdx'.
  150. void cmScoreSetPerfValue( cmScH_t h, unsigned locIdx, unsigned varId, double value );
  151. // Set the performed dynamic level of a score event.
  152. void cmScoreSetPerfDynLevel( cmScH_t h, unsigned evtIdx, unsigned dynLvl );
  153. typedef enum
  154. {
  155. kInvalidMsgScId,
  156. kBeginMsgScId,
  157. kEventMsgScId,
  158. kSectionMsgScId,
  159. kEndMsgScId,
  160. kVarMsgScId,
  161. kDynMsgScId
  162. } cmScMsgTypeId_t;
  163. typedef struct
  164. {
  165. unsigned varId; // see kXXXVarScId from cmScoreSet_t.varId
  166. double value; // value of a variable
  167. } cmScMeas_t;
  168. typedef struct
  169. {
  170. unsigned evtIdx;
  171. unsigned dynLvl;
  172. } cmScDyn_t;
  173. typedef struct
  174. {
  175. cmScMsgTypeId_t typeId;
  176. union
  177. {
  178. cmScoreEvt_t evt; // only used when typeId == kEventMsgScId
  179. cmScMeas_t meas; // only used when typeId == kVarMsgScId
  180. cmScoreSection_t sect; // only used when typeId == kSectionMsgScId
  181. cmScDyn_t dyn; // only used when typeId == kDynLvlMsgScId
  182. } u;
  183. } cmScMsg_t;
  184. // Decode a serialized cmScMsg_t from a byte stream as passed to the
  185. // cmScCb_t function.
  186. cmScRC_t cmScoreDecode( const void* msg, unsigned msgByteCnt, cmScMsg_t* );
  187. void cmScorePrint( cmScH_t h, cmRpt_t* rpt );
  188. void cmScoreTest( cmCtx_t* ctx, const cmChar_t* fn );
  189. #ifdef __cplusplus
  190. }
  191. #endif
  192. #endif