Java™ Platform
Standard Ed. 8
javax.sound.midi.spi

Class MidiFileWriter



  • public abstract class MidiFileWriter
    extends Object
    A MidiFileWriter supplies MIDI file-writing services. Classes that implement this interface can write one or more types of MIDI file from a Sequence object.
    Since:
    1.3
    • Constructor Detail

      • MidiFileWriter

        public MidiFileWriter()
    • Method Detail

      • getMidiFileTypes

        public abstract int[] getMidiFileTypes()
        Obtains the set of MIDI file types for which file writing support is provided by this file writer.
        Returns:
        array of file types. If no file types are supported, an array of length 0 is returned.
      • getMidiFileTypes

        public abstract int[] getMidiFileTypes(Sequence sequence)
        Obtains the file types that this file writer can write from the sequence specified.
        Parameters:
        sequence - the sequence for which MIDI file type support is queried
        Returns:
        array of file types. If no file types are supported, returns an array of length 0.
      • isFileTypeSupported

        public boolean isFileTypeSupported(int fileType)
        Indicates whether file writing support for the specified MIDI file type is provided by this file writer.
        Parameters:
        fileType - the file type for which write capabilities are queried
        Returns:
        true if the file type is supported, otherwise false
      • isFileTypeSupported

        public boolean isFileTypeSupported(int fileType,
                                           Sequence sequence)
        Indicates whether a MIDI file of the file type specified can be written from the sequence indicated.
        Parameters:
        fileType - the file type for which write capabilities are queried
        sequence - the sequence for which file writing support is queried
        Returns:
        true if the file type is supported for this sequence, otherwise false
      • write

        public abstract int write(Sequence in,
                                  int fileType,
                                  OutputStream out)
                           throws IOException
        Writes a stream of bytes representing a MIDI file of the file type indicated to the output stream provided.
        Parameters:
        in - sequence containing MIDI data to be written to the file
        fileType - type of the file to be written to the output stream
        out - stream to which the file data should be written
        Returns:
        the number of bytes written to the output stream
        Throws:
        IOException - if an I/O exception occurs
        IllegalArgumentException - if the file type is not supported by this file writer
        See Also:
        isFileTypeSupported(int, Sequence), getMidiFileTypes(Sequence)
      • write

        public abstract int write(Sequence in,
                                  int fileType,
                                  File out)
                           throws IOException
        Writes a stream of bytes representing a MIDI file of the file type indicated to the external file provided.
        Parameters:
        in - sequence containing MIDI data to be written to the external file
        fileType - type of the file to be written to the external file
        out - external file to which the file data should be written
        Returns:
        the number of bytes written to the file
        Throws:
        IOException - if an I/O exception occurs
        IllegalArgumentException - if the file type is not supported by this file writer
        See Also:
        isFileTypeSupported(int, Sequence), getMidiFileTypes(Sequence)
Java™ Platform
Standard Ed. 8

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, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.

微信小程序

微信扫一扫体验

微信公众账号

微信扫一扫加关注

发表
评论
返回
顶部