MusicSequenceBeatsToBarBeatTime(_:_:_:_:)

Declaration

func MusicSequenceBeatsToBarBeatTime(_ inSequence: MusicSequence, _ inBeats: MusicTimeStamp, _ inSubbeatDivisor: UInt32, _ outBarBeatTime: UnsafeMutablePointer<CABarBeatTime>) -> OSStatus

Parameters

• inSequence:

  The music sequence that you want bar-beat time for.

• inBeats:

  The beats to be represented as bar-beats.

• inSubbeatDivisor:

  The denominator of the fractional number of beats.

• outBarBeatTime:

  On output, the music sequence’s bar-beat time.

Return Value

A result code.

Discussion

The sequence’s tempo track time signature events are used to calculate the bar-beat representation. If there are no Time Sig events added to the sequence 4/4 is assumed. A time signature event is a MIDI Meta Event as specified for MIDI files.

Refer to AudioToolbox/CAClock.h for more information.

See Also

Managing Music Sequences

• NewMusicSequence(_:)
• DisposeMusicSequence(_:)
• MusicSequenceBarBeatTimeToBeats(_:_:_:)
• MusicSequenceDisposeTrack(_:_:)
• MusicSequenceFileCreate(_:_:_:_:_:)
• MusicSequenceFileCreateData(_:_:_:_:_:)
• MusicSequenceFileLoad(_:_:_:_:)
• MusicSequenceFileLoadData(_:_:_:_:)
• MusicSequenceGetAUGraph(_:_:)
• MusicSequenceGetBeatsForSeconds(_:_:_:)
• MusicSequenceGetIndTrack(_:_:_:)
• MusicSequenceGetInfoDictionary(_:)
• MusicSequenceGetSMPTEResolution(_:_:_:)
• MusicSequenceGetSecondsForBeats(_:_:_:)
• MusicSequenceGetSequenceType(_:_:)