midisystem.html

API資料大全

 extracted<DT><B>Returns:</B><DD>a <code>MidiFileFormat</code> object describing the MIDI file 
 format<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/sound/midi/InvalidMidiDataException.html">InvalidMidiDataException</A></CODE> - if the URL does not point to valid MIDI
 file data recognized by the system<DD><CODE><A HREF="../../../java/io/IOException.html">IOException</A></CODE> - if an I/O exception occurs while accessing the URL<DT><B>See Also: </B><DD><A HREF="../../../javax/sound/midi/MidiSystem.html#getMidiFileFormat(java.io.InputStream)"><CODE>getMidiFileFormat(InputStream)</CODE></A>, 
<A HREF="../../../javax/sound/midi/MidiSystem.html#getMidiFileFormat(java.io.File)"><CODE>getMidiFileFormat(File)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getMidiFileFormat(java.io.File)"><!-- --></A><H3>
getMidiFileFormat</H3>
<PRE>
public static <A HREF="../../../javax/sound/midi/MidiFileFormat.html">MidiFileFormat</A> <B>getMidiFileFormat</B>(<A HREF="../../../java/io/File.html">File</A>&nbsp;file)
                                        throws <A HREF="../../../javax/sound/midi/InvalidMidiDataException.html">InvalidMidiDataException</A>,
                                               <A HREF="../../../java/io/IOException.html">IOException</A></PRE>
<DL>
<DD>Obtains the MIDI file format of the specified <code>File</code>.  The 
 <code>File</code> must point to valid MIDI file data for a file type 
 recognized by the system.  
 <p>
 This operation can only succeed for files of a type which can be parsed
 by an installed file reader.  It may fail with an InvalidMidiDataException
 even for valid files if no compatible file reader is installed.  It
 will also fail with an InvalidMidiDataException if a compatible file reader
 is installed, but encounters errors while determining the file format.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>file</CODE> - the <code>File</code> from which file format information 
 should be extracted<DT><B>Returns:</B><DD>a <code>MidiFileFormat</code> object describing the MIDI file 
 format<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/sound/midi/InvalidMidiDataException.html">InvalidMidiDataException</A></CODE> - if the <code>File</code> does not point
  to valid MIDI file data recognized by the system<DD><CODE><A HREF="../../../java/io/IOException.html">IOException</A></CODE> - if an I/O exception occurs while accessing the file<DT><B>See Also: </B><DD><A HREF="../../../javax/sound/midi/MidiSystem.html#getMidiFileFormat(java.io.InputStream)"><CODE>getMidiFileFormat(InputStream)</CODE></A>, 
<A HREF="../../../javax/sound/midi/MidiSystem.html#getMidiFileFormat(java.net.URL)"><CODE>getMidiFileFormat(URL)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getSequence(java.io.InputStream)"><!-- --></A><H3>
getSequence</H3>
<PRE>
public static <A HREF="../../../javax/sound/midi/Sequence.html">Sequence</A> <B>getSequence</B>(<A HREF="../../../java/io/InputStream.html">InputStream</A>&nbsp;stream)
                            throws <A HREF="../../../javax/sound/midi/InvalidMidiDataException.html">InvalidMidiDataException</A>,
                                   <A HREF="../../../java/io/IOException.html">IOException</A></PRE>
<DL>
<DD>Obtains a MIDI sequence from the specified input stream.  The stream must
 point to valid MIDI file data for a file type recognized
 by the system.   
 <p>
 This method and/or the code it invokes may need to read some data 
 from the stream to determine whether
 its data format is supported.  The implementation may therefore
 need to mark the stream, read enough data to determine whether it is in 
 a supported format, and reset the stream's read pointer to its original 
 position.  If the input stream does not permit this set of operations, 
 this method may fail with an <code>IOException</code>.
 <p>
 This operation can only succeed for files of a type which can be parsed
 by an installed file reader.  It may fail with an InvalidMidiDataException
 even for valid files if no compatible file reader is installed.  It
 will also fail with an InvalidMidiDataException if a compatible file reader
 is installed, but encounters errors while constructing the <code>Sequence</code>
 object from the file data.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>stream</CODE> - the input stream from which the <code>Sequence</code> 
 should be constructed<DT><B>Returns:</B><DD>a <code>Sequence</code> object based on the MIDI file data 
 contained in the input stream<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/sound/midi/InvalidMidiDataException.html">InvalidMidiDataException</A></CODE> - if the stream does not point to 
 valid MIDI file data recognized by the system<DD><CODE><A HREF="../../../java/io/IOException.html">IOException</A></CODE> - if an I/O exception occurs while accessing the 
 stream<DT><B>See Also: </B><DD><A HREF="../../../java/io/InputStream.html#markSupported()"><CODE>InputStream.markSupported()</CODE></A>, 
