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: About this document Up: 7 Miscellaneous Previous: Data types