test/README
author Sam Lantinga <slouken@libsdl.org>
Sun, 07 Jul 2019 09:10:56 -0700
changeset 12928 3c4a4b1077cd
parent 10939 e212b4d00d84
permissions -rw-r--r--
Fixed bug 4710 - audio/alsa: avoid configuring hardware parameters with only a single period

Anthony Pesch

The previous code first configured the period size using snd_pcm_hw_par-
ams_set_period_size_near. Then, it further narrowed the configuration
space by calling snd_pcm_hw_params_set_buffer_size_near using a buffer
size of 2 times the _requested_ period size in order to try and get a
configuration with only 2 periods. If the configured period size was
larger than the requested size, the second call could inadvertently
narrow the configuration space to contain only a single period.

Rather than fixing the call to snd_pcm_hw_params_set_buffer_size_near
to use a size of 2 times the configured period size, the code has been
changed to use snd_pcm_hw_params_set_periods_min in order to more
clearly explain the intent.
     1 
     2 These are test programs for the SDL library:
     3 
     4 	checkkeys	Watch the key events to check the keyboard
     5 	loopwave	Audio test -- loop playing a WAV file
     6 	loopwavequeue	Audio test -- loop playing a WAV file with SDL_QueueAudio
     7 	testaudioinfo	Lists audio device capabilities
     8 	testerror	Tests multi-threaded error handling
     9 	testfile	Tests RWops layer
    10 	testgl2		A very simple example of using OpenGL with SDL
    11 	testiconv	Tests international string conversion
    12 	testjoystick	List joysticks and watch joystick events
    13 	testkeys	List the available keyboard keys
    14 	testloadso	Tests the loadable library layer
    15 	testlock	Hacked up test of multi-threading and locking
    16 	testmultiaudio	Tests using several audio devices
    17 	testoverlay2	Tests the overlay flickering/scaling during playback.
    18 	testplatform	Tests types, endianness and cpu capabilities
    19 	testsem		Tests SDL's semaphore implementation
    20 	testshape	Tests shaped windows
    21 	testsprite2	Example of fast sprite movement on the screen
    22 	testthread	Hacked up test of multi-threading
    23 	testtimer	Test the timer facilities
    24 	testver		Check the version and dynamic loading and endianness
    25 	testwm2		Test window manager -- title, icon, events
    26 	torturethread	Simple test for thread creation/destruction
    27 	controllermap   Useful to generate Game Controller API compatible maps
    28 
    29 
    30 
    31 This directory contains sample.wav, which is a sample from Will Provost's
    32 song, The Living Proof:
    33 
    34      From the album The Living Proof
    35      Publisher: 5 Guys Named Will
    36      Copyright 1996 Will Provost
    37 
    38 You can get a copy of the full song (and album!) from iTunes...
    39 
    40     https://itunes.apple.com/us/album/the-living-proof/id4153978
    41 
    42 or Amazon...
    43 
    44     http://www.amazon.com/The-Living-Proof-Will-Provost/dp/B00004R8RH
    45 
    46 Thanks to Will for permitting us to distribute this sample with SDL!
    47