java.lang.Object
javax.sound.midi.MidiFileFormat
public class MidiFileFormat extends Object
MidiFileFormat
オブジェクトは、MIDIファイルのタイプを長さおよびタイミング情報とともにカプセル化します。
MidiFileFormat
オブジェクトには、一式のプロパティを組み込むことができます。 1つのプロパティは、キーと値のペアから成ります。キーはString
型で、対応するプロパティ値は任意のオブジェクトです。 プロパティには、作成者や著作権など、付加的な情報のメタデータを指定します。 プロパティはオプション情報であり、プロパティを提供または認識するためのファイル・リーダーおよびファイル・ライターの実装は必須ではありません。
次の表に、実装で使用される一般的なプロパティの例を示します。
プロパティ・キー | 値のタイプ | 説明 |
---|---|---|
"author" | String
| このファイルの作成者の名前 |
"title" | String
| このファイルのタイトル |
"copyright" | String
| 著作権メッセージ |
"date" | Date
| 録音またはリリースの日付 |
"comment" | String
| 任意のテキスト |
-
フィールドのサマリー
修飾子と型フィールド説明protected int
MIDIファイルの長さをバイトで表示したものです。protected float
MIDIファイルの分割形式です。protected long
MIDIファイルのデュレーションをマイクロ秒で表示したものです。protected int
MIDIファイルのタイミング解像度です。protected int
MIDIファイルの型です。static final int
長さが未知であることを表します。 -
コンストラクタのサマリー
コンストラクタ説明MidiFileFormat
(int type, float divisionType, int resolution, int bytes, long microseconds) MidiFileFormat
を構築します。MidiFileFormat
(int type, float divisionType, int resolution, int bytes, long microseconds, Map<String, Object> properties) MidiFileFormat
を、一式のプロパティを組み込んで構築します。 -
メソッドのサマリー
修飾子と型メソッド説明int
MIDIファイルの長さを8ビット・バイト単位で取得します。float
MIDIファイルのタイミング分割形式を取得します。long
MIDIファイルの長さをマイクロ秒単位で取得します。getProperty
(String key) キーによって指定されたプロパティ値を取得します。int
MIDIファイルのタイミング解像度を取得します。int
getType()
MIDIファイル・タイプを取得します。変更不可能なプロパティのマップを取得します。
-
フィールド詳細
-
UNKNOWN_LENGTH
public static final int UNKNOWN_LENGTH長さが未知であることを表します。 -
type
protected int typeMIDIファイルの型です。 -
divisionType
protected float divisionTypeMIDIファイルの分割形式です。 -
resolution
protected int resolutionMIDIファイルのタイミング解像度です。 -
byteLength
protected int byteLengthMIDIファイルの長さをバイトで表示したものです。 -
microsecondLength
protected long microsecondLengthMIDIファイルのデュレーションをマイクロ秒で表示したものです。
-
-
コンストラクタの詳細
-
MidiFileFormat
public MidiFileFormat(int type, float divisionType, int resolution, int bytes, long microseconds) MidiFileFormat
を構築します。- パラメータ:
type
- MIDIファイルの型(0、1、または2)divisionType
- タイミング分割形式(PPQ、またはSMPTE形式の1つ)resolution
- タイミング解像度bytes
- バイト単位のMIDIファイルの長さ、または未知の場合はUNKNOWN_LENGTH
microseconds
- マイクロ秒単位でのファイルの存続期間、または未知の場合はUNKNOWN_LENGTH
- 関連項目:
-
MidiFileFormat
public MidiFileFormat(int type, float divisionType, int resolution, int bytes, long microseconds, Map<String, Object> properties) MidiFileFormat
を、一式のプロパティを組み込んで構築します。- パラメータ:
type
- MIDIファイルの型(0、1、または2)divisionType
- タイミング分割形式(PPQ、またはSMPTE形式の1つ)resolution
- タイミング解像度bytes
- バイト単位のMIDIファイルの長さ、または未知の場合はUNKNOWN_LENGTH
microseconds
- マイクロ秒単位のファイルの長さ、またはわからない場合はUNKNOWN_LENGTH
properties
- プロパティを指定したMap<String,Object>
オブジェクト- 導入されたバージョン:
- 1.5
- 関連項目:
-
-
メソッドの詳細
-
getType
public int getType()MIDIファイル・タイプを取得します。- 戻り値:
- ファイルの型(0、1、または2)
-
getDivisionType
public float getDivisionType()MIDIファイルのタイミング分割形式を取得します。- 戻り値:
- 分割形式(PPQ、またはSMPTE形式の1つ)
- 関連項目:
-
getResolution
public int getResolution()MIDIファイルのタイミング解像度を取得します。 分割形式がPPQの場合、解像度は1ビート当たりのティックで指定されます。 SMTPEタイミングの場合、解像度は1フレームあたりのティックで指定されます。- 戻り値:
- 1ビート当たり(PPQ)または1フレーム当たり(SMPTE)のティック数
- 関連項目:
-
getByteLength
public int getByteLength()MIDIファイルの長さを8ビット・バイト単位で取得します。- 戻り値:
- ファイル内のバイト数、またはわからない場合は
UNKNOWN_LENGTH
- 関連項目:
-
getMicrosecondLength
public long getMicrosecondLength()MIDIファイルの長さをマイクロ秒単位で取得します。- 戻り値:
- マイクロ秒単位のファイルの長さ、またはわからない場合は
UNKNOWN_LENGTH
- 関連項目:
-
properties
変更不可能なプロパティのマップを取得します。 プロパティの概念の詳細は、class description
の説明を参照してください。- 戻り値:
- すべてのプロパティを格納する
Map<String,Object>
オブジェクト。 プロパティが1つも認識されない場合は、空のマップが返される。 - 導入されたバージョン:
- 1.5
- 関連項目:
-
getProperty
キーによって指定されたプロパティ値を取得します。 プロパティの概念の詳細は、class description
の説明を参照してください。指定したプロパティが特定のファイル形式で定義されていない場合、このメソッドは
null
を返します。- パラメータ:
key
- 取得したいプロパティのキー- 戻り値:
- 指定されたキーを持つプロパティの値、またはプロパティが存在しない場合は
null
- 導入されたバージョン:
- 1.5
- 関連項目:
-