javax.sound.midi.spi

クラスMidiFileWriter

java.lang.Object

javax.sound.midi.spi.MidiFileWriter

public abstract class MidiFileWriter
extends Object

MidiFileWriterは、MIDIファイル書込みサービスを提供します。このインタフェースを実装するクラスは、Sequenceオブジェクトから1種類以上のMIDIファイルを書き込むことができます。

導入されたバージョン:

1.3

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
MidiFileWriter()

メソッドのサマリー

修飾子と型	メソッドと説明
abstract int[]	getMidiFileTypes() このファイル・ライターがファイル書込みサポートを提供するMIDIファイル・タイプのセットを取得します。
abstract int[]	getMidiFileTypes(Sequence sequence) 指定されたシーケンスからこのファイル・ライターが書き込めるファイル・タイプを取得します。
boolean	isFileTypeSupported(int fileType) 指定されたMIDIファイル・タイプのファイル書込みサポートをこのファイル・ライターが提供しているかどうかを示します。
boolean	isFileTypeSupported(int fileType, Sequence sequence) 指定されたファイル・タイプのMIDIファイルを、示されたシーケンスから書き込めるかどうかを示します。
abstract int	write(Sequence in, int fileType, File out) 指定された外部ファイルに示されるファイル・タイプのMIDIファイルを表すバイトのストリームを書き込みます。
abstract int	write(Sequence in, int fileType, OutputStream out) 指定された外部ストリームに示されるファイル・タイプのMIDIファイルを表すバイトのストリームを書き込みます。

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

MidiFileWriter

public MidiFileWriter()

メソッドの詳細

getMidiFileTypes

public abstract int[] getMidiFileTypes()

このファイル・ライターがファイル書込みサポートを提供するMIDIファイル・タイプのセットを取得します。

戻り値:

ファイル・タイプの配列。サポートされているファイル・タイプがない場合、長さ0の配列が返される。

getMidiFileTypes

public abstract int[] getMidiFileTypes(Sequence sequence)

指定されたシーケンスからこのファイル・ライターが書き込めるファイル・タイプを取得します。

パラメータ:

sequence - MIDIファイル・タイプのサポートが照会されるシーケンス

戻り値:

ファイル・タイプの配列。サポートされているファイル・タイプがない場合、長さ0の配列が返される。

isFileTypeSupported

public boolean isFileTypeSupported(int fileType)

指定されたMIDIファイル・タイプのファイル書込みサポートをこのファイル・ライターが提供しているかどうかを示します。

パラメータ:

fileType - 書込み機能が照会されるファイル・タイプ

戻り値:

ファイル・タイプがサポートされている場合はtrue、そうでない場合はfalse

isFileTypeSupported

public boolean isFileTypeSupported(int fileType,
                                   Sequence sequence)

指定されたファイル・タイプのMIDIファイルを、示されたシーケンスから書き込めるかどうかを示します。

パラメータ:

fileType - 書込み機能が照会されるファイル・タイプ

sequence - ファイル書込みサポートが照会されるシーケンス

戻り値:

ファイル・タイプがこのシーケンスに対してサポートされている場合はtrue、そうでない場合はfalse

write

public abstract int write(Sequence in,
                          int fileType,
                          OutputStream out)
                   throws IOException

指定された外部ストリームに示されるファイル・タイプのMIDIファイルを表すバイトのストリームを書き込みます。

パラメータ:

in - ファイルへ書き込まれるMIDIデータを含むシーケンス

fileType - 出力ストリームへ書き込まれるファイルのタイプ

out - ファイル・データが書き込まれるストリーム

戻り値:

出力ストリームへ書き込まれるバイト数

例外:

IOException - 入出力例外が発生した場合

IllegalArgumentException - このファイル・ライターがそのファイル・タイプをサポートしていない場合

関連項目:

isFileTypeSupported(int, Sequence), getMidiFileTypes(Sequence)

write

public abstract int write(Sequence in,
                          int fileType,
                          File out)
                   throws IOException

指定された外部ファイルに示されるファイル・タイプのMIDIファイルを表すバイトのストリームを書き込みます。

パラメータ:

in - 外部ファイルへ書き込まれるMIDIデータを含むシーケンス

fileType - 外部ファイルへ書き込まれるファイルのタイプ

out - ファイル・データが書き込まれる外部ファイル

戻り値:

ファイルへ書き込まれるバイト数

例外:

IOException - 入出力例外が発生した場合

IllegalArgumentException - このファイル・ライターがそのファイル・タイプをサポートしていない場合

関連項目:

isFileTypeSupported(int, Sequence), getMidiFileTypes(Sequence)