ruby-openal 0.1

data/TODO

@@ -0,0 +1,160 @@
+
+
+= AL =
+ * DONE global-parameters
+ * DONE renderer-state management
+ * DONE states
+ * DONE errors
+ * DONE extensions
+
+ * DONE listener : AL::Listener
+  + DONE AL::Listener#orientation (fx,fy,fz,ux,uy,uz)
+  + DONE AL::Listener#gain (v)
+  + DONE AL::Listener#position (x,y,z)
+  + DONE AL::Listener#velocity (x,y,z)
+  + DONE AL::Listener#to_s
+
+
+ * TESTME~
+ * source : AL::Source
+  * DONE + new
+  * DONE - initialize
+  #* - to_s
+  * DONE - attach(buf)     # AL_BUFFER
+  * DONE - play
+  * DONE - stop
+  * DONE - pause
+  * DONE - rewind
+  * DONE - queue_buffers([bufs])
+  * DONE - unqueue_buffers([bufs])
+  * DONE - r: buffers_processed :i # AL_BUFFERS_PROCESSED
+  * DONE - rw: pitch(f)    # AL_PITCH > 0
+  * DONE - rw: gain(f)     # AL_GAIN > 0
+  * DONE - rw: max_distance(f)   # AL_MAX_DISTANCE
+  * DONE - rw: rolloff_factor(f) # AL_ROLLOFF_FACTOR
+  * DONE - rw: reference_distance(f) # AL_REFERENCE_DISTANCE
+  * DONE - rw: min_gain(f)   # AL_MIN_GAIN
+  * DONE - rw: max_gain(f)   # AL_MAX_GAIN
+  * DONE - rw: cone_outer_gain(f)  # AL_CONE_OUTER_GAIN
+  * DONE - rw: cone_inner_angle(f) # AL_CONE_INNER_ANGLE
+  * DONE - rw: cone_outer_angle(f) # AL_CONE_OUTER_ANGLE
+  * DONE - rw: position([x, y, z]) # AL_POSITION
+  * DONE - rw: velocity([x, y, z]) # AL_VELOCITY
+  * DONE - rw: direction([x, y, z])  # AL_DIRECTION
+  * DONE - rw: source_type(enum)   # AL_SOURCE_TYPE [AL_UNDERTERMINED, AL_STATIC, AL_STREAMING]
+  * DONE - rw: looping(bool)       # AL_LOOPING
+  * DONE - rw: source_state(enum)  # AL_SOURCE_STATE [AL_STOPPPED, AL_PLAYING]
+  * DONE - rw: buffers_queued(i)   # AL_BUFFERS_QUEUED
+  * DONE - rw: sec_offset(nsec)     # AL_SEC_OFFSET
+  * DONE - rw: sample_offset(nsamples)  # AL_SAMPLE_OFFSET
+  * DONE - rw: byte_offset(nbytes)  # AL_BYTE_OFFSET
+  * DONE - rw: source_relative(bool)   # AL_SOURCE_RELATIVE
+
+
+
+ * FIXME~
+ * buffer : AL::Buffer
+  - FIXME attach(sample_data)
+  + DONE load_from_sample_data(sample_data)
+  + DONE load_from_file(filename) # alutCreateBufferFromFile
+  + DONE load_from_string(s) # alutCreateBufferFromFileImage
+  + DONE load_hello_world # alutCreateBufferHelloWorld
+  + DONE load_waveform # alutCreateBufferWaveform
+  - DONE r: frequency : ALint
+  - DONE r: size : ALint
+  - DONE r: bits : ALint
+  - DONE r: channels : ALint
+
+
+
+
+= ALC =
+ * DONE errors : ALC::Device#get_error
+ * DONE context : ALC::Context
+ * DONE device : ALC::Device
+ * DONE extensions : ALC::Device#...
+ * DONE queries
+
+ * captures : ALC::CaptureDevice
+  * ALC::CaptureDevice
+   * DONE + ALC::CaptureDeivce#new(device_name, frequency : Fixnum, format : ALenum, bufsize : Fixnum)
+   * DONE - ALC::CaptureDevice#close : Boolean
+   * DONE - ALC::CaptureDevice#start
+   * DONE - ALC::CaptureDevice#stop
+   * - ALC::CaptureDevice#retrive???
+
+
+
+= ALUT =
+ #* NO init
+ * DONE init_without_context
+ * DONE exit
+ * DONE get_error
+ * DONE get_error_string
+ * DONE get_mime_types
+ * DONE major_version
+ * DONE minor_version
+ * DONE sleep
+
+----
+
+ 샘플데이터는 대략 
+  * void* data
+  * ALsizei bufsize
+  * ALenum fmt
+  * ALuint freq
+ ...요렇게 4개의 데이터를 감싸는데 이를 잘 포장할 방법이 필요하삼. 새로운 클래스를 만들어서 이를 포장해야하겠지?
+
+ * AL::SampleData을 사용해서 이를 공개하도록.
+  * DONE + load_from_file(filename) (alutLoadMemoryFromFile)
+  * DONE + load_from_string(io) (alutLoadMemoryFromFileImage)
+
+
+
+---
+
+#include <stdio.h>
+#include <AL/al.h>
+#include <AL/alc.h>
+
+int main( int argc, char *argv[] )
+{
+ALCdevice *mydevice;
+ALubyte mybuf[16384];
+ALint samples;
+ALint leftch, rightch;
+
+// 8000 Hz is really an overkill for my purpose
+// We assume we'll be able to retrieve our samples at least 10 times
+// a second.  At 8000Hz, 16-bit, stereo, we need OpenAL to buffer at
+// least 3200 bytes
+mydevice = alcCaptureOpenDevice( NULL, 8000, AL_FORMAT_STEREO16, 3200 );
+alcCaptureStart( mydevice );
+
+// this would be the application main loop
+while( 1)
+{
+// .....
+
+// ... this would retrieve the samples, whenever I need it
+
+// Copy the samples from OpenAL to our buffer
+alcGetIntegerv(mydevice, ALC_CAPTURE_SAMPLES, &samples);
+if (samples > 0)
+   alcCaptureSamples(mydevice, (ALCvoid *)mybuf, samples);
+
+
+// process the samples....
+
+// sleep(1);
+
+// ......
+}
+
+alcCaptureStop( mydevice );
+alcCaptureCloseDevice( mydevice );
+
+return 0;
+} 
+
+##EOF

