CMake rewrite using modern CMake best practices

Rewrite CMakeLists.txt using CMake targets and modules instead
of building up source files in variables.

Change pkgconfig file generated by CMake to use
Requires.private and Libs.private fields as recommended by the
pkgconfig maintainer:
https://people.freedesktop.org/~dbn/pkg-config-guide.html#faq

Refactor to use standard CMake variables, notably
BUILD_SHARED_LIBS instead of always building both dynamic and
static libraries. Also use CMAKE_FRAMEWORK for building as a
macOS framework.

Remove superfluous PA_ prefixes from option names.

When building with ASIO, automatically download ASIO SDK from
Steinberg if it is not found. The path to the SDK can be
manually specified with ASIO_SDK_ZIP_PATH to facilitate caching
on CI.

Add support for building JACK host API with MSVC and MinGW.

Add support for OSS (off by default).

CMake: move MinGW toolchain file to new cmake/toolchains directory

rename cmake_support directory to cmake

Merge pull request #619 from PortAudio/winrt

wasapi: Improved reliability of the supported platform check.

wasapi: Check for the supported Windows version explicitly in PaWasapi_Initialize() and avoid relying on existence on avrt.dll for detecting the compatible platform (user could provide avrt.dll stub that will break initialization of the library if OS version does not support WASAPI backend).

