Shackapoo

Developing ideas

2011-05-21T15:55:00.000-07:00

I want to write about procrastinating, specifically about procrastinating on developing my ideas for a synesthetic game, but people have already written better essays than I ever could on the subject (my favorite being John Perry's Structured Procrastination). So rather than let this post be hijacked by the procrastination pirates of penzance, I'll try to use this post as a tool to break through my mental block.

When trying to solve a problem that at first seems overwhelming, it's usually best to break it down into smaller more manageable pieces. My somewhat overwhelming problem is to create a musically inspired synesthetic game. There appear to be two big pieces to this goal:

a game that's both very accessible and an engaging experience to users
an algorithm that takes as input game state, and outputs music that enhances the game's experience and possibly even feeds back into the contents of the game.

Below is a diagram of what is admittedly a ridiculously vague model.

Let's first try to focus on the game aspect, and brainstorm a list of games that could fit this genre:

A sidescrolling/third person/first person shooter where enemies, powerups, and graphics vary based on what sounds are generated from shooting enemies and gaining powerups.
A tactical strategy game where the board, enemy, and rules vary based on what sounds are generated from moves made and enemies attacked.
A platform puzzle game where the level is explored and solved based on what sounds are generated from exploring the level.
A card game where your deck, the rules, and play state changes based on the sounds are generated by the cards you play.
An adventure game where the characters you meet and the actions you can take change based on the sounds that are generated by actions you take and characters you meet.

It's getting clear to me that the only way that I can successfully create this game is to break the hard circular dependency between the sound generation and the game itself. I think I'll first focus on creating an app that generates sounds, and later create a game that can evolve and change based on multiple input vectors.

Flexible tone matrix

2011-05-01T14:06:00.000-07:00

Here's a link to my version of a 16 step sine wave synthesizer before I go any further:

http://www.shackapoo.com/flex/SoundMatrix.html

I've been messing with the idea of a synethesic(sp?) rpg. Someone linked me to this tone matrix: lab.andre-michelle.com/tonematrix. I thought a good first step would be reproducing it. I also wanted to expand on musical parts of the matrix, using more than just the pentatonic scale in one key. So here is a much more flexible version of the tone matrix, where you can change the scale, key, and bpm. This is just a fast program I whipped up to figure out how the original was made, so I apologize in advanced if it looks a little rough.

Writing a web based RPG

2011-04-16T12:46:00.000-07:00

Looking over previous posts, I see a common trend. I've started and stopped a lot of personal projects over the past few years. The reasons for why I want to do one are the same as they were then. The reasons why I probably won't finish it are also the same.

That being said, I'm starting, and by gummit Imma finish creating, a tactical RPG made natively in the browser. The reason I'm announcing it before I've made any progress is to keep me honest; if I announce publicly that I'm going to do something, there's way more pressure for me to complete it.

Hopefully there will be a blog post every week with my progress. I'll also try to use twitter/facebook as well.

Logo list evaluation

2009-03-01T00:20:00.000-08:00

Here's a quick update; the problem that I'm considering right now.

Consider the following code in logo:

? print first [3+5]
? print if 1=1 [3+5]

For the first statement, the output is:
3+5

For the second statement, the output is:
8

Why is this significant to logo? Well, it turns out these cases represent special cases in UCBLogo for handling input inside a list. The list [3+5] is a list with one word, '3+5'. If you do the command first [3+5], the word '3+5' is returned. However, if you do an evaluation of the list [3+5] (i.e. if 1=1 [3+5]), the list is interpreted as having 3 symbols, "3", "+", and "5", and is evaluated as 8.

The solution to this problem looks like it's simple enough: If you evaluate an instruction list, and you come across a word which has the symbol(s) +, - (with the exception if it's the first symbol of the word), /, <, (, ), =, or > then you split up the word into separate words around these delimiters. You then evaluate the list.

Fun stuff!

2009-02-22T19:26:00.000-08:00

Well, I haven't been updating this blog recently. The reasons for this are two fold:

1) The updates that I have been making aren't interesting enough to make a blog post about.

2) My work on this project has been slowed down due to job work and other interests.

As per the law of fire and motion, this project won't get done unless I keep making progress each week. I didn't want to set concrete deadlines since I don't really know how long this is going to take and it's demotivating to fail to meet a deadline once you've set one.

