GPMID_GetTrackTuning function


Retrieves the tuning of a string used in a track embedded in the tablature which is currently loaded.



  1. GPMID_ENTRY unsigned int GPMID_GetTrackTuning(
  2. unsigned int aTrackIdx
  3. );


  1. aTrackIdx

    The zero-based index of the track for which to retrieve the tuning.

Return value

The tuning of the string used in the track embedded in the tablature.


Before using this function, GPMID must have been initialized with GPMID_Init and a tablature must have been successfully loaded with GPMID_Load.

This function can be called with an index ranging from 0 to the value returned by GPMID_GetTrackCount minus 1.

If the name of the corresponding track is not set, this function returns an empty string.

Up to 7 strings may be used in a track, so aStringIdx must range from 0 to 6. Use GPMID_GetTrackStringCount to retrieve how many strings are used in the track. The strings are stored from the highest to the lowest.