Module java.desktop
Package javax.sound.midi

# Interface Transmitter

All Superinterfaces:
  `AutoCloseable`

All Known Subinterfaces:
  `MidiDeviceTransmitter`

public interface Transmitter extends AutoCloseable
A `Transmitter` sends `MidiEvent` objects to one or more `Receivers`. Common MIDI transmitters include sequencers and MIDI input ports.

See Also:
  - `Receiver`

## Method Summary

Modifier and Type
Method
Description
`void`
`close()`
Indicates that the application has finished using the transmitter, and that limited resources it requires may be released or made available.
`Receiver`
`getReceiver()`
Obtains the current receiver to which this transmitter will deliver MIDI messages.
`void`
`setReceiver(Receiver receiver)`
Sets the receiver to which this transmitter will deliver MIDI messages.

## Method Details

### setReceiver

void setReceiver(Receiver receiver)
Sets the receiver to which this transmitter will deliver MIDI messages. If a receiver is currently set, it is replaced with this one.

Parameters:
  `receiver` - the desired receiver

### getReceiver

Receiver getReceiver()
Obtains the current receiver to which this transmitter will deliver MIDI messages.

Returns:
  the current receiver. If no receiver is currently set, returns `null`.

### close

void close()
Indicates that the application has finished using the transmitter, and that limited resources it requires may be released or made available.

If the creation of this `Transmitter` resulted in implicitly opening the underlying device, the device is implicitly closed by this method. This is true unless the device is kept open by other `Receiver` or `Transmitter` instances that opened the device implicitly, and unless the device has been opened explicitly. If the device this `Transmitter` is retrieved from is closed explicitly by calling `MidiDevice.close`, the `Transmitter` is closed, too. For a detailed description of open/close behaviour see the class description of `MidiDevice`.

Specified by:
  `close` in interface `AutoCloseable`
See Also:
  - `MidiSystem.getTransmitter()`