java.lang.Object

processing.core.PApplet

net.paulhertz.pixelaudio.example.TutorialOne_01_FileIO

All Implemented Interfaces:: processing.core.PConstants

public class TutorialOne_01_FileIO extends processing.core.PApplet

Field Summary

Fields

Modifier and Type

Field

Description

(package private) ArrayList<ADSRParams>

adsrList

(package private) float

attackTime

(package private) File

audioFile

(package private) int

audioFileLength

(package private) String

audioFileName

(package private) String

audioFilePath

(package private) String

audioFileTag

(package private) int

audioLength

(package private) ddf.minim.AudioOutput

audioOut

(package private) float[]

audioSignal

(package private) float

bufferSampleRate

(package private) PixelAudioMapper.ChannelNames

chan

(package private) int[]

colors

(package private) int

count

(package private) float

decayTime

(package private) ADSRParams

defaultEnv

(package private) boolean

doResample

If doResample == true, resample audio from files with a sampling rate != audioOut.sampleRate().

(package private) int

fileIndex

(package private) float

fileSampleRate

(package private) int

genHeight

(package private) int

genWidth

(package private) File

imageFile

(package private) int

imageFileHeight

(package private) String

imageFileName

(package private) String

imageFilePath

(package private) String

imageFileTag

(package private) int

imageFileWidth

(package private) boolean

isBufferStale

(package private) boolean

isRandomADSR

(package private) processing.core.PImage

mapImage

(package private) PixelAudioMapper

mapper

(package private) int

mapSize

(package private) float

maxAmplitude

(package private) ddf.minim.Minim

minim

Minim audio library

(package private) MultiGen

multigen

(package private) int

noteDuration

(package private) PixelAudio

pixelaudio

(package private) ddf.minim.MultiChannelBuffer

playBuffer

(package private) float

releaseTime

(package private) int

samplelen

(package private) int

samplePos

(package private) float

sampleRate

(package private) float

sustainLevel

(package private) PASamplerInstrument

synth

(package private) ArrayList<TimedLocation>

timeLocsArray

Fields inherited from class processing.core.PApplet
args, ARGS_BGCOLOR, ARGS_DISABLE_AWT, ARGS_DISPLAY, ARGS_EDITOR_LOCATION, ARGS_EXTERNAL, ARGS_FULL_SCREEN, ARGS_HIDE_STOP, ARGS_LOCATION, ARGS_PRESENT, ARGS_SKETCH_FOLDER, ARGS_STOP_COLOR, ARGS_UI_SCALE, ARGS_WINDOW_COLOR, DEFAULT_HEIGHT, DEFAULT_WIDTH, disableAWT, displayHeight, displayWidth, dmouseX, dmouseY, emouseX, emouseY, exitCalled, EXTERNAL_MOVE, EXTERNAL_STOP, finished, firstMouse, focused, frameCount, frameRate, frameRateLastNanos, g, height, insideDraw, javaPlatform, javaVersion, javaVersionName, key, keyCode, keyEvent, keyPressed, keyRepeatEnabled, looping, matchPatterns, mouseButton, mouseEvent, mousePressed, mouseX, mouseY, pixelDensity, pixelHeight, pixels, pixelWidth, platform, pmouseX, pmouseY, ratioLeft, ratioScale, ratioTop, recorder, redraw, rheight, rmouseX, rmouseY, rwidth, surface, useNativeSelect, width, windowX, windowY

