@checksub_team/peaks_timeline 1.4.34 → 1.4.35

package/peaks.js

@@ -12938,6 +12938,16 @@ exports.default = _default;
 
 /**
  * ArrayBuffer adapter consumes binary waveform data.
+ * It is used as a data abstraction layer by `WaveformData`.
+ *
+ * This is supposed to be the fastest adapter ever:
+ * * **Pros**: working directly in memory, everything is done by reference
+ *   (including the offsetting)
+ * * **Cons**: binary data are hardly readable without data format knowledge
+ *   (and this is why this adapter exists).
+ *
+ * @param {ArrayBuffer} buffer
+ * @constructor
  */
 
 function WaveformDataArrayBufferAdapter(buffer) {
@@ -12947,14 +12957,19 @@ function WaveformDataArrayBufferAdapter(buffer) {
 
 /**
  * Detects if a set of data is suitable for the ArrayBuffer adapter.
+ * It is used internally by `WaveformData.create` so you should not bother using it.
+ *
+ * @static
+ * @param {Mixed} data
+ * @returns {boolean}
  */
 
 WaveformDataArrayBufferAdapter.isCompatible = function isCompatible(data) {
-  var isCompatible = data && typeof data === "object" && "byteLength" in data;
+  const isCompatible = data && typeof data === "object" && "byteLength" in data;
 
   if (isCompatible) {
-    var view = new DataView(data);
-    var version = view.getInt32(0, true);
+    const view = new DataView(data);
+    const version = view.getInt32(0, true);
 
     if (version !== 1 && version !== 2) {
       throw new TypeError("This waveform data version not supported.");
@@ -12964,10 +12979,15 @@ WaveformDataArrayBufferAdapter.isCompatible = function isCompatible(data) {
   return isCompatible;
 };
 
- WaveformDataArrayBufferAdapter.prototype = {
+/**
+ * @namespace WaveformDataArrayBufferAdapter
+ */
 
+ WaveformDataArrayBufferAdapter.prototype = {
   /**
    * Returns the data format version number.
+   *
+   * @return {Integer} Version number of the consumed data format.
    */
 
   get version() {
@@ -12986,6 +13006,8 @@ WaveformDataArrayBufferAdapter.isCompatible = function isCompatible(data) {
 
   /**
    * Returns the number of channels.
+   *
+   * @return {Integer} Number of channels.
    */
 
   get channels() {
@@ -12999,6 +13021,8 @@ WaveformDataArrayBufferAdapter.isCompatible = function isCompatible(data) {
 
   /**
    * Returns the number of samples per second.
+   *
+   * @return {Integer} Number of samples per second.
    */
 
   get sample_rate() {
@@ -13007,6 +13031,8 @@ WaveformDataArrayBufferAdapter.isCompatible = function isCompatible(data) {
 
   /**
    * Returns the scale (number of samples per pixel).
+   *
+   * @return {Integer} Number of samples per pixel.
    */
 
   get scale() {
@@ -13015,6 +13041,8 @@ WaveformDataArrayBufferAdapter.isCompatible = function isCompatible(data) {
 
   /**
    * Returns the length of the waveform data (number of data points).
+   *
+   * @return {Integer} Length of the waveform data.
    */
 
   get length() {
@@ -13022,7 +13050,10 @@ WaveformDataArrayBufferAdapter.isCompatible = function isCompatible(data) {
   },
 
   /**
-   * Returns a waveform data value at a specific offset.
+   * Returns a value at a specific offset.
+   *
+   * @param {Integer} index
+   * @return {Integer} waveform value
    */
 
   at: function at_sample(index) {
@@ -13032,6 +13063,9 @@ WaveformDataArrayBufferAdapter.isCompatible = function isCompatible(data) {
   /**
    * Returns a new ArrayBuffer with the concatenated waveform.
    * All waveforms must have identical metadata (version, channels, etc)
+   *
+   * @param {...WaveformDataArrayBufferAdapter} otherAdapters One or more adapters to concatenate
+   * @return {ArrayBuffer} concatenated ArrayBuffer
    */
 
   concatBuffers: function() {
@@ -13121,9 +13155,10 @@ WaveformDataObjectAdapter.isCompatible = function isCompatible(data) {
  */
 
 WaveformDataObjectAdapter.prototype = {
-
   /**
    * Returns the data format version number.
+   *
+   * @return {Integer} Version number of the consumed data format.
    */
 
   get version() {
@@ -13140,6 +13175,8 @@ WaveformDataObjectAdapter.prototype = {
 
   /**
    * Returns the number of channels.
+   *
+   * @return {Integer} Number of channels.
    */
 
   get channels() {
@@ -13148,6 +13185,8 @@ WaveformDataObjectAdapter.prototype = {
 
   /**
    * Returns the number of samples per second.
+   *
+   * @return {Integer} Number of samples per second.
    */
 
   get sample_rate() {
@@ -13156,6 +13195,8 @@ WaveformDataObjectAdapter.prototype = {
 
   /**
    * Returns the scale (number of samples per pixel).
+   *
+   * @return {Integer} Number of samples per pixel.
    */
 
   get scale() {
@@ -13164,6 +13205,8 @@ WaveformDataObjectAdapter.prototype = {
 
   /**
    * Returns the length of the waveform data (number of data points).
+   *
+   * @return {Integer} Length of the waveform data.
    */
 
   get length() {
@@ -13171,11 +13214,14 @@ WaveformDataObjectAdapter.prototype = {
   },
 
   /**
-   * Returns a waveform data value at a specific offset.
+   * Returns a value at a specific offset.
+   *
+   * @param {Integer} index
+   * @return {number} waveform value
    */
 
   at: function at_sample(index) {
-    var data = this._data.data;
+    const data = this._data.data;
 
     if (index >= 0 && index < data.length) {
       return data[index];
@@ -13188,6 +13234,9 @@ WaveformDataObjectAdapter.prototype = {
   /**
    * Returns a new data object with the concatenated waveform.
    * Both waveforms must have identical metadata (version, channels, etc)
+   *
+   * @param {...WaveformDataObjectAdapter} otherAdapters One or more adapters
+   * @return {Mixed} combined waveform data
    */
 
   concatBuffers: function() {
@@ -13212,166 +13261,165 @@ module.exports = WaveformDataObjectAdapter;
 
 var WaveformData = _dereq_("../core");
 var InlineWorker = _dereq_("inline-worker");
-var MainThreadWorker = _dereq_("../util/main-thread-worker");
 
-function processWorker(workerArgs, callback) {
-  var WaveformWorker = workerArgs.disable_worker ? MainThreadWorker : InlineWorker;
+/**
+ * This callback is executed once the audio has been decoded by the browser and
+ * resampled by waveform-data.
+ *
+ * @callback onAudioResampled
+ * @param {Error?}
+ * @param {WaveformData} waveform_data Waveform instance of the browser decoded audio
+ * @param {AudioBuffer} audio_buffer Decoded audio buffer
+ */
 
-  var worker = new WaveformWorker(function() {
-    var INT8_MAX = 127;
-    var INT8_MIN = -128;
+/**
+ * AudioBuffer-based WaveformData generator
+ *
+ * Adapted from BlockFile::CalcSummary in Audacity, with permission.
+ * @see https://code.google.com/p/audacity/source/browse/audacity-src/trunk/src/BlockFile.cpp
+ *
+ * @param {Object.<{scale: Number, amplitude_scale: Number, split_channels: Boolean}>} options
+ * @param {onAudioResampled} callback
+ * @returns {Function.<AudioBuffer>}
+ */
 
-    function calculateWaveformDataLength(audio_sample_count, scale) {
-      var data_length = Math.floor(audio_sample_count / scale);
+function getAudioDecoder(options, callback) {
+  return function onAudioDecoded(audio_buffer) {
+    var worker = new InlineWorker(function() {
+      var INT8_MAX = 127;
+      var INT8_MIN = -128;
 
-      var samples_remaining = audio_sample_count - (data_length * scale);
+      function calculateWaveformDataLength(audio_sample_count, scale) {
+        var data_length = Math.floor(audio_sample_count / scale);
 
-      if (samples_remaining > 0) {
-        data_length++;
-      }
+        var samples_remaining = audio_sample_count - (data_length * scale);
 
-      return data_length;
-    }
+        if (samples_remaining > 0) {
+          data_length++;
+        }
 
-    this.addEventListener("message", function listener(evt) {
-      if (!evt.data.audio_buffer) {
-        return;
+        return data_length;
       }
 
-      var scale = evt.data.scale;
-      var amplitude_scale = evt.data.amplitude_scale;
-      var split_channels = evt.data.split_channels;
-      var audio_buffer = evt.data.audio_buffer;
-
-      var channels = audio_buffer.channels;
-      var output_channels = split_channels ? channels.length : 1;
-      var version = output_channels === 1 ? 1 : 2;
-      var header_size = version === 1 ? 20 : 24;
-      var data_length = calculateWaveformDataLength(audio_buffer.length, scale);
-      var total_size = header_size + data_length * 2 * output_channels;
-      var data_object = new DataView(new ArrayBuffer(total_size));
-
-      var scale_counter = 0;
-      var buffer_length = audio_buffer.length;
-      var offset = header_size;
-      var channel, i;
-
-      var min_value = new Array(output_channels);
-      var max_value = new Array(output_channels);
-
-      for (channel = 0; channel < output_channels; channel++) {
-        min_value[channel] = Infinity;
-        max_value[channel] = -Infinity;
-      }
+      this.addEventListener("message", function(evt) {
+        var scale = evt.data.scale;
+        var amplitude_scale = evt.data.amplitude_scale;
+        var split_channels = evt.data.split_channels;
+        var audio_buffer = evt.data.audio_buffer;
 
-      data_object.setInt32(0, version, true); // Version
-      data_object.setUint32(4, 1, true); // Is 8 bit?
-      data_object.setInt32(8, audio_buffer.sampleRate, true); // Sample rate
-      data_object.setInt32(12, scale, true); // Scale
-      data_object.setInt32(16, data_length, true); // Length
+        var channels = audio_buffer.channels;
+        var output_channels = split_channels ? channels.length : 1;
+        var version = output_channels === 1 ? 1 : 2;
+        var header_size = version === 1 ? 20 : 24;
+        var data_length = calculateWaveformDataLength(audio_buffer.length, scale);
+        var total_size = header_size + data_length * 2 * output_channels;
+        var data_object = new DataView(new ArrayBuffer(total_size));
 
-      if (version === 2) {
-        data_object.setInt32(20, output_channels, true);
-      }
+        var min_value = new Array(output_channels);
+        var max_value = new Array(output_channels);
 
-      for (i = 0; i < buffer_length; i++) {
-        var sample = 0;
+        for (let channel = 0; channel < output_channels; channel++) {
+          min_value[channel] = Infinity;
+          max_value[channel] = -Infinity;
+        }
 
-        if (output_channels === 1) {
-          for (channel = 0; channel < channels.length; ++channel) {
-            sample += channels[channel][i];
-          }
+        var scale_counter = 0;
+        var buffer_length = audio_buffer.length;
+        var offset = header_size;
+        var channel, i;
+
+        data_object.setInt32(0, version, true); // Version
+        data_object.setUint32(4, 1, true); // Is 8 bit?
+        data_object.setInt32(8, audio_buffer.sampleRate, true); // Sample rate
+        data_object.setInt32(12, scale, true); // Scale
+        data_object.setInt32(16, data_length, true); // Length
 
-          sample = Math.floor(INT8_MAX * sample * amplitude_scale / channels.length);
+        if (version === 2) {
+          data_object.setInt32(20, output_channels, true);
+        }
 
-          if (sample < min_value[0]) {
-            min_value[0] = sample;
+        for (i = 0; i < buffer_length; i++) {
+          var sample = 0;
 
-            if (min_value[0] < INT8_MIN) {
-              min_value[0] = INT8_MIN;
+          if (output_channels === 1) {
+            for (channel = 0; channel < channels.length; ++channel) {
+              sample += channels[channel][i];
             }
-          }
 
-          if (sample > max_value[0]) {
-            max_value[0] = sample;
+            sample = Math.floor(INT8_MAX * sample * amplitude_scale / channels.length);
+
+            if (sample < min_value[0]) {
+              min_value[0] = sample;
 
-            if (max_value[0] > INT8_MAX) {
-              max_value[0] = INT8_MAX;
+              if (min_value[0] < INT8_MIN) {
+                min_value[0] = INT8_MIN;
+              }
             }
-          }
-        }
-        else {
-          for (channel = 0; channel < output_channels; ++channel) {
-            sample = Math.floor(INT8_MAX * channels[channel][i] * amplitude_scale);
 
-            if (sample < min_value[channel]) {
-              min_value[channel] = sample;
+            if (sample > max_value[0]) {
+              max_value[0] = sample;
 
-              if (min_value[channel] < INT8_MIN) {
-                min_value[channel] = INT8_MIN;
+              if (max_value[0] > INT8_MAX) {
+                max_value[0] = INT8_MAX;
               }
             }
+          }
+          else {
+            for (channel = 0; channel < output_channels; ++channel) {
+              sample = Math.floor(INT8_MAX * channels[channel][i] * amplitude_scale);
 
-            if (sample > max_value[channel]) {
-              max_value[channel] = sample;
+              if (sample < min_value[channel]) {
+                min_value[channel] = sample;
 
-              if (max_value[channel] > INT8_MAX) {
-                max_value[channel] = INT8_MAX;
+                if (min_value[channel] < INT8_MIN) {
+                  min_value[channel] = INT8_MIN;
+                }
               }
+
+              if (sample > max_value[channel]) {
+                max_value[channel] = sample;
+
+                if (max_value[channel] > INT8_MAX) {
+                  max_value[channel] = INT8_MAX;
+                }
+              }
+            }
+          }
+
+          if (++scale_counter === scale) {
+            for (channel = 0; channel < output_channels; channel++) {
+              data_object.setInt8(offset++, min_value[channel]);
+              data_object.setInt8(offset++, max_value[channel]);
+
+              min_value[channel] = Infinity;
+              max_value[channel] = -Infinity;
             }
+
+            scale_counter = 0;
           }
         }
 
-        if (++scale_counter === scale) {
+        if (scale_counter > 0) {
           for (channel = 0; channel < output_channels; channel++) {
             data_object.setInt8(offset++, min_value[channel]);
             data_object.setInt8(offset++, max_value[channel]);
-
-            min_value[channel] = Infinity;
-            max_value[channel] = -Infinity;
           }
-
-          scale_counter = 0;
-        }
-      }
-
-      if (scale_counter > 0) {
-        for (channel = 0; channel < output_channels; channel++) {
-          data_object.setInt8(offset++, min_value[channel]);
-          data_object.setInt8(offset++, max_value[channel]);
         }
-      }
 
-      this.postMessage(data_object);
-      this.removeEventListener("message", listener);
-      this.close();
+        this.postMessage(data_object);
+      });
     });
-  });
-
-  worker.addEventListener("message", function listener(evt) {
-    if (evt.data.audio_buffer) {
-      return;
-    }
-
-    callback(evt.data);
-
-    // We're only sending a single message to each listener, so
-    // remove the callback afterwards to avoid leaks.
-    worker.removeEventListener("message", listener);
-  });
 
-  worker.postMessage(workerArgs);
-}
+    worker.addEventListener("message", function(evt) {
+      var data_object = evt.data;
 
-/**
- * AudioBuffer-based WaveformData generator
- *
- * Adapted from BlockFile::CalcSummary in Audacity, with permission.
- * See https://code.google.com/p/audacity/source/browse/audacity-src/trunk/src/BlockFile.cpp
- */
+      callback(
+        null,
+        new WaveformData(data_object.buffer),
+        audio_buffer
+      );
+    });
 
-function getAudioDecoder(options, callback) {
-  return function onAudioDecoded(audio_buffer) {
     // Construct a simple object with the necessary AudioBuffer data,
     // as we cannot send an AudioBuffer to a Web Worker.
     var audio_buffer_obj = {
@@ -13385,38 +13433,35 @@ function getAudioDecoder(options, callback) {
       audio_buffer_obj.channels[channel] = audio_buffer.getChannelData(channel);
     }
 
-    var worker_args = {
+    worker.postMessage({
       scale: options.scale,
       amplitude_scale: options.amplitude_scale,
       split_channels: options.split_channels,
-      audio_buffer: audio_buffer_obj,
-      disable_worker: options.disable_worker
-    };
-
-    processWorker(worker_args, function(data_object) {
-      callback(null, new WaveformData(data_object.buffer), audio_buffer);
+      audio_buffer: audio_buffer_obj
     });
   };
 }
 
 module.exports = getAudioDecoder;
 
-},{"../core":83,"../util/main-thread-worker":84,"inline-worker":3}],80:[function(_dereq_,module,exports){
+},{"../core":83,"inline-worker":3}],80:[function(_dereq_,module,exports){
 "use strict";
 
 var defaultOptions = {
   scale: 512,
   amplitude_scale: 1.0,
-  split_channels: false,
-  disable_worker: false
+  split_channels: false
 };
 
 function getOptions(options) {
+  if (Object.prototype.hasOwnProperty.call(options, "scale_adjuster")) {
+    throw new Error("Please rename the 'scale_adjuster' option to 'amplitude_scale'");
+  }
+
   var opts = {
     scale: options.scale || defaultOptions.scale,
     amplitude_scale: options.amplitude_scale || defaultOptions.amplitude_scale,
-    split_channels: options.split_channels || defaultOptions.split_channels,
-    disable_worker: options.disable_worker || defaultOptions.disable_worker
+    split_channels: options.split_channels || defaultOptions.split_channels
   };
 
   return opts;
@@ -13458,7 +13503,39 @@ function createFromAudioBuffer(audioBuffer, options, callback) {
 }
 
 /**
- * Creates a WaveformData instance from audio.
+ * Creates a working WaveformData based on binary audio data.
+ *
+ * This is still quite experimental and the result will mostly depend on the
+ * level of browser support.
+ *
+ * ```javascript
+ * const xhr = new XMLHttpRequest();
+ * const audioContext = new AudioContext();
+ *
+ * // URL of a CORS MP3/Ogg file
+ * xhr.open('GET', 'https://example.com/audio/track.ogg');
+ * xhr.responseType = 'arraybuffer';
+ *
+ * xhr.addEventListener('load', function(progressEvent) {
+ *   WaveformData.createFromAudio(audioContext, progressEvent.target.response,
+ *     function(err, waveform) {
+ *     if (err) {
+ *       console.error(err);
+ *       return;
+ *     }
+ *
+ *     console.log(waveform.duration);
+ *   });
+ * });
+ *
+ * xhr.send();
+ * ```
+ *
+ * @todo Use `SourceBuffer.appendBuffer` and `ProgressEvent` to stream the decoding?
+ * @param {AudioContext|webkitAudioContext} audio_context
+ * @param {ArrayBuffer} audio_data
+ * @param {callback} what to do once the decoding is done
+ * @constructor
  */
 
 function createFromAudio(options, callback) {
@@ -13471,10 +13548,7 @@ function createFromAudio(options, callback) {
     return createFromAudioBuffer(options.audio_buffer, opts, callback);
   }
   else {
-    throw new TypeError(
-      // eslint-disable-next-line
-      "WaveformData.createFromAudio(): Pass either an AudioContext and ArrayBuffer, or an AudioBuffer object"
-    );
+    throw new TypeError("Please pass either an AudioContext and ArrayBuffer, or an AudioBuffer object");
   }
 }
 
@@ -13485,6 +13559,10 @@ module.exports = createFromAudio;
 
 /**
  * Provides access to the waveform data for a single audio channel.
+ *
+ * @param {WaveformData} waveformData Waveform data.
+ * @param {Number} channelIndex Channel number.
+ * @constructor
  */
 
 function WaveformDataChannel(waveformData, channelIndex) {
@@ -13493,27 +13571,58 @@ function WaveformDataChannel(waveformData, channelIndex) {
 }
 
 /**
- * Returns the waveform minimum at the given index position.
+ * Returns a min value for a specific offset.
+ *
+ * ```javascript
+ * var waveform = WaveformData.create({ ... });
+ * var channel = waveform.channel(0);
+ *
+ * console.log(channel.min_sample(10)); // -> -12
+ * ```
+ *
+ * @api
+ * @param {Integer} offset
+ * @return {Number} Offset min value
  */
 
 WaveformDataChannel.prototype.min_sample = function(index) {
-  var offset = (index * this._waveformData.channels + this._channelIndex) * 2;
+  const offset = (index * this._waveformData.channels + this._channelIndex) * 2;
 
   return this._waveformData._adapter.at(offset);
 };
 
 /**
- * Returns the waveform maximum at the given index position.
+ * Returns a max value for a specific offset.
+ *
+ * ```javascript
+ * var waveform = WaveformData.create({ ... });
+ * var channel = waveform.channel(0);
+ *
+ * console.log(channel.max_sample(10)); // -> 12
+ * ```
+ *
+ * @api
+ * @param {Integer} offset
+ * @return {Number} Offset max value
  */
 
 WaveformDataChannel.prototype.max_sample = function(index) {
-  var offset = (index * this._waveformData.channels + this._channelIndex) * 2 + 1;
+  const offset = (index * this._waveformData.channels + this._channelIndex) * 2 + 1;
 
   return this._waveformData._adapter.at(offset);
 };
 
 /**
- * Returns all the waveform minimum values as an array.
+ * Returns all the min values within the current offset.
+ *
+ * ```javascript
+ * var waveform = WaveformData.create({ ... });
+ * var channel = waveform.channel(0);
+ *
+ * console.log(channel.min_array()); // -> [-7, -5, -10]
+ * ```
+ *
+ * @return {Array.<Integer>} Min values contained in the offset.
  */
 
 WaveformDataChannel.prototype.min_array = function() {
@@ -13525,7 +13634,16 @@ WaveformDataChannel.prototype.min_array = function() {
 };
 
 /**
- * Returns all the waveform maximum values as an array.
+ * Returns all the max values within the current offset.
+ *
+ * ```javascript
+ * var waveform = WaveformData.create({ ... });
+ * var channel = waveform.channel(0);
+ *
+ * console.log(channel.max_array()); // -> [9, 6, 11]
+ * ```
+ *
+ * @return {Array.<Integer>} Max values contained in the offset.
  */
 
 WaveformDataChannel.prototype.max_array = function() {
@@ -13551,7 +13669,32 @@ var adapters = [
 ];
 
 /**
- * Provides access to waveform data.
+ * Facade to iterate on audio waveform response.
+ *
+ * ```javascript
+ * var waveform = new WaveformData({ ... });
+ *
+ * var json_waveform = new WaveformData(xhr.responseText);
+ *
+ * var arraybuff_waveform = new WaveformData(
+ *   getArrayBufferData()
+ * );
+ * ```
+ *
+ * ## Offsets
+ *
+ * An **offset** is a non-destructive way to iterate on a subset of data.
+ *
+ * It is the easiest way to **navigate** through data without having to deal
+ * with complex calculations. Simply iterate over the data to display them.
+ *
+ * *Notice*: the default offset is the entire set of data.
+ *
+ * @param {String|ArrayBuffer|Object} data Waveform data,
+ * to be consumed by the related adapter.
+ * @param {WaveformData.adapter|Function} adapter Backend adapter used to manage
+ * access to the data.
+ * @constructor
  */
 
 function WaveformData(data) {
@@ -13561,19 +13704,45 @@ function WaveformData(data) {
 
   this._channels = [];
 
-  for (var channel = 0; channel < this.channels; channel++) {
+  for (let channel = 0; channel < this.channels; channel++) {
     this._channels[channel] = new WaveformDataChannel(this, channel);
   }
 }
 
 /**
- * Creates and returns a WaveformData instance from the given waveform data.
+ * Creates an instance of WaveformData by guessing the adapter from the
+ * data type. It can also accept an XMLHttpRequest response.
+ *
+ * ```javascript
+ * var xhr = new XMLHttpRequest();
+ * xhr.open("GET", "http://example.com/waveforms/track.dat");
+ * xhr.responseType = "arraybuffer";
+ *
+ * xhr.addEventListener("load", function onResponse(progressEvent) {
+ *   var waveform = WaveformData.create(progressEvent.target);
+ *
+ *   console.log(waveform.duration);
+ * });
+ *
+ * xhr.send();
+ * ```
+ *
+ * @static
+ * @throws TypeError
+ * @param {Object} data
+ * @return {WaveformData}
  */
 
 WaveformData.create = function create(data) {
   return new WaveformData(data);
 };
 
+/**
+ * Public API for the Waveform Data manager.
+ *
+ * @namespace WaveformData
+ */
+
 WaveformData.prototype = {
 
   _getAdapter: function(data) {
@@ -13587,23 +13756,47 @@ WaveformData.prototype = {
     });
 
     if (Adapter === null) {
-      throw new TypeError(
-        "WaveformData.create(): Could not detect a WaveformData adapter from the input"
-      );
+      throw new TypeError("Could not detect a WaveformData adapter from the input.");
     }
 
     return Adapter;
   },
 
   /**
-   * Creates and returns a new WaveformData object with resampled data.
-   * Use this method to create waveform data at different zoom levels.
+   * Creates a new WaveformData object with resampled data.
+   * Returns a rescaled waveform, to either fit the waveform to a specific
+   * width, or to a specific zoom level.
+   *
+   * **Note**: You may specify either the *width* or the *scale*, but not both.
+   * The `scale` will be deduced from the `width` you want to fit the data into.
    *
    * Adapted from Sequence::GetWaveDisplay in Audacity, with permission.
-   * https://code.google.com/p/audacity/source/browse/audacity-src/trunk/src/Sequence.cpp
+   *
+   * ```javascript
+   * var waveform = WaveformData.create({ ... });
+   * // ...
+   *
+   * // fitting the data in a 500px wide canvas
+   * var resampled_waveform = waveform.resample({ width: 500 });
+   *
+   * console.log(resampled_waveform.min.length);   // -> 500
+   *
+   * // zooming out on a 3 times less precise scale
+   * var resampled_waveform = waveform.resample({ scale: waveform.scale * 3 });
+   * ```
+   *
+   * @see https://code.google.com/p/audacity/source/browse/audacity-src/trunk/src/Sequence.cpp
+   * @param {Number|{width: Number, scale: Number}} options Either a constraint width or a constraint sample rate
+   * @return {WaveformData} New resampled object
    */
 
   resample: function(options) {
+    if (typeof options === "number") {
+      options = {
+        width: options
+      };
+    }
+
     options.input_index = typeof options.input_index === "number" ? options.input_index : null;
     options.output_index = typeof options.output_index === "number" ? options.output_index : null;
     options.scale = typeof options.scale === "number" ? options.scale : null;
@@ -13612,63 +13805,48 @@ WaveformData.prototype = {
     var is_partial_resampling = Boolean(options.input_index) || Boolean(options.output_index);
 
     if (options.input_index != null && (options.input_index < 0)) {
-      throw new RangeError(
-        "WaveformData.resample(): input_index should be a positive integer value"
-      );
+      throw new RangeError("options.input_index should be a positive integer value. [" + options.input_index + "]");
     }
 
     if (options.output_index != null && (options.output_index < 0)) {
-      throw new RangeError(
-        "WaveformData.resample(): output_index should be a positive integer value"
-      );
+      throw new RangeError("options.output_index should be a positive integer value. [" + options.output_index + "]");
     }
 
     if (options.width != null && (options.width <= 0)) {
-      throw new RangeError("WaveformData.resample(): width should be a positive integer value");
+      throw new RangeError("options.width should be a strictly positive integer value. [" + options.width + "]");
     }
 
     if (options.scale != null && (options.scale <= 0)) {
-      throw new RangeError("WaveformData.resample(): scale should be a positive integer value");
+      throw new RangeError("options.scale should be a strictly positive integer value. [" + options.scale + "]");
     }
 
     if (!options.scale && !options.width) {
-      throw new Error("WaveformData.resample(): Missing scale or width option");
+      throw new RangeError("You should provide either a resampling scale or a width in pixel the data should fit in.");
     }
 
-    if (is_partial_resampling) {
-      if (options.width === null ||
-          options.scale === null ||
-          options.input_index === null ||
-          options.output_index === null) {
-        throw new Error(
-          "WaveformData.resample(): Missing width, scale, input_index, or output_index option"
-        );
-      }
+    var definedPartialOptionsCount = ["width", "scale", "output_index", "input_index"].reduce(function(count, key) {
+      return count + (options[key] === null ? 0 : 1);
+    }, 0);
+
+    if (is_partial_resampling && definedPartialOptionsCount !== 4) {
+      throw new Error("Some partial resampling options are missing. You provided " + definedPartialOptionsCount + " of them over 4.");
     }
 
     var output_data = [];
-    // Scale we want to reach
-    var samples_per_pixel = options.scale ||
-      Math.floor(this.duration * this.sample_rate / options.width);
+    var samples_per_pixel = options.scale || Math.floor(this.duration * this.sample_rate / options.width); // scale we want to reach
     var scale = this.scale; // scale we are coming from
     var channel_count = 2 * this.channels;
 
-    // The amount of data we want to resample i.e. final zoom want to resample
-    // all data but for intermediate zoom we want to resample subset
-    var input_buffer_size = this.length;
-    // Is this start point? or is this the index at current scale?
-    var input_index = options.input_index || 0;
-    // Is this end point? or is this the index at scale we want to be?
-    var output_index = options.output_index || 0;
+    var input_buffer_size = this.length; // the amount of data we want to resample i.e. final zoom want to resample all data but for intermediate zoom we want to resample subset
+    var input_index = options.input_index || 0; // is this start point? or is this the index at current scale
+    var output_index = options.output_index || 0; // is this end point? or is this the index at scale we want to be?
 
     var channels = this.channels;
 
     var min = new Array(channels);
     var max = new Array(channels);
 
-    var channel;
-
-    for (channel = 0; channel < channels; ++channel) {
+    for (let channel = 0; channel < channels; ++channel) {
       if (input_buffer_size > 0) {
         min[channel] = this.channel(channel).min_sample(input_index);
         max[channel] = this.channel(channel).max_sample(input_index);
@@ -13683,9 +13861,7 @@ WaveformData.prototype = {
     var max_value = 127;
 
     if (samples_per_pixel < scale) {
-      throw new Error(
-        "WaveformData.resample(): Zoom level " + samples_per_pixel + " too low, minimum: " + scale
-      );
+      throw new Error("Zoom level " + samples_per_pixel + " too low, minimum: " + scale);
     }
 
     var where, prev_where, stop, value, last_input_index;
@@ -13694,11 +13870,15 @@ WaveformData.prototype = {
       return Math.floor(x * samples_per_pixel);
     }
 
+    function add_sample(min, max) {
+      output_data.push(min, max);
+    }
+
     while (input_index < input_buffer_size) {
       while (Math.floor(sample_at_pixel(output_index) / scale) <= input_index) {
         if (output_index > 0) {
-          for (channel = 0; channel < channels; ++channel) {
-            output_data.push(min[channel], max[channel]);
+          for (let channel = 0; channel < channels; ++channel) {
+            add_sample(min[channel], max[channel]);
           }
         }
 
@@ -13710,7 +13890,7 @@ WaveformData.prototype = {
         prev_where = sample_at_pixel(output_index - 1);
 
         if (where !== prev_where) {
-          for (channel = 0; channel < channels; ++channel) {
+          for (let channel = 0; channel < channels; ++channel) {
             min[channel] = max_value;
             max[channel] = min_value;
           }
@@ -13725,7 +13905,7 @@ WaveformData.prototype = {
       }
 
       while (input_index < stop) {
-        for (channel = 0; channel < channels; ++channel) {
+        for (let channel = 0; channel < channels; ++channel) {
           value = this.channel(channel).min_sample(input_index);
 
           if (value < min[channel]) {
@@ -13750,14 +13930,14 @@ WaveformData.prototype = {
     if (is_partial_resampling) {
       if ((output_data.length / channel_count) > options.width &&
           input_index !== last_input_index) {
-          for (channel = 0; channel < channels; ++channel) {
-            output_data.push(min[channel], max[channel]);
+          for (let channel = 0; channel < channels; ++channel) {
+            add_sample(min[channel], max[channel]);
           }
       }
     }
     else if (input_index !== last_input_index) {
-      for (channel = 0; channel < channels; ++channel) {
-        output_data.push(min[channel], max[channel]);
+      for (let channel = 0; channel < channels; ++channel) {
+        add_sample(min[channel], max[channel]);
       }
     }
 
@@ -13773,9 +13953,11 @@ WaveformData.prototype = {
   },
 
   /**
-   * Concatenates with one or more other waveforms, returning a new WaveformData object.
+   * Return a new WaveformData instance with the concatenated result of multiple waveforms.
+   *
+   * @param {...WaveformData} otherWaveforms One or more waveform instances to concatenate
+   * @return {WaveformData} New concatenated object
    */
-
   concat: function() {
     var self = this;
     var otherWaveforms = Array.prototype.slice.call(arguments);
@@ -13787,7 +13969,7 @@ WaveformData.prototype = {
         self.scale !== otherWaveform.scale ||
         Object.getPrototypeOf(self._adapter) !== Object.getPrototypeOf(otherWaveform._adapter) ||
         self._adapter.version !== otherWaveform._adapter.version) {
-        throw new Error("WaveformData.concat(): Waveforms are incompatible");
+        throw new Error("Waveforms are incompatible");
       }
     });
 
@@ -13802,6 +13984,12 @@ WaveformData.prototype = {
 
   /**
    * Return the unpacked values for a particular offset.
+   *
+   * @param {Integer} start
+   * @param {Integer} length
+   * @param {Integer} correction The step to skip for each iteration
+   * (as the response body is [min, max, min, max...])
+   * @return {Array.<Integer>}
    */
 
   _offsetValues: function getOffsetValues(start, length, correction) {
@@ -13820,6 +14008,14 @@ WaveformData.prototype = {
 
   /**
    * Returns the length of the waveform, in pixels.
+   *
+   * ```javascript
+   * var waveform = WaveformData.create({ ... });
+   * console.log(waveform.length); // -> 600
+   * ```
+   *
+   * @api
+   * @return {Integer} Length of the waveform, in pixels.
    */
 
   get length() {
@@ -13836,6 +14032,14 @@ WaveformData.prototype = {
 
   /**
    * Returns the (approximate) duration of the audio file, in seconds.
+   *
+   * ```javascript
+   * var waveform = WaveformData.create({ ... });
+   * console.log(waveform.duration); // -> 10.33333333333
+   * ```
+   *
+   * @api
+   * @return {number} Duration of the audio waveform, in seconds.
    */
 
   get duration() {
@@ -13843,7 +14047,16 @@ WaveformData.prototype = {
   },
 
   /**
-   * Returns the number of pixels per second.
+   * Return the number of pixels per second.
+   *
+   * ```javascript
+   * var waveform = WaveformData.create({ ... });
+   *
+   * console.log(waveform.pixels_per_second); // -> 93.75
+   * ```
+   *
+   * @api
+   * @return {number} Number of pixels per second.
    */
 
   get pixels_per_second() {
@@ -13851,7 +14064,15 @@ WaveformData.prototype = {
   },
 
   /**
-   * Returns the amount of time represented by a single pixel, in seconds.
+   * Return the amount of time represented by a single pixel.
+   *
+   * ```javascript
+   * var waveform = WaveformData.create({ ... });
+   *
+   * console.log(waveform.seconds_per_pixel);       // -> 0.010666666666666666
+   * ```
+   *
+   * @return {number} Amount of time (in seconds) contained in a pixel.
    */
 
   get seconds_per_pixel() {
@@ -13860,6 +14081,14 @@ WaveformData.prototype = {
 
   /**
    * Returns the number of waveform channels.
+   *
+   * ```javascript
+   * var waveform = WaveformData.create({ ... });
+   * console.log(waveform.channels);    // -> 1
+   * ```
+   *
+   * @api
+   * @return {number} Number of channels.
    */
 
   get channels() {
@@ -13868,6 +14097,16 @@ WaveformData.prototype = {
 
   /**
    * Returns a waveform channel.
+   *
+   * ```javascript
+   * var waveform = WaveformData.create({ ... });
+   * var channel = waveform.channel(0);
+   * console.log(channel.min_sample(0)); // -> 1
+   * ```
+   *
+   * @api
+   * @param {Number} Channel index.
+   * @return {WaveformDataChannel} Waveform channel.
    */
 
   channel: function(index) {
@@ -13880,7 +14119,9 @@ WaveformData.prototype = {
   },
 
   /**
-   * Returns the number of audio samples per second.
+   * Returns the number of samples per second.
+   *
+   * @return {Integer} Number of samples per second.
    */
 
   get sample_rate() {
@@ -13888,7 +14129,9 @@ WaveformData.prototype = {
   },
 
   /**
-   * Returns the number of audio samples per pixel.
+   * Returns the scale (number of samples per pixel).
+   *
+   * @return {Integer} Number of samples per pixel.
    */
 
   get scale() {
@@ -13896,7 +14139,10 @@ WaveformData.prototype = {
   },
 
   /**
-   * Returns the waveform data index position for a given time.
+   * Returns the pixel location for a given time.
+   *
+   * @param {number} time
+   * @return {integer} Index location for a specific time.
    */
 
   at_time: function at_time(time) {
@@ -13904,36 +14150,14 @@ WaveformData.prototype = {
   },
 
   /**
-   * Returns the time in seconds for a given index.
+   * Returns the time in seconds for a given index
+   *
+   * @param {Integer} index
+   * @return {number}
    */
 
   time: function time(index) {
     return index * this.scale / this.sample_rate;
-  },
-
-  /**
-   * Returns an object containing the waveform data.
-   */
-
-  toJSON: function() {
-    const waveform = {
-      version: 2,
-      channels: this.channels,
-      sample_rate: this.sample_rate,
-      samples_per_pixel: this.scale,
-      bits: this.bits,
-      length: this.length,
-      data: []
-    };
-
-    for (var i = 0; i < this.length; i++) {
-      for (var channel = 0; channel < this.channels; channel++) {
-        waveform.data.push(this.channel(channel).min_sample(i));
-        waveform.data.push(this.channel(channel).max_sample(i));
-      }
-    }
-
-    return waveform;
   }
 };
 
@@ -13942,54 +14166,13 @@ module.exports = WaveformData;
 },{"./adapters/arraybuffer":77,"./adapters/object":78,"./channel":82}],84:[function(_dereq_,module,exports){
 "use strict";
 
-function MainThreadWorker(func) {
-  this._listeners = {};
-
-  func.call(this);
-}
-
-MainThreadWorker.prototype.addEventListener = function(event, listener) {
-  if (!this._listeners[event]) {
-    this._listeners[event] = [];
-  }
-
-  this._listeners[event].push(listener);
-};
-
-MainThreadWorker.prototype.removeEventListener = function(event, listener) {
-  if (this._listeners[event]) {
-    this._listeners[event] = this._listeners[event].filter(function(item) {
-      return item !== listener;
-    });
-  }
-};
-
-MainThreadWorker.prototype.postMessage = function(data) {
-  var event = { data: data };
-
-  var listeners = this._listeners.message;
-
-  for (var i = 0; i < listeners.length; i++) {
-    listeners[i].call(this, event);
-  }
-};
-
-MainThreadWorker.prototype.close = function() {
-  this._listeners = {};
-};
-
-module.exports = MainThreadWorker;
-
-},{}],85:[function(_dereq_,module,exports){
-"use strict";
-
 var WaveformData = _dereq_("./lib/core");
 
 WaveformData.createFromAudio = _dereq_("./lib/builders/webaudio");
 
 module.exports = WaveformData;
 
-},{"./lib/builders/webaudio":81,"./lib/core":83}],86:[function(_dereq_,module,exports){
+},{"./lib/builders/webaudio":81,"./lib/core":83}],85:[function(_dereq_,module,exports){
 module.exports = function (Data) {
     'use strict';
     function DataRetriever(peaks) {
@@ -14039,7 +14222,7 @@ module.exports = function (Data) {
     };
     return DataRetriever;
 }(_dereq_('./data'));
-},{"./data":87}],87:[function(_dereq_,module,exports){
+},{"./data":86}],86:[function(_dereq_,module,exports){
 module.exports = function () {
     'use strict';
     function Data(type, content) {
@@ -14071,7 +14254,7 @@ module.exports = function () {
     };
     return Data;
 }();
-},{}],88:[function(_dereq_,module,exports){
+},{}],87:[function(_dereq_,module,exports){
 module.exports = function (Utils, Konva) {
     'use strict';
     function DefaultSegmentMarker(options) {
@@ -14155,7 +14338,7 @@ module.exports = function (Utils, Konva) {
     };
     return DefaultSegmentMarker;
 }(_dereq_('./utils'), _dereq_('konva'));
-},{"./utils":111,"konva":43}],89:[function(_dereq_,module,exports){
+},{"./utils":110,"konva":43}],88:[function(_dereq_,module,exports){
 module.exports = function () {
     'use strict';
     function Invoker() {
@@ -14204,7 +14387,7 @@ module.exports = function () {
     };
     return Invoker;
 }();
-},{}],90:[function(_dereq_,module,exports){
+},{}],89:[function(_dereq_,module,exports){
 module.exports = function () {
     'use strict';
     var nodes = [
@@ -14287,7 +14470,7 @@ module.exports = function () {
     };
     return KeyboardHandler;
 }();
-},{}],91:[function(_dereq_,module,exports){
+},{}],90:[function(_dereq_,module,exports){
 module.exports = function (Konva, Utils) {
     'use strict';
     function LineIndicator(peaks, view, container) {
@@ -14320,22 +14503,57 @@ module.exports = function (Konva, Utils) {
         if (this._peaks.options.enableLineIndicatorContextMenu) {
             this._createContextMenu();
         }
+        this.ICON_SIZE = 18;
+        this._volumeSVGPath = 'M0 6.00001V12H4L9 17V1.00001L4 6.00001H0ZM13.5 9.00001C13.5 7.23001 12.48 5.71001 11 4.97001V13.02C12.48 12.29 13.5 10.77 13.5 9.00001ZM11 0.230011V2.29001C13.89 3.15001 16 5.83001 16 9.00001C16 12.17 13.89 14.85 11 15.71V17.77C15.01 16.86 18 13.28 18 9.00001C18 4.72001 15.01 1.14001 11 0.230011Z';
+        this._noVolumeSVGPath = 'M13.5 9C13.5 7.23 12.48 5.71 11 4.97V7.18L13.45 9.63C13.48 9.43 13.5 9.22 13.5 9ZM16 9C16 9.94 15.8 10.82 15.46 11.64L16.97 13.15C17.63 11.91 18 10.5 18 9C18 4.72 15.01 1.14 11 0.23V2.29C13.89 3.15 16 5.83 16 9ZM1.27 0L0 1.27L4.73 6H0V12H4L9 17V10.27L13.25 14.52C12.58 15.04 11.83 15.45 11 15.7V17.76C12.38 17.45 13.63 16.81 14.69 15.95L16.73 18L18 16.73L9 7.73L1.27 0ZM9 1L6.91 3.09L9 5.18V1Z';
+        this._peaks.on('lineIndicator.setType', this._onSetType.bind(this));
+        this._types = [
+            'default',
+            'volume',
+            'noVolume'
+        ];
     }
+    LineIndicator.prototype._onSetType = function (lineId, type) {
+        this.removeIndicator(lineId, true);
+        type = this._types.includes(type) ? type : 'default';
+        var indicator = this._createIndicator(this._indicators[lineId].line, type);
+        this._layer.add(indicator);
+        this._indicators[lineId].indicator = indicator;
+        this._indicators[lineId].type = type;
+        this.draw();
+    };
     LineIndicator.prototype._showMenu = function (menu) {
         menu.style.display = 'block';
         var containerRect = this._stage.container().getBoundingClientRect();
         menu.style.top = containerRect.top + this._stage.getPointerPosition().y - menu.offsetHeight + 'px';
         menu.style.left = containerRect.left + this._stage.getPointerPosition().x + 6 + 'px';
     };
-    LineIndicator.prototype._createIndicator = function (line) {
-        var indicator = new Konva.Circle({
-            x: this._width / 2,
-            y: line.getY() + line.lineHeight() / 2,
-            radius: this._indicatorRadius,
-            fill: this._peaks.options.lineIndicatorColor,
-            strokeWidth: 0,
-            lineId: line.getId()
-        });
+    LineIndicator.prototype._createIndicator = function (line, type) {
+        var indicator;
+        type = typeof type !== 'undefined' ? type : 'default';
+        if (type === 'default') {
+            indicator = new Konva.Circle({
+                x: this._width / 2,
+                y: line.getY() + line.lineHeight() / 2,
+                radius: this._indicatorRadius,
+                fill: this._peaks.options.lineIndicatorColor,
+                strokeWidth: 0,
+                lineId: line.getId()
+            });
+        } else {
+            var scaleFactor = this._width / 2 / this.ICON_SIZE;
+            indicator = new Konva.Path({
+                x: this._width / 4,
+                y: line.getY() + line.lineHeight() / 2 - this._width / 4,
+                data: type === 'volume' ? this._volumeSVGPath : this._noVolumeSVGPath,
+                fill: this._peaks.options.lineIndicatorColor,
+                scale: {
+                    x: scaleFactor,
+                    y: scaleFactor
+                },
+                lineId: line.getId()
+            });
+        }
         var self = this;
         indicator.on('mouseover', function () {
             indicator.fill(self._peaks.options.lineIndicatorSelected);
@@ -14345,6 +14563,9 @@ module.exports = function (Konva, Utils) {
             indicator.fill(self._peaks.options.lineIndicatorColor);
             indicator.draw();
         });
+        indicator.on('click', function (e) {
+            self._peaks.emit('lineIndicator.click', self._indicators[line.getId()], e.evt.button);
+        });
         return indicator;
     };
     LineIndicator.prototype.addIndicator = function (line) {
@@ -14353,7 +14574,8 @@ module.exports = function (Konva, Utils) {
             this._layer.add(indicator);
             this._indicators[line.getId()] = {
                 indicator: indicator,
-                line: line
+                line: line,
+                type: 'default'
             };
         }
     };
@@ -14369,15 +14591,18 @@ module.exports = function (Konva, Utils) {
             }
         }
     };
+    LineIndicator.prototype.getPixelsFromCenter = function (lineId) {
+        return this._indicators[lineId].type === 'default' ? 0 : this._width / 4;
+    };
     LineIndicator.prototype.updateIndicator = function (lineId) {
         if (this._indicators[lineId]) {
             var y = this._indicators[lineId].line.getY() + this._indicators[lineId].line.lineHeight() / 2;
             if (y + this._indicatorRadius > 0 && y - this._indicatorRadius < this._height) {
                 if (!this._indicators[lineId].indicator) {
-                    this._indicators[lineId].indicator = this._createIndicator(this._indicators[lineId].line);
+                    this._indicators[lineId].indicator = this._createIndicator(this._indicators[lineId].line, this._indicators[lineId].type);
                     this._layer.add(this._indicators[lineId].indicator);
                 } else {
-                    this._indicators[lineId].indicator.y(y);
+                    this._indicators[lineId].indicator.y(y - this.getPixelsFromCenter(lineId));
                 }
             } else {
                 this.removeIndicator(lineId, true);
@@ -14508,7 +14733,7 @@ module.exports = function (Konva, Utils) {
     };
     return LineIndicator;
 }(_dereq_('konva'), _dereq_('./utils'));
-},{"./utils":111,"konva":43}],92:[function(_dereq_,module,exports){
+},{"./utils":110,"konva":43}],91:[function(_dereq_,module,exports){
 module.exports = function (Konva, Utils) {
     'use strict';
     function Line(peaks, view, y, id, position) {
@@ -14971,7 +15196,7 @@ module.exports = function (Konva, Utils) {
     };
     return Line;
 }(_dereq_('konva'), _dereq_('./utils'));
-},{"./utils":111,"konva":43}],93:[function(_dereq_,module,exports){
+},{"./utils":110,"konva":43}],92:[function(_dereq_,module,exports){
 module.exports = function (SegmentsGroup, Line, LineIndicator, Utils) {
     'use strict';
     function Lines(peaks, view, layer) {
@@ -15174,6 +15399,9 @@ module.exports = function (SegmentsGroup, Line, LineIndicator, Utils) {
             }
         }
     };
+    Lines.prototype.getLineByPosition = function (pos) {
+        return this._linesByPosition[pos];
+    };
     Lines.prototype.getLineOnPosition = function (y) {
         var height;
         var pos = [
@@ -15270,7 +15498,7 @@ module.exports = function (SegmentsGroup, Line, LineIndicator, Utils) {
     };
     return Lines;
 }(_dereq_('./segments-group'), _dereq_('./line'), _dereq_('./line-indicator'), _dereq_('./utils'));
-},{"./line":92,"./line-indicator":91,"./segments-group":103,"./utils":111}],94:[function(_dereq_,module,exports){
+},{"./line":91,"./line-indicator":90,"./segments-group":102,"./utils":110}],93:[function(_dereq_,module,exports){
 module.exports = function (Colors, EventEmitter, TimelineSegments, TimelineSources, KeyboardHandler, Player, MarkerFactories, TimelineZoomView, Utils) {
     'use strict';
     function Peaks() {
@@ -15320,7 +15548,7 @@ module.exports = function (Colors, EventEmitter, TimelineSegments, TimelineSourc
             segmentMagnetThreshold: 15,
             enableVerticalScrolling: true,
             lineIndicatorWidth: 20,
-            lineIndicatorColor: 'gray',
+            lineIndicatorColor: '#8A8F98',
             lineIndicatorSelected: '#ccc',
             autoScrollThreshold: 0.05,
             enableLineIndicatorContextMenu: true,
@@ -15459,6 +15687,10 @@ module.exports = function (Colors, EventEmitter, TimelineSegments, TimelineSourc
     Peaks.prototype.setCutMode = function () {
         this.emit('cut_mode');
     };
+    Peaks.prototype.setIndicatorType = function (linePosition, type) {
+        var lineId = this.view.getLineByPosition(linePosition).getId();
+        this.emit('lineIndicator.setType', lineId, type);
+    };
     Peaks.prototype.getVisibleSegments = function () {
         return this.view.getSegmentsGroup().getVisibleSegments();
     };
@@ -15509,7 +15741,7 @@ module.exports = function (Colors, EventEmitter, TimelineSegments, TimelineSourc
     };
     return Peaks;
 }(_dereq_('colors.css'), _dereq_('eventemitter2'), _dereq_('./timeline-segments'), _dereq_('./timeline-sources'), _dereq_('./keyboard-handler'), _dereq_('./player'), _dereq_('./marker-factories'), _dereq_('./timeline-zoomview'), _dereq_('./utils'));
-},{"./keyboard-handler":90,"./marker-factories":95,"./player":98,"./timeline-segments":108,"./timeline-sources":109,"./timeline-zoomview":110,"./utils":111,"colors.css":1,"eventemitter2":2}],95:[function(_dereq_,module,exports){
+},{"./keyboard-handler":89,"./marker-factories":94,"./player":97,"./timeline-segments":107,"./timeline-sources":108,"./timeline-zoomview":109,"./utils":110,"colors.css":1,"eventemitter2":2}],94:[function(_dereq_,module,exports){
 module.exports = function (DefaultSegmentMarker, Utils, Konva) {
     'use strict';
     function createSegmentMarker(options) {
@@ -15541,7 +15773,7 @@ module.exports = function (DefaultSegmentMarker, Utils, Konva) {
         createSegmentLabel: createSegmentLabel
     };
 }(_dereq_('./default-segment-marker'), _dereq_('./utils'), _dereq_('konva'));
-},{"./default-segment-marker":88,"./utils":111,"konva":43}],96:[function(_dereq_,module,exports){
+},{"./default-segment-marker":87,"./utils":110,"konva":43}],95:[function(_dereq_,module,exports){
 module.exports = function (Utils, SourceGroup, Konva) {
     'use strict';
     var TIME_X_OFFSET = 20;
@@ -15813,7 +16045,7 @@ module.exports = function (Utils, SourceGroup, Konva) {
     };
     return ModeLayer;
 }(_dereq_('./utils'), _dereq_('./source-group'), _dereq_('konva'));
-},{"./source-group":104,"./utils":111,"konva":43}],97:[function(_dereq_,module,exports){
+},{"./source-group":103,"./utils":110,"konva":43}],96:[function(_dereq_,module,exports){
 module.exports = function (Konva) {
     'use strict';
     function getMarkerObject(obj) {
@@ -15909,7 +16141,7 @@ module.exports = function (Konva) {
     };
     return MouseDragHandler;
 }(_dereq_('konva'));
-},{"konva":43}],98:[function(_dereq_,module,exports){
+},{"konva":43}],97:[function(_dereq_,module,exports){
 module.exports = function (Utils) {
     'use strict';
     function Player(peaks) {
@@ -15993,7 +16225,7 @@ module.exports = function (Utils) {
     };
     return Player;
 }(_dereq_('./utils'));
-},{"./utils":111}],99:[function(_dereq_,module,exports){
+},{"./utils":110}],98:[function(_dereq_,module,exports){
 module.exports = function (Utils, Konva) {
     'use strict';
     var HANDLE_RADIUS = 10;
@@ -16238,7 +16470,7 @@ module.exports = function (Utils, Konva) {
     };
     return PlayheadLayer;
 }(_dereq_('./utils'), _dereq_('konva'));
-},{"./utils":111,"konva":43}],100:[function(_dereq_,module,exports){
+},{"./utils":110,"konva":43}],99:[function(_dereq_,module,exports){
 module.exports = function (Konva) {
     'use strict';
     function SegmentMarker(options) {
@@ -16324,7 +16556,7 @@ module.exports = function (Konva) {
     };
     return SegmentMarker;
 }(_dereq_('konva'));
-},{"konva":43}],101:[function(_dereq_,module,exports){
+},{"konva":43}],100:[function(_dereq_,module,exports){
 module.exports = function (Konva, SegmentMarker) {
     'use strict';
     var SEGMENT_WIDTH = 10;
@@ -16561,7 +16793,7 @@ module.exports = function (Konva, SegmentMarker) {
     };
     return SegmentShape;
 }(_dereq_('konva'), _dereq_('./segment-marker'));
-},{"./segment-marker":100,"konva":43}],102:[function(_dereq_,module,exports){
+},{"./segment-marker":99,"konva":43}],101:[function(_dereq_,module,exports){
 module.exports = function (Utils) {
     'use strict';
     function validateSegment(peaks, options, context) {
@@ -16755,7 +16987,7 @@ module.exports = function (Utils) {
     };
     return Segment;
 }(_dereq_('./utils'));
-},{"./utils":111}],103:[function(_dereq_,module,exports){
+},{"./utils":110}],102:[function(_dereq_,module,exports){
 module.exports = function (SegmentShape, Utils, Konva) {
     'use strict';
     function SegmentsGroup(peaks, view, allowEditing) {
@@ -17252,7 +17484,7 @@ module.exports = function (SegmentShape, Utils, Konva) {
     };
     return SegmentsGroup;
 }(_dereq_('./segment-shape'), _dereq_('./utils'), _dereq_('konva'));
-},{"./segment-shape":101,"./utils":111,"konva":43}],104:[function(_dereq_,module,exports){
+},{"./segment-shape":100,"./utils":110,"konva":43}],103:[function(_dereq_,module,exports){
 module.exports = function (WaveformBuilder, WaveformShape, Utils, Konva) {
     'use strict';
     var SPACING_BETWEEN_PREVIEW_AND_BORDER_RATIO = 0.15;
@@ -17957,7 +18189,7 @@ module.exports = function (WaveformBuilder, WaveformShape, Utils, Konva) {
     };
     return SourceGroup;
 }(_dereq_('./waveform-builder'), _dereq_('./waveform-shape'), _dereq_('./utils'), _dereq_('konva'));
-},{"./utils":111,"./waveform-builder":112,"./waveform-shape":113,"konva":43}],105:[function(_dereq_,module,exports){
+},{"./utils":110,"./waveform-builder":111,"./waveform-shape":112,"konva":43}],104:[function(_dereq_,module,exports){
 module.exports = function (Utils) {
     'use strict';
     function validateSource(peaks, options, context) {
@@ -18494,7 +18726,7 @@ module.exports = function (Utils) {
     };
     return Source;
 }(_dereq_('./utils'));
-},{"./utils":111}],106:[function(_dereq_,module,exports){
+},{"./utils":110}],105:[function(_dereq_,module,exports){
 module.exports = function (SourceGroup, Lines, DataRetriever, Utils, Invoker, Konva) {
     'use strict';
     function SourcesLayer(peaks, view, allowEditing) {
@@ -18839,9 +19071,12 @@ module.exports = function (SourceGroup, Lines, DataRetriever, Utils, Invoker, Ko
     SourcesLayer.prototype.getLength = function () {
         return this._lines.linesLength();
     };
+    SourcesLayer.prototype.getLineByPosition = function (pos) {
+        return this._lines.getLineByPosition(pos);
+    };
     return SourcesLayer;
 }(_dereq_('./source-group'), _dereq_('./lines'), _dereq_('./data-retriever'), _dereq_('./utils'), _dereq_('./invoker'), _dereq_('konva'));
-},{"./data-retriever":86,"./invoker":89,"./lines":93,"./source-group":104,"./utils":111,"konva":43}],107:[function(_dereq_,module,exports){
+},{"./data-retriever":85,"./invoker":88,"./lines":92,"./source-group":103,"./utils":110,"konva":43}],106:[function(_dereq_,module,exports){
 module.exports = function (Utils, Konva) {
     'use strict';
     var LEFT_PADDING = 4;
@@ -18982,7 +19217,7 @@ module.exports = function (Utils, Konva) {
     };
     return TimelineAxis;
 }(_dereq_('./utils'), _dereq_('konva'));
-},{"./utils":111,"konva":43}],108:[function(_dereq_,module,exports){
+},{"./utils":110,"konva":43}],107:[function(_dereq_,module,exports){
 module.exports = function (Colors, Segment, Utils) {
     'use strict';
     function TimelineSegments(peaks) {
@@ -19132,7 +19367,7 @@ module.exports = function (Colors, Segment, Utils) {
     };
     return TimelineSegments;
 }(_dereq_('colors.css'), _dereq_('./segment'), _dereq_('./utils'));
-},{"./segment":102,"./utils":111,"colors.css":1}],109:[function(_dereq_,module,exports){
+},{"./segment":101,"./utils":110,"colors.css":1}],108:[function(_dereq_,module,exports){
 module.exports = function (Source, Utils) {
     'use strict';
     function TimelineSources(peaks) {
@@ -19299,7 +19534,7 @@ module.exports = function (Source, Utils) {
     };
     return TimelineSources;
 }(_dereq_('./source'), _dereq_('./utils'));
-},{"./source":105,"./utils":111}],110:[function(_dereq_,module,exports){
+},{"./source":104,"./utils":110}],109:[function(_dereq_,module,exports){
 module.exports = function (MouseDragHandler, PlayheadLayer, SourcesLayer, ModeLayer, TimelineAxis, Utils, Konva) {
     'use strict';
     function TimelineZoomView(container, peaks) {
@@ -19710,6 +19945,9 @@ module.exports = function (MouseDragHandler, PlayheadLayer, SourcesLayer, ModeLa
     TimelineZoomView.prototype.getEndTime = function () {
         return this.pixelsToTime(this._frameOffset + this._width);
     };
+    TimelineZoomView.prototype.getLineByPosition = function (pos) {
+        return this._sourcesLayer.getLineByPosition(pos);
+    };
     TimelineZoomView.prototype.setStartTime = function (time) {
         if (time < 0) {
             time = 0;
@@ -19848,7 +20086,7 @@ module.exports = function (MouseDragHandler, PlayheadLayer, SourcesLayer, ModeLa
     };
     return TimelineZoomView;
 }(_dereq_('./mouse-drag-handler'), _dereq_('./playhead-layer'), _dereq_('./sources-layer'), _dereq_('./mode-layer'), _dereq_('./timeline-axis'), _dereq_('./utils'), _dereq_('konva'));
-},{"./mode-layer":96,"./mouse-drag-handler":97,"./playhead-layer":99,"./sources-layer":106,"./timeline-axis":107,"./utils":111,"konva":43}],111:[function(_dereq_,module,exports){
+},{"./mode-layer":95,"./mouse-drag-handler":96,"./playhead-layer":98,"./sources-layer":105,"./timeline-axis":106,"./utils":110,"konva":43}],110:[function(_dereq_,module,exports){
 module.exports = function (UUID) {
     'use strict';
     if (typeof Number.isFinite !== 'function') {
@@ -20012,7 +20250,7 @@ module.exports = function (UUID) {
         }
     };
 }(_dereq_('uuid'));
-},{"uuid":62}],112:[function(_dereq_,module,exports){
+},{"uuid":62}],111:[function(_dereq_,module,exports){
 module.exports = function (WaveformData, Utils) {
     'use strict';
     var isXhr2 = 'withCredentials' in new XMLHttpRequest();
@@ -20204,7 +20442,7 @@ module.exports = function (WaveformData, Utils) {
     };
     return WaveformBuilder;
 }(_dereq_('waveform-data'), _dereq_('./utils'));
-},{"./utils":111,"waveform-data":85}],113:[function(_dereq_,module,exports){
+},{"./utils":110,"waveform-data":84}],112:[function(_dereq_,module,exports){
 module.exports = function (Utils, Konva) {
     'use strict';
     function scaleY(amplitude, height, scale) {
@@ -20297,6 +20535,6 @@ module.exports = function (Utils, Konva) {
     };
     return WaveformShape;
 }(_dereq_('./utils'), _dereq_('konva'));
-},{"./utils":111,"konva":43}]},{},[94])(94)
+},{"./utils":110,"konva":43}]},{},[93])(93)
 });
 //# sourceMappingURL=peaks.js.map