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