Fields inherited from interface processing.core.PConstants
ADD, ALPHA, ALT, AMBIENT, ARC, ARGB, ARROW, BACKSPACE, BASELINE, BEVEL, BEZIER_VERTEX, BLEND, BLUR, BOTTOM, BOX, BREAK, BURN, CENTER, CHATTER, CHORD, CLAMP, CLOSE, CODED, COMPLAINT, CONTROL, CORNER, CORNERS, CROSS, CURVE_VERTEX, CUSTOM, DARKEST, DEG_TO_RAD, DELETE, DIAMETER, DIFFERENCE, DILATE, DIRECTIONAL, DISABLE_ASYNC_SAVEFRAME, DISABLE_BUFFER_READING, DISABLE_DEPTH_MASK, DISABLE_DEPTH_SORT, DISABLE_DEPTH_TEST, DISABLE_KEY_REPEAT, DISABLE_NATIVE_FONTS, DISABLE_OPENGL_ERRORS, DISABLE_OPTIMIZED_STROKE, DISABLE_STROKE_PERSPECTIVE, DISABLE_STROKE_PURE, DISABLE_TEXTURE_MIPMAPS, DODGE, DOWN, DXF, ELLIPSE, ENABLE_ASYNC_SAVEFRAME, ENABLE_BUFFER_READING, ENABLE_DEPTH_MASK, ENABLE_DEPTH_SORT, ENABLE_DEPTH_TEST, ENABLE_KEY_REPEAT, ENABLE_NATIVE_FONTS, ENABLE_OPENGL_ERRORS, ENABLE_OPTIMIZED_STROKE, ENABLE_STROKE_PERSPECTIVE, ENABLE_STROKE_PURE, ENABLE_TEXTURE_MIPMAPS, ENTER, EPSILON, ERODE, ESC, EXCLUSION, FX2D, GIF, GRAY, GROUP, HALF_PI, HAND, HARD_LIGHT, HINT_COUNT, HSB, IMAGE, INVERT, JAVA2D, JPEG, LANDSCAPE, LEFT, LIGHTEST, LINE, LINE_LOOP, LINE_STRIP, LINES, LINUX, MACOS, MACOSX, MAX_FLOAT, MAX_INT, MIN_FLOAT, MIN_INT, MITER, MODEL, MODELVIEW, MOVE, MULTIPLY, NORMAL, OPAQUE, OPEN, OPENGL, ORTHOGRAPHIC, OTHER, OVERLAY, P2D, P3D, PATH, PDF, PERSPECTIVE, PI, PIE, platformNames, POINT, POINTS, POLYGON, PORTRAIT, POSTERIZE, PROBLEM, PROJECT, PROJECTION, QUAD, QUAD_BEZIER_VERTEX, QUAD_STRIP, QUADRATIC_VERTEX, QUADS, QUARTER_PI, RAD_TO_DEG, RADIUS, RECT, REPEAT, REPLACE, RETURN, RGB, RIGHT, ROUND, SCREEN, SHAPE, SHIFT, SOFT_LIGHT, SPAN, SPHERE, SPOT, SQUARE, SUBTRACT, SVG, TAB, TARGA, TAU, TEXT, THIRD_PI, THRESHOLD, TIFF, TOP, TRIANGLE, TRIANGLE_FAN, TRIANGLE_STRIP, TRIANGLES, TWO_PI, UP, VERTEX, WAIT, WHITESPACE, WINDOWS, X, Y, Z
Constructor Summary

Constructors

Constructor

Description

TutorialOne_01_FileIO()
Method Summary

Modifier and Type

Method

Description

int[]

applyColor(int[] colorSource, int[] graySource, int[] lut)

Utility method for applying hue and saturation values from a source array of RGB values to the brightness values in a target array of RGB values, using a lookup table to redirect indexing.

void

applyImageColor(File imgFile, processing.core.PImage targetImage)

Apply the hue and saturation of a chosen image file to the brightness channel of the display image.

void

audioFileSelectedWrite(File selection)

void

audioMousePressed(int x, int y)

Typically called from mousePressed with mouseX and mouseY, generates audio events.

int

calcSampleLen()

void

chooseColorImage()

Call to initiate process of opening an image file to get its color data.

void

chooseFile()

Wrapper method for Processing's selectInput command

int

clipToHeight(int y)

int

clipToWidth(int x)

void

colorFileSelected(File selectedFile)

callback method for chooseColorImage()

void

draw()

void

drawCircle(int x, int y)

