mnSetOutputSmoothValues

This command is used to control settings that impact upon the smoothness of sound output.

This command can be used when the output instance is inactive and when it is active.

If you do not want to change an option set it to 0 and it will be left unchanged.

Unsmooth sound output has small noticeable gaps between each packet of data added using mnPlayData. Smooth sound output has no noticeable gaps.

The higher this value the MillisecondsOfStoredDataCap the smoother sound output will be, but the more delay between mnPlayData and actual sound output.

For an explanation of TimeSinceLastAddedCap I will use the example of outputting speech.

If TimeSinceLastAddedCap is too high then the end of a people’s speech will be unsmooth, with a noticeable gap towards the end of each speech.

If TimeSinceLastAddedCap is too low then MillisecondsOfStoredDataCap is overridden and all sound output will be unsmooth.

Parameters

int InstanceID: The output instance ID that this command should use.

unsigned int MillisecondsOfStoredDataCap: Queued data will not be played until this number of milliseconds worth of data is queued. By default this is 500ms.

unsigned int TimeSinceLastAddedCap: If queued data has not reached the MillisecondsOfStoredDataCap then the data will be played anyway if no new data is added within this number of milliseconds. By default this is 300ms.

Returns (Integer)

0 if no error occurred.

-1 if an error occurred.

Present in

DBP

C++

.Net