bloops 0.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3cd9f25401e9862ac0cefccbc8db376e505b4a87211f79fe29d604cfda106b98
+  data.tar.gz: ca5d8575c212f385ab0d6bd80c61b6265a7d81b8f1d353643a800e12c844e8c8
+SHA512:
+  metadata.gz: 4b72958048821906c0aad1fb8989d833799b09a7c8ab2f03b72add6a6eefc28e6750bddb79fcc38048f1a219444f1b2b2d882ba4ecb753fb6035575fb10894a1
+  data.tar.gz: 395c456eecfb898e86a01cdc55968e73f37dc728b634f6639872e33f89558ee51595286885aafe394c98bcb18a621f79d9d7a389d81a27b48f128686b6e88d19

data/COPYING

@@ -0,0 +1,27 @@
+  
+  :$: BLOOPSAPHONE :$:
+  Copyright (c) 2009 why the lucky stiff
+  Based on sfxr (c) 2007 Tomas Pettersson
+    (Also released under the MIT license)
+  
+  Permission is hereby granted, free of charge, to any person
+  obtaining a copy of this software and associated documentation
+  files (the "Software"), to deal in the Software without restriction,
+  including without limitation the rights to use, copy, modify, merge,
+  publish, distribute, sublicense, and/or sell copies of the Software,
+  and to permit persons to whom the Software is furnished to do so,
+  subject to the following conditions:
+    
+  The above copyright notice and this permission notice shall be 
+  included in all copies or substantial portions of the Software.
+     
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+  ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+  TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+  PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
+  SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+  OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
+  OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+  WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+

data/Makefile

