cannam@124: /** @file patest_stop_playout.c
cannam@124: 	@ingroup test_src
cannam@124: 	@brief Test whether all queued samples are played when Pa_StopStream()
cannam@124:             is used with a callback or read/write stream, or when the callback
cannam@124:             returns paComplete.
cannam@124: 	@author Ross Bencina <rossb@audiomulch.com>
cannam@124: */
cannam@124: /*
cannam@124:  * $Id: patest_stop_playout.c 1446 2010-01-24 12:27:31Z rossb $
cannam@124:  *
cannam@124:  * This program uses the PortAudio Portable Audio Library.
cannam@124:  * For more information see: http://www.portaudio.com/
cannam@124:  * Copyright (c) 1999-2004 Ross Bencina and Phil Burk
cannam@124:  *
cannam@124:  * Permission is hereby granted, free of charge, to any person obtaining
cannam@124:  * a copy of this software and associated documentation files
cannam@124:  * (the "Software"), to deal in the Software without restriction,
cannam@124:  * including without limitation the rights to use, copy, modify, merge,
cannam@124:  * publish, distribute, sublicense, and/or sell copies of the Software,
cannam@124:  * and to permit persons to whom the Software is furnished to do so,
cannam@124:  * subject to the following conditions:
cannam@124:  *
cannam@124:  * The above copyright notice and this permission notice shall be
cannam@124:  * included in all copies or substantial portions of the Software.
cannam@124:  *
cannam@124:  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
cannam@124:  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
cannam@124:  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
cannam@124:  * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
cannam@124:  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
cannam@124:  * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
cannam@124:  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
cannam@124:  */
cannam@124: 
cannam@124: /*
cannam@124:  * The text above constitutes the entire PortAudio license; however, 
cannam@124:  * the PortAudio community also makes the following non-binding requests:
cannam@124:  *
cannam@124:  * Any person wishing to distribute modifications to the Software is
cannam@124:  * requested to send the modifications to the original developer so that
cannam@124:  * they can be incorporated into the canonical version. It is also 
cannam@124:  * requested that these non-binding requests be included along with the 
cannam@124:  * license above.
cannam@124:  */
cannam@124: #include <stdio.h>
cannam@124: #include <math.h>
cannam@124: #include "portaudio.h"
cannam@124: 
cannam@124: #define SAMPLE_RATE         (44100)
cannam@124: #define FRAMES_PER_BUFFER   (1024)
cannam@124: 
cannam@124: #define TONE_SECONDS        (1)      /* long tone */
cannam@124: #define TONE_FADE_SECONDS   (.04)    /* fades at start and end of long tone */
cannam@124: #define GAP_SECONDS         (.25)     /* gap between long tone and blip */
cannam@124: #define BLIP_SECONDS        (.035)   /* short blip */
cannam@124: 
cannam@124: #define NUM_REPEATS         (3)
cannam@124: 
cannam@124: #ifndef M_PI
cannam@124: #define M_PI (3.14159265)
cannam@124: #endif
cannam@124: 
cannam@124: #define TABLE_SIZE          (2048)
cannam@124: typedef struct
cannam@124: {
cannam@124:     float sine[TABLE_SIZE+1];
cannam@124: 
cannam@124:     int repeatCount;
cannam@124:     
cannam@124:     double phase;
cannam@124:     double lowIncrement, highIncrement;
cannam@124:     
cannam@124:     int gap1Length, toneLength, toneFadesLength, gap2Length, blipLength;
cannam@124:     int gap1Countdown, toneCountdown, gap2Countdown, blipCountdown;
cannam@124: }
cannam@124: TestData;
cannam@124: 
cannam@124: 
cannam@124: static void RetriggerTestSignalGenerator( TestData *data )
cannam@124: {
cannam@124:     data->phase = 0.;
cannam@124:     data->gap1Countdown = data->gap1Length;
cannam@124:     data->toneCountdown = data->toneLength;
cannam@124:     data->gap2Countdown = data->gap2Length;
cannam@124:     data->blipCountdown = data->blipLength;
cannam@124: }
cannam@124: 
cannam@124: 
cannam@124: static void ResetTestSignalGenerator( TestData *data )
cannam@124: {
cannam@124:     data->repeatCount = 0;
cannam@124:     RetriggerTestSignalGenerator( data );
cannam@124: }
cannam@124: 
cannam@124: 
cannam@124: static void InitTestSignalGenerator( TestData *data )
cannam@124: {
cannam@124:     int signalLengthModBufferLength, i;
cannam@124: 
cannam@124:     /* initialise sinusoidal wavetable */
cannam@124:     for( i=0; i<TABLE_SIZE; i++ )
cannam@124:     {
cannam@124:         data->sine[i] = (float) sin( ((double)i/(double)TABLE_SIZE) * M_PI * 2. );
cannam@124:     }
cannam@124:     data->sine[TABLE_SIZE] = data->sine[0]; /* guard point for linear interpolation */
cannam@124: 
cannam@124: 
cannam@124:     
cannam@124:     data->lowIncrement = (330. / SAMPLE_RATE) * TABLE_SIZE;
cannam@124:     data->highIncrement = (1760. / SAMPLE_RATE) * TABLE_SIZE;
cannam@124: 
cannam@124:     data->gap1Length = GAP_SECONDS * SAMPLE_RATE;
cannam@124:     data->toneLength = TONE_SECONDS * SAMPLE_RATE;
cannam@124:     data->toneFadesLength = TONE_FADE_SECONDS * SAMPLE_RATE;
cannam@124:     data->gap2Length = GAP_SECONDS * SAMPLE_RATE;
cannam@124:     data->blipLength = BLIP_SECONDS * SAMPLE_RATE;
cannam@124: 
cannam@124:     /* adjust signal length to be a multiple of the buffer length */
cannam@124:     signalLengthModBufferLength = (data->gap1Length + data->toneLength + data->gap2Length + data->blipLength) % FRAMES_PER_BUFFER;
cannam@124:     if( signalLengthModBufferLength > 0 )
cannam@124:         data->toneLength += signalLengthModBufferLength;
cannam@124: 
cannam@124:     ResetTestSignalGenerator( data );
cannam@124: }
cannam@124: 
cannam@124: 
cannam@124: #define MIN( a, b ) (((a)<(b))?(a):(b))
cannam@124: 
cannam@124: static void GenerateTestSignal( TestData *data, float *stereo, int frameCount )
cannam@124: {
cannam@124:     int framesGenerated = 0;
cannam@124:     float output;
cannam@124:     long index;
cannam@124:     float fraction;
cannam@124:     int count, i;
cannam@124: 
cannam@124:     while( framesGenerated < frameCount && data->repeatCount < NUM_REPEATS )
cannam@124:     {
cannam@124:         if( framesGenerated < frameCount && data->gap1Countdown > 0 ){
cannam@124:             count = MIN( frameCount - framesGenerated, data->gap1Countdown );
cannam@124:             for( i=0; i < count; ++i )
cannam@124:             {
cannam@124:                 *stereo++ = 0.f;
cannam@124:                 *stereo++ = 0.f;
cannam@124:             }
cannam@124: 
cannam@124:             data->gap1Countdown -= count;
cannam@124:             framesGenerated += count;
cannam@124:         }
cannam@124:     
cannam@124:         if( framesGenerated < frameCount && data->toneCountdown > 0 ){
cannam@124:             count = MIN( frameCount - framesGenerated, data->toneCountdown );
cannam@124:             for( i=0; i < count; ++i )
cannam@124:             {
cannam@124:                 /* tone with data->lowIncrement phase increment */
cannam@124:                 index = (long)data->phase;
cannam@124:                 fraction = data->phase - index;
cannam@124:                 output = data->sine[ index ] + (data->sine[ index + 1 ] - data->sine[ index ]) * fraction;
cannam@124: 
cannam@124:                 data->phase += data->lowIncrement;
cannam@124:                 while( data->phase >= TABLE_SIZE )
cannam@124:                     data->phase -= TABLE_SIZE;
cannam@124: 
cannam@124:                 /* apply fade to ends */
cannam@124: 
cannam@124:                 if( data->toneCountdown < data->toneFadesLength )
cannam@124:                 {
cannam@124:                     /* cosine-bell fade out at end */
cannam@124:                     output *= (-cos(((float)data->toneCountdown / (float)data->toneFadesLength) * M_PI) + 1.) * .5;
cannam@124:                 }
cannam@124:                 else if( data->toneCountdown > data->toneLength - data->toneFadesLength ) 
cannam@124:                 {
cannam@124:                     /* cosine-bell fade in at start */
cannam@124:                     output *= (cos(((float)(data->toneCountdown - (data->toneLength - data->toneFadesLength)) / (float)data->toneFadesLength) * M_PI) + 1.) * .5;
cannam@124:                 }
cannam@124: 
cannam@124:                 output *= .5; /* play tone half as loud as blip */
cannam@124:             
cannam@124:                 *stereo++ = output;
cannam@124:                 *stereo++ = output;
cannam@124: 
cannam@124:                 data->toneCountdown--;
cannam@124:             }                         
cannam@124: 
cannam@124:             framesGenerated += count;
cannam@124:         }
cannam@124: 
cannam@124:         if( framesGenerated < frameCount && data->gap2Countdown > 0 ){
cannam@124:             count = MIN( frameCount - framesGenerated, data->gap2Countdown );
cannam@124:             for( i=0; i < count; ++i )
cannam@124:             {
cannam@124:                 *stereo++ = 0.f;
cannam@124:                 *stereo++ = 0.f;
cannam@124:             }
cannam@124: 
cannam@124:             data->gap2Countdown -= count;
cannam@124:             framesGenerated += count;
cannam@124:         }
cannam@124: 
cannam@124:         if( framesGenerated < frameCount && data->blipCountdown > 0 ){
cannam@124:             count = MIN( frameCount - framesGenerated, data->blipCountdown );
cannam@124:             for( i=0; i < count; ++i )
cannam@124:             {
cannam@124:                 /* tone with data->highIncrement phase increment */
cannam@124:                 index = (long)data->phase;
cannam@124:                 fraction = data->phase - index;
cannam@124:                 output = data->sine[ index ] + (data->sine[ index + 1 ] - data->sine[ index ]) * fraction;
cannam@124: 
cannam@124:                 data->phase += data->highIncrement;
cannam@124:                 while( data->phase >= TABLE_SIZE )
cannam@124:                     data->phase -= TABLE_SIZE;
cannam@124: 
cannam@124:                 /* cosine-bell envelope over whole blip */
cannam@124:                 output *= (-cos( ((float)data->blipCountdown / (float)data->blipLength) * 2. * M_PI) + 1.) * .5;
cannam@124:                 
cannam@124:                 *stereo++ = output;
cannam@124:                 *stereo++ = output;
cannam@124: 
cannam@124:                 data->blipCountdown--;
cannam@124:             }
cannam@124: 
cannam@124:             framesGenerated += count;
cannam@124:         }
cannam@124: 
cannam@124: 
cannam@124:         if( data->blipCountdown == 0 )
cannam@124:         {
cannam@124:             RetriggerTestSignalGenerator( data );
cannam@124:             data->repeatCount++;
cannam@124:         }        
cannam@124:     }
cannam@124: 
cannam@124:     if( framesGenerated < frameCount )
cannam@124:     {
cannam@124:         count = frameCount - framesGenerated;
cannam@124:         for( i=0; i < count; ++i )
cannam@124:         {
cannam@124:             *stereo++ = 0.f;
cannam@124:             *stereo++ = 0.f;
cannam@124:         }
cannam@124:     }
cannam@124: }
cannam@124: 
cannam@124: 
cannam@124: static int IsTestSignalFinished( TestData *data )
cannam@124: {
cannam@124:     if( data->repeatCount >= NUM_REPEATS )
cannam@124:         return 1;
cannam@124:     else
cannam@124:         return 0;
cannam@124: }
cannam@124: 
cannam@124: 
cannam@124: static int TestCallback1( const void *inputBuffer, void *outputBuffer,
cannam@124:                             unsigned long frameCount,
cannam@124:                             const PaStreamCallbackTimeInfo* timeInfo,
cannam@124:                             PaStreamCallbackFlags statusFlags,
cannam@124:                             void *userData )
cannam@124: {
cannam@124:     (void) inputBuffer; /* Prevent unused variable warnings. */
cannam@124:     (void) timeInfo;
cannam@124:     (void) statusFlags;
cannam@124: 
cannam@124:     GenerateTestSignal( (TestData*)userData, (float*)outputBuffer, frameCount );
cannam@124: 
cannam@124:     if( IsTestSignalFinished( (TestData*)userData ) )
cannam@124:         return paComplete;
cannam@124:     else
cannam@124:         return paContinue;
cannam@124: }
cannam@124: 
cannam@124: 
cannam@124: volatile int testCallback2Finished = 0;
cannam@124: 
cannam@124: static int TestCallback2( const void *inputBuffer, void *outputBuffer,
cannam@124:                             unsigned long frameCount,
cannam@124:                             const PaStreamCallbackTimeInfo* timeInfo,
cannam@124:                             PaStreamCallbackFlags statusFlags,
cannam@124:                             void *userData )
cannam@124: {
cannam@124:     (void) inputBuffer; /* Prevent unused variable warnings. */
cannam@124:     (void) timeInfo;
cannam@124:     (void) statusFlags;
cannam@124: 
cannam@124:     GenerateTestSignal( (TestData*)userData, (float*)outputBuffer, frameCount );
cannam@124: 
cannam@124:     if( IsTestSignalFinished( (TestData*)userData ) )
cannam@124:         testCallback2Finished = 1;
cannam@124:    
cannam@124:     return paContinue;
cannam@124: }
cannam@124: 
cannam@124: /*******************************************************************/
cannam@124: int main(void);
cannam@124: int main(void)
cannam@124: {
cannam@124:     PaStreamParameters outputParameters;
cannam@124:     PaStream *stream;
cannam@124:     PaError err;
cannam@124:     TestData data;
cannam@124:     float writeBuffer[ FRAMES_PER_BUFFER * 2 ];
cannam@124:     
cannam@124:     printf("PortAudio Test: check that stopping stream plays out all queued samples. SR = %d, BufSize = %d\n", SAMPLE_RATE, FRAMES_PER_BUFFER);
cannam@124: 
cannam@124:     InitTestSignalGenerator( &data );
cannam@124:     
cannam@124:     err = Pa_Initialize();
cannam@124:     if( err != paNoError ) goto error;
cannam@124: 
cannam@124:     outputParameters.device = Pa_GetDefaultOutputDevice(); /* default output device */
cannam@124:     outputParameters.channelCount = 2;       /* stereo output */
cannam@124:     outputParameters.sampleFormat = paFloat32; /* 32 bit floating point output */
cannam@124:     outputParameters.suggestedLatency = Pa_GetDeviceInfo( outputParameters.device )->defaultHighOutputLatency;
cannam@124:     outputParameters.hostApiSpecificStreamInfo = NULL;
cannam@124: 
cannam@124: /* test paComplete ---------------------------------------------------------- */
cannam@124: 
cannam@124:     ResetTestSignalGenerator( &data );
cannam@124: 
cannam@124:     err = Pa_OpenStream(
cannam@124:               &stream,
cannam@124:               NULL, /* no input */
cannam@124:               &outputParameters,
cannam@124:               SAMPLE_RATE,
cannam@124:               FRAMES_PER_BUFFER,
cannam@124:               paClipOff,      /* we won't output out of range samples so don't bother clipping them */
cannam@124:               TestCallback1,
cannam@124:               &data );
cannam@124:     if( err != paNoError ) goto error;
cannam@124: 
cannam@124:     err = Pa_StartStream( stream );
cannam@124:     if( err != paNoError ) goto error;
cannam@124: 
cannam@124:     printf("\nPlaying 'tone-blip' %d times using callback, stops by returning paComplete from callback.\n", NUM_REPEATS );
cannam@124:     printf("If final blip is not intact, callback+paComplete implementation may be faulty.\n\n" );
cannam@124: 
cannam@124:     while( (err = Pa_IsStreamActive( stream )) == 1 )
cannam@124:         Pa_Sleep( 2 );
cannam@124: 
cannam@124:     if( err != 0 ) goto error;
cannam@124: 
cannam@124:     err = Pa_StopStream( stream );
cannam@124:     if( err != paNoError ) goto error;
cannam@124: 
cannam@124:     err = Pa_CloseStream( stream );
cannam@124:     if( err != paNoError ) goto error;
cannam@124: 
cannam@124:     Pa_Sleep( 500 );
cannam@124: 
cannam@124: 
cannam@124: /* test paComplete ---------------------------------------------------------- */
cannam@124: 
cannam@124:     ResetTestSignalGenerator( &data );
cannam@124: 
cannam@124:     err = Pa_OpenStream(
cannam@124:               &stream,
cannam@124:               NULL, /* no input */
cannam@124:               &outputParameters,
cannam@124:               SAMPLE_RATE,
cannam@124:               FRAMES_PER_BUFFER,
cannam@124:               paClipOff,      /* we won't output out of range samples so don't bother clipping them */
cannam@124:               TestCallback1,
cannam@124:               &data );
cannam@124:     if( err != paNoError ) goto error;
cannam@124: 
cannam@124:     err = Pa_StartStream( stream );
cannam@124:     if( err != paNoError ) goto error;
cannam@124: 
cannam@124:     printf("\nPlaying 'tone-blip' %d times using callback, stops by returning paComplete from callback.\n", NUM_REPEATS );
cannam@124:     printf("If final blip is not intact or is followed by garbage, callback+paComplete implementation may be faulty.\n\n" );
cannam@124: 
cannam@124:     while( (err = Pa_IsStreamActive( stream )) == 1 )
cannam@124:         Pa_Sleep( 5 );
cannam@124: 
cannam@124:     printf("Waiting 5 seconds after paComplete before stopping the stream. Tests that buffers are flushed correctly.\n");
cannam@124:     Pa_Sleep( 5000 );
cannam@124: 
cannam@124:     if( err != 0 ) goto error;
cannam@124: 
cannam@124:     err = Pa_StopStream( stream );
cannam@124:     if( err != paNoError ) goto error;
cannam@124: 
cannam@124:     err = Pa_CloseStream( stream );
cannam@124:     if( err != paNoError ) goto error;
cannam@124: 
cannam@124:     Pa_Sleep( 500 );
cannam@124: 
cannam@124: 
cannam@124: /* test Pa_StopStream() with callback --------------------------------------- */
cannam@124: 
cannam@124:     ResetTestSignalGenerator( &data );
cannam@124: 
cannam@124:     testCallback2Finished = 0;
cannam@124:     
cannam@124:     err = Pa_OpenStream(
cannam@124:               &stream,
cannam@124:               NULL, /* no input */
cannam@124:               &outputParameters,
cannam@124:               SAMPLE_RATE,
cannam@124:               FRAMES_PER_BUFFER,
cannam@124:               paClipOff,      /* we won't output out of range samples so don't bother clipping them */
cannam@124:               TestCallback2,
cannam@124:               &data );
cannam@124:     if( err != paNoError ) goto error;
cannam@124: 
cannam@124:     err = Pa_StartStream( stream );
cannam@124:     if( err != paNoError ) goto error;
cannam@124: 
cannam@124: 
cannam@124:     printf("\nPlaying 'tone-blip' %d times using callback, stops by calling Pa_StopStream.\n", NUM_REPEATS );
cannam@124:     printf("If final blip is not intact, callback+Pa_StopStream implementation may be faulty.\n\n" );
cannam@124: 
cannam@124:     /* note that polling a volatile flag is not a good way to synchronise with
cannam@124:         the callback, but it's the best we can do portably. */
cannam@124:     while( !testCallback2Finished )
cannam@124:         Pa_Sleep( 2 );
cannam@124: 
cannam@124:     Pa_Sleep( 500 );
cannam@124: 
cannam@124:     err = Pa_StopStream( stream );
cannam@124:     if( err != paNoError ) goto error;
cannam@124:     
cannam@124: 
cannam@124:     err = Pa_CloseStream( stream );
cannam@124:     if( err != paNoError ) goto error;
cannam@124: 
cannam@124:     Pa_Sleep( 500 );
cannam@124: 
cannam@124: /* test Pa_StopStream() with Pa_WriteStream --------------------------------- */
cannam@124: 
cannam@124:     ResetTestSignalGenerator( &data );
cannam@124: 
cannam@124:     err = Pa_OpenStream(
cannam@124:               &stream,
cannam@124:               NULL, /* no input */
cannam@124:               &outputParameters,
cannam@124:               SAMPLE_RATE,
cannam@124:               FRAMES_PER_BUFFER,
cannam@124:               paClipOff,      /* we won't output out of range samples so don't bother clipping them */
cannam@124:               NULL, /* no callback, use blocking API */
cannam@124:               NULL ); /* no callback, so no callback userData */
cannam@124:     if( err != paNoError ) goto error;
cannam@124: 
cannam@124:     err = Pa_StartStream( stream );
cannam@124:     if( err != paNoError ) goto error;
cannam@124: 
cannam@124: 
cannam@124:     printf("\nPlaying 'tone-blip' %d times using Pa_WriteStream, stops by calling Pa_StopStream.\n", NUM_REPEATS );
cannam@124:     printf("If final blip is not intact, Pa_WriteStream+Pa_StopStream implementation may be faulty.\n\n" );
cannam@124: 
cannam@124:     do{
cannam@124:         GenerateTestSignal( &data, writeBuffer, FRAMES_PER_BUFFER );
cannam@124:         err = Pa_WriteStream( stream, writeBuffer, FRAMES_PER_BUFFER );
cannam@124:         if( err != paNoError ) goto error;
cannam@124:         
cannam@124:     }while( !IsTestSignalFinished( &data ) );
cannam@124: 
cannam@124:     err = Pa_StopStream( stream );
cannam@124:     if( err != paNoError ) goto error;
cannam@124:     
cannam@124: 
cannam@124:     err = Pa_CloseStream( stream );
cannam@124:     if( err != paNoError ) goto error;
cannam@124: 
cannam@124: /* -------------------------------------------------------------------------- */
cannam@124:     
cannam@124:     Pa_Terminate();
cannam@124:     printf("Test finished.\n");
cannam@124:     
cannam@124:     return err;
cannam@124:     
cannam@124: error:
cannam@124:     Pa_Terminate();
cannam@124:     fprintf( stderr, "An error occured while using the portaudio stream\n" );
cannam@124:     fprintf( stderr, "Error number: %d\n", err );
cannam@124:     fprintf( stderr, "Error message: %s\n", Pa_GetErrorText( err ) );
cannam@124:     return err;
cannam@124: }