Insanely Twisted Shadow Planet is a 2D shooter with an outstanding visual style (and this is where my description ends since I am yet to try this game, even though I already bought it). In this 10mn video, Ryan Meyer explains how the camera system he wrote for the game works.
A couple of dear friends and I are (too) often having discussions by email, on topics that range from video games to politics, and mostly software development and design in general. A while back, one of those discussions started after sharing an AltDevBlogADay article on optimization. As we were confronting our experiences on optimization or lack thereof, one of them, Rubix as we call him, made some insightful points by explaining an approach he would call “incremental reshaping”.
When I found myself coming back to his mails several times, I suggested he turned them into an article. With his permission, here it is.
The most common case at my work is to stumble upon slow spaghetti & copypasta code, full of lists of hashtables of lists, all within a big class with 45 methods hitting them directly. So I start off by pulling the data out and into new classes, to encapsulate it. Then I clean up the code that uses them, by factorizing all similar operations into methods of these new classes, as well as trying to come up with good names for them (I know this part is done when the original data structure ends up being private in the class).
This way the operations eventually make sense, and I can at last understand what the code is trying to do on a higher level. Finally I can simplify the calculations and rework the (now hidden and loosely-coupled) data structures to best match the most critical uses. All of this has to be done incrementally. Do one change at a time, and then pause to look at the new code to search for the next simple refactoring. Otherwise, your changes will not be optimal.
Once everything is clean, if it’s still too slow, *then* optimize, even if it means to add complexity by removing good abstractions. Code that is complex in a particular way because that’s what is time-critical, will be both more maintainable and faster than code that gradually, without global monitoring, evolved into something complex everywhere, uniformly slow for many reasons.
Encapsulation rarely affects performance in my case. I work in environments where the cost of a function call is negligible, and functions are the most common abstraction tool.
Now, an example.
Yesterday, I saw a four parameters function I didn’t like. I first created a tiny class to contain just that function (all call sites became “new Foo().method(a1, a2, a3, a4)”), then I moved two of these arguments, that were often the same, into the class (call sites would become “new Foo(a1, a2).method(a3, a4)”). At some places in the calling code, I was then able to cache and reuse the instance of “Foo” into a local variable, because “a1” and “a2” were the same for several calls to “method”.
From there, I found that the calling code was more or less always doing the same kind of things before calling the method, so I moved that stuff to a second method of Foo (it turned out to work so well that the first method became private). Then I noticed a loop that was calling Foo’s method repeatedly, so I wrote a new method that took a list as a parameter. (I also ended up finding an appropriate name for Foo!)
Now I ‘could’ also have done it the hard way: enter the zone, stare at the code for a while, think a lot, decide that I wanted it to eventually be like this, then put my headphones and implement it directly instead of going through any of the sub-steps, which are unnecessary when you can fit all of it in your head.
But incremental reshaping has several advantages:
- No need to know in advance what to do from begin to end, ideas come as you go.
- The possibility of changing your mind more easily; you had an idea but you may find a better one later.
- You can take advantage of the compiler & IDE at each step, to always know what state your code is in, and make sure nothing was forgotten, thus avoiding bugs and going faster. At a given time, it’s always the same message from the compiler, so it’s easier to read.
- It keeps your code compiling and correct between every change. Also, for every little change, if you know your tools well you should be able to convince yourself that it breaks nothing.
- It diminishes greatly the cost (and the pain) of being interrupted while focused on your changes.
I am at the airport waiting for my plane, and since there is free WiFi (and surprisingly fast on top of that), I naturally check my Twitter feed. Well, obviously, something just happened at E3, and the conclusion seems pretty clear. Here is an excerpt:
Sony is kind of humiliating MS today..
— Marco Salvi (@marcosalvi) June 11, 2013
Did you all hear that? That was the sound of Sony winning the next gen war pre-emptively.
— Promit Roy (@promit_roy) June 11, 2013
— Michael Nicolella (@MikeNicolella) June 11, 2013
— Branimir Karadžić (@bkaradzic) June 11, 2013
— jaymin kessler (@okonomiyonda) June 11, 2013
Sony’s E3 event was nothing short of awe inspiring!
— Timothy Lottes (@TimothyLottes) June 11, 2013
xbox execs are going to have some though weeks ahead.
— Tiago ”xrl” (@xernobyl) June 11, 2013
I get the impression from Twitter that Sony’s presentation went a little better than Microsoft’s or something
— Melissa (@0xabad1dea) June 11, 2013
So, Sony pulled off better hardware, at a cheaper price, with no crazy DRM lockdown.I know what I’m buying.
— Richard Minerich (@rickasaurus) June 11, 2013
To any objective measure, Sony won. They had to, and they did.
— Angelo Pesce (@kenpex) June 11, 2013
Sharing games on PS4: youtube.com/watch?v=kWSIFh… OMG devastating. Most decisive console win in history?
— George Broussard (@georgeb3dr) June 11, 2013
Although I am not a fan of violent games, I like the effort put to make it not only look, but feel real: in particular the scene of the random guy trying to get his girlfriend to talk to him after getting shot is quite strong and disturbing.
On the rendering side, there is a lot to notice. Many materials completely nail it (look at that leather coat!), and the faces look really good, especially when back lit.