Beta Release Notes
V16.5.14 - 12/16/2012 Beta
- Added crossfading capability to the sample data queue. You can smooth the transition from one queue data block to another. This is handy if you are queuing arbitrary pieces of sample. Call the setCrossFadeIn() method of the QueueDataCommand.
- Added setImmediate(flag) method to QueueDataCommand. If true then the queue will be cleared and this item will be started immediately. It is better to use this flag than to clear the queue from the application because there could be a gap before the next item is available. This is most useful when combined with setCrossFadeIn().
- When stopping the synthesizer, the audio thread is interrupted. This should result in a quicker shutdown of the synth.
- Prevent some uninformative NullPointerExceptions that could occur if the audio device initialization failed.
V16.5.6 - 10/8/12 Beta
- IMPORTANT: SampleLoader.loadFloatSample() no longer throws a javax.sound.sampled.UnsupportedAudioFileException. That is a JavaSound exception. In order to support JSyn on Android we are eliminating references to JavaSound classes from the API. You may need to eliminate it from your catch clauses. Please do not distribute this JAR file with an existing application without testing sample file loading.
- Added custom audio file parsing to replace the JavaSound file parser. If you need to use the old JavaSound SampleLoader then call SampleLoader.setJavaSoundPreferred(true).
- Added support for 32-bit floating point WAV and AIF files.
- Read sample markers and cues and set the sustain loop accordingly.
V16.5.4 - 9/5/12 Beta
- Fix problem with default invalid input device when using JPortAudio.
V16.5.3 - 9/4/12 Beta
- Added support for JPortAudio, an alternative to JavaSound for audio I/O. JPortAudio allows you to use multi-channel devices, and also eliminates the annoying clicks on Mac caused by JavaSound.
V16.5.1 - 6/2/12 Beta
- Fixed crash in PowerOfTwo when input is -1.5308084989341915E-17. Added extra guard point.
- Added setEnabled(false) in WaveShapingVoice so it starts off not using any CPU.
- Rewired SubtractiveSynthVoice so that it does not use any CPU when the envelope finishes.
- Print a more informative error if the user forgets to add a unit to the synth.
V16.5.0 - 4/28/12 Beta
- Added PitchDetector that uses a sample based auto-correlation technique.
- Completely modified API for VoiceAllocator. There is no longer a VoiceFactory. Instead you pass an array of pre-instantiated UnitVoices to the VoiceAllocator constructor. VoiceAllocator now supports referencing of voices allocated in the future by an integer tag. Added methods noteOn(), noteOff(), allNotesOff(), setPort().
- WaveShapingVoice now has a built in Chebyshev polynomial table so it can be used for playing notes.
- Added VoiceDescription, Instrument interface, InstrumentBrowser.
- Added InstrumentTester app.
- Big changes to Ports. I removed UnitValuePort because it was a bad legacy from the old JSyn. There are now some port interfaces including ConnectableInput, ConnectableOutput, GettablePort, SettablePort. These are mostly internal changes and should not affect you. Let me know if they do.
- Add ASCIIMusicKeyboard. It is a KeyListener that makes it very easy to play notes using the ASCII keyboard of a computer. Handy for testing instruments or for Applets.
There were several code breaking API changes this time. Note that this is a beta version and we are tuning the API. We will try to reduce code breaking changes but we also don't want to get stuck with a funky API.
- UnitVoice has several new methods. Also the noteOn() parameter order changed.
- UnitSink now has a start() method.
- UnitGenerator getPorts() now returns Collection<UnitPort> instead of an old style Enumeration.
- VoiceAllocator no longer uses a factory.
- Clave is now a preset of DrumWoodFM.
V16.4.6 - 2/14/12 Beta
- Fixed SampleLoader.loadFloatSample(file). It mangled the data when loading stereo samples.
- Changed the function port of FunctionOscillator from protected to public.
- Fix race condition that could occur when circuits were nested. It would cause code to get executed multiple times resulting in distortion.
V16.4.4 - 8/29/11 Beta
- Many binary operator unit gens like Subtract now extend UnitBinaryOperator. If you are using the new JSyn API then you will need to recompile with the new JAR file!
- Added lots more JavaDocs and some online docs.
- The GrainSource method next() no longer takes the envelope parameter.
- Fixed range of PseudoRandom.random(). Was negative!
- Fixed a bug in VoiceAllocator that could cause allocate() to return a null voice.
V16.4.3 - 6/19/11 Beta
- Use higher suggested latency by default on Windows platforms to prevent glitching.
- Improved AudioScope. Added AUTO trigger mode and auto scaling.
- VariableRateMonoReader and VariableRateStereoReader are now subclasses of VariableRateDataReader.
- GrainFarm - experimental granular synthesis engine. In progress. API likely to change.
- JAR file is now a double-clickable application that shows the version and lets you play some sine waves.
V16.4.2 - 5/3/11 Beta
- Fixed NullPointerException if table not set in wave-shaper.
- Added example for ChebyshevSong.
- Changed name of FunctionLookup unit to FunctionEvaluator.
- Changed name of Function.lookup() to Function.evaluate().
V16.4.1 - 5/1/11 Beta
- Fixed problem with array index out of bounds when using audio input.
- Added JSyn.createSynthesizer() method.
- Renamed sample and envelope readers. Use VariableRateMonoReader to play envelopes or samples or both.
- Released autodocs.
- Added queueLoop() method.
- Added finite loop counts for queueLoop.
- Removed FLAG_LOOP_IF_LAST and other old fashioned bit flags. Use queueLoop instead.
- Add UnitDataQueueCallback and QueueDataCommand for notification of queue events.
V16.3 - 10/19/10 Beta
- New proposed package hierarchy to match migration document.
- Added missing connect() methods.
- Fixed disconnect(). Was connecting!
- Preparation for API release.
V16.1 - 6/23/10 Beta
- Fix problem with getDefaultOutputDevice() returning -1 and causing an ArrayIndexOutOfBoundsException.
V16.0 - 4/5/10 Beta
- Fixed problem with oscillator frequencies that are outside the Nyquist range. They are now clipped to the Nyquist frequency, which is half the sample rate. This fixes a problem with some Rhythmicon voices.
V15.9 - 4/3/10 Beta
- Fixed problem in stereo sample players that was causing NoSuchElementException and a missing right channel.
V15.8 3/27/10 Beta
- Replaced peekLast() method that was causing a NoSuchMethodError is JSyn was used with Java 1.5. Apparently peekLast() was added for Java 1.6.
- Check for user's overindexing of port parts before sending asynchronous command to engine. Now the exception will be thrown in the user code. This makes it easier to debug.
V15.7 3/24/10 Beta
- Fixed a race condition bug that caused NullPointerException at (ThingTable.java:99). It could happen if multiple threads were creating and deleting Synth resources like units, envelopes, samples, etc.
- Implemented Synth.FLAG_SKIP_IF_OTHERS
V15.7 3/7/10 Beta
- Detect and report error if mono samples played on stereo sample players or vice versa. That could cause NoSuchElementException in UnitDataQueuePort.checkBlock().
V15.5 3/4/10 Beta
- Fixed high pitch whine that was sometimes heard when stopping a SynthCircuit.
- Added proper clipping to audio output.
- Fix bug that caused interference between multiple Applets running at the same time.
- Fixed race condition when stopping units that could cause ConcurrencyModificationException.
- There is a known problem on Mac with random clicking. This appears to be a JavaSound bug. It does not happen on Windows.
V15.4 1/6/10 Beta
- Fixed speed of LinearLag.
- Fixed spontaneous autoStop in SampleReader_16V1.
- Support loading Wire patches.
- Usage now works.
- Support getMin() and getMax() for ports by setting a port signal type. The setSignalType() method is deprecated, just a stub, no longer needed.
V15.3 12/15/09 Beta
- All unit generators are converted.
- Should match the old JSyn except for the following:
- CPU performance will be lower because it is not native code.
- Latency will be higher because of Java and JavaSound.
- The SynthPort "signal types" are not implemented. It only made sense for old fixed-point DSP architectures.
- Applets that use audio input will need to be signed using a digital certificate!