/*
 * Copyright (c) 1999, 2016, 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;

import javax.sound.midi.*;



MidiInDevice class representing functionality of MidiIn devices.
Author:David Rivas, Kara Kytle, Florian Bomers
/** * MidiInDevice class representing functionality of MidiIn devices. * * @author David Rivas * @author Kara Kytle * @author Florian Bomers */
final class MidiInDevice extends AbstractMidiDevice implements Runnable { private volatile Thread midiInThread; // CONSTRUCTOR MidiInDevice(AbstractMidiDeviceProvider.Info info) { super(info); if(Printer.trace) Printer.trace("MidiInDevice CONSTRUCTOR"); } // IMPLEMENTATION OF ABSTRACT MIDI DEVICE METHODS // $$kk: 06.24.99: i have this both opening and starting the midi in device. // may want to separate these?? protected synchronized void implOpen() throws MidiUnavailableException { if (Printer.trace) Printer.trace("> MidiInDevice: implOpen()"); int index = ((MidiInDeviceProvider.MidiInDeviceInfo)getDeviceInfo()).getIndex(); id = nOpen(index); // can throw MidiUnavailableException if (id == 0) { throw new MidiUnavailableException("Unable to open native device"); } // create / start a thread to get messages if (midiInThread == null) { midiInThread = JSSecurityManager.createThread(this, "Java Sound MidiInDevice Thread", // name false, // daemon -1, // priority true); // doStart } nStart(id); // can throw MidiUnavailableException if (Printer.trace) Printer.trace("< MidiInDevice: implOpen() completed"); } // $$kk: 06.24.99: i have this both stopping and closing the midi in device. // may want to separate these?? protected synchronized void implClose() { if (Printer.trace) Printer.trace("> MidiInDevice: implClose()"); long oldId = id; id = 0; super.implClose(); // close the device nStop(oldId); if (midiInThread != null) { try { midiInThread.join(1000); } catch (InterruptedException e) { // IGNORE EXCEPTION } } nClose(oldId); if (Printer.trace) Printer.trace("< MidiInDevice: implClose() completed"); } public long getMicrosecondPosition() { long timestamp = -1; if (isOpen()) { timestamp = nGetTimeStamp(id); } return timestamp; } // OVERRIDES OF ABSTRACT MIDI DEVICE METHODS protected boolean hasTransmitters() { return true; } protected Transmitter createTransmitter() { return new MidiInTransmitter(); }
An own class to distinguish the class name from the transmitter of other devices
/** * An own class to distinguish the class name from * the transmitter of other devices */
private final class MidiInTransmitter extends BasicTransmitter { private MidiInTransmitter() { super(); } } // RUNNABLE METHOD public void run() { // while the device is started, keep trying to get messages. // this thread returns from native code whenever stop() or close() is called while (id!=0) { // go into native code and retrieve messages nGetMessages(id); if (id!=0) { try { Thread.sleep(1); } catch (InterruptedException e) {} } } if(Printer.verbose) Printer.verbose("MidiInDevice Thread exit"); // let the thread exit midiInThread = null; } // CALLBACKS FROM NATIVE
Callback from native code when a short MIDI event is received from hardware.
Params:
  • timeStamp – time-stamp in microseconds
@parampackedMsg: status | data1 << 8 | data2 << 8
/** * Callback from native code when a short MIDI event is received from hardware. * @param packedMsg: status | data1 << 8 | data2 << 8 * @param timeStamp time-stamp in microseconds */
void callbackShortMessage(int packedMsg, long timeStamp) { if (packedMsg == 0 || id == 0) { return; } /*if(Printer.verbose) { int status = packedMsg & 0xFF; int data1 = (packedMsg & 0xFF00)>>8; int data2 = (packedMsg & 0xFF0000)>>16; Printer.verbose(">> MidiInDevice callbackShortMessage: status: " + status + " data1: " + data1 + " data2: " + data2 + " timeStamp: " + timeStamp); }*/ getTransmitterList().sendMessage(packedMsg, timeStamp); } void callbackLongMessage(byte[] data, long timeStamp) { if (id == 0 || data == null) { return; } getTransmitterList().sendMessage(data, timeStamp); } // NATIVE METHODS private native long nOpen(int index) throws MidiUnavailableException; private native void nClose(long id); private native void nStart(long id) throws MidiUnavailableException; private native void nStop(long id); private native long nGetTimeStamp(long id); // go into native code and get messages. May be blocking private native void nGetMessages(long id); }