# processing-sound

**Repository Path**: wayseek/processing-sound

## Basic Information

- **Project Name**: processing-sound
- **Description**: No description available
- **Primary Language**: 其他
- **License**: LGPL-2.1
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-02-26
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Processing Sound library

The new Sound library for Processing 3 provides a simple way to work with audio. It can play, analyze, and synthesize sound. The library comes with a collection of oscillators for basic wave forms, a variety of noise generators, and effects and filters to alter sound files and other generated sounds. The syntax is minimal to make it easy for beginners who want a straightforward way to add some sound to their Processing sketches!

### How to use

The easiest way to install the Sound library is through Processing's Contribution Manager. The library comes with many example sketches, the full online reference can be found [here](https://www.processing.org/reference/libraries/sound/).

Please report bugs [on the Github issues page](https://github.com/processing/processing-sound/issues). Advanced users can also have a look at the library's full JavaDoc documentation [here](https://processing.github.io/processing-sound/index.html?processing/sound/package-summary.html).

For detailed changelogs and to download older releases, have a look at the [Github releases page](https://github.com/processing/processing-sound/releases).

### Known issues

[`SoundFile`](https://processing.org/reference/libraries/sound/SoundFile.html) class for loading audio data from disk:
* Currently no support for decoding WAV files that are in compressed formats such as 8bit unsigned (see [#15](/../../issues/15))
* MP3 decoding is extremely slow on ARM processors (Android and Raspberry Pi). Since all audio samples loaded by the library end up being stored as raw uncompressed data in RAM anyway, we generally recommend using WAV files for loading audio samples from disk
* Some MP3 files with meta-information (especially where large amounts of data such as the album cover image is stored in the ID3 header) fail to load (see [#32](/../../issues/32))

### How to build

1. `git clone git@github.com:processing/processing-sound.git`
2. (optional: copy (or soft-link) `processing-core.zip` from your local [Processing for Android mode](https://github.com/processing/processing-android/releases/tag/latest) as well as your Android SDK's `android.jar`, API level 26 or higher, into the `library/` folder. If you don't do this, these will be downloaded from GitHub instead. Note that as of version 2.2 the sound library is compiled against Processing's Android mode rather than the normal Processing `core.jar` in order to more smoothly support `AudioIn` on Android. Other dependencies, in particular Phil Burk's [JSyn](http://www.softsynth.com/jsyn/) engine on which this library is based, are also all downloaded automatically by ant.)
3. `ant dist` (or, alternatively, run `build.xml` from within Eclipse)

The resulting `sound.zip` can be extracted into your Processing installation's `libraries/` folder.

### License

LGPL v2.1