org.jsynthlib.synthdrivers.AlesisDM5

Class AlesisDM5Converter

java.lang.Object

org.jsynthlib.device.model.AbstractDriver

org.jsynthlib.device.model.Converter

org.jsynthlib.synthdrivers.AlesisDM5.AlesisDM5Converter

All Implemented Interfaces:

IConverter, IDriver

public class AlesisDM5Converter
extends Converter

Removes "Garbage Data" from Alesis response to dump request and extracts desired patch. When responding to a sysex data dump request, the DM5 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 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 DM5 patch in the block and discard the rest of the data. It will work with any of the five patch types - system info, edit buffer, program change table, single set, or trigger setup.

Author:

Jeff Weber

Field Summary

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

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

Method Summary

Modifier and Type	Method and Description
Patch[]	extractPatch(Patch p) Extracts a Alesis patch from a Alesis patch dump response (block of data).
boolean	supportsPatch(String patchString, byte[] sysex) Extracts the last valid patch in a Alesis 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 Alesis 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 Alesis 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 - the result of p.getPatchHeader().

sysex - a byte array of sysex message

Returns:

true if this driver supports the Patch.

See Also:

AbstractDriver.patchSize, AbstractDriver.sysexID

extractPatch

public Patch[] extractPatch(Patch p)

Extracts a Alesis patch from a Alesis patch dump response (block of data). Calls parseSysex to do the extraction.

Specified by:

extractPatch in class Converter