data/ext/openal/MANIFEST

@@ -0,0 +1,9 @@
+extconf.rb
+openal.h
+openal.c
+openal_al.h
+openal_al.c
+openal_alc.h
+openal_alc.c
+openal_alut.h
+openal_alut.c

data/ext/openal/Makefile

@@ -0,0 +1,149 @@
+
+SHELL = /bin/sh
+
+#### Start of system configuration section. ####
+
+srcdir = /home/ageldama/my/ruby-openal/trunk/ext/openal
+topdir = /usr/lib/ruby/1.8/i486-linux
+hdrdir = $(topdir)
+VPATH = $(srcdir):$(topdir):$(hdrdir)
+prefix = $(DESTDIR)/usr
+exec_prefix = $(DESTDIR)/usr
+sitedir = $(DESTDIR)/usr/local/lib/site_ruby
+rubylibdir = $(libdir)/ruby/$(ruby_version)
+docdir = $(datarootdir)/doc/$(PACKAGE)
+dvidir = $(docdir)
+datarootdir = $(prefix)/share
+archdir = $(rubylibdir)/$(arch)
+sbindir = $(exec_prefix)/sbin
+psdir = $(docdir)
+localedir = $(datarootdir)/locale
+htmldir = $(docdir)
+datadir = $(prefix)/share
+includedir = $(prefix)/include
+infodir = $(datarootdir)/info
+sysconfdir = $(DESTDIR)/etc
+mandir = $(datadir)/man
+libdir = $(DESTDIR)/usr/lib
+sharedstatedir = $(prefix)/com
+oldincludedir = $(DESTDIR)/usr/include
+pdfdir = $(docdir)
+sitearchdir = $(sitelibdir)/$(sitearch)
+bindir = $(exec_prefix)/bin
+localstatedir = $(DESTDIR)/var
+sitelibdir = $(sitedir)/$(ruby_version)
+libexecdir = $(exec_prefix)/libexec
+
+CC = gcc
+LIBRUBY = $(LIBRUBY_SO)
+LIBRUBY_A = lib$(RUBY_SO_NAME)-static.a
+LIBRUBYARG_SHARED = -l$(RUBY_SO_NAME)
+LIBRUBYARG_STATIC = -l$(RUBY_SO_NAME)-static
+
+RUBY_EXTCONF_H = 
+CFLAGS   =  -fPIC -Wall -g -fno-strict-aliasing -O2  -fPIC 
+INCFLAGS = -I. -I. -I/usr/lib/ruby/1.8/i486-linux -I/home/ageldama/my/ruby-openal/trunk/ext/openal
+CPPFLAGS = -DHAVE_SNPRINTF 
+CXXFLAGS = $(CFLAGS) 
+DLDFLAGS =  -rdynamic -Wl,-export-dynamic  
+LDSHARED = $(CC) -shared
+AR = ar
+EXEEXT = 
+
+RUBY_INSTALL_NAME = ruby1.8
+RUBY_SO_NAME = ruby1.8
+arch = i486-linux
+sitearch = i486-linux
+ruby_version = 1.8
+ruby = /usr/bin/ruby1.8
+RUBY = $(ruby)
+RM = rm -f
+MAKEDIRS = mkdir -p
+INSTALL = /usr/bin/install -c
+INSTALL_PROG = $(INSTALL) -m 0755
+INSTALL_DATA = $(INSTALL) -m 644
+COPY = cp
+
+#### End of system configuration section. ####
+
+preload = 
+
+libpath = $(libdir)
+LIBPATH =  -L"$(libdir)"
+DEFFILE = 
+
+CLEANFILES = 
+DISTCLEANFILES = 
+
+extout = 
+extout_prefix = 
+target_prefix = 
+LOCAL_LIBS = 
+LIBS = $(LIBRUBYARG_SHARED) -lalut -lopenal  -lpthread -ldl -lcrypt -lm   -lc
+SRCS = openal.c openal_alut.c openal_alc.c openal_al.c
+OBJS = openal.o openal_alut.o openal_alc.o openal_al.o
+TARGET = openal
+DLLIB = $(TARGET).so
+EXTSTATIC = 
+STATIC_LIB = 
+
+RUBYCOMMONDIR = $(sitedir)$(target_prefix)
+RUBYLIBDIR    = $(sitelibdir)$(target_prefix)
+RUBYARCHDIR   = $(sitearchdir)$(target_prefix)
+
+TARGET_SO     = $(DLLIB)
+CLEANLIBS     = $(TARGET).so $(TARGET).il? $(TARGET).tds $(TARGET).map
+CLEANOBJS     = *.o *.a *.s[ol] *.pdb *.exp *.bak
+
+all:		$(DLLIB)
+static:		$(STATIC_LIB)
+
+clean:
+		@-$(RM) $(CLEANLIBS) $(CLEANOBJS) $(CLEANFILES)
+
+distclean:	clean
+		@-$(RM) Makefile $(RUBY_EXTCONF_H) conftest.* mkmf.log
+		@-$(RM) core ruby$(EXEEXT) *~ $(DISTCLEANFILES)
+
+realclean:	distclean
+install: install-so install-rb
+
+install-so: $(RUBYARCHDIR)
+install-so: $(RUBYARCHDIR)/$(DLLIB)
+$(RUBYARCHDIR)/$(DLLIB): $(DLLIB)
+	$(INSTALL_PROG) $(DLLIB) $(RUBYARCHDIR)
+install-rb: pre-install-rb install-rb-default
+install-rb-default: pre-install-rb-default
+pre-install-rb: Makefile
+pre-install-rb-default: Makefile
+$(RUBYARCHDIR):
+	$(MAKEDIRS) $@
+
+site-install: site-install-so site-install-rb
+site-install-so: install-so
+site-install-rb: install-rb
+
+.SUFFIXES: .c .m .cc .cxx .cpp .C .o
+
+.cc.o:
+	$(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) -c $<
+
+.cxx.o:
+	$(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) -c $<
+
+.cpp.o:
+	$(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) -c $<
+
+.C.o:
+	$(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) -c $<
+
+.c.o:
+	$(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) -c $<
+
+$(DLLIB): $(OBJS)
+	@-$(RM) $@
+	$(LDSHARED) $(DLDFLAGS) $(LIBPATH) -o $@ $(OBJS) $(LOCAL_LIBS) $(LIBS)
+
+
+
+$(OBJS): ruby.h defines.h

