Spec-Zone .ru
спецификации, руководства, описания, API
Please note that the specifications and other information contained herein are not final and are subject to change. The information is being made available to you solely for purpose of evaluation.

Java™ Platform
Standard Ed. 7

DRAFT ea-b118

javax.sound.midi
Interface Receiver

All Superinterfaces:
AutoCloseable
All Known Subinterfaces:
MidiDeviceReceiver

public interface Receiver
extends AutoCloseable

A Receiver receives MidiEvent objects and typically does something useful in response, such as interpreting them to generate sound or raw MIDI output. Common MIDI receivers include synthesizers and MIDI Out ports.

See Also:
MidiDevice, Synthesizer, Transmitter

Method Summary
Modifier and Type Method and Description
 void close()
          Indicates that the application has finished using the receiver, and that limited resources it requires may be released or made available.
 void send(MidiMessage message, long timeStamp)
          Sends a MIDI message and time-stamp to this receiver.
 

Method Detail

send

void send(MidiMessage message,
          long timeStamp)
Sends a MIDI message and time-stamp to this receiver. If time-stamping is not supported by this receiver, the time-stamp value should be -1.

Parameters:
message - the MIDI message to send
timeStamp - the time-stamp for the message, in microseconds.
Throws:
IllegalStateException - if the receiver is closed

close

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

If the creation of this Receiver 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 Receiver is retrieved from is closed explicitly by calling MidiDevice.close, the Receiver 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.getReceiver()

Java™ Platform
Standard Ed. 7

DRAFT ea-b118

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright © 1993, 2010, Oracle Corporation. All rights reserved.
DRAFT ea-b118

Scripting on this page tracks web page traffic, but does not change the content in any way.