I'll see you all tomorrow, or more likely Saturday.

In the meantime, though, I've been doing a teensy bit of work.  It's all in C# and so not really usable, but I hope to play around with the interface and some actual gameplay.  I'm hoping to get something that resembles fun without any narrative or anything.  I'm sort of doubting my ability to do that, but we'll see.  I'll go into more detail when it isn't post-1AM and I have to be up in a few hours.

Here's some proof:

I also synched contacts with my Gmail account -- I'm not so sure that was a good idea.  Now I've got a phone contact for every last person I've e-mailed (it feels like).  support@paypal.com?  Ugg, why is that there.  I've got some pruning to do.  I found an option to trim it down to just those I had phone numbers for, but my contact book was pretty sparse on that.  Guess I'll have to rectify it.

Game-wise:  I've done a bit more thinking about how things should work, and it's not exactly TDD worthy but at least I have some solid thoughts on the matter.  No plan survives the enemy and all that, so I think my next big coding step (after fixing the snafu I'm about to describe) will be to figure out how to Profile this stuff.  Whether I wrote my own code (probably necessary), or can somehow use the Android tools.  I'll also try debugging on my device, since I have that now.  Should be fun!

So, as things currently stand, about a few hours into making the document I got bored and wanted to write some code.  I coded up a C++ test rig and wrote a few test cases for my reals class.  Ideally, I want the reals to work like any other built-in type, so this means I've got some operator-overloaded muck to deal with.

The usual stuff wasn't that big of a deal:  arithmetic and arithmetic-assignment operators are all done, as well as logical comparisons--inequalities (and equalities, I suppose). I had also coded up some constructors, assignment operators, and some cast operators, but they were causing me no end of grief with the equality operators.  Briefly, it couldn't decide how to handle equality, so in a case like this:
  real r = 32.2f; float f = 32.2f;

  if( r == f ) { // ...
it would call real(32.2f) to convert that number to a real type, but then when it got to the second line, it didn't know whether to call real(float) with f to convert f to a float, or to call real::operator float() to convert r down to a float before it could compare them.  And then there was some ugly template mess thrown into the mix.  (The fixed-point version of real uses an int template to determine where exactly the point is.)

Anyway, I solved that problem by getting rid of the constructors, but through some sequence of events that eludes me unless I sit and think really hard (like, with pencil and paper) about it, it managed to break my list class (and my vector class).  Something about how my list was expecting <T>'s (just any old type), but I guess it was trying to construct them and that didn't work, and so I tried to change it to take pointer-to-<T>'s, but that doesn't work in the simple value-case where I don't mind if it gets copied around.  That is, I can't just have a list of ints (or vectors) anymore, I have to specifically allocate each one somewhere and then keep track of it.  It's sort of a mess.

I've downloaded a few STL implementations and if I can manage to decipher the typedef/macro insanity that all STL implementors feel is necessary, I'll try to do something similar in my own class.  I suspect I may have to create my own allocator for the case where I want to store simple value-types that are larger than a native pointer.  This isn't a huge problem, though, since I was planning on creating a couple fixed-size allocators to use for such a purpose.  I'll just cordon off a smallish chunks of memory near the end for 4, 8, 16, and 32 byte allocations and be happy (well, maybe not 4 bytes, that's a bit small).

Goals for the immediate future include: figuring out what chain of events fixing my real type causes lists to explode, documenting it, and fixing all of that so that it compiles.

Oh, I should manage that I have like three working directories now.  My trunk, which I've sort of given up on because it's in all sort of non-compile state:  I was trying to port some things around and it's been a while since I looked at it so all I know right now is that it doesn't compile.  I spawned a new repository from the latest commit in that (which compiled), and used that to fix some of the issues I discovered while writing the test cases.  I was able to commit those changes, push them back into the trunk repo, pull and (seemlessly!) merge those changes down into the test repo, and then push a bit of the test rig setup back to the main repo.  It was all so smooth.  It's amazing!  SVN has nothing on this.  (I hear Perforce might be okay, but I have to wonder how much the cost of it helps indoctrinate its users into thinking it's so great.  While that can be had for free for individual users, I can't imagine it being as painless to use as Mercurial is.)

I spent a pretty amazing time this weekend hammering out some things on the game.  First, I had fixed some pernicious bugs that were plaguing my graphics system.  I can now appropriately texture things (with different! gasp textures).  The issue seemed wholly unrelated, and I think is another problem with the OpenGL implementation (which is a software renderer, I discovered.  Although I'm not sure why that's surprising, since I'm running on an emulator anyway).  It turns out that the GLES spec specifies that the GL State should remain completely unchanged if an error occurs in a function, as if the call was never called at all (there's an exception for out of memory errors, which are allowed to totally break everything completely).  Well, turns out one of my calls was producing an error, and fixing that was a necessary, though not sufficient, part of the solution.  It turns out that two of the parameters you pass to the function to glTexImage2D (the function to configure 2D Textures) need to be the same, and I was accidentally passing in different values - I had written some code to derive the second value based on the texture as loaded from the file, but the first value was old code from where I was assuming everything was the same.  I don't really remember what else I had to do to get it fixed, but it did eventually happen.  Here's Proof:  

I started on something like that once, but it got hard to think about and so turned into a Coding style document.  I don't need a coding style document, it's just me!  (Although it probably wouldn't hurt, since I do tend to change my style slightly from day to day because I think something seems a little better or worse for the situation at hand--e.g. sometimes int Value() feels nicer to me than int GetValue().  It would definitely behoove me to stick to something logical).

So, there you have it - my goal for tomorrow is to come up with a draft of the document which will describe what I'm trying to accomplish with each module at nice medium-depth level, so that I won't have to worry too hard about making those decisions while I'm coding, which will hopefully let me just code, and not have to pull my head out and start thinking about the big picture.  I'll have a postcard of the big picture next to me so I can just do what it says :)

An interesting thing happened, which is that it got a bit harder to keep doing work as the month wore on.  This feels very much like the mid-week demotivation that also occurs in NaNoWriMo, which I thought was interesting.  Combined that with one day forgetting to bring home the power to my laptop, a growing desire to play some games, a house to myself all evening, and Mass Effect 2 already installed, and sitting with just a few hours in it yet, and I missed a day of work, and the next day it was also hard to pick myself back up again.  I think that after today, though, I probably caught up with most of what I missed.

I ran CLOC on my project and was surprised by the results:  only about 2000 lines of code, maybe another 1000 of whitespace and comments.  I would've thought it would have been much more than that, but that shows what I know.  (And a bunch of that is stuff I #included, like hundreds of lines of GL declarations).

There's been a few things that have cropped up over the last few days that I wanted to highlight.  Here goes:

So, the game!  I've got things refactored well enough and objects back on the screen and doing their happy dance.  I've spawned some threads and have input and a gameloop (well, almost--input isn't really there yet) going.  I made a video, but really it's pretty dull.

I've got Mercurial up and running on my website and have been committing code to my local repository and pushing it up there today; so that's cool.  I keep forgetting, though, and I'm treating it more like SVN where I want to commit as infrequently as possible.  My goal here is to basically commit whenever I've got something decent and compiling.

I should maybe look at getting some type of debugger up and running, though, because printf() debugging is getting a little old.

Also, I just need to figure out a whole bunch of boring underlying stuff that isn't done yet.  I need to decide how I'm loading things from [ROM, the FileSystem, whatever], as well as what I'm going to do about memory allocation.  I've been avoiding templates, too, because someone who's opinion I trust was vehemently opposed to them for the bloat in the size of the code they produced.  When you've only got so much memory, having your executable take up too much of it can be a problem.  Also, larger code tends to be slower, since you'll have to suffer through more cache fetches (pulling the instructions from RAM into the processor's working storage (i.e. cache) so that they can be executed) to get the same amount of work done as smaller code.

I need to write up a bunch of these utility functions and proper test suites for them.  I've been avoiding that, but I was bit by a bug today where a float was being cast to an integer for some reason and so nothing was happening (the value was <1, so it became 0, and then when it got multiplied into the rest of the equation a whole lot of nothing happened).

Also, just now, I seem to have discovered a Texturing bug.  I'm not sure if it's my fault or just another bug with glDrawTex_OES() on the emulator, but calls to glBindTexture() don't seem to change the texture that it's going to be drawing with.  I don't get it.

I'll talk to you all tomorrow, and let you know what my goals were for the day, and what got accomplished.  For real!

But that's okay, because I found this:  http://tinyurl.com/chrome-stayfocusd--a quite configurable extension for Chrome that helps you stay on task by limiting the amount of time you can spend daily on a list of blocked websites.  I found it looking for a way to block google reader for free, without having to block all of google.com along with it (the HOSTS trick failed when I discovered google.com/reader in addition to reader.google.com.  Alas.)

Anyway.  This thing looks super-amazing!  I'm so psyched.  I struggle pretty hard with procrastination, and I can use this to take out my largest outlets (particular websites) where I tend to waste my time.  I mostly only use chrome now, so while it's still possible for me to fire up FireFox or IE to go waste time, I can't really see myself doing that.  Both of those browsers feel so slow and bloated now that I've continued to drink Google's Kool-Aid.

Also, Summer is apparently over.  I hope you all enjoyed it as much as I did.  Most of today was spent in the 50's, with a 6pm high of 68 degrees.  When I got home the windows were open and before it even got dark I had to put on a sweater.  A SWEATER.

Here are some depressing graphs, courtesy wolframalpha:

Note the precipitous decline to the pre-summer period of Jun 14 - Jul 4.  This is even worse:

Note that today apparently isn't on that chart, or else it would be back down there with the rest of the temperatures between September and June, excluding the week or so in December it dropped below freezing.

Oh, so, I didn't really mention this, but I'm not going to stay up (too) late killing myself working on the project.  Instead, I'm going to work out a little in the morning!  The ! is because I'm scared.  I've never really had to or tried very hard to take care of a body before.  I wonder what it will be like.  I also bought some multi-vitamins, that's how you can tell I mean business.  Workout courtesy myfitstream.com, which actually looks a lot different back when I was beta-testing it I confused with fitstream.com (understandably, I hope you'll agree).  The site's still in beta, I suppose, but the initial pitch is this:  free accounts get a new work-out every week of some pre-recorded VODs (think youtube) of exercise routines that target the areas they want to work on, and use the equipment they have indicated they have available at home.  Premium accounts get access to that, plus they get custom-made VODs (basically, a virtual personal-trainer), and maybe something else.  I'll try it out and report back whether the exercise kills me.

[Update]:  My wife is drinking hot chocolate.

Going to the park with the family yesterday was definitely a good thing, but I don't really know what all I accomplished today.  In fact, I'm pretty sure there wasn't much at all.

Well, I know what I accomplished - I (almost completely) explored a new area and completed the quest in it with some online acquaintances in a game.  I've had some sort of thing brewing against what I'm calling Social Games--the kind of games that leverage the (in my experience, in-game) community that they build up to keep you coming back to them and playing them.  I feel that they're dangerous because you can sink a ton of time (and I mean a ton) into these things without really anything to show for it.  You have some great experiences and neat stories to tell, but they don't really transfer that well to others who don't have a similar basis for understanding it.  That is, nobody wants to hear about your raid.  I don't want to say that they're unrewarding, just that I'm not sure the rewards merit the rest.

I feel like it's unnecessarily focusing your time spent playing games (consuming game media) on one narrow aspect.  This is a terrible analogy, but it strikes me as similar to listening to only one style of music, or only watching tragedies on stage or something.  As I write this though, I'm growing to see it more in the light of a depth vs. breadth of experiences question and considering that choosing depth may be acceptable choice to some.  But I've been really turned off to it, lately.  Between Wives of WoW, and my own experiences playing on a MUD as well as the revelation I had when I quit these sort of games completely coming off of Evony/Civony, I've got a pretty bad taste in my mouth for what these games have to offer in relation to what they demand.

I don't really want to come out and say they destroy your social life, but I think it's easy to see the feedback loop wherein 1) you establish very real relationships with online friends and 2) you spend time with your online friends, preventing you from doing so with your real life friends and 3) each time you play, you're making a decision to join one group of friends over another, and the more you make it the harder it is to break.  Not a problem for everyone, of course, but I spent a ton of my time playing a trash game I wish I hadn't because I had forged friendships with some folks and enjoyed exploring and exploiting the game mechanics with them, and the general camaraderie that developed from doing that.

Now, that's just in the case where your real life friends don't also game.  I guess that could also be good, but I imagine the case where one player gets more into it than the rest and surpasses everyone else, causing them to lose interest because they can't keep up is a common one.

Anyway, I've gotten back into my MUD a bit because I'm getting really excited for Guild Wars 2.  They seem to be addressing a lot of the problems I have with MMOs.  The two biggest things I want to highlight are these:

[Disclaimer: I have friends who work at ArenaNet, the developers of Guild Wars and Guild Wars 2.  I have received discounts on their products in the past. I'm not getting anything out of writing this, though.  I hate that the FCC have decided I need to write this.]

Oh, right, the game!

Well, I got it compiling again and things organized much nicer.  Not much more progress than that, though I have discovered that the GL_VERSION strings aren't consistent across GLES version! Can you believe that?  Total madness!  So, like, there might be some future version of OpenGLES that my game just totally barfs on because they have decided to change the string around again.  Insanity!

cf the 1.x version and the 2.0 version!  1.x looks like "OpenGL ES-CX M.m" and the 2.x looks like "OpenGL ES M <V>".

X is one of M or L, to indicate Common or Light

M is the major release number

m is the minor release number

<V> is vendor-specific-information, whatever that means.

Now that I know that, I can figure out the version pretty easily, but of course there's no reliable pattern for knowing what future versions will look like (let's hope they stick with the 2.0 pattern, but I don't know what to expect).

So now I'm going to commit to just sitting down at 11 and pounding one out.  Shouldn't be too hard to do.

I tempted fate yesterday at lunch by mentioning to my coworkers how there had been 3 clear days in a row, with bright blue skies and a nice view of Mt. Rainer.  By the time I left work for the day, the entire thing was back to the usual overcast.  Although it was a nice sort of orange-ish pink, as if the sun were shining through somewhere.

Today, though, I felt properly chastised and nature relented and let it be bright out again.  We went to the beach (I use the term loosely) where my daughter did not like the waves, did like the ducks, and sat still playing with rocks long enough for me to build a sand castle (again, loosely) around her.

As far as programming goes, I spent a few hours last evening and some time today on it.  It certainly feels less productive when I'm not necessarily producing more builds or adding features or anything.  Mostly, I've been re-arranging and rewriting the code I do have.  I had been being really lazy and dumping most everything I needed to get it to work all into one file, which was getting pretty monstrous and disgusting.  It was also getting hard to add new code without proper function definitions/header files.  I'm refactoring quite a lot, with the focus on separating different functions into different files appropriately and separating out the interfacing-with-SDK-specific things from the core engine to ease the whole cross-development thing I've got going.  I'm still struggling with how I want to declare things, and what's going in which header files and all that.  I've got to just go with a 'what-works' approach for now, and worry about making it nicer later.  I don't want to spend too much time on stuff that isn't really going to be important.

I promised Programming Potpourri yesterday but didn't deliver.  I apologize.

Also, had friends over and I played Carcassone tonight.  Hadn't played before, but I won, barely.  I had one point more than the next guy, although I did get to take one more move then everyone else (netting me like 5 or 6 points), and also after we were done there were claims of finding a few extra tiles my daughter had hidden under the table.  Oh well!

Got started with the game pretty late, but I accomplished a few things:  Got my Mercurial Repo set up at my website, managed to determine that GoDaddy won't let me install a certificate I didn't buy from them on their cheapo-hosting-plan, and fixed a pernicious bug I had introduced into my code (turns out things don't get constructed if you declare them as static or just malloc them and cast the pointer! Whoops.  -- Also, I can't believe it's been so long since I've used objects correctly that I've forgotten about this.  I guess I am much more of a C programmer now than C++... weird).  How could I have forgotten the new.

Also - holy crap I have an optometrist appointment early tomorrow.  Yay new glasses, eep still being up this late.

Looking forward to the potpourri tomorrow.  I hope I haven't forgotten too much of it - I should really write this down next week.

got the input thing nice and pretty, and starting to work on like a real, final, weapons-grade compilable OpenGL renderer!  So far, I uh, check the Version String.  And handle all errors!  Oh yeah *flex*.

Maybe I'll get some video up tomorrow AM, but I wouldn't count on it (note the current time is two AM).

In doing so I now see the folly of selecting July as the month to get things done!  Seattle's only few days of warm and tempting weather will mostly be this month; and it's light outside until 9:30 or so, so I don't always realize "oh wow I should get to work so I can get to bed at a reasonable time" until it's a bit too late.

By the way, if you want to help with that, speak up; I'll appreciate the help.  I... well, honestly, for all the time I spent on this today I didn't do that much more than that.  Getting OpenGL into the correct state to display textures was a bit of a hassle.  It all makes sense in retrospect, but if you've forgotten to call one little function (like say, specify which matrix you're modifying) here or there, it's a giant pain in the butt to remember every step you need to take (why would I need to enable 2D Textures?  I'm already telling you to use them).

Also, apparently, be it a feature of OpenGLES, or just the small number of stable libraries for the Android NDK, glu (An openGL utility library) was unavailable to me.  So I had to implement my own version of gluPerspective.  No biggie.  Oh, gluPerspective uses glFrustum and I don't have that either?  Guess I'll have to implement that, too...  Big matrix refresher.

I'm keeping a big list of things for Programmer Potpourri on Friday, so make sure you stay tuned.  To entice you, here's an item that didn't make the cut:  I made a couple of sourdough loaves yesterday, and they are delicious.  I will miss them when they're gone.  I really ought to stop messing willy-nilly with the recipe though, because substituting too much Whole Wheat flour tends to leave it a little dense / uncooked in the middle sometimes.  Oh well.

After uploading my video to YouTube yesterday, I noticed that the first two related items were in fact very related!  I had watched the first of these previously, and found that I agreed with a lot of what the guy said and found the rest to sound like useful tips, so it's good to see an updated talk.

So I watched through the second one of those and was feeling pretty good about myself.  Then I got to work.

What seemed pretty simple turned out to be waaay more complicated than I thought it 

needed to be.  I eventually found the documentation and the buried newsgroup post that explained the hoops I needed to jump through to find things in Java and then open them up in C.  I think I'm getting a handle on this JNI thing, but I sure wish there was a bit more documentation sometimes (ironic, considering how much I was praising it earlier).  For example:  that there is a function to convert Java strings to C strings, and how to actually invoke it: neither of those was very obvious.

I got over my separation anxiety from Visual Studio and have been enjoying sublime pretty well.  Still haven't figured out the hotkeys, and Suresh tells me there's one to switch between headers and source code.  Gotta make that the first one to find.

So the game!  Boy, was debugging that frustrating.  I eventually got it all to compile (although I had to turn off DISABLE_IMPORTGL (which makes sense... but then it is defined in the demo code I was referencing) and rewrite the import functions in my own code and just return dummy values (no idea why they wouldn't link across files.  Some sort of deadstripping gone crazy?)  And then after that it took me a few hours to figure out the Dynamic function loading was failing, and that specifically I had the following problems:

Ignore the trails on the mouse cursor there; that's just an artifact of the encoding process.

Speaking of debugging being a nightmare:  I have no idea how to use GDB.  I've been having some difficulty getting it to connect to the process at all, and once I get in:  what then?  I can't imagine debugging through a command line; it sounds extremely painful.