Name

play()

Class

SoundFile

Description

Starts the playback of the soundfile. Only plays to the end of the audiosample once. If cue() or pause() were called previously, playback will resume from the cued position.

Examples

  • import processing.sound.*;
    SoundFile file;
    
    void setup() {
      size(640, 360);
      background(255);
        
      // Load a soundfile from the /data folder of the sketch and play it back
      file = new SoundFile(this, "sample.mp3");
      file.play();
    }
    
    void draw() {
    }
    

Syntax

  • soundfile.play()
  • soundfile.play(rate)
  • soundfile.play(rate, amp)
  • soundfile.play(rate, pos, amp)
  • soundfile.play(rate, pos, amp, add)
  • soundfile.play(rate, pos, amp, add, cue)

Parameters

  • rate(float)relative playback rate to use. 1 is the original speed. 0.5 is half speed and one octave down. 2 is double the speed and one octave up.
  • pos(float)the panoramic position of this sound unit from -1.0 (left) to 1.0 (right). Only works for mono soundfiles!
  • amp(float)the desired playback amplitude of the audiosample as a value from 0.0 (complete silence) to 1.0 (full volume)
  • add(float)offset the output of the generator by the given value
  • cue(float)position in the audiosample that playback should start from, in seconds.

Return

  • void