ao 0.0.4 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: f356483d9927a615433c919ccdf4a9335ef0f825
-  data.tar.gz: f96008a87b99d866c38f665ce24dee46527cd2a7
+SHA256:
+  metadata.gz: ce2aaa85c50a86ac3467984323d71563ecb1eeab53892a211fee59b67752fd28
+  data.tar.gz: 44126c6129f860e6c5de4076442e5d28300326127d6dd86e39ef28c0903c970a
 SHA512:
-  metadata.gz: 181ae039738c5c04d9215878fbbd6b70270b2a15904680073dfd7c15f30a45e8213aeeb30a20f217f28b95d09f936777655fb3d40a751a1fa032e72d85e72d31
-  data.tar.gz: db92ee3c10022d5f5adaa71ec5ca51588ae8c2f6523014bc966ee043cb6b8f66e89def62302aed44eed739555115899dd186cfc2d3691621730d93f4e8ca73af
+  metadata.gz: e4228179a5b5c685a30438e530350422a581784abf2311a10d9eeb48046afa27628c7dbdf4159fac8f97f9bdbd8082b53890a2b096c0620ed8fea76c1c772a29
+  data.tar.gz: fe1d53eb6782afa35c1cedf0829fe1f9038f8d12095bac1c20c20221b2116d2074f6233ad17b0dab03759f8980494a73fe4bf17b96e5b73ca9cbb8bec414f1c5

data/Rakefile

@@ -0,0 +1,14 @@
+#-*- coding: utf-8 -*-
+
+require 'rake/extensiontask'
+
+Rake::ExtensionTask.new('audio') do |ext|
+  ext.name = 'outputc'
+  ext.lib_dir  ='lib/audio'
+  ext.cross_compile = true
+  ext.cross_platform = ENV['CROSS_COMPILE'] || 'armv6j-linux-gnueabi'
+  ext.cross_compiling do |gem_spec|
+    gem_spec.post_install_message = "You installed the binary version of this gem!"
+  end
+end
+

data/ext/audio/cao.h

@@ -0,0 +1,94 @@
+#ifndef CAO_H
+#define CAO_H
+
+#include <ruby.h>
+#include <ruby/thread.h>
+#include <ao/ao.h>
+#include <ao/os_types.h>
+#include <pthread.h>
+
+extern VALUE cAudio;
+extern VALUE cAO_Live;
+extern VALUE cAO_File;
+extern VALUE cAO_Info;
+extern VALUE cAO_Mixer;
+extern VALUE cAO_DeviceData;
+extern VALUE cAO_eAOError;
+extern VALUE cAO_eDeviceError;
+extern VALUE cAO_eUnknownError;
+
+extern VALUE cAO_eNoDriver;
+extern VALUE cAO_eNotFile;
+extern VALUE cAO_eNotLive;
+extern VALUE cAO_eBadOption;
+extern VALUE cAO_eDriverError;
+
+extern VALUE cAO_eFileError;
+extern VALUE cAO_eFileExists;
+extern VALUE cAO_eBadFormat;
+
+#define cAO_STATE_EXIT -1
+#define cAO_STATE_STOP 0
+#define cAO_STATE_ACTIVE 1
+#define cAO_STATE_PLAYING 2
+
+typedef struct queue {
+  void *data;
+  struct queue *next;
+} queue;
+
+typedef struct sample_t {
+  uint_32 bytes;
+  char *buffer;
+} sample_t;
+
+typedef struct ao_struct {
+  ao_device        *device;
+  ao_sample_format *format;
+  ao_option        *option;
+  queue            *queue;
+  int               qsize;
+  pthread_t         thread;
+  pthread_mutex_t   mutex;
+  pthread_cond_t    cond;
+  int               status;
+} ao_struct;
+
+
+void init_info(void);
+void init_option(void);
+void init_mixer(void);
+ao_struct *init_aos(ao_device *dev,
+		    ao_sample_format *format,
+		    ao_option *option);
+void close_device(ao_struct *aos);
+void remove_device(ao_struct *aos);
+
+void init_exception(void);
+void init_constant(void);
+ao_sample_format *
+set_format(VALUE bits, VALUE rate, VALUE channels,
+	   VALUE byte_format, VALUE matrix);
+void free_format(ao_sample_format *format);
+ao_option * set_option(VALUE a_options);
+
+VALUE
+raodev_play(VALUE obj, VALUE output_samples);
+
+VALUE raodev_close(VALUE obj);
+VALUE raodev_closed(VALUE obj);
+VALUE raodev_playing(VALUE obj);
+VALUE raodev_waiting(VALUE obj);
+
+VALUE
+rao_open_live(VALUE obj,      VALUE driver_id,
+	      VALUE bits, VALUE rate, VALUE channels,
+	      VALUE byte_format, VALUE matrix,
+	      VALUE a_options, VALUE thread);
+VALUE
+rao_open_file(VALUE obj,      VALUE driver_id,
+	      VALUE filename, VALUE overwrite,
+	      VALUE bits, VALUE rate, VALUE channels,
+	      VALUE byte_format, VALUE matrix,
+	      VALUE a_options, VALUE thread);
+#endif