Unify all stringizing macros to new PA_STRINGIZE macro in pa_util.h (#605)

pa_win_wmme.c: replace LPCTSTR with LPCWSTR (#597)

Have PaUtil_GetTime() use monotonic time on Unix (#559)

The currently used clock, CLOCK_REALTIME, will have discontinuous jumps, forward
and backward, when the system clock is adjusted.  This is bad for synchronizing
audio.  CLOCK_MONOTONIC does not have jumps, and never moves backward, but does
have the continuous adjustments done by NTP to increase clock accuracy.

Since kernel 2.6.25 ALSA has use CLOCK_MONOTONIC by default for timestamps
(commit b751eef1 from Dec 13 2007).  This change means the timestamps provided
in the PA callbacks can be compared to PaUtil_GetTime(), which currently does
not work.

The function used on MacOS, mach_absolute_time(), behaves like CLOCK_MONOTONIC.

If the system does not have CLOCK_MONOTONIC, fallback to CLOCK_REALTIME, which
is what alsa-lib does for such systems.  Which at this point would need to be
very old.

* Use clock monotonic for condition variable

This is necessary to match PaUtil_GetTime() also using the monotonic
clock.  Otherwise the wait time, derived from that function, will be
completely incorrect.

This will also fix an obscure flaw if the system clock is adjust while
waiting for the stream to open, it might not wait at all and fail or
wait (effectively) forever instead of timing out, depend on the
adjustment direction.

Unify windows error processing into a single PaWinUtil_SetLastSystemErrorInfo function (#495)

alsa: init stream variable in pa_linux_alsa.c (#584)

Prevent compiler warnings.

Alternative to #567

test: time out in patest_sine_time.c (#585)

On ALSA the StreamTime was not advancing so the while()
loop never exited. Now it will time out if it plays for much
longer than expected without the stream time changing.

Also measure timestamp latency from callback info.

pa_mac_core.c: init streamLatency and others (#591)

Prevent compiler warnings.

Alsa: Use hires timestamps (#560)

ALSA added nanosecond timestamps in library version 0.9.1.  Use these
instead of microsecond timestamps for reporting audio timestamps as well
as underrun/overrun times.

alsa-lib version 0.9.1 was released on Mar 11 2003.  I had fallback code
to use non-hires timestamps, but after 18 years it didn't seem
necessary, and I removed it from this commit.

Add documentation indicating that Pa_ReadStream, Pa_WriteStream, Pa_GetStreamReadAvailable and Pa_GetStreamWriteAvailable are only valid while the stream is running (between calls to Pa_StartStream and Pa_StopStream.)

Added Pa_GetVersionInfo to portaudio.def (#574)

* - added Pa_GetVersionInfo to portaudio.def

* - added Pa_GetVersionInfo to `cmake_support/template_portaudio.def`

Co-authored-by: Mirko Rajkovaca <mirko@mrcode.dev>

alsa: Increase snprintf buffer size to fix warning (#566)

Avoid compiler warning suggesting the buffer is too small:

../PortAudioLib/portaudio/src/hostapi/alsa/pa_linux_alsa.c: In function 'BuildDeviceList.constprop':
../PortAudioLib/portaudio/src/hostapi/alsa/pa_linux_alsa.c:1304:45: warning: '%s' directive output may be truncated writing up to 49 bytes into a region of size between 46 and 50 [-Wformat-truncation=]
             snprintf( buf, sizeof (buf), "%s%s,%d", hwPrefix, alsaCardName, devIdx );
                                             ^~                ~~~~~~~~~~~~
../PortAudioLib/portaudio/src/hostapi/alsa/pa_linux_alsa.c:1304:42: note: directive argument in the range [0, 2147483647]
             snprintf( buf, sizeof (buf), "%s%s,%d", hwPrefix, alsaCardName, devIdx );
                                          ^~~~~~~~~
../PortAudioLib/portaudio/src/hostapi/alsa/pa_linux_alsa.c:1304:13: note: 'snprintf' output between 3 and 65 bytes into a destination of size 50
             snprintf( buf, sizeof (buf), "%s%s,%d", hwPrefix, alsaCardName, devIdx );
             ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

MME: fix comparison of IO buffer sizes in CalculateBufferSettings() (#571)

Pull in fix from Audacity: https://bugzilla.audacityteam.org/show_bug.cgi?id=1969

The problem was some kind of typo, comparing pointers instead of the values of pointers.

Merge pull request #552 from PortAudio/winrt

wasapi: Fixed compilation with MinGW (W64)

[macOS] drop support for 10.5 (#511)

* drop support for 10.5

* more documentation fixes

Co-authored-by: John Melas <john@jmelas.gr>

remove deprecated pablio (#437)

This is deprecated code from 1999.

Whitespace cleanup in Java and C++ bindings#458)

CMake: clean up including headers for examples

CMake: build qa executables

CMake: build all tests

GH Actions: add separate workflow for CMake testing every OS

CMake: bump minimum version to 3.0.0 to fix deprecation warning

paqa_devs.c: define _USE_MATH_DEFINES (#554)

before including math.h

Fixes #551

patest_unplug.c: change int32_t to int (#553)

To prevent compiler errors and to avoid controversy over
stdint.h vs inttypes.h.

Fixes #550

wasapi: Fixed compilation with MinGW (W64) when targeting 32-bit platform

fix patest_converters.c argc argv order (#544)

They were reversed.
Also added void casts to prevent unused parameter warnings.

Improve JACK regex pattern escape code (see ticket #534). Improves previously merged PR #405 master commit eec7bb7 by performing string conversion directly in to the target buffer, thus avoiding one allocation and one strncpy per client/device name. (#536)

JACK PipeWire fixes (escape regex chars) (#504)

This patch fixes a problem caused by special regex characters
appearing in the device names when using the Jack interface to PipeWire.

It is uncommon for JACK ports to have any characters that need to
be escaped in a regex. jackd simply calls the audio interface
"system". However PipeWire uses the device name from ALSA for the
JACK port names. If this contains any special regex characters,
BuildDeviceList would find the device but determine it has 0
input channels and 0 output channels. In my case, I have an RME
Babyface Pro which puts its serial number in parentheses:

$ aplay -l
card 0: Pro70785713 [Babyface Pro (70785713)], device 0: USB Audio [USB Audio]
  Subdevices: 1/1
  Subdevice #0: subdevice #0

Bump version to 19.7.0

configure: better test for Mac OS arch

Use AC_COMPILE_IFELSE because AC_TRY_COMPILE is deprecated.
Include cdefs.h because it has checks for architcture.

WASAPI final whitespace fix

Add .editorconfig (#394)

Clean up whitespace in src/hostapi/coreaudio in preparation for .editorconfig. (#502)

* Clean up whitespace in src/hostapi/coreaudio in preparation for .editorconfig. Convert tabs to 4 spaces. Indent by 4 spaces. Strip trailing whitespace. Ensure only one EOL at EOF.

Merge pull request #510 from alienpenguin/fix-vs2010-compilation

wasapi: Fix compilation for VS2010.

fixed VS2010 compilation

Merge pull request #509 from PortAudio/winrt

wasapi: Fixed compilation for UWP platform, minor cleanup and refactoring.

wasapi: Fixed compilation for UWP platform, minor cleanup and refactoring.

Merge pull request #508 from PortAudio/winrt

wasapi: Fixed glitchy audio in case of Exclusive polling mode and 24-bit packed format.

wasapi: Fixed glitchy audio in case of Exclusive mode, 24-bit packed format and USB DAC (other audio devices using the same audio format could be affected too).

coreaudio: remove pa_mac_core_old.c

It has not been used for years.

Fixes #493

Cleanup newlines at EOF in oss (#491)

Cleanup newlines at EOF in dsound (#490)

configure/make: export PaWasapi_* and PaWasapiWinrt_* symbols (#500)

macos: consider major version 11

Change version logic to allow for major 11 or later.

Partial fix for #492

Merge pull request #496 from rouseabout/master

wasapi: add PaWasapi_GetIMMDevice function

WASAPI: Add PaWaspi_GetIMMDevice function

The IMMDevice pointer enables access to audio device capabiltiies not exposed by PortAudio.
https://docs.microsoft.com/en-us/windows/win32/api/mmdeviceapi/nn-mmdeviceapi-immdevice

Merge pull request #499 from rouseabout/consistent-export-symbol-numbers

cmake_support/template_portaudio.def: make symbol numbers consistent …

cmake_support/template_portaudio.def: make symbol numbers consistent with build/msvc/portaudio.def

build: Fix builds with parallel make.

replace Carbon with CoreFoundation and CoreServices

OSS: support 32-bit signed format AFMT_S32_NE (#462)

It may not be provided by all OSS implementations, so wrap the cases in
`#ifdef AFMT_S32_NE`.

configure: add arm64 for Mac M1

Add additional architecture to builds.

Fixes #445

configure: add INCLUDES for mingw build

Previously, only portaudio.h was installed when building under mingw using
make. This behavior differs from CMakeLists.txt PA_PUBLIC_INCLUDES where
pa_win_*.h header files are installed.

To cross-compile using MXE (https://mxe.cc/) we need pa_win_*.h headers.
Add them to configure.in so that they are installed.

Patch by Stefan Hajnoczi

Cleanup newlines at EOF in skeleton (#480)

Cleanup newlines at EOF in src/os/win (#481)

Cleanup newlines at EOF in src/common (#482)

Cleanup newlines at EOF in src/hostapi/asio (#483)

Clean up whitespace in src/hostapi/wasapi in preparation for .editorconfig. Indent by 4 spaces. Strip trailing whitespace. (#477)

Clean up whitespace in src/hostapi/wdmks in preparation for .editorconfig. Indent by 4 spaces. Strip trailing whitespace. (#476)

Clean up whitespace in src/hostapi/alsa in preparation for .editorconfig. Indent by 4 spaces. (#475)

pa_mac_core.c: add missing definition to fix build on older systems

thanks to @kencu

Fix user-facing and non-user-facing typos

Found via `codespell v2.1.dev0`
`codespell -q 3 -L chello,gord,guid,numer,pres,uint,wirth`

use variadic arguments in DEFINE_GUID also for MSVC (#374)

The fix for DEFINE_GUID that was recently added in pa_win_wdmks.c is also needed for the MSVC compiler.
Latest versions of the compiler support the /Zc:preprocessor option which is conforming to C99 and later standards
https://docs.microsoft.com/en-us/cpp/build/reference/zc-preprocessor?view=msvc-160
so it generates the exact same error as Clang (too many arguments error).

Co-authored-by: John Melas <john@jmelas.gr>

Run MSBuild MSVC project CI for pull requests (#419)

mac autoconf: support current and future SDKs (#470)

Improve the way we generate the path to the SDK so that it
it not tied to specific Mac versions.

Also changed macosx-version-min to 10.6

Fixes #378
Fixes #468

Use xcrun instead of xcodebuild

Note that "configure" was generated using autoconf on Linux.

Fix patest1 printf (#467)

* Fix patest1.c printf

Got changed from fprintf() accidentally.

Fixes #466

autoconf build: add src dir src/hostapi/skeleton to fix out of tree builds."

Whitespace cleanup in test

Whitespace cleanup in examples

Whitespace cleanup in qa

docs: Pa_OpenStream() fails if sampleRate unavailable (#446)

It was not clear in the previous docs.
Fixes #443

Clean up whitespace in qa/ in preparation for .editorconfig. (#418)

* Clean up whitespace in qa/ in preparation for .editorconfig. Convert tabs to 4 spaces. Indent by 4 spaces. Strip trailing whitespace. Ensure EOL at EOF.

Clean up whitespace in test/ in preparation for .editorconfig.  (#417)

* Clean up whitespace in test/ in preparation for .editorconfig. Convert tabs to 4 spaces. Indent by 4 spaces. Strip trailing whitespace. Ensure EOL at EOF.

Clean up whitespace in src/os/unix in preparation for .editorconfig. Convert tabs to 4 spaces. Indent by 4 spaces. Strip trailing whitespace. Ensure EOL at EOF. (#410)

Clean up whitespace in src/os/win in preparation for .editorconfig. (#409)

* Clean up whitespace in src/os/win in preparation for .editorconfig. Convert tabs to 4 spaces. Indent by 4 spaces. Strip trailing whitespace. Ensure EOL at EOF.

Clean up whitespace in src/common in preparation for .editorconfig. (#408)

* Clean up whitespace in src/common in preparation for .editorconfig. Convert tabs to 4 spaces. Indent by 4 spaces. Strip trailing whitespace.

Clean up whitespace in pa_win_wmme.c in preparation for .editorconfig (#413)

* Clean up whitespace in pa_win_wmme.c in preparation for .editorconfig. Convert tabs to 4 spaces. Indent by 4 spaces. Strip trailing whitespace. Ensure EOL at EOF.

* vertically align trailing comments on 4 space boundary

Clean up whitespace in src\hostapi\dsound in preparation for .editorconfig. Convert tabs to 4 spaces. Indent by 4 spaces. Strip trailing whitespace. Ensure EOL at EOF. (#412)

Clean up whitespace in examples/ in preparation for .editorconfig. Convert tabs to 4 spaces. Indent by 4 spaces. Strip trailing whitespace. Ensure EOL at EOF. (#416)

Clean up whitespace in pa_asio.cpp in preparation for .editorconfig. Convert tabs to 4 spaces. Indent by 4 spaces. Strip trailing whitespace. Ensure EOL at EOF. (#411)

Ignore the Visual Studio CMake settings file. (#422)

When using CMake, this file is written by Visual Studio to hold custom
CMake parameters.

Clean up whitespace in src/hostapi/{asihpi, jack, oss, skeleton} in preparation for .editorconfig. (#414)

* Clean up whitespace in src/hostapi/{asihpi, jack, oss, skeleton} in preparation for .editorconfig. Convert tabs to 4 spaces. Indent by 4 spaces. Strip trailing whitespace. Ensure EOL at EOF.

* Additional formatting cleanups.

Clean up whitespace in include/ in preparation for .editorconfig.  (#415)

* Clean up whitespace in include/ in preparation for .editorconfig. Convert tabs to 4 spaces. Indent by 4 spaces. Strip trailing whitespace. Ensure EOL at EOF.

alignment fixes

remove todo comments

pass input size in AudioConverterFillComplexBuffer as number of packets

fix ringBufferIOProc

remove support for OS X 10.4, rename functions pa_ -> PaMacCore_

formatting and #ifdef comment

fix compile error

new hal

fix logging warnings

OSS: correct test for unsupported formats

Previously GetAvailableFormats returned paSampleFormatNotSupported if
AFMT_S16_NE was not supported, regardless of the supported state of any
other formats.  Instead, return paSampleFormatNotSupported if no
supported formats are found.

OSS: include both /dev/dsp and /dev/dsp0

On FreeBSD /dev/dsp is the default device but may not be /dev/dsp0.
PortAudio in the FreeBSD ports collection initially had a patch to
replace the default device with /dev/dsp (for example, with three
devices and /dev/dsp1 as the default we'd have /dev/dsp0, /dev/dsp,
/dev/dsp2).  This caused some trouble (the first device is no longer
default) and was later replaced with this change, leaving /dev/dsp
as the first entry, and just adding each /dev/dsp%d that exists.

FreeBSD bugs 208968 and 236118.

remove unused and undocumented fixdir.bat & fixfile.bat

remove index.html

This file does not belong in a code repository.