<A HREF="../../../java/io/InputStream.html#mark(int)"><CODE>InputStream.mark(int)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getSequence(java.net.URL)"><!-- --></A><H3>
getSequence</H3>
<PRE>
public static <A HREF="../../../javax/sound/midi/Sequence.html">Sequence</A> <B>getSequence</B>(<A HREF="../../../java/net/URL.html">URL</A>&nbsp;url)
                            throws <A HREF="../../../javax/sound/midi/InvalidMidiDataException.html">InvalidMidiDataException</A>,
                                   <A HREF="../../../java/io/IOException.html">IOException</A></PRE>
<DL>
<DD>Obtains a MIDI sequence from the specified URL.  The URL must
 point to valid MIDI file data for a file type recognized
 by the system.   
 <p>
 This operation can only succeed for files of a type which can be parsed
 by an installed file reader.  It may fail with an InvalidMidiDataException
 even for valid files if no compatible file reader is installed.  It
 will also fail with an InvalidMidiDataException if a compatible file reader
 is installed, but encounters errors while constructing the <code>Sequence</code>
 object from the file data.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>url</CODE> - the URL from which the <code>Sequence</code> should be
 constructed<DT><B>Returns:</B><DD>a <code>Sequence</code> object based on the MIDI file data 
 pointed to by the URL<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/sound/midi/InvalidMidiDataException.html">InvalidMidiDataException</A></CODE> - if the URL does not point to valid MIDI
 file data recognized by the system<DD><CODE><A HREF="../../../java/io/IOException.html">IOException</A></CODE> - if an I/O exception occurs while accessing the URL</DL>
</DD>
</DL>
<HR>

<A NAME="getSequence(java.io.File)"><!-- --></A><H3>
getSequence</H3>
<PRE>
public static <A HREF="../../../javax/sound/midi/Sequence.html">Sequence</A> <B>getSequence</B>(<A HREF="../../../java/io/File.html">File</A>&nbsp;file)
                            throws <A HREF="../../../javax/sound/midi/InvalidMidiDataException.html">InvalidMidiDataException</A>,
                                   <A HREF="../../../java/io/IOException.html">IOException</A></PRE>
<DL>
<DD>Obtains a MIDI sequence from the specified <code>File</code>.  
 The <code>File</code> must point to valid MIDI file data 
 for a file type recognized by the system.   
 <p>
 This operation can only succeed for files of a type which can be parsed
 by an installed file reader.  It may fail with an InvalidMidiDataException
 even for valid files if no compatible file reader is installed.  It
 will also fail with an InvalidMidiDataException if a compatible file reader
 is installed, but encounters errors while constructing the <code>Sequence</code>
 object from the file data.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>file</CODE> - the <code>File</code> from which the <code>Sequence</code> 
 should be constructed<DT><B>Returns:</B><DD>a <code>Sequence</code> object based on the MIDI file data 
 pointed to by the File<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/sound/midi/InvalidMidiDataException.html">InvalidMidiDataException</A></CODE> - if the File does not point to valid MIDI
 file data recognized by the system<DD><CODE><A HREF="../../../java/io/IOException.html">IOException</A></CODE> - if an I/O exception occurs</DL>
</DD>
</DL>
<HR>

<A NAME="getMidiFileTypes()"><!-- --></A><H3>
getMidiFileTypes</H3>
<PRE>
public static int[] <B>getMidiFileTypes</B>()</PRE>
<DL>
<DD>Obtains the set of MIDI file types for which file writing support is 
 provided by the system.<DD><DL>
<DT><B>Returns:</B><DD>array of file types.  If no file types are supported, 
 an array of length 0 is returned.</DL>
</DD>
</DL>
<HR>

<A NAME="isFileTypeSupported(int)"><!-- --></A><H3>
isFileTypeSupported</H3>
<PRE>
public static boolean <B>isFileTypeSupported</B>(int&nbsp;fileType)</PRE>
<DL>
<DD>Indicates whether file writing support for the specified MIDI file type 
 is provided by the system.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>fileType</CODE> - the file type for which write capabilities are queried<DT><B>Returns:</B><DD><code>true</code> if the file type is supported, 
 otherwise <code>false</code></DL>
</DD>
</DL>
<HR>

<A NAME="getMidiFileTypes(javax.sound.midi.Sequence)"><!-- --></A><H3>
getMidiFileTypes</H3>
<PRE>
public static int[] <B>getMidiFileTypes</B>(<A HREF="../../../javax/sound/midi/Sequence.html">Sequence</A>&nbsp;sequence)</PRE>
<DL>
<DD>Obtains the set of MIDI file types that the system can write from the
 sequence specified.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>sequence</CODE> - the sequence for which MIDI file type support
 is queried<DT><B>Returns:</B><DD>the set of supported file types.  If no file types are supported, 
 returns an array of length 0.</DL>
