Performance Object
.gif) |
The Performance object manages music playback. Most applications have a single performance, but it is possible to have multiple performances, each with its own global parameters such as tempo and volume. The application can pass a Performance object to the script in an object variable. If the script calls a Performance method without an Object prefix, the default performance is assumed.
A Performance object has the following methods.
| Method | Description |
| GetMasterGrooveLevel | Retrieves the current master groove level, which is a value added to all groove levels in the performance. |
| GetMasterTempo | Retrieves the current master tempo. |
| GetMasterTranspose | Retrieves the current master transposition. |
| GetMasterVolume | Retrieves the current master volume. |
| Rand | Returns a randomly generated integer. |
| SetMasterGrooveLevel | Sets a value to be added to all groove levels in the performance. |
| SetMasterTempo | Sets a scaling factor that is applied to the tempo. |
| SetMasterTranspose | Sets the current master transposition. |
| SetMasterVolume | Sets the master volume of the performance. |
| Trace | Sends a lyrics message that displays text in the DirectMusic Producer message window. |