Instead, I'll do something I should have done formally from the beginning. I'm going to schedule time each week for working on this project. Here are the times:

M: 9:30-11p
T: 9:30-11p
Sa: 10a-12p
Su: 9-11a

There you go. 7 hours total per week. Since it takes about 15 minutes to really get started, it's 6 hours of consecutive work per week. That should get this project rolling.

Logo development update: Test driven development and Logo Lexer

2009-02-07T23:48:00.000-08:00

Test driven development is relatively new to me in the sense that, while I've known about it for some years, I've never used it in any non trivial project. This deficiency is something that I regret.

To be more accurate, not using test driven development is something I feel that I should regret, but deep down inside I do not. Most working developers understand things need to get done under a certain deadline. To state the obvious, certain development methods take longer than others to initially deliver a result. If the final product is something with loose requirements or requirements that are hard to test, test driven development is probably too expensive in terms of the time it will take to push out a change. However if you have a tightly defined spec with well defined requirements, then test driven development may work for you.

Note that while I do not think test driven development is the bees knees, I do believe well defined tests are essential. Most projects are better for having rigorous tests, but you have to think carefully about the way you place writing tests into your development process. For some projects, it's better to write tests before you've written a line of code, for some it's better after you've written the entire thing, and then there's all that stuff in between. Who really cares, it's all very domain specific, and it's been written about before and written better. We're done with this topic and we're moving to part two:

Logo development will be test driven. The test driven development model appeals to this project since ucblogo is a (mostly) well defined language whose core concepts rarely change over time. It's important to write the tests before writing the code since the tests will essentially write the spec for interpreter implementation.

So far I've written several tests for the logo lexer. Each test is separated into two files: a test file with a sample logo program, and an expected results file with the logo lists written as strings. Each test file will be read and executed by a junit test in the lexer module and the output will be compared to the correspond expected file.

Here is the sample test and expected file:

sample.test
;; a simple print statement
print "simple

sample.expected
[print quoted simple]

As per usual, let me first state why this method of testing is bad (and by association why it makes me a bad developer):

This approach sucks because it separates the core part of the test from code itself and makes it more difficult for me to read my test files . Now I have to create a separate conf file to hold path variables that java doesn't know about natively since it's not embedded in the code. This conf file makes the build process more complicated, since I now need to include this file if I'm testing, but not include it if I'm running the app as normal since I don't want the dependencies in the final application.

So why did I choose this method to develop the Lexer tests?

This approach is nice because it separates the core part of the test from the code itself and allows me to switch the code base I will be using if I need to. Since this project is in its early stage, if I decide it would be better to write the interpreter in say, actionscript or C#, I could switch without losing everything I wrote. Java is a nice platform and all, but in reality, it's not an ideal language for this kind of development. If I find out there's a better multi-platform (in terms of both browser and OS) language for this kind of work, then I want to be able to quickly and painlessly jump ship.

make "|Step 1 of a logo interpreter| "read

2009-02-01T00:38:00.000-08:00

An interpreter at the highest level looks like this:

loop until done
  read input
  evaluate the input
  print the evaluated input to the user

This set of steps is commonly referred to as the read-eval-print loop.

At a quick glance, one might think that each step takes an equally long amount of time to implement. That thought is very far from the truth. If we were to relate the implementation time for each step in the read-eval-print loop to the thickness of the components of a deli sandwich, the read and print steps would be thin slices of rye, and eval would be 20 different layers of delicious meats and cheeses squished in between those two slices.

I am currently working on test cases for the logo lexer, which is the core of the read step. Although it's certainly not the meat of the interpreter (TO SELF: oh god, give up with this analogy), it is important to get right. In coming up with a comprehensive set of test cases, I came across a few syntactical features that you don't really find in other languages.

For example, in ucblogo, you can set a variable name to be any valid word value. Since a word can be almost any sequence of text, this can lead to some interesting, if not obfuscated ways of writing code. Here are some interesting, and perfectly legal, logo code snippets (note: don't try to copy this into your logo interpreter since the browser doesn't render tabs):

;; test a space followed by a tab. Creates a variable named " " with value "hello"
? make "\ "hello
;; test a tab followed by a space. Creates a variable named "\t" with value "goodbye"
? make "\ "goodbye
;; print the value of the space variable
? print \
;; print the value of the tab variable
? print \