Draws a circle at the location of an audio trigger (mouseDown event).

void

fileSelected(File selectedFile)

callback method for chooseFile(), handles standard audio and image formats for Processing.

int[]

getColors(int size)

Generates an array of rainbow colors using the HSB color space.

int

getSamplePos(int x, int y)

Calculate position of the image pixel within the signal path.

void

imageFileSelectedWrite(File selection)

void

initADSRList()

void

initAudio()

CALL THIS METHOD IN SETUP() Initializes Minim audio library and audio variables.

void

initImages()

Initialize mapImage with the colors array.

void

keyPressed()

built-in keyPressed handler, forwards events to parseKey

void

loadAudioFile(File audFile)

Attempts to load audio data from a selected file into playBuffer, then calls writeAudioToImage() to transcode audio data and write it to mapImage If the file does not use the default sample rate we set in initAudio(), it will still play correctly.

void

loadImageFile(File imgFile)

Attempts to load image data from a selected file into mapImage, then calls writeImageToAudio() to transcode HSB brightness color data from the image to audio and writes it to playBuffer and audioSignal.

static void

main(String[] args)

void

mouseClicked()

void

mousePressed()

The built-in mousePressed handler for Processing, not used yet...

void

parseKey(char key, int keyCode)

Handles key press events passed on by the built-in keyPressed method.

int

playSample(int samplePos, int samplelen, float amplitude)

Plays an audio sample with PASamplerInstrument and default ADSR.

int

playSample(int samplePos, int samplelen, float amplitude, ADSRParams env)

Plays an audio sample with PASamplerInstrument and custom ADSR.

void

renderSignals()

Prepares audioSignal before it is used as an instrument source.

void

runTimeArray()

Tracks and runs TimedLocation events in the timeLocsArray list, which is associated with mouse clicks that trigger audio a the click point.

void

saveAudioToFile(float[] samples, float sampleRate, String fileName)

Saves audio data to 16-bit integer PCM format, which Processing can also open.

void

saveImageToFile(processing.core.PImage img, String fileName)

void

saveToAudio()

void

saveToImage()

void

settings()

void

setup()

void

showHelp()

to generate help output, run RegEx search/replace on parseKey case lines with: // case ('.'): // (.+) // println(" * Press $1 to $2.");

void

stop()

void

writeAudioToImage(float[] sig, PixelAudioMapper mapper, processing.core.PImage img, PixelAudioMapper.ChannelNames chan)

Transcodes audio data in sig[] and writes it to color channel chan of mapImage using the lookup tables in mapper to redirect indexing.

void

writeImageToAudio(processing.core.PImage img, PixelAudioMapper mapper, float[] sig, PixelAudioMapper.ChannelNames chan)

This method writes a color channel from the an image to playBuffer, fulfilling a central concept of the PixelAudio library: image is sound.

