QMedia Movie audio metering

QM_GetFrequencyLevels

QM_GetFrequencyLevels(sessionRef; averageLevels):error
sessionRef Longint Frequency metering session reference
averageLevels Array 2D Average levels
error Longint Error result

Retrieves the current frequency levels.

Parameter sessionRef specifies the frequency metering session. It must be a valid frequency metering session reference number, otherwise error qm_ParamErr is returned.

Parameter averageLevels is a 2-dimensional real array that receives the current frequency levels. The array is resized to hold the frequency levels of all channels in the audio mix. Each row of the array (the first dimension) will contain the frequency levels of the corresponging audio channel, and each column (the second dimension) will contain the frequency levels of the corresponding band.

For example, when doing frequency metering on the stereo mix (qm_AudioStereoMix) with 8 bands, averageLevels will contain 2 rows and each row will contain 8 columns. averageLevels{1}{1} will contain the level of the first band of the left channel, averageLevels{1}{2} will contain the level of the second band of the left channel, and so on.

Related commands

QM_StartFreqMeteringSession Starts a frequency metering session for a movie.
QM_EndFreqMeteringSession Ends a frequency metering session.

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