QMedia Movie audio metering

QM_StartFreqMeteringSession

QM_StartFreqMeteringSession(sessionRef; movieRef; whatMix; numBands):error
sessionRef Longint Frequency metering session reference
movieRef Longint Movie reference
whatMix String4 Audio mix identifier
numBands Longint Numder of bands
error Longint Error result

Starts a frequency metering session for a movie.

Parameter sessionRef receives a reference number that identifies the frequency metering session. Use this reference number to retrieve band frequencies with QM_GetFreqMeteringBands, frequency levels with QM_GetFrequencyLevels, and to end the frequency metering session with QM_EndFreqMeteringSession when you are done.

Parameter movieRef specifies the movie from which you want to receive volume levels.

Parameter whatMix specifies the audio 'mix' to be used in the volume metering session. Use one of the following constants:

qm_AudioStereoMix stmx Stereo mix
qm_AudioMonoMix momx Mono mix
qm_AudioDeviceMix dcly Current audio device mix

Parameter numBands specifies the number of bands to be metered. QuickTime may adjust this number if it is higher than what is possible.

Related commands

QM_GetFreqMeteringBands Returns the band frequences of the frequency metering session.
QM_GetFrequencyLevels Retrieves the current frequency levels.
QM_EndFreqMeteringSession Ends a frequency metering session.

QMedia © Escape OE
Generated by QDoc 2.8 on Thu, Nov 24, 2011 18:42:03