Methods inherited from class processing.core.PApplet
abs, abs, acos, alpha, ambient, ambient, ambient, ambientLight, ambientLight, append, append, append, append, append, append, applyMatrix, applyMatrix, applyMatrix, applyMatrix, applyMatrix, arc, arc, arraycopy, arraycopy, arraycopy, arrayCopy, arrayCopy, arrayCopy, asin, atan, atan2, attrib, attrib, attrib, attribColor, attribNormal, attribPosition, background, background, background, background, background, background, background, beginCamera, beginContour, beginPGL, beginRaw, beginRaw, beginRecord, beginRecord, beginShape, beginShape, bezier, bezier, bezierDetail, bezierPoint, bezierTangent, bezierVertex, bezierVertex, binary, binary, binary, binary, blend, blend, blendColor, blendMode, blue, box, box, brightness, calcSketchPath, camera, camera, ceil, checkAlpha, checkExtension, choice, choice, circle, clear, clip, color, color, color, color, color, color, color, color, colorMode, colorMode, colorMode, colorMode, concat, concat, concat, concat, concat, concat, concat, constrain, constrain, copy, copy, copy, cos, createFont, createFont, createFont, createGraphics, createGraphics, createGraphics, createImage, createInput, createInput, createInputRaw, createOutput, createOutput, createPath, createPath, createPrimaryGraphics, createReader, createReader, createReader, createShape, createShape, createShape, createWriter, createWriter, createWriter, cursor, cursor, cursor, cursor, curve, curve, curveDetail, curvePoint, curveTangent, curveTightness, curveVertex, curveVertex, dataFile, dataPath, day, debug, degrees, delay, dequeueEvents, desktopFile, desktopPath, die, die, directionalLight, displayDensity, displayDensity, dispose, dist, dist, edge, ellipse, ellipseMode, emissive, emissive, emissive, endCamera, endContour, endPGL, endRaw, endRecord, endShape, endShape, exec, exec, exit, exitActual, exitCalled, exp, expand, expand, expand, expand, expand, expand, expand, expand, expand, expand, expand, expand, expand, expand, expand, expand, expand, expand, fill, fill, fill, fill, fill, fill, filter, filter, filter, floor, flush, focusGained, focusLost, frameMoved, frameRate, frustum, fullScreen, fullScreen, fullScreen, fullScreen, get, get, get, getExtension, getGraphics, getMatrix, getMatrix, getMatrix, getSurface, green, handleDraw, handleKeyEvent, handleMethods, handleMouseEvent, hex, hex, hex, hex, hideMenuBar, hint, hour, hue, image, image, image, imageMode, initSurface, insertFrame, isLooping, join, join, keyPressed, keyReleased, keyReleased, keyTyped, keyTyped, launch, lerp, lerpColor, lerpColor, lightFalloff, lights, lightSpecular, line, line, link, listFiles, listFiles, listPaths, loadBytes, loadBytes, loadBytes, loadFont, loadImage, loadImage, loadJSONArray, loadJSONArray, loadJSONObject, loadJSONObject, loadPixels, loadShader, loadShader, loadShape, loadShape, loadStrings, loadStrings, loadStrings, loadStrings, loadTable, loadTable, loadXML, loadXML, log, loop, mag, mag, main, main, main, makeGraphics, map, mask, match, matchAll, max, max, max, max, max, max, method, millis, min, min, min, min, min, min, minute, modelX, modelY, modelZ, month, mouseClicked, mouseDragged, mouseDragged, mouseEntered, mouseEntered, mouseExited, mouseExited, mouseMoved, mouseMoved, mousePressed, mouseReleased, mouseReleased, mouseWheel, mouseWheel, nf, nf, nf, nf, nf, nf, nfc, nfc, nfc, nfc, nfp, nfp, nfp, nfp, nfs, nfs, nfs, nfs, noClip, noCursor, noFill, noise, noise, noise, noiseDetail, noiseDetail, noiseSeed, noLights, noLoop, norm, normal, noSmooth, noStroke, noTexture, noTint, orientation, ortho, ortho, ortho, parseBoolean, parseBoolean, parseBoolean, parseBoolean, parseByte, parseByte, parseByte, parseByte, parseByte, parseByte, parseByte, parseByte, parseChar, parseChar, parseChar, parseChar, parseFloat, parseFloat, parseFloat, parseFloat, parseFloat, parseFloat, parseFloat, parseInt, parseInt, parseInt, parseInt, parseInt, parseInt, parseInt, parseInt, parseInt, parseInt, parseInt, parseInt, parseJSONArray, parseJSONObject, parseXML, parseXML, pause, perspective, perspective, pixelDensity, point, point, pointLight, pop, popMatrix, popStyle, postEvent, postWindowMoved, postWindowResized, pow, print, print, print, print, print, print, print, print, print, printArray, printCamera, println, println, println, println, println, println, println, println, println, println, println, printMatrix, printProjection, printStackTrace, push, pushMatrix, pushStyle, quad, quadraticVertex, quadraticVertex, radians, random, random, randomGaussian, randomSeed, rect, rect, rect, rectMode, red, redraw, registerMethod, requestImage, requestImage, resetMatrix, resetShader, resetShader, resume, reverse, reverse, reverse, reverse, reverse, reverse, reverse, rotate, rotate, rotateX, rotateY, rotateZ, round, runSketch, runSketch, runSketch, saturation, save, saveBytes, saveBytes, saveBytes, saveFile, saveFrame, saveFrame, saveJSONArray, saveJSONArray, saveJSONObject, saveJSONObject, savePath, saveStream, saveStream, saveStream, saveStream, saveStream, saveStrings, saveStrings, saveStrings, saveTable, saveTable, saveXML, saveXML, scale, scale, scale, screenX, screenX, screenY, screenY, screenZ, second, selectCallback, selectFolder, selectFolder, selectFolder, selectInput, selectInput, selectInput, selectOutput, selectOutput, selectOutput, set, set, setMatrix, setMatrix, setMatrix, setSize, shader, shader, shape, shape, shape, shapeMode, shearX, shearY, shell, shininess, shorten, shorten, shorten, shorten, shorten, shorten, shorten, showDepthWarning, showDepthWarningXYZ, showMethodWarning, showMissingWarning, showSurface, showVariationWarning, sin, size, size, size, sketchDisplay, sketchFile, sketchFullScreen, sketchHeight, sketchOutputPath, sketchOutputStream, sketchPath, sketchPath, sketchPixelDensity, sketchRenderer, sketchSmooth, sketchWidth, sketchWindowColor, smooth, smooth, sort, sort, sort, sort, sort, sort, sort, sort, sort, sort, specular, specular, specular, sphere, sphereDetail, sphereDetail, splice, splice, splice, splice, splice, splice, splice, splice, splice, splice, splice, splice, splice, split, split, splitTokens, splitTokens, spotLight, sq, sqrt, square, start, startSurface, str, str, str, str, str, str, str, str, str, str, stroke, stroke, stroke, stroke, stroke, stroke, strokeCap, strokeJoin, strokeWeight, style, subset, subset, subset, subset, subset, subset, subset, subset, subset, subset, subset, subset, subset, subset, subset, subset, subset, subset, tan, text, text, text, text, text, text, text, text, text, text, text, textAlign, textAlign, textAscent, textDescent, textFont, textFont, textLeading, textMode, textSize, texture, textureMode, textureWrap, textWidth, textWidth, textWidth, thread, tint, tint, tint, tint, tint, tint, translate, translate, triangle, trim, trim, unbinary, unhex, unregisterMethod, updatePixels, updatePixels, urlDecode, urlEncode, vertex, vertex, vertex, vertex, vertex, windowMove, windowMoved, windowRatio, windowResizable, windowResize, windowResized, windowTitle, year

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details
- pixelaudio
  
  PixelAudio pixelaudio
