Back
Class   Sample
   
Name  

read()

   
Examples  
// Populate the data[] array with sample data. 
// Notes: Make sure to include the specified audio file in your project's 'data' folder. 
 
Sample mySample; 
 
float[] data; 
void setup() { 
  size(100,100); 
  Sonia.start(this); 
  mySample = new Sample("sine.aiff"); 
  data = new float[mySample.getNumFrames()]; //creates a new array the length of the sample 
  mySample.read(data); 
} 
 
public void stop(){ 
  Sonia.stop(); 
  super.stop(); 
} 

Description   Populates an array with the data from a mono sample (use readChannel() for stereo samples). The sample data comes in floats of -1.0 to 1.0 per frame. A 44.1 kHz sample has 44100 frames per second.
   
Syntax  
mySample.read(dataArray)   // reads entire sample into the data array.
mySample.read(dataArray, firstDataFrame, firstSampleFrame, numFrames)
   
Parameters  
dataArray   float[]: an array that can hold float values

firstDataFrame   int: First index element to populate in the data[] array

firstSampleFrame   int: First sample frame to read

numFrames   int: number of sample frames to read

   
Returns   None
   
Usage   Web & Application
   
Related   readChannel()
write()
writeChannel()