Devices

#include <oalplus/device.hpp>

Common device operations

namespace tag {

struct Playback { };
struct Capture { };

} // namespace tag

class DevCommonOps
{
public:
	DevCommonOps(DevCommonOps&&) = default;

	static Range<StrCRef> Extensions(void); 
};

template <typename DeviceTag>
class DeviceOps;

Returns a range of ALC extension strings for this devices. See alcGetString, ALC_EXTENSIONS.

Playback operations

DeviceOps<tag::Playback> implements audio playback device-specific operations.

	Note
	Do not use this class directly, use Device instead.

template <>
class DeviceOps<tag::Playback>
 : public DevCommonOps
{
public:
	StrCRef Specifier(void) const; 

	static Range<StrCRef> Specifiers(void); 
};

	Returns the device specifier string. See `alcGetString`, `ALC_DEVICE_SPECIFIER`.
	Returns a range of specifier strings for available audio playback devices. See `alcGetString`, `ALC_DEVICE_SPECIFIER`.

Capture operations

DeviceOps<tag::Capture> implements audio capture device-specific operations.

	Note
	Do not use this class directly, use CaptureDevice instead.

template <>
class DeviceOps<tag::Capture>
 : public DevCommonOps
{
public:
	StrCRef Specifier(void) const; 

	static Range<StrCRef> Specifiers(void); 

	void Start(void); 
	void Stop(void); 

	ALCsizei Samples(void) const; 
	void Samples(ALCvoid* buffer, ALCsizei samples) const; 
};

	Returns the device specifier string. See `alcGetString`, `ALC_CAPTURE_DEVICE_SPECIFIER`.
	Returns a range of specifier strings for available audio capture devices. See `alcGetString`, `ALC_CAPTURE_DEVICE_SPECIFIER`.
	Starts audio capture on `this` device. See `alcCaptureStart`.
	Stops audio capture on `this` device. See `alcCaptureStop`.
	Gets the number of samples captured on `this` device. See `alcGetInteger`, `ALC_CAPTURE_SAMPLES`.
	Gets the samples captured on `this` device. See `alcCaptureSamples`.

Playback device

class Device
 : public DeviceOps<tag::Playback>
{
public:
	Device(void); 

	Device(StrCRef dev_spec); 
};

	Constructs an object referencing the default audio playback device. See `alcOpenDevice`.
	Constructs an object referencing the specified audio device. See `alcOpenDevice`.

Capture device

class CaptureDevice
 : public DeviceOps<tag::Capture>
{
public:
	CaptureDevice(
		ALCuint frequency,
		DataFormat format,
		ALCsizei bufsize
	); 

	CaptureDevice(
		StrCRef dev_spec,
		ALCuint frequency,
		DataFormat format,
		ALCsizei bufsize
	); 
};

	Constructs an object referencing the default audio capture device. See `alcCaptureOpenDevice`.
	Constructs an object referencing the specified audio capture device. See `alcCaptureOpenDevice`.