next up previous contents
Next: About this document Up: 7 Miscellaneous Previous: Data types

Functions

This section describes all available miscellaneous MIDAS Digital Audio System functions.



 

7.3.1 MIDASaddEchoEffect

 
MIDASechoHandle MIDASaddEchoEffect(MIDASechoSet *echoSet);

Adds an echo effect to the output.

Input

echoSet
The echo set that describes the effect, see MIDASechoSet

Description

This function adds an echo effect to the output. An echo effect is described by a MIDASechoSet structure, and can consist of one or more echoes. Any number of echo effects can be active simultaneously, the effects added last are processed first. After this function returns, the echo set structure is no longer used by MIDAS and may be deallocated.

Note that echo effects can use large amounts of CPU time, and may even be unusable on 486-class and slower computers.

Return value

MIDAS echo handle for the echo effect if successful, NULL if not.

Operating systems

All

See also

MIDASremoveEchoEffect



 

7.3.2 MIDASaddPostProcessor

 
BOOL MIDASaddPostProcessor(MIDASpostProcessor *postProc,
    unsigned procPos, void *userData);

Adds a user post-processor to the output.

Input

postProc
A pointer to a MIDASpostProcessor structure that describes the post-processor.
procPos
The post-processor position in the post-processor list, see enum MIDASpostProcPosition.
userData
An user data pointer that will be passed to the post-processing functions.

Description

This function adds a user post-processor to the output. The post-processor can be used to alter the output sound data in interesting ways, or to gather information about the data for graphical displays and such. See the MIDASpostProcessor structure documentation for more information.

The postProc structure may not be deallocated or re-used after this function returns, as it is used by MIDAS Digital Audio System internally. The post-processor can be removed from the output with MIDASremovePostProcessor, after which the structure can be deallocated.

Return value

TRUE if successful, FALSE if not.

Operating systems

All

See also

MIDASremovePostProcessor



 

7.3.3 MIDASremoveEchoEffect

 
BOOL MIDASremoveEchoEffect(MIDASechoHandle echoHandle);

Removes an echo effect from the output.

Input

echoHandle
Echo handle for the effect that will be removed

Description

This function removes an echo effect, added with MIDASaddEchoEffect, from the output. The echo handle will no longer be valid after this function has been called. Echo effects do not need to be removed in the same order they were added in, but can be added and removed in any order.

Return value

TRUE if successful, FALSE if not

Operating systems

All

See also

MIDASaddEchoEffect



 

7.3.4 MIDASremovePostProcessor

 
BOOL MIDASremovePostProcessor(MIDASpostProcessor *postProc);

Removes a user post-processor from the output.

Input

postProc
A pointer to a MIDASpostProcessor structure that describes the post-processor.

Description

This function removes a user post-processor added with MIDASaddPostProcessor from the output. The post-processing functions will no longer be called, and the post-processor structure may be deallocated.

Return value

TRUE if successful, FALSE if not.

Operating systems

All

See also

MIDASaddPostProcessor


next up previous contents
Next: About this document Up: 7 Miscellaneous Previous: Data types

Petteri Kangaslampi
Sun Mar 1 22:15:08 EET 1998