The above code prints hello, and then goodbye. UCBLogo actually gives you several ways to do this. You could also write the code above with vertical bars like this:

;; print the value of the space variable
? print | |
;; print the value of the tab variable
? print | |

This is only a taste of the kind of obfuscation this syntactic feature gives you. Imaging reading and maintaining code which combined spaces and tabs to create all sorts of weird variable names. It's a scary thought.

However, it does offer the power to come up with some more practical naming conventions that allow for white space, something most other languages don't offer. Take for example:

? make "|my greeting| "hello
? make "|my farewell| "goodbye
? print |my greeting|
hello
? print |my farewell|
goodbye

That's a little more understandable than camel hump notation... or it would be if those darn vertical bars weren't there. While it doesn't look like there's an easy way around this, something I may do once I've implemented the core language is create an editor that hides the vertical bars but still makes it clear which words are part of the variable.

To me, this flexibility in variable naming is a neat part of logo that really shows it was a language designed to be accessible to everyone. Although Logo gives you the power to write messed up code with variables names dependent on spaces and carriage returns, it also allows kids to write variables in plain English. Actually, since ucblogo has UTF8 support, kids can write programs that read well in any language.

The more I delve into this language, the more interesting it gets.

Logo in Java: why do it at all?

2009-01-24T20:06:00.000-08:00

The plan: implement a version of the UCBLogo interpreter in Java.

To begin, let me just say that I start and abandon a lot of projects. It starts by me choosing a project that I have few doubts about. However, soon after I start, there's an inner skeptic in me that says I should forget about the whole thing and do something useful. Usually, my mentality is to ignore my skeptical thoughts and just go on with the project. "Screw you doubts, I'm going to go and do it anyway!" These doubts, unresolved, then fester and grow as I'm working out the project details. As soon as I hit a tough point, the doubts take over and soon I abandon what I'm working on and start the cycle anew by searching for another doubt free project.

This time, I'm going to take a different approach. I'm going to get the doubts out of the way now, so I can push through the initial development phase and end up with something of value.

So here it is, the three main reasons why this project is a giant waste of time:

1) It's been done and it's been done better.

There already are many logo implementations already out there. According to Wikipedia, there are 187 working implementations of Logo. If someone wants to write a program in Logo, they can pick any one of these implementations. Moreover, there are several rock solid implementations, like UCBLogo, FMSLogo, and Microworlds, which are better than anything I could ever come up with. There's even a really cool web based one being developed!

2) Logo is old, boring, and dying

Logo is over 40 years old. Its main purpose was to be an educational programming language for kids. In recent years, there have been other exciting developments in educational programming languages. Alice lets you create programs in your own 3D environment. Scratch lets you snap together blocks and share your programs on the web. Logo is just turtle graphics, which no kid thinks is exciting. Logo is dead, long live Alice and Scratch.

3) Java is the wrong language

Let's face it, Java is not the ideal language for implementing a Logo interpreter. The biggest problem with choosing Java as my language is the lack of built in continuations. You see, Logo (or actually UCBLogo) requires tail call elimination. The easiest way to implement tail call elimination is with a language that supports continuations. In Brian Harvey's C based version of UCB Logo, this problem was solved with an evaluation procedure that used GOTO statements to avoid explicit recursion and a stack to store the execution state. Java doesn't have GOTO, so tail call elimination will need to be implemented by either inventing continuations on top of the JVM or some other more convoluted way. Why not implement the language in something that already has continuations so I don't have to deal with this stuff?

To summarize the above: Why make a cement wheel with a hammer and chisel when you can get a better one, made of rubber, at the hardware store for less?

I chose Logo because I'm interested in Computer Science education, and what better way to learn about the ideas behind CS education then by learning every detail of a language rich in those ideas.

I chose Java, or explicitly the JVM, because it can run in a browser, it runs on all platforms, and because it's popular. When I'm done, I want someone to be easily able to use it for their own purposes. As for continuations, I'll deal with them when I get there.

And for the point that it's been done and it's been done better. Well, erhm... this point is rather embarrassing. You see, I've never written a compiler or interpreter before that wasn't for a class, and I've certainly never written one that was any good. Many people say that writing a compiler or interpreter yourself is a right of passage as a programmer. I know it's doubtful anybody will call me a better programmer after writing this thing, but it's even more doubtful that they will if I don't write it. This is one right of passage that I need to take.