JavaTM 2 Platform
Standard Ed. 5.0

javax.sound.midi
类 Instrument

java.lang.Object
  继承者 javax.sound.midi.SoundbankResource
      继承者 javax.sound.midi.Instrument

public abstract class Instrument
extends SoundbankResource

乐器是带特定参数设置的声音合成算法,通常是为模仿现实世界的特定乐器或为获得特定音效而设计的。乐器通常存储在称为 soundbank(音库)的集合中。要让乐器演奏乐曲,必须先将其加载到合成器中,然后还需要在一个或多个通道中通过程序更改命令选用该乐器。这些通道上后续接收的 MIDI 乐曲将使用选定乐器的声音演奏。

另请参见:
Soundbank, Soundbank.getInstruments(), Patch, Synthesizer.loadInstrument(Instrument), MidiChannel.programChange(int, int)

构造方法摘要
protected Instrument(Soundbank soundbank, Patch patch, String name, Class<?> dataClass)
          从指定的 Patch 构造一个新的 MIDI 乐器。
 
方法摘要
 Patch getPatch()
          获得 Patch 对象,该对象指示此乐器在合成器中存储位置处的库和程序号。
 
从类 javax.sound.midi.SoundbankResource 继承的方法
getData, getDataClass, getName, getSoundbank
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

Instrument

protected Instrument(Soundbank soundbank,
                     Patch patch,
                     String name,
                     Class<?> dataClass)
从指定的 Patch 构造一个新的 MIDI 乐器。在有加载此乐器的后续请求时,音库将搜索其内容中是否有此乐器的 Patch,然后将此乐器加载到由 Patch 对象指示的库和程序位置的合成器中。

参数:
soundbank - 包含此乐器的音库
patch - 此乐器的包
name - 此乐器的名称
dataClass - 用于表示样本数据的类。
另请参见:
Synthesizer.loadInstrument(Instrument)
方法详细信息

getPatch

public Patch getPatch()
获得 Patch 对象,该对象指示此乐器在合成器中存储位置处的库和程序号。

返回:
此乐器的包

JavaTM 2 Platform
Standard Ed. 5.0

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

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策