org.jsynthlib.synthdrivers.BehringerVAmp2

Class VAmp2BankDriver

java.lang.Object

org.jsynthlib.device.model.AbstractDriver

org.jsynthlib.device.model.AbstractBankDriver

org.jsynthlib.synthdrivers.BehringerVAmp2.VAmp2BankDriver

All Implemented Interfaces:

IBankDriver, IDriver

public class VAmp2BankDriver
extends AbstractBankDriver

V-Amp 2 Bank Driver. Used for V-Amp 2 bank patch. The V-Amp 2 appears to the user to have 25 banks consisting of five patch locations apiece. The banks are numbered 1 through 25 and the patches are designated by the letters A, B, C, D, and E. The actual physical layout is a single bank consisting of 125 patch locations numbered 0 to 124.

Author:

Jeff Weber

Field Summary

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

singleSize, singleSysexID

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

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

Constructor Summary

Constructors

Constructor and Description
VAmp2BankDriver() Constructs a VAmp2BankDriver

Method Summary

Modifier and Type	Method and Description
protected BankPatch	createNewPatch() Creates a new bank patch.
Patch	getPatch(Patch bank, int patchNum) Returns a single program patch from a bank.
String	getPatchName(Patch p, int patchNum) Gets the name of a patch within the bank.
int	getPatchStart(int patchNum) Returns the index of the selected patch
void	putPatch(Patch bank, Patch p, int patchNum) Puts a single program patch into a bank.
void	requestPatchDump(int bankNum, int patchNum) Requests a dump of a V-Amp 2 bank consisting of 125 patches.
void	setPatchName(Patch p, int patchNum, String name) Sets the name of a patch within the bank.
void	storePatch(Patch p, int bankNum, int patchNum) Extracts all 125 preset patches from a bank patch and sends all to the device.

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

canHoldPatch, deletePatch, editPatch, getNumColumns, getNumPatches, getPatchName, getSingleSize, getSingleSysexID, hasEditor, isBankDriver, isConverter, isSingleDriver, setPatchName, setSingleSize, setSingleSysexID

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

calculateChecksum, calculateChecksum, calculateChecksum, canCreatePatch, 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, send, send, send, send, sendPatch, sendPatchWorker, setBankNum, setBankNumbers, setChecksumEnd, setChecksumOffset, setChecksumStart, setDevice, setDeviceIDoffset, setPatchNameSize, setPatchNameStart, setPatchNum, setPatchNumbers, setPatchSize, setSysexID, setSysexRequestDump, setTrimSize, supportsPatch, toString, trimSysex

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jsynthlib.device.model.IDriver

calculateChecksum, calculateChecksum, canCreatePatch, createPatch, createPatch, createPatches, getAuthors, getBankNumbers, getChannel, getChecksumEnd, getChecksumOffset, getChecksumStart, getDevice, getDeviceID, getDeviceIDoffset, getPatchNameSize, getPatchNameStart, getPatchNumbers, getPatchSize, getPatchType, getSysexID, getSysexRequestDump, getTrimSize, playPatch, send, sendPatch, setBankNumbers, setChecksumEnd, setChecksumOffset, setChecksumStart, setDevice, setDeviceIDoffset, setPatchNameSize, setPatchNameStart, setPatchNumbers, setPatchSize, setSysexID, setSysexRequestDump, setTrimSize, supportsPatch, toString, trimSysex

Constructor Detail

VAmp2BankDriver

public VAmp2BankDriver()

Constructs a VAmp2BankDriver

Method Detail

getPatchStart

public int getPatchStart(int patchNum)

Returns the index of the selected patch

Parameters:

patchNum - Patch number

Returns:

Index of the patch

putPatch

public void putPatch(Patch bank,
                     Patch p,
                     int patchNum)

Puts a single program patch into a bank. The target bank is given by the bank parameter. The target location within the bank is given by patchNum, where patchNum is in the range 0 through 124. The header and trailer bytes are stripped from the sysex data and the target location within the bank is overwritten.

Parameters:

bank - The target bank where the patch will be placed.

p - The patch to be placed into the target bank.

patchNum - The location within the bank where the patch will be placed.

See Also:

Patch#put(IPatch, int)

getPatch

public Patch getPatch(Patch bank,
                      int patchNum)

Returns a single program patch from a bank. The source bank is given by the bank parameter. The patch location within the bank is given by patchNum, where patchNum is in the range 0 through 124. The patch is extracted from the bank and a valid V-Amp 2 preset patch header is appended at the beginning and 0xF7 is appended at the end.

Parameters:

bank - The bank from which the patch will be retrieved.

patchNum - The location of the requested patch within the bank.

Returns:

A reference to the requested patch.

See Also:

Patch#get(int)

getPatchName

public String getPatchName(Patch p,
                           int patchNum)

Gets the name of a patch within the bank. Patch p is the bank patch. int patchNum represents the location of the single patch within the bank, designated by a number between 0 and 124.

Parameters:

p - The target bank patch containing the single patch whose name is to be retrieved.

patchNum - The location within the bank of the single patch whose name is to be retrieved.

Returns:

A String containing the patch name.

See Also:

Patch#getName(int)

setPatchName

public void setPatchName(Patch p,
                         int patchNum,
                         String name)

Sets the name of a patch within the bank. Patch p is the bank patch. int patchNum represents the location of the single patch within the bank, designated by a number between 0 and 124. String name contains the name to be assigned to the patch.

Parameters:

p - The target bank patch containing the single patch whose name is to be changed.

patchNum - The location within the bank of the single patch whose name is to be changed.

name - A String containing the getPatchFactory().createNewPatch name.

See Also:

Patch#setName(int, String)

createNewPatch

protected BankPatch createNewPatch()

Creates a new bank patch.

Overrides:

createNewPatch in class AbstractBankDriver

Returns:

A reference to the new bank patch.

See Also:

IDriver.createPatch(), AbstractDriver.createPatch()

requestPatchDump

public void requestPatchDump(int bankNum,
                             int patchNum)

Requests a dump of a V-Amp 2 bank consisting of 125 patches. The bankNum and patchNum parameters are ignored.

Specified by:

requestPatchDump in interface IDriver

Overrides:

requestPatchDump in class AbstractDriver

Parameters:

bankNum - Parameter provided to match the method in the superclass. Values pased in this parameter are ignored.

patchNum - Parameter provided to match the method in the superclass. Values pased in this parameter are ignored.

See Also:

IDriver.requestPatchDump(int, int), SysexHandler

storePatch

public void storePatch(Patch p,
                       int bankNum,
                       int patchNum)

Extracts all 125 preset patches from a bank patch and sends all to the device. Patch p represents the bank patch to be stored. For the V-Amp 2, the bankNum and patchNum parameters are ignored (since the V-Amp 2 only has one bank).

Specified by:

storePatch in interface IDriver

Overrides:

storePatch in class AbstractBankDriver

Parameters:

p - The patch to be stored.

bankNum - Parameter provided to match the method in the superclass. Values pased in this parameter are ignored.

patchNum - Parameter provided to match the method in the superclass. Values pased in this parameter are ignored.

See Also:

Patch.send(int, int)