- multigen
  
  MultiGen multigen
- genWidth
  
  int genWidth
- genHeight
  
  int genHeight
- mapper
  
  PixelAudioMapper mapper
- mapSize
  
  int mapSize
- mapImage
  
  processing.core.PImage mapImage
- chan
  
  PixelAudioMapper.ChannelNames chan
- colors
  
  int[] colors
- audioFile
  
  File audioFile
- audioFilePath
  
  String audioFilePath
- audioFileName
  
  String audioFileName
- audioFileTag
  
  String audioFileTag
- audioFileLength
  
  int audioFileLength
- imageFile
  
  File imageFile
- imageFilePath
  
  String imageFilePath
- imageFileName
  
  String imageFileName
- imageFileTag
  
  String imageFileTag
- imageFileWidth
  
  int imageFileWidth
- imageFileHeight
  
  int imageFileHeight
- doResample
  
  boolean doResample
  
  If doResample == true, resample audio from files with a sampling rate != audioOut.sampleRate(). For PixelAudio applications where we want the display pixels to correspond to the audio samples, we should always resample. We'll do it automatically in most example code.
- minim
  
  ddf.minim.Minim minim
  
  Minim audio library
- audioOut
  
  ddf.minim.AudioOutput audioOut
- isBufferStale
  
  boolean isBufferStale
