1. /*

  2.  * @(#)Receiver.java	1.19 03/01/27

  3.  *

  4.  * Copyright 2003 Sun Microsystems, Inc. All rights reserved.

  5.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  6.  */

  7. 

  8. package javax.sound.midi;		  	 

  9. 

  10. 

  11. /**

  12.  * A <code>Receiver</code> receives <code>{@link MidiEvent}</code> objects and

  13.  * typically does something useful in response, such as interpreting them to

  14.  * generate sound or raw MIDI output.  Common MIDI receivers include 

  15.  * synthesizers and MIDI Out ports.  

  16.  *

  17.  * @see MidiDevice

  18.  * @see Synthesizer

  19.  * @see Transmitter

  20.  *

  21.  * @version 1.19, 03/01/27

  22.  * @author Kara Kytle

  23.  */

  24. public interface Receiver {

  25. 

  26. 

  27.     //$$fb 2002-04-12: fix for 4662090: Contradiction in Receiver specification

  28.     /**

  29.      * Sends a MIDI message and time-stamp to this receiver.

  30.      * If time-stamping is not supported by this receiver, the time-stamp 

  31.      * value should be -1.

  32.      * @param message the MIDI message to send

  33.      * @param timeStamp the time-stamp for the message, in microseconds.

  34.      * @throws IllegalStateException if the receiver is closed

  35.      */ 

  36.     public void send(MidiMessage message, long timeStamp);													 

  37. 	

  38.     /**

  39.      * Indicates that the application has finished using the receiver, and

  40.      * that limited resources it requires may be released or made available.

  41.      * Invoking methods on a receiver which has been closed may cause an 

  42.      * <code>IllegalArgumentException</code> or other exception to be thrown.

  43.      */

  44.     public void close();

  45. }