5#include "ArdStkLogger.h"
82typedef float StkFloat;
105 PROCESS_SOCKET_IPADDR,
112 std::string message_;
117 StkError(
const std::string& message, Type type = StkError::UNSPECIFIED)
118 : message_(message), type_(type) {}
126 std::ostream* out = &std::cout;
128 std::ostream* out = &std::cerr;
130 *out <<
'\n' << message_ <<
"\n\n";
134 virtual const Type&
getType(
void) {
return type_; }
137 virtual const std::string&
getMessage(
void) {
return message_; }
147 typedef unsigned long StkFormat;
196 static void swap16(
unsigned char *ptr );
199 static void swap32(
unsigned char *ptr );
202 static void swap64(
unsigned char *ptr );
205 static void sleep(
unsigned long milliseconds );
208 static bool inRange( StkFloat value, StkFloat min, StkFloat max ) {
209 if ( value < min )
return false;
210 else if ( value > max )
return false;
215 static void handleError(
const char *message, StkError::Type type );
218 static void handleError( std::string message, StkError::Type type );
227 static StkFloat srate_;
228 static std::string rawwavepath_;
229 static bool showWarnings_;
230 static bool printErrors_;
231 static std::vector<Stk *> alertList_;
235 static std::ostringstream oStream_;
236 bool ignoreSampleRateChange_;
291 StkFrames(
unsigned int nFrames = 0,
unsigned int nChannels = 0 );
294 StkFrames(
const StkFloat& value,
unsigned int nFrames,
unsigned int nChannels );
353 StkFloat&
operator() (
size_t frame,
unsigned int channel );
361 StkFloat
operator() (
size_t frame,
unsigned int channel )
const;
370 StkFloat
interpolate( StkFloat frame,
unsigned int channel = 0 )
const;
373 size_t size()
const {
return size_; };
386 void resize(
size_t nFrames,
unsigned int nChannels = 1 );
396 void resize(
size_t nFrames,
unsigned int nChannels, StkFloat value );
415 unsigned int channels(
void )
const {
return nChannels_; };
418 unsigned int frames(
void )
const {
return (
unsigned int)nFrames_; };
432 StkFloat
dataRate(
void )
const {
return dataRate_; };
435 StkFloat EMPTY_RESULT = 0.0f;
440 unsigned int nChannels_;
446inline bool StkFrames :: empty()
const
448 if ( size_ > 0 )
return false;
452inline StkFloat& StkFrames :: operator[] (
size_t n )
454#if defined(_STK_DEBUG_)
456 std::ostringstream error;
457 error <<
"StkFrames::operator[]: invalid index (" << n <<
") value!";
462 return data_==
nullptr ? EMPTY_RESULT : data_[n];
465inline StkFloat StkFrames :: operator[] (
size_t n )
const
467#if defined(_STK_DEBUG_)
469 std::ostringstream error;
470 error <<
"StkFrames::operator[]: invalid index (" << n <<
") value!";
475 return data_==
nullptr ? EMPTY_RESULT : data_[n];
478inline StkFloat& StkFrames :: operator() (
size_t frame,
unsigned int channel )
480#if defined(_STK_DEBUG_)
481 if ( frame >= nFrames_ || channel >= nChannels_ ) {
482 std::ostringstream error;
483 error <<
"StkFrames::operator(): invalid frame (" << frame <<
") or channel (" << channel <<
") value!";
488 return data_==
nullptr? EMPTY_RESULT : data_[ frame * nChannels_ + channel ];
491inline StkFloat StkFrames :: operator() (
size_t frame,
unsigned int channel )
const
493#if defined(_STK_DEBUG_)
494 if ( frame >= nFrames_ || channel >= nChannels_ ) {
495 std::ostringstream error;
496 error <<
"StkFrames::operator(): invalid frame (" << frame <<
") or channel (" << channel <<
") value!";
501 return data_==
nullptr ? EMPTY_RESULT : data_[ frame * nChannels_ + channel ];
506#if defined(_STK_DEBUG_)
508 std::ostringstream error;
509 error <<
"StkFrames::operator+: frames argument must be of equal dimensions!";
513 StkFrames sum((
unsigned int)nFrames_,nChannels_);
514 StkFloat *sumPtr = &sum[0];
515 const StkFloat *fptr = f.data_;
516 const StkFloat *dPtr = data_;
517 for (
unsigned int i = 0; i < size_; i++) {
518 *sumPtr++ = *fptr++ + *dPtr++;
525#if defined(_STK_DEBUG_)
527 std::ostringstream error;
528 error <<
"StkFrames::operator+=: frames argument must be of equal dimensions!";
533 StkFloat *fptr = &f[0];
534 StkFloat *dptr = data_;
535 for (
unsigned int i=0; i<size_; i++ )
541#if defined(_STK_DEBUG_)
543 std::ostringstream error;
544 error <<
"StkFrames::operator*=: frames argument must be of equal dimensions!";
549 StkFloat *fptr = &f[0];
550 StkFloat *dptr = data_;
551 for (
unsigned int i=0; i<size_; i++ )
556typedef unsigned short UINT16;
557typedef unsigned int UINT32;
558typedef signed short SINT16;
559typedef signed int SINT32;
560typedef float FLOAT32;
561typedef double FLOAT64;
564const StkFloat SRATE = 44100.0;
570const unsigned int RT_BUFFER_SIZE = 512;
581#if !defined(RAWWAVE_PATH)
582# define RAWWAVE_PATH "../../rawwaves/"
585const StkFloat STK_PI = 3.14159265358979;
586const StkFloat STK_TWO_PI = 2 * STK_PI;
588const StkFloat ONE_OVER_128 = 0.0078125;
590#if defined(__WINDOWS_DS__) || defined(__WINDOWS_ASIO__) || defined(__WINDOWS_MM__)
591 #define __OS_WINDOWS__
592 #define __STK_REALTIME__
593#elif defined(__LINUX_OSS__) || defined(__LINUX_ALSA__) || defined(__UNIX_JACK__)
595 #define __STK_REALTIME__
596#elif defined(__IRIX_AL__)
598#elif defined(__MACOSX_CORE__) || defined(__UNIX_JACK__)
599 #define __OS_MACOSX__
600 #define __STK_REALTIME__
virtual void printMessage(void)
Prints thrown error message to stderr.
Definition Stk.h:124
virtual const std::string & getMessage(void)
Returns the thrown error message string.
Definition Stk.h:137
virtual const char * getMessageCString(void)
Returns the thrown error message as a C string.
Definition Stk.h:140
virtual const Type & getType(void)
Returns the thrown error message type.
Definition Stk.h:134
virtual ~StkError(void)
The destructor.
Definition Stk.h:121
StkError(const std::string &message, Type type=StkError::UNSPECIFIED)
The constructor.
Definition Stk.h:117
unsigned int channels(void) const
Return the number of channels represented by the data.
Definition Stk.h:415
void operator*=(StkFrames &f)
Assignment by product operator into self.
Definition Stk.h:539
void operator+=(StkFrames &f)
Assignment by sum operator into self.
Definition Stk.h:523
unsigned int frames(void) const
Return the number of sample frames represented by the data.
Definition Stk.h:418
size_t size() const
Returns the total number of audio samples represented by the object.
Definition Stk.h:373
void resize(size_t nFrames, unsigned int nChannels=1)
Resize self to represent the specified number of channels and frames.
~StkFrames()
The destructor.
StkFloat interpolate(StkFloat frame, unsigned int channel=0) const
Return an interpolated value at the fractional frame index and channel.
StkFrames operator+(const StkFrames &frames) const
Sum operator.
Definition Stk.h:504
void resize(size_t nFrames, unsigned int nChannels, StkFloat value)
Resize self to represent the specified number of channels and frames and perform element initializati...
StkFloat dataRate(void) const
Return the sample rate associated with the StkFrames data.
Definition Stk.h:432
StkFrames & getChannel(unsigned int channel, StkFrames &destinationFrames, unsigned int destinationChannel) const
Retrieves a single channel.
bool empty() const
Returns true if the object size is zero and false otherwise.
Definition Stk.h:446
StkFloat & operator()(size_t frame, unsigned int channel)
Channel / frame subscript operator that returns a reference.
Definition Stk.h:478
StkFloat & operator[](size_t n)
Subscript operator that returns a reference to element n of self.
Definition Stk.h:452
StkFrames(unsigned int nFrames=0, unsigned int nChannels=0)
The default constructor initializes the frame data structure to size zero.
StkFrames(const StkFloat &value, unsigned int nFrames, unsigned int nChannels)
Overloaded constructor that initializes the frame data to the specified size with value.
void setChannel(unsigned int channel, const StkFrames &sourceFrames, unsigned int sourceChannel)
Sets a single channel.
void setDataRate(StkFloat rate)
Set the sample rate associated with the StkFrames data.
Definition Stk.h:425
static const StkFormat STK_FLOAT32
Definition Stk.h:152
static void showWarnings(bool status)
Toggle display of WARNING and STATUS messages.
Definition Stk.h:221
static void clear_alertList()
Static method that frees memory from alertList_.
Definition Stk.h:187
void removeSampleRateAlert(Stk *ptr)
Remove class pointer from list for sample rate change notification.
static void setSampleRate(StkFloat rate)
Static method that sets the STK sample rate.
static void handleError(const char *message, StkError::Type type)
Static function for error reporting and handling using c-strings.
static void setRawwavePath(std::string path)
Static method that sets the STK rawwave path.
static const StkFormat STK_FLOAT64
Definition Stk.h:153
static const StkFormat STK_SINT16
Definition Stk.h:149
void addSampleRateAlert(Stk *ptr)
Add class pointer to list for sample rate change notification.
static std::string rawwavePath(void)
Static method that returns the current rawwave path.
Definition Stk.h:190
static void swap64(unsigned char *ptr)
Static method that byte-swaps a 64-bit data type.
static StkFloat sampleRate(void)
Static method that returns the current STK sample rate.
Definition Stk.h:156
static const StkFormat STK_SINT32
Definition Stk.h:151
virtual void sampleRateChanged(StkFloat newRate, StkFloat oldRate)
This function should be implemented in subclasses that depend on the sample rate.
static bool inRange(StkFloat value, StkFloat min, StkFloat max)
Static method to check whether a value is within a specified range.
Definition Stk.h:208
static void swap32(unsigned char *ptr)
Static method that byte-swaps a 32-bit data type.
Stk(void)
Default constructor.
static void swap16(unsigned char *ptr)
Static method that byte-swaps a 16-bit data type.
void ignoreSampleRateChange(bool ignore=true)
A function to enable/disable the automatic updating of class data when the STK sample rate changes.
Definition Stk.h:184
static void handleError(std::string message, StkError::Type type)
Static function for error reporting and handling using c++ strings.
virtual ~Stk(void)
Class destructor.
static void sleep(unsigned long milliseconds)
Static cross-platform method to sleep for a number of milliseconds.
static const StkFormat STK_SINT8
Definition Stk.h:148
void handleError(StkError::Type type) const
Internal function for error reporting that assumes message in oStream_ variable.
static const StkFormat STK_SINT24
Definition Stk.h:150
static void printErrors(bool status)
Toggle display of error messages before throwing exceptions.
Definition Stk.h:224
The STK namespace.
Definition ADSR.h:8