- sampleRate
  
  float sampleRate
- fileSampleRate
  
  float fileSampleRate
- bufferSampleRate
  
  float bufferSampleRate
- audioSignal
  
  float[] audioSignal
- playBuffer
  
  ddf.minim.MultiChannelBuffer playBuffer
- samplePos
  
  int samplePos
- audioLength
  
  int audioLength
- noteDuration
  
  int noteDuration
- samplelen
  
  int samplelen
- synth
  
  PASamplerInstrument synth
- defaultEnv
  
  ADSRParams defaultEnv
- maxAmplitude
  
  float maxAmplitude
- attackTime
  
  float attackTime
- decayTime
  
  float decayTime
- sustainLevel
  
  float sustainLevel
- releaseTime
  
  float releaseTime
- adsrList
  
  ArrayList<ADSRParams> adsrList
- isRandomADSR
  
  boolean isRandomADSR
- timeLocsArray
  
  ArrayList<TimedLocation> timeLocsArray
- count
  
  int count
- fileIndex
  
  int fileIndex
Constructor Details
- TutorialOne_01_FileIO
  
  public TutorialOne_01_FileIO()
Method Details
- main
  
  public static void main(String[] args)
  
  Parameters:
  
  args -
- settings
  
  public void settings()
  
  Overrides:
  
  settings in class processing.core.PApplet
- setup
  
  public void setup()
  
  Overrides:
  
  setup in class processing.core.PApplet
- stop
  
  public void stop()
  
  Overrides:
  
  stop in class processing.core.PApplet
- getColors
  
  public int[] getColors(int size)
  
  Generates an array of rainbow colors using the HSB color space.
  
  Parameters:
  
  size - the number of entries in the colors array
  
  Returns:
  
  an array of RGB colors ordered by hue
- initImages
  
  public void initImages()
  
  Initialize mapImage with the colors array. MapImage will handle the color data for mapper and also serve as our display image.
- draw
  
  public void draw()
  
  Overrides:
  
  draw in class processing.core.PApplet
- mousePressed
  
  public void mousePressed()
  
  The built-in mousePressed handler for Processing, not used yet...
  
  Overrides:
  
  mousePressed in class processing.core.PApplet
- mouseClicked
  
  public void mouseClicked()
  
  Overrides:
  
  mouseClicked in class processing.core.PApplet
- keyPressed
  
  public void keyPressed()
  
  built-in keyPressed handler, forwards events to parseKey
  
  Overrides:
  
  keyPressed in class processing.core.PApplet
- parseKey
  
  public void parseKey(char key, int keyCode)
  
  Handles key press events passed on by the built-in keyPressed method. By moving key event handling outside the built-in keyPressed method, we make it possible to post key commands without an actual key event. Methods and interfaces and even other threads can call parseKey(). This opens up many possibilities and a some risks, too.
  
  Parameters:
  
  key -
  
  keyCode -
- showHelp
  
  public void showHelp()
  
  to generate help output, run RegEx search/replace on parseKey case lines with: // case ('.'): // (.+) // println(" * Press $1 to $2.");
- applyColor
  
  public int[] applyColor(int[] colorSource, int[] graySource, int[] lut)
  
  Utility method for applying hue and saturation values from a source array of RGB values to the brightness values in a target array of RGB values, using a lookup table to redirect indexing.
  
  Parameters:
  
  colorSource - a source array of RGB data from which to obtain hue and saturation values
  
  graySource - an target array of RGB data from which to obtain brightness values
  
  lut - a lookup table, must be the same size as colorSource and graySource
  
  Returns:
  
  the graySource array of RGB values, with hue and saturation values changed
  
  Throws:
  
  IllegalArgumentException - if array arguments are null or if they are not the same length