data/ext/openal/extconf.rb

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+require 'mkmf'
+
+dir_config("openal");
+
+if have_library('openal', 'alGetError') and
+  have_func('snprintf', 'stdio.h') and
+  have_library('alut', 'alutGetErrorString') then
+  create_makefile("openal");
+else
+  raise "No OpenAL library found."
+end

data/ext/openal/mkmf.log

@@ -0,0 +1,66 @@
+have_library: checking for alGetError() in -lopenal... -------------------- yes
+
+"gcc -o conftest -I. -I/usr/lib/ruby/1.8/i486-linux -I/home/ageldama/my/ruby-openal/trunk/ext/openal  -Wall -g -fno-strict-aliasing -O2  -fPIC conftest.c  -L"/usr/lib"  -rdynamic -Wl,-export-dynamic     -lruby1.8-static -lopenal  -lpthread -ldl -lcrypt -lm   -lc"
+conftest.c: In function ‘t’:
+conftest.c:3: error: ‘alGetError’ undeclared (first use in this function)
+conftest.c:3: error: (Each undeclared identifier is reported only once
+conftest.c:3: error: for each function it appears in.)
+checked program was:
+/* begin */
+1: /*top*/
+2: int main() { return 0; }
+3: int t() { void ((*volatile p)()); p = (void ((*)()))alGetError; return 0; }
+/* end */
+
+"gcc -o conftest -I. -I/usr/lib/ruby/1.8/i486-linux -I/home/ageldama/my/ruby-openal/trunk/ext/openal  -Wall -g -fno-strict-aliasing -O2  -fPIC conftest.c  -L"/usr/lib"  -rdynamic -Wl,-export-dynamic     -lruby1.8-static -lopenal  -lpthread -ldl -lcrypt -lm   -lc"
+conftest.c: In function ‘t’:
+conftest.c:3: warning: implicit declaration of function ‘alGetError’
+checked program was:
+/* begin */
+1: /*top*/
+2: int main() { return 0; }
+3: int t() { alGetError(); return 0; }
+/* end */
+
+--------------------
+
+have_func: checking for snprintf()... -------------------- yes
+
+"gcc -o conftest -I. -I/usr/lib/ruby/1.8/i486-linux -I/home/ageldama/my/ruby-openal/trunk/ext/openal  -Wall -g -fno-strict-aliasing -O2  -fPIC conftest.c  -L"/usr/lib"  -rdynamic -Wl,-export-dynamic    -lopenal  -lruby1.8-static -lopenal  -lpthread -ldl -lcrypt -lm   -lc"
+checked program was:
+/* begin */
+1: #include <stdio.h>
+2: 
+3: /*top*/
+4: int main() { return 0; }
+5: int t() { void ((*volatile p)()); p = (void ((*)()))snprintf; return 0; }
+/* end */
+
+--------------------
+
+have_library: checking for alutGetErrorString() in -lalut... -------------------- yes
+
+"gcc -o conftest -I. -I/usr/lib/ruby/1.8/i486-linux -I/home/ageldama/my/ruby-openal/trunk/ext/openal  -Wall -g -fno-strict-aliasing -O2  -fPIC conftest.c  -L"/usr/lib"  -rdynamic -Wl,-export-dynamic    -lopenal  -lruby1.8-static -lalut -lopenal  -lpthread -ldl -lcrypt -lm   -lc"
+conftest.c: In function ‘t’:
+conftest.c:3: error: ‘alutGetErrorString’ undeclared (first use in this function)
+conftest.c:3: error: (Each undeclared identifier is reported only once
+conftest.c:3: error: for each function it appears in.)
+checked program was:
+/* begin */
+1: /*top*/
+2: int main() { return 0; }
+3: int t() { void ((*volatile p)()); p = (void ((*)()))alutGetErrorString; return 0; }
+/* end */
+
+"gcc -o conftest -I. -I/usr/lib/ruby/1.8/i486-linux -I/home/ageldama/my/ruby-openal/trunk/ext/openal  -Wall -g -fno-strict-aliasing -O2  -fPIC conftest.c  -L"/usr/lib"  -rdynamic -Wl,-export-dynamic    -lopenal  -lruby1.8-static -lalut -lopenal  -lpthread -ldl -lcrypt -lm   -lc"
+conftest.c: In function ‘t’:
+conftest.c:3: warning: implicit declaration of function ‘alutGetErrorString’
+checked program was:
+/* begin */
+1: /*top*/
+2: int main() { return 0; }
+3: int t() { alutGetErrorString(); return 0; }
+/* end */
+
+--------------------
+