data/ext/audio/device.c

@@ -0,0 +1,202 @@
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+#include <assert.h>
+#include <errno.h>
+#include "cao.h"
+#include "queue.h"
+
+typedef struct aos_gvl {
+  ao_struct *aos;
+  sample_t   sample;
+  int        res;
+} aos_gvl;
+
+void *nogvl_ao_play(void *dat){
+  aos_gvl *aosg = (aos_gvl *)dat;
+
+  aosg->res =
+    ao_play(aosg->aos->device,
+	    aosg->sample.buffer,
+	    aosg->sample.bytes);
+  return NULL;
+}
+
+ao_struct *
+init_aos(ao_device *dev, ao_sample_format *format,
+	 ao_option *option){
+  ao_struct *aos;
+
+  aos          = ALLOC(ao_struct);
+  aos->device  = dev;
+  aos->format  = format;
+  aos->option  = option;
+  aos->queue   = NULL;
+  aos->status  = 1;
+  aos->qsize   = 0;
+  aos->thread  = 0;
+  return aos;
+}
+
+/*
+ * call-seq: ao.play(output_samples)
+ *
+ * 受け取ったサンプルを再生する。
+ * threadが有効の場合、受け取ったサンプルを
+ * 再生キューに追加する。
+ * (デバイスがファイル出力の場合はファイルに書き出す)
+ * 一度に渡せる量はunsigned int(32bit)の範囲まで。
+ *
+ * [arg1] buffer(String)
+ * [return] Fixnum
+ */
+VALUE
+raodev_play(VALUE obj, VALUE output_samples)
+{
+  sample_t  *sample;
+  ao_struct *aos;
+  aos_gvl    aosg;
+
+  Check_Type(output_samples, T_STRING);
+  if (rb_ivar_get(obj, rb_intern("@device")) == Qnil){
+    rb_raise(cAO_eAOError, "Device already closed.");
+  }
+  Data_Get_Struct(rb_ivar_get(obj, rb_intern("@device")),
+		  ao_struct, aos);
+  if ((sample = malloc(sizeof(sample_t))) == NULL){
+    rb_raise(cAO_eAOError, "Memory allocation failure.");
+  }
+  sample->bytes = RSTRING_LENINT(output_samples);
+  if ((sample->buffer = malloc(sample->bytes)) == NULL){
+    rb_raise(cAO_eAOError, "Memory allocation failure.");
+  }
+  memcpy(sample->buffer, StringValuePtr(output_samples), sample->bytes);
+
+  if (aos->thread == 1){
+    enqueue(aos, sample);
+  } else {
+    aosg.aos = aos;
+    aosg.sample = *sample;
+#ifdef HAVE_RB_THREAD_CALL_WITHOUT_GVL
+    rb_thread_call_without_gvl2(nogvl_ao_play, &aosg, NULL, NULL);
+#else
+    nogvl_ao_play(&aosg);
+#endif
+    free(sample->buffer);
+  }
+  return obj;
+}
+
+/*
+ * ao_struct構造体の持つデバイスを全て閉じ、
+ * またオプションとフォーマットの情報も削除する。
+ * メンバ変数にはNULLを設定する。
+ * ao_struct構造体自体は開放しない。
+ * (rubyのGCによって実行されるremove_device関数に任せるため)
+ */
+void
+close_device(ao_struct *aos){
+  int i;
+  sample_t *sample;
+
+  if (aos->thread == 1){
+    assert(pthread_mutex_lock(&aos->mutex) == 0);
+    if (aos->status > 0){
+      aos->status = 0;
+    }
+    assert(pthread_cond_signal(&aos->cond) == 0);
+    assert(pthread_mutex_unlock(&aos->mutex) == 0);
+
+    while ((sample = dequeue(aos)) != NULL){
+      free(sample->buffer);
+      free(sample);
+    }
+    pthread_join(aos->thread, NULL);
+  } else {
+    if (aos->device != NULL){
+      ao_close(aos->device);
+    }
+    if (aos->option != NULL){
+      ao_free_options(aos->option);
+    }
+    if (aos->format != NULL){
+      free_format(aos->format);
+    }
+    aos->device = NULL;
+    aos->option = NULL;
+    aos->format = NULL;
+    aos->queue  = NULL;
+  }
+  return;
+}
+
+/*
+ * GCが実行された時にデバイスを閉じ、構造体を開放する。
+ * この関数はopen_live()とopen_file()にてao_struct構造体をWrapする時に
+ * 構造体free用関数として渡す(rubyのGCにて呼ばれるよう設定する)
+ * Data_Wrap_Struct(cAO_DeviceData, 0, remove_device, aos);
+ */
+void
+remove_device(ao_struct *aos)
+{
+  close_device(aos);
+  free(aos);
+  return;
+}
+
+/*
+ * call-seq: ao.closed?
+ *
+ * デバイスが既に閉じられているか確認する。
+ * [return] true or false
+ */
+VALUE
+raodev_closed(VALUE obj)
+{
+  ao_struct *aos;
+  Data_Get_Struct(rb_ivar_get(obj, rb_intern("@device")),
+		  ao_struct, aos);
+  if (aos->device == NULL){
+    return Qtrue;
+  }
+  return Qfalse;
+}
+
+/*
+ * call-seq: ao.playing?
+ *
+ * デバイスがオーディオを出力中か確認する。
+ * (threadを有効にしていない場合、常にfalse)
+ * [return] true or false
+ */
+VALUE
+raodev_playing(VALUE obj)
+{
+  ao_struct *aos;
+  Data_Get_Struct(rb_ivar_get(obj, rb_intern("@device")),
+		  ao_struct, aos);
+  if (aos->thread == 1 && aos->status == 2){
+    return Qtrue;
+  }
+  return Qfalse;
+}
+
+/*
+ * call-seq: ao.waiting
+ *
+ * 再生キューの待ち数を返す。
+ * (threadを有効にしていない場合、常に0)
+ * [return] Integer
+ */
+VALUE
+raodev_waiting(VALUE obj)
+{
+  ao_struct *aos;
+  Data_Get_Struct(rb_ivar_get(obj, rb_intern("@device")),
+		  ao_struct, aos);
+  if (aos->thread == 1){
+    return INT2FIX(aos->qsize);
+  }
+  return 0;
+}