- chooseColorImage
  
  public void chooseColorImage()
  
  Call to initiate process of opening an image file to get its color data.
- colorFileSelected
  
  public void colorFileSelected(File selectedFile)
  
  callback method for chooseColorImage()
  
  Parameters:
  
  selectedFile - the File the user selected
- applyImageColor
  
  public void applyImageColor(File imgFile, processing.core.PImage targetImage)
  
  Apply the hue and saturation of a chosen image file to the brightness channel of the display image.
  
  Parameters:
  
  imgFile - selected image file, source of hue and saturation values
  
  targetImage - target image where brightness will remain unchanged
- chooseFile
  
  public void chooseFile()
  
  Wrapper method for Processing's selectInput command
- fileSelected
  
  public void fileSelected(File selectedFile)
  
  callback method for chooseFile(), handles standard audio and image formats for Processing. If a file has been successfully selected, continues with a call to loadAudioFile() or loadImageFile().
  
  Parameters:
  
  selectedFile - the File the user selected
- loadAudioFile
  
  public void loadAudioFile(File audFile)
  
  Attempts to load audio data from a selected file into playBuffer, then calls writeAudioToImage() to transcode audio data and write it to mapImage If the file does not use the default sample rate we set in initAudio(), it will still play correctly. If we set doResample = true the file will be resampled to audioOut.sampleRate(), if necessary. In most PixelAudio examples, we provide built-in resampling.
  
  Parameters:
  
  audFile - an audio file
- writeAudioToImage
  
  public void writeAudioToImage(float[] sig, PixelAudioMapper mapper, processing.core.PImage img, PixelAudioMapper.ChannelNames chan)
  
  Transcodes audio data in sig[] and writes it to color channel chan of mapImage using the lookup tables in mapper to redirect indexing. Calls mapper.mapSigToImg(), which will throw an IllegalArgumentException if sig.length != img.pixels.length or sig.length != mapper.getSize().
  
  Parameters:
  
  sig - an array of float, should be audio data in the range [-1.0, 1.0]
  
  mapper - a PixelAudioMapper
  
  img - a PImage
  
  chan - a color channel
- loadImageFile
  
  public void loadImageFile(File imgFile)
  
  Attempts to load image data from a selected file into mapImage, then calls writeImageToAudio() to transcode HSB brightness color data from the image to audio and writes it to playBuffer and audioSignal.
  
  Parameters:
  
  imgFile - an image file
- writeImageToAudio
  
  public void writeImageToAudio(processing.core.PImage img, PixelAudioMapper mapper, float[] sig, PixelAudioMapper.ChannelNames chan)
  
  This method writes a color channel from the an image to playBuffer, fulfilling a central concept of the PixelAudio library: image is sound. Calls mapper.mapImgToSig(), which will throw an IllegalArgumentException if img.pixels.length != sig.length or img.width * img.height != mapper.getWidth() * mapper.getHeight().
  
  Parameters:
  
  img - a PImage, a source of data
  
  mapper - a PixelAudioMapper, handles mapping between image and audio signal
  
  sig - an target array of float in audio format
  
  chan - a color channel
- saveToAudio
  
  public void saveToAudio()
- audioFileSelectedWrite
  
  public void audioFileSelectedWrite(File selection)
- saveAudioToFile
  
  public void saveAudioToFile(float[] samples, float sampleRate, String fileName) throws IOException, UnsupportedAudioFileException
  
  Saves audio data to 16-bit integer PCM format, which Processing can also open. This same method can be called as a static method in PixelAudio.
  
  Parameters:
  
  samples - an array of floats in the audio range (-1.0f, 1.0f)
  
  sampleRate - audio sample rate for the file
  
  fileName - name of the file to save to
  
  Throws:
  
  IOException - an Exception you'll need to handle to call this method
  
  UnsupportedAudioFileException - another Exception
- saveToImage
  
  public void saveToImage()
- imageFileSelectedWrite
  
  public void imageFileSelectedWrite(File selection)
