All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class quicktime.std.music.ToneDescription

java.lang.Object
   |
   +----quicktime.util.QTByteObject
           |
           +----quicktime.std.music.ToneDescription

public final class ToneDescription
extends QTByteObject
implements QuickTimeLib, Cloneable
Provides the information needed to produce a specific musical sound.


Variable Index

 o kNativeSize
This is the size (the number of bytes) that are required for this class

Constructor Index

 o ToneDescription()
Creates a ToneDescription object with no initial settings.
 o ToneDescription(int)
Initializes the ToneDescription instance with the appropriate instrument based on the specified gmNumber.
 o ToneDescription(NoteAllocator, int)
Initializes the ToneDescription instance with the appropriate instrument based on the specified gmNumber.

Method Index

 o clone()
Makes a copy of a ToneDescription object.
 o getGMNumber()
Returns the current gm Number of the described instrument's synthesiser.
 o getInstrumentName()
Returns the current name of the described instrument.
 o getInstrumentNumber()
Returns the current number of the described instrument.
 o getSynthesizerName()
Returns the current name of the described instrument's synthesiser.
 o getSynthesizerType()
Returns the current OSType of the described instrument's synthesiser.
 o pickInstrument(NoteAllocator, String, int)
Initialises the tone description structure through providing the user with a dialog that allows the user to choose the instrument.
 o setGMNumber(int)
Sets the current gm Number of the described instrument's synthesiser.
 o setInstrumentName(String)
Sets the current name of the described instrument.
 o setInstrumentNumber(int)
Sets the current number of the described instrument.
 o setSynthesizerName(String)
Sets the current name of the described instrument's synthesiser.
 o setSynthesizerType(int)
Sets the current OSType of the described instrument's synthesiser.
 o stuff(NoteAllocator, int)
Initializes the calling ToneDescription instance with the details of the note channel specified by the gmNumber.
 o toString()
Returns a string representation of this object

Variables

 o kNativeSize
 public static final int kNativeSize
This is the size (the number of bytes) that are required for this class

Constructors

 o ToneDescription
 public ToneDescription()
Creates a ToneDescription object with no initial settings.

 o ToneDescription
 public ToneDescription(int gmNumber) throws QTException
Initializes the ToneDescription instance with the appropriate instrument based on the specified gmNumber.

QuickTime::NAStuffToneDescription

Parameters:
gmNumber - instrument number
 o ToneDescription
 public ToneDescription(NoteAllocator na,
                        int gmNumber) throws StdQTException
Initializes the ToneDescription instance with the appropriate instrument based on the specified gmNumber.

QuickTime::NAStuffToneDescription

Parameters:
na - the NoteAllocator component instance to use
gmNumber - instrument number

Methods

 o getSynthesizerType
 public final int getSynthesizerType()
Returns the current OSType of the described instrument's synthesiser.

Returns:
the OSType
 o setSynthesizerType
 public final void setSynthesizerType(int type)
Sets the current OSType of the described instrument's synthesiser.

Parameters:
type - the OSType
 o getSynthesizerName
 public final String getSynthesizerName() throws UtilException
Returns the current name of the described instrument's synthesiser.

Returns:
the Synthesizer name
 o setSynthesizerName
 public final void setSynthesizerName(String name) throws UtilException
Sets the current name of the described instrument's synthesiser.

Parameters:
name - the Synthesizer name
 o getInstrumentName
 public final String getInstrumentName() throws UtilException
Returns the current name of the described instrument.

Returns:
the instrumentName
 o setInstrumentName
 public final void setInstrumentName(String name) throws UtilException
Sets the current name of the described instrument.

Parameters:
name - the instrumentName
 o getInstrumentNumber
 public final int getInstrumentNumber()
Returns the current number of the described instrument.

Returns:
the instrumentNumber
 o setInstrumentNumber
 public final void setInstrumentNumber(int num)
Sets the current number of the described instrument.

Parameters:
num - the instrumentNumber
 o getGMNumber
 public final int getGMNumber()
Returns the current gm Number of the described instrument's synthesiser.

Returns:
the gm Number
 o setGMNumber
 public final void setGMNumber(int gmNumber)
Sets the current gm Number of the described instrument's synthesiser.

Parameters:
gmNumber - the gm Number
 o stuff
 public final void stuff(NoteAllocator na,
                         int gmNumber) throws StdQTException
Initializes the calling ToneDescription instance with the details of the note channel specified by the gmNumber.

QuickTime::NAStuffToneDescription

Parameters:
na - the Note Allocator component to use
gmNumber - instrument number
 o pickInstrument
 public final void pickInstrument(NoteAllocator na,
                                  String prompt,
                                  int flags) throws StdQTException
Initialises the tone description structure through providing the user with a dialog that allows the user to choose the instrument.

QuickTime::NAPickInstrument

Parameters:
na - the Note Allocator component to use
prompt - Dialog box prompt "New Instrument..."
flags - flags to limit user options
 o toString
 public String toString()
Returns a string representation of this object

Overrides:
toString in class QTByteObject
 o clone
 public Object clone()
Makes a copy of a ToneDescription object.

Overrides:
clone in class Object

All Packages  Class Hierarchy  This Package  Previous  Next  Index