data/ext/{extconf.rb → audio/extconf.rb}

@@ -3,10 +3,14 @@
 
 require 'mkmf'
 
+RbConfig::MAKEFILE_CONFIG['CC'] = ENV['CC'] if ENV['CC']
+
 dir_config('audio')
+have_header('pthread.h')
 have_header('ao/ao.h')
 have_header('ao/os_types.h')
 have_header('ao/plugin.h')
 have_library('ao')
+have_library('pthread')
 have_func('rb_thread_call_without_gvl')
 create_makefile('audio/outputc')

data/ext/audio/file.c

@@ -0,0 +1,127 @@
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <errno.h>
+#include "cao.h"
+#include "thread.h"
+
+ao_device *
+rao_open_file_dev(int driver_id, char *filename,
+		  int overwrite, ao_sample_format *format,
+		  ao_option *option){
+  ao_device *dev;
+
+  dev = ao_open_file(driver_id, filename,
+		     overwrite, format, option);
+  if (dev == NULL){
+    free_format(format);
+    ao_free_options(option);
+    switch(errno){
+    case AO_ENODRIVER:
+      rb_raise(cAO_eNoDriver,
+	       "No driver corresponds - %s",
+	       strerror(errno));
+      break;
+    case AO_ENOTFILE:
+      rb_raise(cAO_eNotFile,
+	       "This driver is not a file output device - %s",
+	       strerror(errno));
+      break;
+    case AO_EBADOPTION:
+      rb_raise(cAO_eBadOption,
+	       "A valid option key has an invalid value - %s",
+	       strerror(errno));
+      break;
+    case AO_EOPENFILE:
+      rb_raise(cAO_eFileError,
+	       "Cannot open the device - %s",
+	       strerror(errno));
+      break;
+    case AO_EFILEEXISTS:
+      rb_raise(cAO_eFileExists,
+	       "The file already exists - %s",
+	       strerror(errno));
+    case AO_EFAIL:
+      rb_raise(cAO_eUnknownError,
+	       "Any other cause of failure - %s",
+	       strerror(errno));
+      break;
+    default:
+      rb_raise(cAO_eUnknownError,
+	       "Unknown error - %s",
+	       strerror(errno));
+    }
+  }  
+  return dev;
+}
+
+/*
+ * call-seq: Audio::FileOutput.new(driver_id, filepath, overwrite, bits, rate, channels, byte_format, matrix, options)
+ *
+ * ファイルを開く。引数に指定するmatrixとoptionについては以下を参照。
+ * [matrix] http://xiph.org/ao/doc/ao_sample_format.html
+ * [option] http://xiph.org/ao/doc/drivers.html
+ * optionはKey-Valueを要素に含む2次元配列を設定する。
+ * 特に設定が必要なければnilで構わない。
+ * ex) RAWドライバの出力エンディアンをビッグエンディアンに設定する場合は [["byteirder", "big"]] を渡す。
+ *
+ * [arg1] DriverID(Fixnum)
+ * [arg2] filepath(String)
+ * [arg3] overwrite?(true or false)
+ * [arg4] bits(Fixnum)
+ * [arg5] rate(Fixnum)
+ * [arg6] channels(fixnum)
+ * [arg7] byte_format(fixnum)
+ * [arg8] matrix(String or nil)
+ * [arg9] options(Array or nil)
+ * [arg10] thread(true or false)
+ * [return] self
+ */
+VALUE
+rao_open_file(VALUE obj,      VALUE driver_id,
+	      VALUE filename, VALUE overwrite,
+	      VALUE bits, VALUE rate, VALUE channels,
+	      VALUE byte_format, VALUE matrix,
+	      VALUE a_options, VALUE thread)
+{
+  ao_struct        *aos;
+  ao_device        *dev;
+  ao_sample_format *format;
+  ao_option        *option;
+  int               overwrite_int = 0;
+  VALUE             rdev;
+
+  if (rb_iv_get(obj, "@device") != Qnil){
+    Data_Get_Struct(rb_iv_get(obj, "@device"),
+		    ao_struct, aos);
+    rb_raise(cAO_eDeviceError,
+	     "Device is already open.\n");
+  }
+
+  Check_Type(filename,  T_STRING);
+  Check_Type(driver_id, T_FIXNUM);
+  if (TYPE(overwrite) == T_TRUE){
+    overwrite_int = 1;
+  }
+  format = set_format(bits, rate, channels, byte_format, matrix);
+  option = set_option(a_options);
+  dev = rao_open_file_dev(FIX2INT(driver_id), StringValuePtr(filename), overwrite_int, format, option);
+  if ((aos = init_aos(dev, format, option)) == NULL){
+    rb_raise(cAO_eUnknownError,
+	     "memory allocation failure - %s",
+	     strerror(errno));
+  }
+  if (TYPE(thread) == T_TRUE){
+    if ((aos = create_thread(aos)) == NULL){
+      rb_raise(cAO_eUnknownError,
+	       "memory allocation failure - %s",
+	       strerror(errno));
+    }
+  }
+  rdev = Data_Wrap_Struct(cAO_DeviceData, 0,
+			  remove_device, aos);
+  rb_iv_set(obj, "@device", rdev);
+  rb_ary_push(rb_cv_get(cAO_File, "@@devices"), rdev);
+
+  return obj;
+}