- saveImageToFile
  
  public void saveImageToFile(processing.core.PImage img, String fileName)
- initAudio
  
  public void initAudio()
  
  CALL THIS METHOD IN SETUP() Initializes Minim audio library and audio variables.
- initADSRList
  
  public void initADSRList()
- renderSignals
  
  public void renderSignals()
  
  Prepares audioSignal before it is used as an instrument source. Modify as needed to prepare your audio signal data.
- audioMousePressed
  
  public void audioMousePressed(int x, int y)
  
  Typically called from mousePressed with mouseX and mouseY, generates audio events.
  
  Parameters:
  
  x - x-coordinate within a PixelAudioMapper's width
  
  y - y-coordinate within a PixelAudioMapper's height
- clipToWidth
  
  public int clipToWidth(int x)
  
  Parameters:
  
  x - a value to constrain to the current window width
  
  Returns:
  
  the constrained value
- clipToHeight
  
  public int clipToHeight(int y)
  
  Parameters:
  
  y - a value to constrain to the current window height
  
  Returns:
  
  the constrained value
- getSamplePos
  
  public int getSamplePos(int x, int y)
  
  Calculate position of the image pixel within the signal path. When we add animation in TutorialOne_03_Animation and windowed buffering in MusicBoxBuffer, this gets more complicated.
- playSample
  
  public int playSample(int samplePos, int samplelen, float amplitude, ADSRParams env)
  
  Plays an audio sample with PASamplerInstrument and custom ADSR.
  
  Parameters:
  
  samplePos - position of the sample in the audio buffer
  
  samplelen - length of the sample (will be adjusted)
  
  amplitude - amplitude of the sample on playback
  
  adsr - an ADSR envelope for the sample
  
  Returns:
  
  the calculated sample length in samples
- playSample
  
  public int playSample(int samplePos, int samplelen, float amplitude)
  
  Plays an audio sample with PASamplerInstrument and default ADSR.
  
  Parameters:
  
  samplePos - position of the sample in the audio buffer
  
  samplelen - length of the sample (will be adjusted)
  
  amplitude - amplitude of the sample on playback
  
  Returns:
  
  the calculated sample length in samples
- calcSampleLen
  
  public int calcSampleLen()
- runTimeArray
  
  public void runTimeArray()
  
  Tracks and runs TimedLocation events in the timeLocsArray list, which is associated with mouse clicks that trigger audio a the click point.
- drawCircle
  
  public void drawCircle(int x, int y)
  
  Draws a circle at the location of an audio trigger (mouseDown event).
  
  Parameters:
  
  x - x coordinate of circle
  
  y - y coordinate of circle

Class TutorialOne_01_FileIO

Field Summary

Fields inherited from class processing.core.PApplet

Fields inherited from interface processing.core.PConstants

Constructor Summary

Method Summary

Methods inherited from class processing.core.PApplet

Methods inherited from class java.lang.Object

Field Details

pixelaudio

multigen

genWidth

genHeight

mapper

mapSize

mapImage

chan

colors

audioFile

audioFilePath

audioFileName

audioFileTag

audioFileLength

imageFile

imageFilePath

imageFileName

imageFileTag

imageFileWidth

imageFileHeight

doResample

minim

audioOut

isBufferStale

sampleRate

fileSampleRate

bufferSampleRate

audioSignal

playBuffer

samplePos

audioLength

noteDuration

samplelen

synth

defaultEnv

maxAmplitude

attackTime

decayTime

sustainLevel

releaseTime

adsrList

isRandomADSR

timeLocsArray

count

fileIndex

Constructor Details

TutorialOne_01_FileIO

Method Details

main

settings

setup

stop

getColors

initImages

draw

mousePressed

mouseClicked

keyPressed

parseKey

showHelp

applyColor

chooseColorImage

colorFileSelected

applyImageColor

chooseFile

fileSelected

loadAudioFile

writeAudioToImage

loadImageFile

writeImageToAudio

saveToAudio