data/ext/openal/openal.c

@@ -0,0 +1,15 @@
+#include "ruby.h"
+#include "openal.h"
+#include "AL/al.h"
+#include "AL/alc.h"
+
+/// initialize 'openal' extension
+void Init_openal() {
+  setup_module_AL();
+  setup_module_ALC();
+  setup_module_ALUT();
+
+  //
+  return;
+}
+

data/ext/openal/openal.h

@@ -0,0 +1,50 @@
+#ifndef RUBY_OPENAL_H
+#define RUBY_OPENAL_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "AL/al.h"
+
+#include "openal_al.h"
+#include "openal_alc.h"
+#include "openal_alut.h"
+
+/// data types
+typedef struct {
+  void* buf;
+  ALsizei bufsize;
+  ALenum fmt;
+  ALuint freq;
+} al_sample_data_t;
+
+
+/// function prototypes
+extern void Init_openal();
+
+/// AL::SampleData internal object interface
+extern al_sample_data_t* AL_SampleData_new();
+extern void AL_SampleData_free(al_sample_data_t* p);
+
+
+/// helper macros
+#define albool2rbbool(b) ((b)?(Qtrue):(Qfalse))
+
+#define RARRAY2ARRAY(rbary, ary, n, convf) \
+VALUE ___v; int ___c;\
+for(___c=0;___c<n;___c++){\
+ ___v=rb_ary_entry(rbary,___c);\
+ ary[___c]=convf(___v);}
+
+#define ARRAY2RARRAY(ary, rbary, n, convf) \
+int ___c; \
+for(___c=0;___c<n;___c++){\
+ rb_ary_push(rbary, convf(ary[___c]));}\
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif