1. /*

  2.  * @(#)Transmitter.java	1.20 03/01/23

  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>Transmitter</code> sends <code>{@link MidiEvent}</code> objects to one or more 

  13.  * <code>{@link Receiver Receivers}</code>. Common MIDI transmitters include sequencers

  14.  * and MIDI input ports.

  15.  *

  16.  * @see Receiver

  17.  *

  18.  * @version 1.20, 03/01/23

  19.  * @author Kara Kytle

  20.  */

  21. public interface Transmitter {

  22. 

  23. 

  24.     /**

  25.      * Sets the receiver to which this transmitter will deliver MIDI messages.

  26.      * If a receiver is currently set, it is replaced with this one.

  27.      * @param receiver the desired receiver.

  28.      */

  29.     public void setReceiver(Receiver receiver);

  30. 

  31. 

  32.     /**

  33.      * Obtains the current receiver to which this transmitter will deliver MIDI messages. 

  34.      * @return the current receiver.  If no receiver is currently set, 

  35.      * returns <code>null</code>

  36.      */

  37.     public Receiver getReceiver();

  38. 

  39. 	

  40.     /**

  41.      * Indicates that the application has finished using the transmitter, and

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

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

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

  45.      */

  46.     public void close();

  47. }