| /* |
| * Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved. |
| * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
| * |
| * This code is free software; you can redistribute it and/or modify it |
| * under the terms of the GNU General Public License version 2 only, as |
| * published by the Free Software Foundation. Oracle designates this |
| * particular file as subject to the "Classpath" exception as provided |
| * by Oracle in the LICENSE file that accompanied this code. |
| * |
| * This code is distributed in the hope that it will be useful, but WITHOUT |
| * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
| * version 2 for more details (a copy is included in the LICENSE file that |
| * accompanied this code). |
| * |
| * You should have received a copy of the GNU General Public License version |
| * 2 along with this work; if not, write to the Free Software Foundation, |
| * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
| * |
| * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
| * or visit www.oracle.com if you need additional information or have any |
| * questions. |
| */ |
| package com.sun.media.sound; |
| |
| /** |
| * This class is used to store modulator/artiuclation data. |
| * A modulator connects one synthesizer source to |
| * a destination. For example a note on velocity |
| * can be mapped to the gain of the synthesized voice. |
| * It is stored as a "art1" or "art2" chunk inside DLS files. |
| * |
| * @author Karl Helgason |
| */ |
| public final class DLSModulator { |
| |
| // DLS1 Destinations |
| public static final int CONN_DST_NONE = 0x000; // 0 |
| public static final int CONN_DST_GAIN = 0x001; // cB |
| public static final int CONN_DST_PITCH = 0x003; // cent |
| public static final int CONN_DST_PAN = 0x004; // 0.1% |
| public static final int CONN_DST_LFO_FREQUENCY = 0x104; // cent (default 5 Hz) |
| public static final int CONN_DST_LFO_STARTDELAY = 0x105; // timecent |
| public static final int CONN_DST_EG1_ATTACKTIME = 0x206; // timecent |
| public static final int CONN_DST_EG1_DECAYTIME = 0x207; // timecent |
| public static final int CONN_DST_EG1_RELEASETIME = 0x209; // timecent |
| public static final int CONN_DST_EG1_SUSTAINLEVEL = 0x20A; // 0.1% |
| public static final int CONN_DST_EG2_ATTACKTIME = 0x30A; // timecent |
| public static final int CONN_DST_EG2_DECAYTIME = 0x30B; // timecent |
| public static final int CONN_DST_EG2_RELEASETIME = 0x30D; // timecent |
| public static final int CONN_DST_EG2_SUSTAINLEVEL = 0x30E; // 0.1% |
| // DLS2 Destinations |
| public static final int CONN_DST_KEYNUMBER = 0x005; |
| public static final int CONN_DST_LEFT = 0x010; // 0.1% |
| public static final int CONN_DST_RIGHT = 0x011; // 0.1% |
| public static final int CONN_DST_CENTER = 0x012; // 0.1% |
| public static final int CONN_DST_LEFTREAR = 0x013; // 0.1% |
| public static final int CONN_DST_RIGHTREAR = 0x014; // 0.1% |
| public static final int CONN_DST_LFE_CHANNEL = 0x015; // 0.1% |
| public static final int CONN_DST_CHORUS = 0x080; // 0.1% |
| public static final int CONN_DST_REVERB = 0x081; // 0.1% |
| public static final int CONN_DST_VIB_FREQUENCY = 0x114; // cent |
| public static final int CONN_DST_VIB_STARTDELAY = 0x115; // dB |
| public static final int CONN_DST_EG1_DELAYTIME = 0x20B; // timecent |
| public static final int CONN_DST_EG1_HOLDTIME = 0x20C; // timecent |
| public static final int CONN_DST_EG1_SHUTDOWNTIME = 0x20D; // timecent |
| public static final int CONN_DST_EG2_DELAYTIME = 0x30F; // timecent |
| public static final int CONN_DST_EG2_HOLDTIME = 0x310; // timecent |
| public static final int CONN_DST_FILTER_CUTOFF = 0x500; // cent |
| public static final int CONN_DST_FILTER_Q = 0x501; // dB |
| |
| // DLS1 Sources |
| public static final int CONN_SRC_NONE = 0x000; // 1 |
| public static final int CONN_SRC_LFO = 0x001; // linear (sine wave) |
| public static final int CONN_SRC_KEYONVELOCITY = 0x002; // ??db or velocity?? |
| public static final int CONN_SRC_KEYNUMBER = 0x003; // ??cent or keynumber?? |
| public static final int CONN_SRC_EG1 = 0x004; // linear direct from eg |
| public static final int CONN_SRC_EG2 = 0x005; // linear direct from eg |
| public static final int CONN_SRC_PITCHWHEEL = 0x006; // linear -1..1 |
| public static final int CONN_SRC_CC1 = 0x081; // linear 0..1 |
| public static final int CONN_SRC_CC7 = 0x087; // linear 0..1 |
| public static final int CONN_SRC_CC10 = 0x08A; // linear 0..1 |
| public static final int CONN_SRC_CC11 = 0x08B; // linear 0..1 |
| public static final int CONN_SRC_RPN0 = 0x100; // ?? // Pitch Bend Range |
| public static final int CONN_SRC_RPN1 = 0x101; // ?? // Fine Tune |
| public static final int CONN_SRC_RPN2 = 0x102; // ?? // Course Tune |
| // DLS2 Sources |
| public static final int CONN_SRC_POLYPRESSURE = 0x007; // linear 0..1 |
| public static final int CONN_SRC_CHANNELPRESSURE = 0x008; // linear 0..1 |
| public static final int CONN_SRC_VIBRATO = 0x009; // linear 0..1 |
| public static final int CONN_SRC_MONOPRESSURE = 0x00A; // linear 0..1 |
| public static final int CONN_SRC_CC91 = 0x0DB; // linear 0..1 |
| public static final int CONN_SRC_CC93 = 0x0DD; // linear 0..1 |
| // DLS1 Transforms |
| public static final int CONN_TRN_NONE = 0x000; |
| public static final int CONN_TRN_CONCAVE = 0x001; |
| // DLS2 Transforms |
| public static final int CONN_TRN_CONVEX = 0x002; |
| public static final int CONN_TRN_SWITCH = 0x003; |
| public static final int DST_FORMAT_CB = 1; |
| public static final int DST_FORMAT_CENT = 1; |
| public static final int DST_FORMAT_TIMECENT = 2; |
| public static final int DST_FORMAT_PERCENT = 3; |
| int source; |
| int control; |
| int destination; |
| int transform; |
| int scale; |
| int version = 1; |
| |
| public int getControl() { |
| return control; |
| } |
| |
| public void setControl(int control) { |
| this.control = control; |
| } |
| |
| public static int getDestinationFormat(int destination) { |
| |
| if (destination == CONN_DST_GAIN) |
| return DST_FORMAT_CB; |
| if (destination == CONN_DST_PITCH) |
| return DST_FORMAT_CENT; |
| if (destination == CONN_DST_PAN) |
| return DST_FORMAT_PERCENT; |
| |
| if (destination == CONN_DST_LFO_FREQUENCY) |
| return DST_FORMAT_CENT; |
| if (destination == CONN_DST_LFO_STARTDELAY) |
| return DST_FORMAT_TIMECENT; |
| |
| if (destination == CONN_DST_EG1_ATTACKTIME) |
| return DST_FORMAT_TIMECENT; |
| if (destination == CONN_DST_EG1_DECAYTIME) |
| return DST_FORMAT_TIMECENT; |
| if (destination == CONN_DST_EG1_RELEASETIME) |
| return DST_FORMAT_TIMECENT; |
| if (destination == CONN_DST_EG1_SUSTAINLEVEL) |
| return DST_FORMAT_PERCENT; |
| |
| if (destination == CONN_DST_EG2_ATTACKTIME) |
| return DST_FORMAT_TIMECENT; |
| if (destination == CONN_DST_EG2_DECAYTIME) |
| return DST_FORMAT_TIMECENT; |
| if (destination == CONN_DST_EG2_RELEASETIME) |
| return DST_FORMAT_TIMECENT; |
| if (destination == CONN_DST_EG2_SUSTAINLEVEL) |
| return DST_FORMAT_PERCENT; |
| |
| if (destination == CONN_DST_KEYNUMBER) |
| return DST_FORMAT_CENT; // NOT SURE WITHOUT DLS 2 SPEC |
| if (destination == CONN_DST_LEFT) |
| return DST_FORMAT_CB; |
| if (destination == CONN_DST_RIGHT) |
| return DST_FORMAT_CB; |
| if (destination == CONN_DST_CENTER) |
| return DST_FORMAT_CB; |
| if (destination == CONN_DST_LEFTREAR) |
| return DST_FORMAT_CB; |
| if (destination == CONN_DST_RIGHTREAR) |
| return DST_FORMAT_CB; |
| if (destination == CONN_DST_LFE_CHANNEL) |
| return DST_FORMAT_CB; |
| if (destination == CONN_DST_CHORUS) |
| return DST_FORMAT_PERCENT; |
| if (destination == CONN_DST_REVERB) |
| return DST_FORMAT_PERCENT; |
| |
| if (destination == CONN_DST_VIB_FREQUENCY) |
| return DST_FORMAT_CENT; |
| if (destination == CONN_DST_VIB_STARTDELAY) |
| return DST_FORMAT_TIMECENT; |
| |
| if (destination == CONN_DST_EG1_DELAYTIME) |
| return DST_FORMAT_TIMECENT; |
| if (destination == CONN_DST_EG1_HOLDTIME) |
| return DST_FORMAT_TIMECENT; |
| if (destination == CONN_DST_EG1_SHUTDOWNTIME) |
| return DST_FORMAT_TIMECENT; |
| |
| if (destination == CONN_DST_EG2_DELAYTIME) |
| return DST_FORMAT_TIMECENT; |
| if (destination == CONN_DST_EG2_HOLDTIME) |
| return DST_FORMAT_TIMECENT; |
| |
| if (destination == CONN_DST_FILTER_CUTOFF) |
| return DST_FORMAT_CENT; |
| if (destination == CONN_DST_FILTER_Q) |
| return DST_FORMAT_CB; |
| |
| return -1; |
| } |
| |
| public static String getDestinationName(int destination) { |
| |
| if (destination == CONN_DST_GAIN) |
| return "gain"; |
| if (destination == CONN_DST_PITCH) |
| return "pitch"; |
| if (destination == CONN_DST_PAN) |
| return "pan"; |
| |
| if (destination == CONN_DST_LFO_FREQUENCY) |
| return "lfo1.freq"; |
| if (destination == CONN_DST_LFO_STARTDELAY) |
| return "lfo1.delay"; |
| |
| if (destination == CONN_DST_EG1_ATTACKTIME) |
| return "eg1.attack"; |
| if (destination == CONN_DST_EG1_DECAYTIME) |
| return "eg1.decay"; |
| if (destination == CONN_DST_EG1_RELEASETIME) |
| return "eg1.release"; |
| if (destination == CONN_DST_EG1_SUSTAINLEVEL) |
| return "eg1.sustain"; |
| |
| if (destination == CONN_DST_EG2_ATTACKTIME) |
| return "eg2.attack"; |
| if (destination == CONN_DST_EG2_DECAYTIME) |
| return "eg2.decay"; |
| if (destination == CONN_DST_EG2_RELEASETIME) |
| return "eg2.release"; |
| if (destination == CONN_DST_EG2_SUSTAINLEVEL) |
| return "eg2.sustain"; |
| |
| if (destination == CONN_DST_KEYNUMBER) |
| return "keynumber"; |
| if (destination == CONN_DST_LEFT) |
| return "left"; |
| if (destination == CONN_DST_RIGHT) |
| return "right"; |
| if (destination == CONN_DST_CENTER) |
| return "center"; |
| if (destination == CONN_DST_LEFTREAR) |
| return "leftrear"; |
| if (destination == CONN_DST_RIGHTREAR) |
| return "rightrear"; |
| if (destination == CONN_DST_LFE_CHANNEL) |
| return "lfe_channel"; |
| if (destination == CONN_DST_CHORUS) |
| return "chorus"; |
| if (destination == CONN_DST_REVERB) |
| return "reverb"; |
| |
| if (destination == CONN_DST_VIB_FREQUENCY) |
| return "vib.freq"; |
| if (destination == CONN_DST_VIB_STARTDELAY) |
| return "vib.delay"; |
| |
| if (destination == CONN_DST_EG1_DELAYTIME) |
| return "eg1.delay"; |
| if (destination == CONN_DST_EG1_HOLDTIME) |
| return "eg1.hold"; |
| if (destination == CONN_DST_EG1_SHUTDOWNTIME) |
| return "eg1.shutdown"; |
| |
| if (destination == CONN_DST_EG2_DELAYTIME) |
| return "eg2.delay"; |
| if (destination == CONN_DST_EG2_HOLDTIME) |
| return "eg.2hold"; |
| |
| if (destination == CONN_DST_FILTER_CUTOFF) |
| return "filter.cutoff"; // NOT SURE WITHOUT DLS 2 SPEC |
| if (destination == CONN_DST_FILTER_Q) |
| return "filter.q"; // NOT SURE WITHOUT DLS 2 SPEC |
| |
| return null; |
| } |
| |
| public static String getSourceName(int source) { |
| |
| if (source == CONN_SRC_NONE) |
| return "none"; |
| if (source == CONN_SRC_LFO) |
| return "lfo"; |
| if (source == CONN_SRC_KEYONVELOCITY) |
| return "keyonvelocity"; |
| if (source == CONN_SRC_KEYNUMBER) |
| return "keynumber"; |
| if (source == CONN_SRC_EG1) |
| return "eg1"; |
| if (source == CONN_SRC_EG2) |
| return "eg2"; |
| if (source == CONN_SRC_PITCHWHEEL) |
| return "pitchweel"; |
| if (source == CONN_SRC_CC1) |
| return "cc1"; |
| if (source == CONN_SRC_CC7) |
| return "cc7"; |
| if (source == CONN_SRC_CC10) |
| return "c10"; |
| if (source == CONN_SRC_CC11) |
| return "cc11"; |
| |
| if (source == CONN_SRC_POLYPRESSURE) |
| return "polypressure"; |
| if (source == CONN_SRC_CHANNELPRESSURE) |
| return "channelpressure"; |
| if (source == CONN_SRC_VIBRATO) |
| return "vibrato"; |
| if (source == CONN_SRC_MONOPRESSURE) |
| return "monopressure"; |
| if (source == CONN_SRC_CC91) |
| return "cc91"; |
| if (source == CONN_SRC_CC93) |
| return "cc93"; |
| return null; |
| } |
| |
| public int getDestination() { |
| return destination; |
| } |
| |
| public void setDestination(int destination) { |
| this.destination = destination; |
| } |
| |
| public int getScale() { |
| return scale; |
| } |
| |
| public void setScale(int scale) { |
| this.scale = scale; |
| } |
| |
| public int getSource() { |
| return source; |
| } |
| |
| public void setSource(int source) { |
| this.source = source; |
| } |
| |
| public int getVersion() { |
| return version; |
| } |
| |
| public void setVersion(int version) { |
| this.version = version; |
| } |
| |
| public int getTransform() { |
| return transform; |
| } |
| |
| public void setTransform(int transform) { |
| this.transform = transform; |
| } |
| } |
