nickjillings@1386: /**
nickjillings@1386:  *  loundess.js
nickjillings@1386:  *  Loudness module for the Web Audio Evaluation Toolbox
nickjillings@1386:  *  Allows for automatic calculation of loudness of Web Audio API Buffer objects,
nickjillings@1386:  * 	return gain values to correct for a target loudness or match loudness between
nickjillings@1386:  *  multiple objects
nickjillings@1386:  */
nickjillings@1386: 
nickjillings@1386: var interval_cal_loudness_event = null;
nickjillings@1386: 
nickjillings@1386: function calculateLoudness(buffer, timescale, target, offlineContext)
nickjillings@1386: {
nickjillings@1386: 	// This function returns the EBU R 128 specification loudness model and sets the linear gain required to match -23 LUFS
nickjillings@1386: 	// buffer -> Web Audio API Buffer object
nickjillings@1386: 	// timescale -> M or Momentary (returns Array), S or Short (returns Array),
nickjillings@1386: 	//   I or Integrated (default, returns number)
nickjillings@1386: 	// target -> default is -23 LUFS but can be any LUFS measurement.
nickjillings@1386: 	
nickjillings@1386: 	if (buffer == undefined)
nickjillings@1386: 	{
nickjillings@1386: 		return 0;
nickjillings@1386: 	}
nickjillings@1386: 	if (timescale == undefined)
nickjillings@1386: 	{
nickjillings@1386: 		timescale = "I";
nickjillings@1386: 	}
nickjillings@1386: 	if (target == undefined)
nickjillings@1386: 	{
nickjillings@1386: 		target = -23;
nickjillings@1386: 	}
nickjillings@1386: 	if (offlineContext == undefined)
nickjillings@1386: 	{
nickjillings@1386: 		offlineContext = new OfflineAudioContext(buffer.numberOfChannels, buffer.length, buffer.sampleRate);
nickjillings@1386: 	}
nickjillings@1386: 	// Create the required filters
nickjillings@1386: 	var KFilter = offlineContext.createBiquadFilter();
nickjillings@1386: 	KFilter.type = "highshelf";
nickjillings@1386: 	KFilter.gain.value = 4;
nickjillings@1386: 	KFilter.frequency.value = 1480;
nickjillings@1386: 	
nickjillings@1386: 	var HPFilter = offlineContext.createBiquadFilter();
nickjillings@1386: 	HPFilter.type = "highpass";
nickjillings@1386: 	HPFilter.Q.value = 0.707;
nickjillings@1386: 	HPFilter.frequency.value = 60;
nickjillings@1386: 	// copy Data into the process buffer
nickjillings@1386: 	var processSource = offlineContext.createBufferSource();
nickjillings@1386: 	processSource.buffer = buffer;
nickjillings@1386: 	
nickjillings@1386: 	processSource.connect(KFilter);
nickjillings@1386: 	KFilter.connect(HPFilter);
nickjillings@1386: 	HPFilter.connect(offlineContext.destination);
nickjillings@1386: 	processSource.start();
nickjillings@1386: 	offlineContext.startRendering().then(function(renderedBuffer) {
nickjillings@1386: 		// Have the renderedBuffer information, now continue processing
nickjillings@1386: 		switch(timescale)
nickjillings@1386: 		{
nickjillings@1386: 		case "I":
nickjillings@1386: 			var blockEnergy = calculateProcessedLoudness(renderedBuffer, 400, 0.75);
nickjillings@1386: 			// Apply the absolute gate
nickjillings@1386: 			var loudness = calculateLoudnessFromChannelBlocks(blockEnergy);
nickjillings@1386: 			var absgatedEnergy = new Array(blockEnergy.length);
nickjillings@1386: 			for (var c=0; c<blockEnergy.length; c++)
nickjillings@1386: 			{
nickjillings@1386: 				absgatedEnergy[c] = [];
nickjillings@1386: 			}
nickjillings@1386: 			for (var i=0; i<loudness.length; i++)
nickjillings@1386: 			{
nickjillings@1386: 				if (loudness[i] >= -70)
nickjillings@1386: 				{
nickjillings@1386: 					for (var c=0; c<blockEnergy.length; c++)
nickjillings@1386: 					{
nickjillings@1386: 						absgatedEnergy[c].push(blockEnergy[c][i]);
nickjillings@1386: 					}
nickjillings@1386: 				}
nickjillings@1386: 			}
nickjillings@1386: 			var overallAbsLoudness = calculateOverallLoudnessFromChannelBlocks(absgatedEnergy);
nickjillings@1386: 			
nickjillings@1386: 			//applying the relative gate 8 dB down from overallAbsLoudness
nickjillings@1386: 			var relGateLevel = overallAbsLoudness - 8;
nickjillings@1386: 			var relgateEnergy = new Array(blockEnergy.length);
nickjillings@1386: 			for (var c=0; c<blockEnergy.length; c++)
nickjillings@1386: 			{
nickjillings@1386: 				relgateEnergy[c] = [];
nickjillings@1386: 			}
nickjillings@1386: 			for (var i=0; i<loudness.length; i++)
nickjillings@1386: 			{
nickjillings@1386: 				if (loudness[i] >= relGateLevel)
nickjillings@1386: 				{
nickjillings@1386: 					for (var c=0; c<blockEnergy.length; c++)
nickjillings@1386: 					{
nickjillings@1386: 						relgateEnergy[c].push(blockEnergy[c][i]);
nickjillings@1386: 					}
nickjillings@1386: 				}
nickjillings@1386: 			}
nickjillings@1386: 			var overallRelLoudness = calculateOverallLoudnessFromChannelBlocks(relgateEnergy);
nickjillings@1386: 			buffer.lufs =  overallRelLoudness;
nickjillings@1386: 		}
nickjillings@1386: 	}).catch(function(err) {
nickjillings@1386: 		console.log(err);
nickjillings@1386: 		buffer.lufs = 1;
nickjillings@1386: 	});
nickjillings@1386: }
nickjillings@1386: 
nickjillings@1386: function calculateProcessedLoudness(buffer, winDur, overlap)
nickjillings@1386: {
nickjillings@1386: 	// Buffer		Web Audio buffer node
nickjillings@1386: 	// winDur		Window Duration in milliseconds
nickjillings@1386: 	// overlap		Window overlap as normalised (0.5 = 50% overlap);
nickjillings@1386: 	if (buffer == undefined)
nickjillings@1386: 	{
nickjillings@1386: 		return 0;
nickjillings@1386: 	}
nickjillings@1386: 	if (winDur == undefined)
nickjillings@1386: 	{
nickjillings@1386: 		winDur = 400;
nickjillings@1386: 	}
nickjillings@1386: 	if (overlap == undefined)
nickjillings@1386: 	{
nickjillings@1386: 		overlap = 0.5;
nickjillings@1386: 	}
nickjillings@1386: 	var winSize = buffer.sampleRate*winDur/1000;
nickjillings@1386: 	var olapSize = (1-overlap)*winSize;
nickjillings@1386: 	var numberOfFrames = Math.floor(buffer.length/olapSize - winSize/olapSize + 1);
nickjillings@1386: 	var blockEnergy = new Array(buffer.numberOfChannels);
nickjillings@1386: 	for (var channel = 0; channel < buffer.numberOfChannels; channel++)
nickjillings@1386: 	{
nickjillings@1386: 		blockEnergy[channel] = new Float32Array(numberOfFrames);
nickjillings@1386: 		var data = buffer.getChannelData(channel);
nickjillings@1386: 		for (var i=0; i<numberOfFrames; i++)
nickjillings@1386: 		{
nickjillings@1386: 			var sigma = 0;
nickjillings@1386: 			for (var n=i*olapSize; n < i*olapSize+winSize; n++)
nickjillings@1386: 			{
nickjillings@1386: 				sigma += Math.pow(data[n],2);
nickjillings@1386: 			}
nickjillings@1386: 			blockEnergy[channel][i] = sigma/winSize;
nickjillings@1386: 		}
nickjillings@1386: 	}
nickjillings@1386: 	return blockEnergy;
nickjillings@1386: }
nickjillings@1386: function calculateLoudnessFromChannelBlocks(blockEnergy)
nickjillings@1386: {
nickjillings@1386: 	// Loudness
nickjillings@1386: 	var loudness = new Float32Array(blockEnergy[0].length);
nickjillings@1386: 	for (var i=0; i<blockEnergy[0].length; i++)
nickjillings@1386: 	{
nickjillings@1386: 		var sigma = 0;
nickjillings@1386: 		for (var channel = 0; channel < blockEnergy.length; channel++)
nickjillings@1386: 		{
nickjillings@1386: 			var G = 1.0;
nickjillings@1386: 			if (channel >= 4) {G = 1.41;}
nickjillings@1386: 			sigma += blockEnergy[channel][i]*G;
nickjillings@1386: 		}
nickjillings@1386: 		loudness[i] = -0.691 + 10*Math.log10(sigma);
nickjillings@1386: 	}
nickjillings@1386: 	return loudness;
nickjillings@1386: }
nickjillings@1386: function calculateOverallLoudnessFromChannelBlocks(blockEnergy)
nickjillings@1386: {
nickjillings@1386: 	// Loudness
nickjillings@1386: 	var summation = 0;
nickjillings@1386: 	for (var channel = 0; channel < blockEnergy.length; channel++)
nickjillings@1386: 	{
nickjillings@1386: 		var G = 1.0;
nickjillings@1386: 		if (channel >= 4) {G = 1.41;}
nickjillings@1386: 		var sigma = 0;
nickjillings@1386: 		for (var i=0; i<blockEnergy[0].length; i++)
nickjillings@1386: 		{
nickjillings@1386: 			blockEnergy[channel][i] *= G;
nickjillings@1386: 			sigma += blockEnergy[channel][i];
nickjillings@1386: 		}
nickjillings@1386: 		sigma /= blockEnergy.length;
nickjillings@1386: 		summation+= sigma;
nickjillings@1386: 	}
nickjillings@1386: 	return -0.691 + 10*Math.log10(summation);;
nickjillings@1386: }