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)