QMedia
![]() |
![]() |
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. |