org.jsynthlib.synthdrivers.BehringerVAmp2

Class VAmp2Converter

java.lang.Object

org.jsynthlib.device.model.AbstractDriver

org.jsynthlib.device.model.Converter

org.jsynthlib.synthdrivers.BehringerVAmp2.VAmp2Converter

All Implemented Interfaces:

IConverter, IDriver

public class VAmp2Converter
extends Converter

Removes "Garbage Data" from response to dump request and extracts desired patch. When responding to a sysex data dump request, the device sometimes sends a single sysex message and sometimes it sends a block of multiple messages along with garbage data (the behavior is unpredictable). The last valid sysex message sent is always the one we are interested in but it can be preceded or succeeded with other garbage data. This converter will attempt to parse out the last FCB patch in the block and discard the rest of the data.

Author:

Jeff Weber

Field Summary

Fields inherited from class org.jsynthlib.device.model.AbstractDriver

bankNumbers, checksumEnd, checksumOffset, checksumStart, deviceIDoffset, numSysexMsgs, patchNameSize, patchNameStart, patchNumbers, patchSize, sysexID, sysexRequestDump, trimSize

Method Summary

Modifier and Type	Method and Description
Patch[]	extractPatch(Patch p) Extracts a V-Amp 2 patch from a V-Amp 2 patch dump response (block of data).
boolean	supportsPatch(String patchString, byte[] sysex) Extracts the last valid patch in a dump request and validates it.

Methods inherited from class org.jsynthlib.device.model.Converter

createPatches, editPatch, getPatchName, hasEditor, isBankDriver, isConverter, isSingleDriver, setPatchName, storePatch

Methods inherited from class org.jsynthlib.device.model.AbstractDriver

calculateChecksum, calculateChecksum, calculateChecksum, canCreatePatch, createNewPatch, createPatch, createPatch, createPatches, generateNumbers, getAuthors, getBankNumbers, getChannel, getChecksumEnd, getChecksumOffset, getChecksumStart, getDevice, getDeviceID, getDeviceIDoffset, getManufacturerName, getModelName, getPatchFactory, getPatchNameSize, getPatchNameStart, getPatchNumbers, getPatchSize, getPatchType, getSynthName, getSysexID, getSysexRequestDump, getTrimSize, playPatch, requestPatchDump, send, send, send, send, sendPatch, sendPatchWorker, setBankNum, setBankNumbers, setChecksumEnd, setChecksumOffset, setChecksumStart, setDevice, setDeviceIDoffset, setPatchNameSize, setPatchNameStart, setPatchNum, setPatchNumbers, setPatchSize, setSysexID, setSysexRequestDump, setTrimSize, toString, trimSysex

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

supportsPatch

public boolean supportsPatch(String patchString,
                             byte[] sysex)

Extracts the last valid patch in a dump request and validates it. Note that supportsPatch does not convert the patch. It only attempts to parse out the last patch of a block of data and compare the header to the V-Amp 2 header bytes. The job of actually converting the patch is handled by extractPatch. If supportsPatch returns true, JSynthLib Core will call extractPatch.

Specified by:

supportsPatch in interface IDriver

Overrides:

supportsPatch in class AbstractDriver

Parameters:

patchString - String representing the patch header & identifying information of a driver.

sysex - Byte array containing the sysex data.

Returns:

Boolean representing if the patch is supported by this driver. A value of true indicates the patch is supported.

See Also:

AbstractDriver.patchSize, AbstractDriver.sysexID

extractPatch

public Patch[] extractPatch(Patch p)

Extracts a V-Amp 2 patch from a V-Amp 2 patch dump response (block of data). Calls parseSysex to do the extraction.

Specified by:

extractPatch in class Converter

Returns:

A patch object containing the extracted sysex data.