@@ -0,0 +1,60 @@
+SRC = c/bloopsaphone.c c/notation.c
+OBJ = ${SRC:.c=.o}
+
+PREFIX = /usr/local
+CC = gcc
+AR = ar
+ARFLAGS = cr
+CFLAGS ?= -Wall
+DEBUG ?= 0
+ECHO = /bin/echo
+INCS = -Ic
+LDFLAGS ?=
+LIBS = -lm -lportaudio
+RAGEL = ragel
+
+RAGELV = `${RAGEL} -v | sed "/ version /!d; s/.* version //; s/ .*//"`
+
+all: bloopsaphone
+
+rebuild: clean bloopsaphone
+
+bloopsaphone: bloopsawhat bloopsalib
+
+bloopsawhat: ${OBJ} c/bloopsawhat.o
+	@${ECHO} LINK bloopsawhat
+	@${CC} ${CFLAGS} ${OBJ} c/bloopsawhat.o ${LDFLAGS} ${LIBS} -o bloopsawhat
+
+bloopsalib: ${OBJ} 
+	@${ECHO} LINK bloopsalib
+	@${AR} ${ARFLAGS} libbloopsaphone.a ${OBJ}
+
+c/notation.c: c/notation.rl
+	@if [ "${RAGELV}" != "6.3" ]; then \
+		if [ "${RAGELV}" != "6.2" ]; then \
+			${ECHO} "** bloopsaphone may not work with ragel ${RAGELV}! try version 6.2 or 6.3."; \
+		fi; \
+	fi
+	@${ECHO} RAGEL c/notation.rl
+	@${RAGEL} c/notation.rl -C -o $@
+
+%.o: %.c
+	@${ECHO} CC $<
+	@${CC} -c ${CFLAGS} ${INCS} -o $@ $<
+
+clean:
+	@${ECHO} cleaning
+	@rm -f ${OBJ}
+	@rm -f c/notation.c c/*.o
+	@rm -f bloopsawhat libbloopsaphone.a bloopsaphone.so
+	@cd ext/ruby && make distclean || true
+
+ruby: c/notation.c c/bloopsaphone.c
+	@${ECHO} RUBY extconf.rb
+	@cd ext/ruby && CFLAGS="${CFLAGS}" LDFLAGS="${LDFLAGS}" ruby extconf.rb && make
+	@${ECHO} ""
+	@${ECHO} "To test: cd ext/ruby"
+	@${ECHO} "Then:    ruby test.rb"
+	@${ECHO} ""
+
+.PHONY: all bloopsaphone clean rebuild ruby

data/README

@@ -0,0 +1,172 @@
+
+      |~~              |~~
+      |                |
+     :$: bloopsaphone :$:
+      `''''''''''''''''`
+
+  for writing chiptune-style songs
+  in c or ruby. you know: the sounds
+  of ataris, gameboys and the like.
+
+               ~
+
+  -$- ABOUT
+
+  this is a small c library for sending
+  chiptunes through portaudio, which is
+  a rather light cross-platform audio lib.
+  <http://www.portaudio.com/>
+
+  right now i'm only including ruby
+  bindings. you are welcome to contribute
+  code to hook up to other languages,
+  though.
+
+  i wrote this for h-ety h.
+  <http://hacketyhack.net/>
+
+  i don't have binaries ready for this yet,
+  so if you're on windows or os x, you may
+  have to wait until HH comes out at ART
+  AND CODE. the tribulations you face.
+
+               ~
+
+  -$- THE BLOOPSAPHONE THEME SONG
+      (in ruby)
+
+      require 'bloops'
+
+    # the bloops o' phone
+      b = Bloops.new
+      b.tempo = 320
+
+    # melodious
+      s1 = b.sound Bloops::SQUARE
+      s1.punch = 0.5
+      s1.sustain = 0.4
+      s1.decay = 0.2
+      s1.arp = 0.4
+      s1.aspeed = 0.6
+      s1.repeat = 0.6
+      s1.phase = 0.2
+      s1.psweep = 0.2
+
+    # beats
+      s2 = b.sound Bloops::NOISE
+      s2.punch = 0.5
+      s2.sustain = 0.2
+      s2.decay = 0.4
+      s2.slide = -0.4
+      s2.phase = 0.2
+      s2.psweep = 0.2
+
+    # the tracks
+      b.tune s1, "f#5 c6 e4 b6 g5 d6 4  f#5 e5 c5 b6 c6 d6 4 "
+      b.tune s2, "4   c6 4  b5 4  4  e4 4   c6 4  b5 4  4  e4"
+
+    # and away we go
+      b.play
+      sleep 1 while !b.stopped?
+
+               ~
+
+  -$- BUILDING FOR RUBY
+
+  If Ruby is in your path and PortAudio 1.9
+  or greater is installed:
+
+    make ruby
+
+  To install PortAudio 1.9 under Ubuntu:
+
+    aptitude install portaudio19-dev
+
+  To build from source isn't too bad.
+  Download PortAudio 1.9 and build it.
+  <http://www.portaudio.com/archives/pa_stable_v19_20071207.tar.gz>
+
+  Like this:
+
+    $ tar xzvf pa_stable_v19_20071207.tar.gz
+    $ cd portaudio
+    $ ./configure
+    $ make
+    $ sudo make install
+
+  Then go back to Bloopsaphone and do
+  a `make ruby`.
+
+               ~
+
+  -$- THE IDEALS,
+
+  -1- ASYNCHRONOUS.
+      You send it a song and it plays in
+      the background. You'll get an event
+      when it finishes.
+
+  -2- SMALL.
+      This is just a toy, I don't want it
+      to be very big and comprehensive.
+      Just to play little tunes with a
+      nostalgic arcade sound rather than
+      the CASIO-stylings of most MIDI.
+
+  -3- CUSTOM NOTATION.
+      Someone told me about Nokring, iMelody,
+      numbered musical notation and I did
+      some reading. They're little languages
+      for texting yourself a ringtone.
+
+  <http://en.wikipedia.org/wiki/Ring_Tone_Transfer_Language>
+  <http://homepage.mac.com/alvinmok/ericsson/emelody.html>
+
+      Bloopsaphone uses a variation on RTTTL.
+
+      Instead of commas, I use whitespace.
+      A rest is simply a number. A plus sign
+      moves everything up an octave. A minus
+      down an octave.
+
+      The Simpsons' Theme, for instance, would be:
+
+        32 + C E F# 8:A G E C - 8:A 8:F# 8:F# 8:F# 2:G
+
+      Which translates into:
+
+       * a 1/32nd note rest.
+       * change one octave up.
+       * C quarter note.
+       * E quarter note.
+       * F# quarter note.
+       * A eighth note.
+       * G quarter.
+       * E quarter.
+       * C one-quarter note.
+       * change one octave down.
+       * A eighth.
+       * Three F# eighths.
+       * G half note.
+
+      The colons are optional. They are there because you
+      can place an octave number after each note. Somehow
+      "8B6" (an eighth note of B at the sixth octave) looks
+      more confusing than "8:B6". I guess I figured that
+      the timing "8" is conceptually separate from the
+      actual tone "B6", even though they both comprise
+      the note itself.
+
+  -4- SERIALIZE SOUNDS.
+      To accomodate passing instruments between
+      ruby and c, bloopsaphone comes with a tiny
+      file format for describing sounds.
+
+      You can find examples of these in the sounds/
+      folder in this distro. Possible sound types
+      are 'square', 'sawtooth', 'sine' and 'noise'.
+      All other settings go from 0.0 to 1.0.
+
+      The 'freq' setting is only used if the sound
+      is played without a tune.
+

data/c/bloopsaphone-internal.h

@@ -0,0 +1,46 @@
+//
+// threads.h - threaded garments for the bloopsaphone
+//
+#ifndef BLOOPSAPHONE_INTERNAL_H
+#define BLOOPSAPHONE_INTERNAL_H
+
+#ifdef _WIN32
+#include <windows.h>
+typedef CRITICAL_SECTION bloopsalock;
+static inline void bloops_lock_init(bloopsalock *lock) {
+    InitializeCriticalSection(lock);
+}
+static inline void bloops_lock_acquire(bloopsalock *lock) {
+    EnterCriticalSection(lock);
+}
+static inline int bloops_lock_try_acquire(bloopsalock *lock) {
+    return !!TryEnterCriticalSection(lock);
+}
+static inline void bloops_lock_release(bloopsalock *lock) {
+    LeaveCriticalSection(lock);
+}
+static inline void bloops_lock_finalize(bloopsalock *lock) {
+    DeleteCriticalSection(lock);
+}
+#else
+#include <pthread.h>
+#include <errno.h>
+typedef pthread_mutex_t bloopsalock;
+static inline void bloops_lock_init(bloopsalock *lock) {
+    pthread_mutex_init(lock, NULL);
+}
+static inline void bloops_lock_acquire(bloopsalock *lock) {
+    pthread_mutex_lock(lock);
+}
+static inline int bloops_lock_try_acquire(bloopsalock *lock) {
+    return !pthread_mutex_trylock(lock);
+}
+static inline void bloops_lock_release(bloopsalock *lock) {
+    pthread_mutex_unlock(lock);
+}
+static inline void bloops_lock_finalize(bloopsalock *lock) {
+    pthread_mutex_destroy(lock);
+}
+#endif
+
+#endif