MidiFileFormat

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.sound.midi
类 MidiFileFormat

java.lang.Object
  javax.sound.midi.MidiFileFormat

public class MidiFileFormat
extends Object
extends Object

MidiFileFormat 对象，它封装了 MIDI 文件的类型、长度和定时信息。

MidiFileFormat 对象可包含一组属性。属性是一对键和值：键的类型是 String，关联属性值是任意对象。属性指定其他的信息元数据（如作者或版权）。属性是可选信息，不要求文件 reader 和文件 writer 实现提供或识别属性。

下表列出了一些应在实现中使用的常见属性：

属性键	值类型	描述
"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 文件的 division 类型。
`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 文件的定时 division 类型。
`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 文件的 division 类型。

另请参见：: 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 - 定时 division 类型（PPQ 或某一 SMPTE 类型）; 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 - 定时 division 类型（PPQ 或某一 SMPTE 类型）; 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 文件的定时 division 类型。

返回：: division 类型（PPQ 或某一 SMPTE 类型）
另请参见：: 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 文件的定时精度。如果 division 类型为 PPQ，则精度按每拍的节拍数指定。对于 SMTPE 定时，精度按每帧的节拍数指定。

返回：: 每拍 (PPQ) 或每帧 (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()

获得属性的一个不可修改的映射。在类描述中对属性的概念进行了进一步的介绍。

返回：: 一个包含所有属性的 Map<String,Object> 对象。如果没有任何可识别的属性，则返回一个空映射。
从以下版本开始：: 1.5
另请参见：: getProperty(String)

getProperty

public Object getProperty(String key)

获得由键指定的属性值。在类描述中对属性的概念进行了进一步的介绍。

如果对于一个特定的文件格式，指定的属性未定义，则此方法返回 null。

参数：: key - 所需属性的键
返回：: 具有指定键的属性的值，如果此属性不存在，则返回 null。
从以下版本开始：: 1.5
另请参见：: properties

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。