Page MenuHome
Differential D2716 Diff 8940 extern/audaspace/bindings/python/PySound.cpp

Changeset View

Standalone View

View Options

extern/audaspace/bindings/python/PySound.cpp

  • This file was added.
/*******************************************************************************
* Copyright 2009-2016 Jörg Müller
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
******************************************************************************/
#include "PyHRTF.h"
#include "PyImpulseResponse.h"
#include "PySound.h"
#include "PySource.h"
#include "PyThreadPool.h"
#include "Exception.h"
#include "file/File.h"
#include "file/FileWriter.h"
#include "util/StreamBuffer.h"
#include "generator/Sawtooth.h"
#include "generator/Silence.h"
#include "generator/Sine.h"
#include "generator/Square.h"
#include "generator/Triangle.h"
#include "fx/Accumulator.h"
#include "fx/ADSR.h"
#include "fx/BinauralSound.h"
#include "fx/ConvolverSound.h"
#include "fx/Delay.h"
#include "fx/Envelope.h"
#include "fx/Fader.h"
#include "fx/Highpass.h"
#include "fx/IIRFilter.h"
#include "fx/Limiter.h"
#include "fx/Loop.h"
#include "fx/Lowpass.h"
#include "fx/MutableSound.h"
#include "fx/Pitch.h"
#include "fx/Reverse.h"
#include "fx/SoundList.h"
#include "fx/Sum.h"
#include "fx/Threshold.h"
#include "fx/Volume.h"
#include "respec/ChannelMapper.h"
#include "respec/ChannelMapperReader.h"
#include "respec/LinearResample.h"
#include "respec/JOSResample.h"
#include "respec/JOSResampleReader.h"
#include "sequence/Double.h"
#include "sequence/PingPong.h"
#include "sequence/Superpose.h"
#include <cstring>
#include <structmember.h>
#define NPY_NO_DEPRECATED_API NPY_1_7_API_VERSION
#include <numpy/ndarrayobject.h>
using namespace aud;
extern PyObject* AUDError;
static void
Sound_dealloc(Sound* self)
{
if(self->sound)
delete reinterpret_cast<std::shared_ptr<ISound>*>(self->sound);
Py_TYPE(self)->tp_free((PyObject *)self);
}
static PyObject *
Sound_new(PyTypeObject* type, PyObject* args, PyObject* kwds)
{
Sound* self;
self = (Sound*)type->tp_alloc(type, 0);
if(self != nullptr)
{
static const char* kwlist[] = {"filename", nullptr};
const char* filename = nullptr;
if(!PyArg_ParseTupleAndKeywords(args, kwds, "s:Sound", const_cast<char**>(kwlist), &filename))
{
Py_DECREF(self);
return nullptr;
}
try
{
self->sound = new std::shared_ptr<ISound>(new File(filename));
}
catch(Exception& e)
{
Py_DECREF(self);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)self;
}
PyDoc_STRVAR(M_aud_Sound_data_doc,
"data()\n\n"
"Retrieves the data of the sound as numpy array.\n\n"
":return: A two dimensional numpy float array.\n"
":rtype: :class:`numpy.ndarray`\n\n"
".. note:: Best efficiency with cached sounds.");
static PyObject *
Sound_data(Sound* self)
{
std::shared_ptr<ISound> sound = *reinterpret_cast<std::shared_ptr<ISound>*>(self->sound);
auto stream_buffer = std::dynamic_pointer_cast<StreamBuffer>(sound);
if(!stream_buffer)
stream_buffer = std::make_shared<StreamBuffer>(sound);
Specs specs = stream_buffer->getSpecs();
auto buffer = stream_buffer->getBuffer();
npy_intp dimensions[2];
dimensions[0] = buffer->getSize() / AUD_SAMPLE_SIZE(specs);
dimensions[1] = specs.channels;
PyArrayObject* array = reinterpret_cast<PyArrayObject*>(PyArray_SimpleNew(2, dimensions, NPY_FLOAT));
sample_t* data = reinterpret_cast<sample_t*>(PyArray_DATA(array));
std::memcpy(data, buffer->getBuffer(), buffer->getSize());
Py_INCREF(array);
return reinterpret_cast<PyObject*>(array);
}
PyDoc_STRVAR(M_aud_Sound_write_doc,
"write(filename, rate, channels, format, container, codec, bitrate, buffersize)\n\n"
"Writes the sound to a file.\n\n"
":arg filename: The path to write to.\n"
":type filename: string\n"
":arg rate: The sample rate to write with.\n"
":type rate: int\n"
":arg channels: The number of channels to write with.\n"
":type channels: int\n"
":arg format: The sample format to write with.\n"
":type format: int\n"
":arg container: The container format for the file.\n"
":type container: int\n"
":arg codec: The codec to use in the file.\n"
":type codec: int\n"
":arg bitrate: The bitrate to write with.\n"
":type bitrate: int\n"
":arg buffersize: The size of the writing buffer.\n"
":type buffersize: int\n");
static PyObject *
Sound_write(Sound* self, PyObject* args, PyObject* kwds)
{
const char* filename = nullptr;
int rate = RATE_INVALID;
Channels channels = CHANNELS_INVALID;
SampleFormat format = FORMAT_INVALID;
Container container = CONTAINER_INVALID;
Codec codec = CODEC_INVALID;
int bitrate = 0;
int buffersize = 0;
static const char* kwlist[] = {"filename", "rate", "channels", "format", "container", "codec", "bitrate", "buffersize", nullptr};
if(!PyArg_ParseTupleAndKeywords(args, kwds, "s|iiiiiii:write", const_cast<char**>(kwlist), &filename, &rate, &channels, &format, &container, &codec, &bitrate, &buffersize))
return nullptr;
try
{
std::shared_ptr<IReader> reader = (*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound))->createReader();
DeviceSpecs specs;
specs.specs = reader->getSpecs();
if((rate != RATE_INVALID) && (specs.rate != rate))
{
specs.rate = rate;
reader = std::make_shared<JOSResampleReader>(reader, rate);
}
if((channels != CHANNELS_INVALID) && (specs.channels != channels))
{
specs.channels = channels;
reader = std::make_shared<ChannelMapperReader>(reader, channels);
}
if(format == FORMAT_INVALID)
format = FORMAT_S16;
specs.format = format;
const char* invalid_container_error = "Container could not be determined from filename.";
if(container == CONTAINER_INVALID)
{
std::string path = filename;
if(path.length() < 4)
{
PyErr_SetString(AUDError, invalid_container_error);
return nullptr;
}
std::string extension = path.substr(path.length() - 4);
if(extension == ".ac3")
container = CONTAINER_AC3;
else if(extension == "flac")
container = CONTAINER_FLAC;
else if(extension == ".mkv")
container = CONTAINER_MATROSKA;
else if(extension == ".mp2")
container = CONTAINER_MP2;
else if(extension == ".mp3")
container = CONTAINER_MP3;
else if(extension == ".ogg")
container = CONTAINER_OGG;
else if(extension == ".wav")
container = CONTAINER_WAV;
else
{
PyErr_SetString(AUDError, invalid_container_error);
return nullptr;
}
}
if(codec == CODEC_INVALID)
{
switch(container)
{
case CONTAINER_AC3:
codec = CODEC_AC3;
break;
case CONTAINER_FLAC:
codec = CODEC_FLAC;
break;
case CONTAINER_MATROSKA:
codec = CODEC_OPUS;
break;
case CONTAINER_MP2:
codec = CODEC_MP2;
break;
case CONTAINER_MP3:
codec = CODEC_MP3;
break;
case CONTAINER_OGG:
codec = CODEC_VORBIS;
break;
case CONTAINER_WAV:
codec = CODEC_PCM;
break;
default:
PyErr_SetString(AUDError, "Unknown container, cannot select default codec.");
return nullptr;
}
}
if(buffersize <= 0)
buffersize = AUD_DEFAULT_BUFFER_SIZE;
std::shared_ptr<IWriter> writer = FileWriter::createWriter(filename, specs, container, codec, bitrate);
FileWriter::writeReader(reader, writer, 0, buffersize);
}
catch(Exception& e)
{
PyErr_SetString(AUDError, e.what());
return nullptr;
}
Py_RETURN_NONE;
}
PyDoc_STRVAR(M_aud_Sound_buffer_doc,
"buffer(data, rate)\n\n"
"Creates a sound from a data buffer.\n\n"
":arg data: The data as two dimensional numpy array.\n"
":type data: numpy.ndarray\n"
":arg rate: The sample rate.\n"
":type rate: double\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_buffer(PyTypeObject* type, PyObject* args)
{
PyArrayObject* array = nullptr;
double rate = RATE_INVALID;
if(!PyArg_ParseTuple(args, "Od:buffer", &array, &rate))
return nullptr;
if((!PyObject_TypeCheck(reinterpret_cast<PyObject*>(array), &PyArray_Type)) || (PyArray_TYPE(array) != NPY_FLOAT))
{
PyErr_SetString(PyExc_TypeError, "The data needs to be supplied as float32 numpy array!");
return nullptr;
}
if(PyArray_NDIM(array) > 2)
{
PyErr_SetString(PyExc_TypeError, "The array needs to have one or two dimensions!");
return nullptr;
}
if(rate <= 0)
{
PyErr_SetString(PyExc_TypeError, "The sample rate has to be positive!");
return nullptr;
}
Specs specs;
specs.rate = rate;
specs.channels = CHANNELS_MONO;
if(PyArray_NDIM(array) == 2)
specs.channels = static_cast<Channels>(PyArray_DIM(array, 1));
int size = PyArray_DIM(array, 0) * AUD_SAMPLE_SIZE(specs);
std::shared_ptr<Buffer> buffer = std::make_shared<Buffer>(size);
std::memcpy(buffer->getBuffer(), PyArray_DATA(array), size);
Sound* self;
self = (Sound*)type->tp_alloc(type, 0);
if(self != nullptr)
{
try
{
self->sound = new std::shared_ptr<StreamBuffer>(new StreamBuffer(buffer, specs));
}
catch(Exception& e)
{
Py_DECREF(self);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)self;
}
PyDoc_STRVAR(M_aud_Sound_cache_doc,
"cache()\n\n"
"Caches a sound into RAM.\n"
"This saves CPU usage needed for decoding and file access if the "
"underlying sound reads from a file on the harddisk, but it "
"consumes a lot of memory.\n\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`\n\n"
".. note:: Only known-length factories can be buffered.\n\n"
".. warning:: Raw PCM data needs a lot of space, only buffer "
"short factories.");
static PyObject *
Sound_cache(Sound* self)
{
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new StreamBuffer(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound)));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_file_doc,
"file(filename)\n\n"
"Creates a sound object of a sound file.\n\n"
":arg filename: Path of the file.\n"
":type filename: string\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`\n\n"
".. warning:: If the file doesn't exist or can't be read you will "
"not get an exception immediately, but when you try to start "
"playback of that sound.");
static PyObject *
Sound_file(PyTypeObject* type, PyObject* args)
{
const char* filename = nullptr;
if(!PyArg_ParseTuple(args, "s:file", &filename))
return nullptr;
Sound* self;
self = (Sound*)type->tp_alloc(type, 0);
if(self != nullptr)
{
try
{
self->sound = new std::shared_ptr<ISound>(new File(filename));
}
catch(Exception& e)
{
Py_DECREF(self);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)self;
}
PyDoc_STRVAR(M_aud_Sound_sawtooth_doc,
"sawtooth(frequency, rate=48000)\n\n"
"Creates a sawtooth sound which plays a sawtooth wave.\n\n"
":arg frequency: The frequency of the sawtooth wave in Hz.\n"
":type frequency: float\n"
":arg rate: The sampling rate in Hz. It's recommended to set this "
"value to the playback device's samling rate to avoid resamping.\n"
":type rate: int\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_sawtooth(PyTypeObject* type, PyObject* args)
{
float frequency;
double rate = 48000;
if(!PyArg_ParseTuple(args, "f|d:sawtooth", &frequency, &rate))
return nullptr;
Sound* self;
self = (Sound*)type->tp_alloc(type, 0);
if(self != nullptr)
{
try
{
self->sound = new std::shared_ptr<ISound>(new Sawtooth(frequency, (SampleRate)rate));
}
catch(Exception& e)
{
Py_DECREF(self);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)self;
}
PyDoc_STRVAR(M_aud_Sound_silence_doc,
"silence()\n\n"
"Creates a silence sound which plays simple silence.\n\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_silence(PyTypeObject* type)
{
Sound* self;
self = (Sound*)type->tp_alloc(type, 0);
if(self != nullptr)
{
try
{
self->sound = new std::shared_ptr<ISound>(new Silence());
}
catch(Exception& e)
{
Py_DECREF(self);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)self;
}
PyDoc_STRVAR(M_aud_Sound_sine_doc,
"sine(frequency, rate=48000)\n\n"
"Creates a sine sound which plays a sine wave.\n\n"
":arg frequency: The frequency of the sine wave in Hz.\n"
":type frequency: float\n"
":arg rate: The sampling rate in Hz. It's recommended to set this "
"value to the playback device's samling rate to avoid resamping.\n"
":type rate: int\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_sine(PyTypeObject* type, PyObject* args)
{
float frequency;
double rate = 48000;
if(!PyArg_ParseTuple(args, "f|d:sine", &frequency, &rate))
return nullptr;
Sound* self;
self = (Sound*)type->tp_alloc(type, 0);
if(self != nullptr)
{
try
{
self->sound = new std::shared_ptr<ISound>(new Sine(frequency, (SampleRate)rate));
}
catch(Exception& e)
{
Py_DECREF(self);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)self;
}
PyDoc_STRVAR(M_aud_Sound_square_doc,
"square(frequency, rate=48000)\n\n"
"Creates a square sound which plays a square wave.\n\n"
":arg frequency: The frequency of the square wave in Hz.\n"
":type frequency: float\n"
":arg rate: The sampling rate in Hz. It's recommended to set this "
"value to the playback device's samling rate to avoid resamping.\n"
":type rate: int\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_square(PyTypeObject* type, PyObject* args)
{
float frequency;
double rate = 48000;
if(!PyArg_ParseTuple(args, "f|d:square", &frequency, &rate))
return nullptr;
Sound* self;
self = (Sound*)type->tp_alloc(type, 0);
if(self != nullptr)
{
try
{
self->sound = new std::shared_ptr<ISound>(new Square(frequency, (SampleRate)rate));
}
catch(Exception& e)
{
Py_DECREF(self);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)self;
}
PyDoc_STRVAR(M_aud_Sound_triangle_doc,
"triangle(frequency, rate=48000)\n\n"
"Creates a triangle sound which plays a triangle wave.\n\n"
":arg frequency: The frequency of the triangle wave in Hz.\n"
":type frequency: float\n"
":arg rate: The sampling rate in Hz. It's recommended to set this "
"value to the playback device's samling rate to avoid resamping.\n"
":type rate: int\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_triangle(PyTypeObject* type, PyObject* args)
{
float frequency;
double rate = 48000;
if(!PyArg_ParseTuple(args, "f|d:triangle", &frequency, &rate))
return nullptr;
Sound* self;
self = (Sound*)type->tp_alloc(type, 0);
if(self != nullptr)
{
try
{
self->sound = new std::shared_ptr<ISound>(new Triangle(frequency, (SampleRate)rate));
}
catch(Exception& e)
{
Py_DECREF(self);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)self;
}
PyDoc_STRVAR(M_aud_Sound_accumulate_doc,
"accumulate(additive=False)\n\n"
"Accumulates a sound by summing over positive input differences thus generating a monotonic sigal. "
"If additivity is set to true negative input differences get added too, but positive ones with a factor of two. "
"Note that with additivity the signal is not monotonic anymore.\n\n"
":arg additive: Whether the accumulation should be additive or not.\n"
":type time: bool\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_accumulate(Sound* self, PyObject* args)
{
bool additive = false;
PyObject* additiveo;
if(!PyArg_ParseTuple(args, "|O:accumulate", &additiveo))
return nullptr;
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
if(additiveo != nullptr)
{
if(!PyBool_Check(additiveo))
{
PyErr_SetString(PyExc_TypeError, "additive is not a boolean!");
return nullptr;
}
additive = additiveo == Py_True;
}
try
{
parent->sound = new std::shared_ptr<ISound>(new Accumulator(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), additive));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_ADSR_doc,
"ADSR(attack,decay,sustain,release)\n\n"
"Attack-Decay-Sustain-Release envelopes the volume of a sound. "
"Note: there is currently no way to trigger the release with this API.\n\n"
":arg attack: The attack time in seconds.\n"
":type attack: float\n"
":arg decay: The decay time in seconds.\n"
":type decay: float\n"
":arg sustain: The sustain level.\n"
":type sustain: float\n"
":arg release: The release level.\n"
":type release: float\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_ADSR(Sound* self, PyObject* args)
{
float attack, decay, sustain, release;
if(!PyArg_ParseTuple(args, "ffff:ADSR", &attack, &decay, &sustain, &release))
return nullptr;
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new ADSR(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), attack, decay, sustain, release));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_delay_doc,
"delay(time)\n\n"
"Delays by playing adding silence in front of the other sound's "
"data.\n\n"
":arg time: How many seconds of silence should be added before "
"the sound.\n"
":type time: float\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_delay(Sound* self, PyObject* args)
{
float delay;
if(!PyArg_ParseTuple(args, "f:delay", &delay))
return nullptr;
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new Delay(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), delay));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_envelope_doc,
"envelope(attack, release, threshold, arthreshold)\n\n"
"Delays by playing adding silence in front of the other sound's "
"data.\n\n"
":arg attack: The attack factor.\n"
":type attack: float\n"
":arg release: The release factor.\n"
":type release: float\n"
":arg threshold: The general threshold value.\n"
":type threshold: float\n"
":arg arthreshold: The attack/release threshold value.\n"
":type arthreshold: float\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_envelope(Sound* self, PyObject* args)
{
float attack, release, threshold, arthreshold;
if(!PyArg_ParseTuple(args, "ffff:envelope", &attack, &release, &threshold, &arthreshold))
return nullptr;
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new Envelope(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), attack, release, threshold, arthreshold));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_fadein_doc,
"fadein(start, length)\n\n"
"Fades a sound in by raising the volume linearly in the given "
"time interval.\n\n"
":arg start: Time in seconds when the fading should start.\n"
":type start: float\n"
":arg length: Time in seconds how long the fading should last.\n"
":type length: float\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`\n\n"
".. note:: Before the fade starts it plays silence.");
static PyObject *
Sound_fadein(Sound* self, PyObject* args)
{
float start, length;
if(!PyArg_ParseTuple(args, "ff:fadein", &start, &length))
return nullptr;
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new Fader(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), FADE_IN, start, length));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_fadeout_doc,
"fadeout(start, length)\n\n"
"Fades a sound in by lowering the volume linearly in the given "
"time interval.\n\n"
":arg start: Time in seconds when the fading should start.\n"
":type start: float\n"
":arg length: Time in seconds how long the fading should last.\n"
":type length: float\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`\n\n"
".. note:: After the fade this sound plays silence, so that "
"the length of the sound is not altered.");
static PyObject *
Sound_fadeout(Sound* self, PyObject* args)
{
float start, length;
if(!PyArg_ParseTuple(args, "ff:fadeout", &start, &length))
return nullptr;
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new Fader(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), FADE_OUT, start, length));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_filter_doc,
"filter(b, a = (1))\n\n"
"Filters a sound with the supplied IIR filter coefficients.\n"
"Without the second parameter you'll get a FIR filter.\n"
"If the first value of the a sequence is 0 it will be set to 1 "
"automatically.\n"
"If the first value of the a sequence is neither 0 nor 1, all "
"filter coefficients will be scaled by this value so that it is 1 "
"in the end, you don't have to scale yourself.\n\n"
":arg b: The nominator filter coefficients.\n"
":type b: sequence of float\n"
":arg a: The denominator filter coefficients.\n"
":type a: sequence of float\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_filter(Sound* self, PyObject* args)
{
PyObject* py_b;
PyObject* py_a = nullptr;
Py_ssize_t py_a_len;
Py_ssize_t py_b_len;
if(!PyArg_ParseTuple(args, "O|O:filter", &py_b, &py_a))
return nullptr;
if(!PySequence_Check(py_b) || (py_a != nullptr && !PySequence_Check(py_a)))
{
PyErr_SetString(PyExc_TypeError, "Parameter is not a sequence!");
return nullptr;
}
py_a_len= py_a ? PySequence_Size(py_a) : 0;
py_b_len= PySequence_Size(py_b);
if(!py_b_len || ((py_a != nullptr) && !py_a_len))
{
PyErr_SetString(PyExc_ValueError, "The sequence has to contain at least one value!");
return nullptr;
}
std::vector<float> a, b;
PyObject* py_value;
float value;
for(Py_ssize_t i = 0; i < py_b_len; i++)
{
py_value = PySequence_GetItem(py_b, i);
value= (float)PyFloat_AsDouble(py_value);
Py_DECREF(py_value);
if(value == -1.0f && PyErr_Occurred()) {
return nullptr;
}
b.push_back(value);
}
if(py_a)
{
for(Py_ssize_t i = 0; i < py_a_len; i++)
{
py_value = PySequence_GetItem(py_a, i);
value= (float)PyFloat_AsDouble(py_value);
Py_DECREF(py_value);
if(value == -1.0f && PyErr_Occurred()) {
return nullptr;
}
a.push_back(value);
}
if(a[0] == 0)
a[0] = 1;
}
else
a.push_back(1);
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new IIRFilter(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), b, a));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_highpass_doc,
"highpass(frequency, Q=0.5)\n\n"
"Creates a second order highpass filter based on the transfer "
"function H(s) = s^2 / (s^2 + s/Q + 1)\n\n"
":arg frequency: The cut off trequency of the highpass.\n"
":type frequency: float\n"
":arg Q: Q factor of the lowpass.\n"
":type Q: float\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_highpass(Sound* self, PyObject* args)
{
float frequency;
float Q = 0.5;
if(!PyArg_ParseTuple(args, "f|f:highpass", &frequency, &Q))
return nullptr;
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new Highpass(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), frequency, Q));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_limit_doc,
"limit(start, end)\n\n"
"Limits a sound within a specific start and end time.\n\n"
":arg start: Start time in seconds.\n"
":type start: float\n"
":arg end: End time in seconds.\n"
":type end: float\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_limit(Sound* self, PyObject* args)
{
float start, end;
if(!PyArg_ParseTuple(args, "ff:limit", &start, &end))
return nullptr;
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new Limiter(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), start, end));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_loop_doc,
"loop(count)\n\n"
"Loops a sound.\n\n"
":arg count: How often the sound should be looped. "
"Negative values mean endlessly.\n"
":type count: integer\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`\n\n"
".. note:: This is a filter function, you might consider using "
":attr:`Handle.loop_count` instead.");
static PyObject *
Sound_loop(Sound* self, PyObject* args)
{
int loop;
if(!PyArg_ParseTuple(args, "i:loop", &loop))
return nullptr;
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new Loop(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), loop));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_lowpass_doc,
"lowpass(frequency, Q=0.5)\n\n"
"Creates a second order lowpass filter based on the transfer "
"function H(s) = 1 / (s^2 + s/Q + 1)\n\n"
":arg frequency: The cut off trequency of the lowpass.\n"
":type frequency: float\n"
":arg Q: Q factor of the lowpass.\n"
":type Q: float\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_lowpass(Sound* self, PyObject* args)
{
float frequency;
float Q = 0.5;
if(!PyArg_ParseTuple(args, "f|f:lowpass", &frequency, &Q))
return nullptr;
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new Lowpass(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), frequency, Q));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_pitch_doc,
"pitch(factor)\n\n"
"Changes the pitch of a sound with a specific factor.\n\n"
":arg factor: The factor to change the pitch with.\n"
":type factor: float\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`\n\n"
".. note:: This is done by changing the sample rate of the "
"underlying sound, which has to be an integer, so the factor "
"value rounded and the factor may not be 100 % accurate.\n\n"
".. note:: This is a filter function, you might consider using "
":attr:`Handle.pitch` instead.");
static PyObject *
Sound_pitch(Sound* self, PyObject* args)
{
float factor;
if(!PyArg_ParseTuple(args, "f:pitch", &factor))
return nullptr;
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new Pitch(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), factor));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_rechannel_doc,
"rechannel(channels)\n\n"
"Rechannels the sound.\n\n"
":arg channels: The new channel configuration.\n"
":type channels: int\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_rechannel(Sound* self, PyObject* args)
{
int channels;
if(!PyArg_ParseTuple(args, "i:rechannel", &channels))
return nullptr;
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
DeviceSpecs specs;
specs.channels = static_cast<Channels>(channels);
specs.rate = RATE_INVALID;
specs.format = FORMAT_INVALID;
parent->sound = new std::shared_ptr<ISound>(new ChannelMapper(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), specs));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_resample_doc,
"resample(rate, high_quality)\n\n"
"Resamples the sound.\n\n"
":arg rate: The new sample rate.\n"
":type rate: double\n"
":arg high_quality: When true use a higher quality but slower resampler.\n"
":type high_quality: bool\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_resample(Sound* self, PyObject* args)
{
double rate;
PyObject* high_qualityo;
bool high_quality = false;
if(!PyArg_ParseTuple(args, "d|O:resample", &rate, &high_qualityo))
return nullptr;
if(!PyBool_Check(high_qualityo))
{
PyErr_SetString(PyExc_TypeError, "high_quality is not a boolean!");
return nullptr;
}
high_quality = high_qualityo == Py_True;
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
DeviceSpecs specs;
specs.channels = CHANNELS_INVALID;
specs.rate = rate;
specs.format = FORMAT_INVALID;
if(high_quality)
parent->sound = new std::shared_ptr<ISound>(new JOSResample(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), specs));
else
parent->sound = new std::shared_ptr<ISound>(new LinearResample(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), specs));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_reverse_doc,
"reverse()\n\n"
"Plays a sound reversed.\n\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`\n\n"
".. note:: The sound has to have a finite length and has to be "
"seekable. It's recommended to use this only with factories with "
"fast and accurate seeking, which is not true for encoded audio "
"files, such ones should be buffered using :meth:`cache` before "
"being played reversed.\n\n"
".. warning:: If seeking is not accurate in the underlying sound "
"you'll likely hear skips/jumps/cracks.");
static PyObject *
Sound_reverse(Sound* self)
{
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new Reverse(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound)));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_sum_doc,
"sum()\n\n"
"Sums the samples of a sound.\n\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_sum(Sound* self)
{
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new Sum(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound)));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_threshold_doc,
"threshold(threshold = 0)\n\n"
"Makes a threshold wave out of an audio wave by setting all samples "
"with a amplitude >= threshold to 1, all <= -threshold to -1 and "
"all between to 0.\n\n"
":arg threshold: Threshold value over which an amplitude counts "
"non-zero.\n"
":type threshold: float\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_threshold(Sound* self, PyObject* args)
{
float threshold = 0;
if(!PyArg_ParseTuple(args, "|f:threshold", &threshold))
return nullptr;
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new Threshold(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), threshold));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_volume_doc,
"volume(volume)\n\n"
"Changes the volume of a sound.\n\n"
":arg volume: The new volume..\n"
":type volume: float\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`\n\n"
".. note:: Should be in the range [0, 1] to avoid clipping.\n\n"
".. note:: This is a filter function, you might consider using "
":attr:`Handle.volume` instead.");
static PyObject *
Sound_volume(Sound* self, PyObject* args)
{
float volume;
if(!PyArg_ParseTuple(args, "f:volume", &volume))
return nullptr;
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new Volume(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), volume));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_join_doc,
"join(sound)\n\n"
"Plays two factories in sequence.\n\n"
":arg sound: The sound to play second.\n"
":type sound: :class:`Sound`\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`\n\n"
".. note:: The two factories have to have the same specifications "
"(channels and samplerate).");
static PyObject *
Sound_join(Sound* self, PyObject* object)
{
PyTypeObject* type = Py_TYPE(self);
if(!PyObject_TypeCheck(object, type))
{
PyErr_SetString(PyExc_TypeError, "Object has to be of type Sound!");
return nullptr;
}
Sound* parent;
Sound* child = (Sound*)object;
parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new Double(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), *reinterpret_cast<std::shared_ptr<ISound>*>(child->sound)));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_mix_doc,
"mix(sound)\n\n"
"Mixes two factories.\n\n"
":arg sound: The sound to mix over the other.\n"
":type sound: :class:`Sound`\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`\n\n"
".. note:: The two factories have to have the same specifications "
"(channels and samplerate).");
static PyObject *
Sound_mix(Sound* self, PyObject* object)
{
PyTypeObject* type = Py_TYPE(self);
if(!PyObject_TypeCheck(object, type))
{
PyErr_SetString(PyExc_TypeError, "Object is not of type Sound!");
return nullptr;
}
Sound* parent = (Sound*)type->tp_alloc(type, 0);
Sound* child = (Sound*)object;
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new Superpose(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), *reinterpret_cast<std::shared_ptr<ISound>*>(child->sound)));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_pingpong_doc,
"pingpong()\n\n"
"Plays a sound forward and then backward.\n"
"This is like joining a sound with its reverse.\n\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_pingpong(Sound* self)
{
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new PingPong(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound)));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_list_doc,
"list()\n\n"
"Creates an empty sound list that can contain several sounds.\n\n"
":arg random: wether the playback will be random or not.\n"
":type random: int\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_list(PyTypeObject* type, PyObject* args)
{
int random;
if(!PyArg_ParseTuple(args, "i:random", &random))
return nullptr;
Sound* self;
self = (Sound*)type->tp_alloc(type, 0);
if(self != nullptr)
{
try
{
self->sound = new std::shared_ptr<ISound>(new SoundList(random));
}
catch(Exception& e)
{
Py_DECREF(self);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)self;
}
PyDoc_STRVAR(M_aud_Sound_mutable_doc,
"mutable()\n\n"
"Creates a sound that will be restarted when sought backwards.\n"
"If the original sound is a sound list, the playing sound can change.\n\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_mutable(Sound* self)
{
PyTypeObject* type = Py_TYPE(self);
Sound* parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new MutableSound(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound)));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_list_addSound_doc,
"addSound(sound)\n\n"
"Adds a new sound to a sound list.\n\n"
":arg sound: The sound that will be added to the list.\n"
":type sound: :class:`Sound`\n\n"
".. note:: You can only add a sound to a sound list.");
static PyObject *
Sound_list_addSound(Sound* self, PyObject* object)
{
PyTypeObject* type = Py_TYPE(self);
if(!PyObject_TypeCheck(object, type))
{
PyErr_SetString(PyExc_TypeError, "Object has to be of type Sound!");
return nullptr;
}
Sound* child = (Sound*)object;
try
{
(*reinterpret_cast<std::shared_ptr<SoundList>*>(self->sound))->addSound(*reinterpret_cast<std::shared_ptr<ISound>*>(child->sound));
Py_RETURN_NONE;
}
catch(Exception& e)
{
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
PyDoc_STRVAR(M_aud_Sound_convolver_doc,
"convolver()\n\n"
"Creates a sound that will apply convolution to another sound.\n\n"
":arg impulseResponse: The filter with which convolve the sound.\n"
":type impulseResponse: :class:`ImpulseResponse`\n"
":arg threadPool: A thread pool used to parallelize convolution.\n"
":type threadPool: :class:`ThreadPool`\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_convolver(Sound* self, PyObject* args)
{
PyTypeObject* type = Py_TYPE(self);
PyObject* object1;
PyObject* object2;
if(!PyArg_ParseTuple(args, "OO:convolver", &object1, &object2))
return nullptr;
ImpulseResponseP* filter = checkImpulseResponse(object1);
if(!filter)
return nullptr;
ThreadPoolP* threadPool = checkThreadPool(object2);
if(!threadPool)
return nullptr;
Sound* parent;
parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new ConvolverSound(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), *reinterpret_cast<std::shared_ptr<ImpulseResponse>*>(filter->impulseResponse), *reinterpret_cast<std::shared_ptr<ThreadPool>*>(threadPool->threadPool)));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
PyDoc_STRVAR(M_aud_Sound_binaural_doc,
"convolver()\n\n"
"Creates a binaural sound using another sound as source. The original sound must be mono\n\n"
":arg hrtfs: An HRTF set.\n"
":type hrtf: :class:`HRTF`\n"
":arg source: An object representing the source position of the sound.\n"
":type source: :class:`Source`\n"
":arg threadPool: A thread pool used to parallelize convolution.\n"
":type threadPool: :class:`ThreadPool`\n"
":return: The created :class:`Sound` object.\n"
":rtype: :class:`Sound`");
static PyObject *
Sound_binaural(Sound* self, PyObject* args)
{
PyTypeObject* type = Py_TYPE(self);
PyObject* object1;
PyObject* object2;
PyObject* object3;
if(!PyArg_ParseTuple(args, "OOO:binaural", &object1, &object2, &object3))
return nullptr;
HRTFP* hrtfs = checkHRTF(object1);
if(!hrtfs)
return nullptr;
SourceP* source = checkSource(object2);
if(!hrtfs)
return nullptr;
ThreadPoolP* threadPool = checkThreadPool(object3);
if(!threadPool)
return nullptr;
Sound* parent;
parent = (Sound*)type->tp_alloc(type, 0);
if(parent != nullptr)
{
try
{
parent->sound = new std::shared_ptr<ISound>(new BinauralSound(*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound), *reinterpret_cast<std::shared_ptr<HRTF>*>(hrtfs->hrtf), *reinterpret_cast<std::shared_ptr<Source>*>(source->source), *reinterpret_cast<std::shared_ptr<ThreadPool>*>(threadPool->threadPool)));
}
catch(Exception& e)
{
Py_DECREF(parent);
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
return (PyObject *)parent;
}
static PyMethodDef Sound_methods[] = {
{"data", (PyCFunction)Sound_data, METH_NOARGS,
M_aud_Sound_data_doc
},
{"write", (PyCFunction)Sound_write, METH_VARARGS | METH_KEYWORDS,
M_aud_Sound_write_doc
},
{"buffer", (PyCFunction)Sound_buffer, METH_VARARGS | METH_CLASS,
M_aud_Sound_buffer_doc
},
{"cache", (PyCFunction)Sound_cache, METH_NOARGS,
M_aud_Sound_cache_doc
},
{"file", (PyCFunction)Sound_file, METH_VARARGS | METH_CLASS,
M_aud_Sound_file_doc
},
{"sawtooth", (PyCFunction)Sound_sawtooth, METH_VARARGS | METH_CLASS,
M_aud_Sound_sawtooth_doc
},
{"silence", (PyCFunction)Sound_silence, METH_NOARGS | METH_CLASS,
M_aud_Sound_silence_doc
},
{"sine", (PyCFunction)Sound_sine, METH_VARARGS | METH_CLASS,
M_aud_Sound_sine_doc
},
{"square", (PyCFunction)Sound_square, METH_VARARGS | METH_CLASS,
M_aud_Sound_square_doc
},
{"triangle", (PyCFunction)Sound_triangle, METH_VARARGS | METH_CLASS,
M_aud_Sound_triangle_doc
},
{"accumulate", (PyCFunction)Sound_accumulate, METH_VARARGS,
M_aud_Sound_accumulate_doc
},
{"ADSR", (PyCFunction)Sound_ADSR, METH_VARARGS,
M_aud_Sound_ADSR_doc
},
{"delay", (PyCFunction)Sound_delay, METH_VARARGS,
M_aud_Sound_delay_doc
},
{"envelope", (PyCFunction)Sound_envelope, METH_VARARGS,
M_aud_Sound_envelope_doc
},
{"fadein", (PyCFunction)Sound_fadein, METH_VARARGS,
M_aud_Sound_fadein_doc
},
{"fadeout", (PyCFunction)Sound_fadeout, METH_VARARGS,
M_aud_Sound_fadeout_doc
},
{"filter", (PyCFunction)Sound_filter, METH_VARARGS,
M_aud_Sound_filter_doc
},
{"highpass", (PyCFunction)Sound_highpass, METH_VARARGS,
M_aud_Sound_highpass_doc
},
{"limit", (PyCFunction)Sound_limit, METH_VARARGS,
M_aud_Sound_limit_doc
},
{"loop", (PyCFunction)Sound_loop, METH_VARARGS,
M_aud_Sound_loop_doc
},
{"lowpass", (PyCFunction)Sound_lowpass, METH_VARARGS,
M_aud_Sound_lowpass_doc
},
{"pitch", (PyCFunction)Sound_pitch, METH_VARARGS,
M_aud_Sound_pitch_doc
},
{"rechannel", (PyCFunction)Sound_rechannel, METH_VARARGS,
M_aud_Sound_rechannel_doc
},
{"resample", (PyCFunction)Sound_resample, METH_VARARGS,
M_aud_Sound_resample_doc
},
{"reverse", (PyCFunction)Sound_reverse, METH_NOARGS,
M_aud_Sound_reverse_doc
},
{"sum", (PyCFunction)Sound_sum, METH_NOARGS,
M_aud_Sound_sum_doc
},
{"threshold", (PyCFunction)Sound_threshold, METH_VARARGS,
M_aud_Sound_threshold_doc
},
{"volume", (PyCFunction)Sound_volume, METH_VARARGS,
M_aud_Sound_volume_doc
},
{"join", (PyCFunction)Sound_join, METH_O,
M_aud_Sound_join_doc
},
{"mix", (PyCFunction)Sound_mix, METH_O,
M_aud_Sound_mix_doc
},
{ "pingpong", (PyCFunction)Sound_pingpong, METH_NOARGS,
M_aud_Sound_pingpong_doc
},
{ "list", (PyCFunction)Sound_list, METH_VARARGS | METH_CLASS,
M_aud_Sound_list_doc
},
{ "mutable", (PyCFunction)Sound_mutable, METH_NOARGS,
M_aud_Sound_mutable_doc
},
{ "addSound", (PyCFunction)Sound_list_addSound, METH_O,
M_aud_Sound_list_addSound_doc
},
{ "convolver", (PyCFunction)Sound_convolver, METH_VARARGS,
M_aud_Sound_convolver_doc
},
{ "binaural", (PyCFunction)Sound_binaural, METH_VARARGS,
M_aud_Sound_binaural_doc
},
{nullptr} /* Sentinel */
};
PyDoc_STRVAR(M_aud_Sound_specs_doc,
"The sample specification of the sound as a tuple with rate and channel count.");
static PyObject *
Sound_get_specs(Sound* self, void* nothing)
{
try
{
Specs specs = (*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound))->createReader()->getSpecs();
return Py_BuildValue("(di)", specs.rate, specs.channels);
}
catch(Exception& e)
{
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
PyDoc_STRVAR(M_aud_Sound_length_doc,
"The sample specification of the sound as a tuple with rate and channel count.");
static PyObject *
Sound_get_length(Sound* self, void* nothing)
{
try
{
int length = (*reinterpret_cast<std::shared_ptr<ISound>*>(self->sound))->createReader()->getLength();
return Py_BuildValue("i", length);
}
catch(Exception& e)
{
PyErr_SetString(AUDError, e.what());
return nullptr;
}
}
static PyGetSetDef Sound_properties[] = {
{(char*)"specs", (getter)Sound_get_specs, nullptr,
M_aud_Sound_specs_doc, nullptr },
{(char*)"length", (getter)Sound_get_length, nullptr,
M_aud_Sound_length_doc, nullptr },
{nullptr} /* Sentinel */
};
PyDoc_STRVAR(M_aud_Sound_doc,
"Sound objects are immutable and represent a sound that can be "
"played simultaneously multiple times. They are called factories "
"because they create reader objects internally that are used for "
"playback.");
PyTypeObject SoundType = {
PyVarObject_HEAD_INIT(nullptr, 0)
"aud.Sound", /* tp_name */
sizeof(Sound), /* tp_basicsize */
0, /* tp_itemsize */
(destructor)Sound_dealloc, /* tp_dealloc */
0, /* tp_print */
0, /* tp_getattr */
0, /* tp_setattr */
0, /* tp_reserved */
0, /* tp_repr */
0, /* tp_as_number */
0, /* tp_as_sequence */
0, /* tp_as_mapping */
0, /* tp_hash */
0, /* tp_call */
0, /* tp_str */
0, /* tp_getattro */
0, /* tp_setattro */
0, /* tp_as_buffer */
Py_TPFLAGS_DEFAULT, /* tp_flags */
M_aud_Sound_doc, /* tp_doc */
0, /* tp_traverse */
0, /* tp_clear */
0, /* tp_richcompare */
0, /* tp_weaklistoffset */
0, /* tp_iter */
0, /* tp_iternext */
Sound_methods, /* tp_methods */
0, /* tp_members */
Sound_properties, /* tp_getset */
0, /* tp_base */
0, /* tp_dict */
0, /* tp_descr_get */
0, /* tp_descr_set */
0, /* tp_dictoffset */
0, /* tp_init */
0, /* tp_alloc */
Sound_new, /* tp_new */
};
AUD_API PyObject* Sound_empty()
{
return SoundType.tp_alloc(&SoundType, 0);
}
AUD_API Sound* checkSound(PyObject* sound)
{
if(!PyObject_TypeCheck(sound, &SoundType))
{
PyErr_SetString(PyExc_TypeError, "Object is not of type Sound!");
return nullptr;
}
return (Sound*)sound;
}
bool initializeSound()
{
import_array();
return PyType_Ready(&SoundType) >= 0;
}
void addSoundToModule(PyObject* module)
{
Py_INCREF(&SoundType);
PyModule_AddObject(module, "Sound", (PyObject *)&SoundType);
}