MidiFileFormat (Java Platform SE 7)

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`	任意のテキスト

関連項目:: MidiSystem.getMidiFileFormat(java.io.File), Sequencer.setSequence(java.io.InputStream stream)

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`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()` 変更不可能なプロパティーのマップを取得します。

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - UNKNOWN_LENGTH
```
public static final int UNKNOWN_LENGTH
```
    長さが未知であることを表します。
    
    関連項目:
    getByteLength()、getMicrosecondLength()、定数フィールド値
  - type
```
protected int type
```
    MIDI ファイルの型です。
  - divisionType
```
protected float divisionType
```
    MIDI ファイルの分割形式です。
    
    関連項目:
    Sequence.PPQ, Sequence.SMPTE_24, Sequence.SMPTE_25, Sequence.SMPTE_30DROP, Sequence.SMPTE_30
  - 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 - MIDI ファイルのデュレーション (マイクロ秒単位) か、長さが未知の場合は 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 - MIDI ファイルのデュレーション (マイクロ秒単位) か、長さが未知の場合は 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.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()

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス MidiFileFormat

フィールドのサマリー

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

メソッドのサマリー

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

フィールドの詳細

UNKNOWN_LENGTH

type

divisionType

resolution

byteLength

microsecondLength

コンストラクタの詳細

MidiFileFormat

MidiFileFormat

メソッドの詳細

getType

getDivisionType

getResolution

getByteLength

getMicrosecondLength

properties

getProperty