</DD>
</DL>
<HR>

<A NAME="isFileTypeSupported(int, javax.sound.midi.Sequence)"><!-- --></A><H3>
isFileTypeSupported</H3>
<PRE>
public static boolean <B>isFileTypeSupported</B>(int&nbsp;fileType,
                                          <A HREF="../../../javax/sound/midi/Sequence.html">Sequence</A>&nbsp;sequence)</PRE>
<DL>
<DD>Indicates whether a MIDI file of the file type specified can be written
 from the sequence indicated.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>fileType</CODE> - the file type for which write capabilities 
 are queried<DD><CODE>sequence</CODE> - the sequence for which file writing support is queried<DT><B>Returns:</B><DD><code>true</code> if the file type is supported for this 
 sequence, otherwise <code>false</code></DL>
</DD>
</DL>
<HR>

<A NAME="write(javax.sound.midi.Sequence, int, java.io.OutputStream)"><!-- --></A><H3>
write</H3>
<PRE>
public static int <B>write</B>(<A HREF="../../../javax/sound/midi/Sequence.html">Sequence</A>&nbsp;in,
                        int&nbsp;fileType,
                        <A HREF="../../../java/io/OutputStream.html">OutputStream</A>&nbsp;out)
                 throws <A HREF="../../../java/io/IOException.html">IOException</A></PRE>
<DL>
<DD>Writes a stream of bytes representing a file of the MIDI file type
 indicated to the output stream provided.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>in</CODE> - sequence containing MIDI data to be written to the file<DD><CODE>fileType</CODE> - the file type of the file to be written to the output stream<DD><CODE>out</CODE> - stream to which the file data should be written<DT><B>Returns:</B><DD>the number of bytes written to the output stream<DT><B>Throws:</B><DD><CODE><A HREF="../../../java/io/IOException.html">IOException</A></CODE> - if an I/O exception occurs<DD><CODE><A HREF="../../../java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - if the file format is not supported by
 the system<DT><B>See Also: </B><DD><A HREF="../../../javax/sound/midi/MidiSystem.html#isFileTypeSupported(int, javax.sound.midi.Sequence)"><CODE>isFileTypeSupported(int, Sequence)</CODE></A>, 
<A HREF="../../../javax/sound/midi/MidiSystem.html#getMidiFileTypes(javax.sound.midi.Sequence)"><CODE>getMidiFileTypes(Sequence)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="write(javax.sound.midi.Sequence, int, java.io.File)"><!-- --></A><H3>
write</H3>
<PRE>
public static int <B>write</B>(<A HREF="../../../javax/sound/midi/Sequence.html">Sequence</A>&nbsp;in,
                        int&nbsp;type,
                        <A HREF="../../../java/io/File.html">File</A>&nbsp;out)
                 throws <A HREF="../../../java/io/IOException.html">IOException</A></PRE>
<DL>
<DD>Writes a stream of bytes representing a file of the MIDI file type
 indicated to the external file provided.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>in</CODE> - sequence containing MIDI data to be written to the file<DD><CODE>fileType</CODE> - the file type of the file to be written to the output stream<DD><CODE>out</CODE> - external file to which the file data should be written<DT><B>Returns:</B><DD>the number of bytes written to the file<DT><B>Throws:</B><DD><CODE><A HREF="../../../java/io/IOException.html">IOException</A></CODE> - if an I/O exception occurs<DD><CODE><A HREF="../../../java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - if the file type is not supported by
 the system<DT><B>See Also: </B><DD><A HREF="../../../javax/sound/midi/MidiSystem.html#isFileTypeSupported(int, javax.sound.midi.Sequence)"><CODE>isFileTypeSupported(int, Sequence)</CODE></A>, 
<A HREF="../../../javax/sound/midi/MidiSystem.html#getMidiFileTypes(javax.sound.midi.Sequence)"><CODE>getMidiFileTypes(Sequence)</CODE></A></DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/MidiSystem.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Java<sup><font size=-2>TM</font></sup>&nbsp;2&nbsp;Platform<br>Std.&nbsp;Ed. v1.3</b></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../javax/sound/midi/MidiMessage.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javax/sound/midi/Patch.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="MidiSystem.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: &nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>
<font size="-1"><a href="http://java.sun.com/cgi-bin/bugreport.cgi">Submit a bug or feature</a><br>For further API reference and developer documentation, see <a href="http://java.sun.com/products/jdk/1.3/devdocs-vs-specs.html">Java 2 SDK SE Developer Documentation</a>. That documentation  contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples. <p>Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road<br>Palo Alto, California, 94303, U.S.A.  All Rights Reserved.</font>
</BODY>
</HTML>