No Magic Numbers

Action Solitaire 1.31 is now available for download.

After the last posting, we discovered a rather significant bug in Action Solitaire. It was fortunate that it was discovered in house, but unfortunate that it was not found during beta testing and, hence, required a public update. The problem caused two of the 65 games to behave incorrectly (or even crash) when large or huge card sizes were selected, either explicitly or implicitly through automatic sizing.

The problem turned out to be magic numbers in the code. We released the first version of Action Solitaire back in 2003, which was six years of coding experience ago and at a time when I felt under some (self-imposed) pressure to get the product finished. Unlike some of the other projects, the source code for this game has not been refactored, except to the extent necessary to make updates for Vista and add new games, so I never revisited these (working) games to see the problem.

For those who do not know, a magic number is an explicit and undocumented constant in the source code for a program, so named because the value works like magic, without any proper explanation. In this particular case, the width and height of an image buffer were set to constant values, calculated (manually) to accommodate an area based on the largest card sizes supported by the game at that time. Rather than actually letting the computer determine the necessary buffer size, based on named constant values (e.g., MaxCardWidth and MaxCardHeight), the code just used constant numbers directly. When the maximum card size increased, the buffer was too small and problems ensued. Such are the dangers of magic numbers.

It did not take long to find and fix the problem, but it should not have been necessary in the first place, especially since we had standards, even back then, that discouraged the use of magic numbers. I made an exception and got burned. Ouch.

Anyway, Action Solitaire can be downloaded here, and I guarantee ample opportunity to find other bugs in this product, but the game is fun (and addictive) as well.

Action Solitaire 1.30

Can you believe it? Another product release!

Goodsol Development has released Action Solitaire 1.30, continuing the string of product update releases in 2009. This latest version of Action Solitaire adds five more games and (belatedly) implements support for larger card sizes, including those provided in all of the newer downloadable cardsets. The new action games are:

  • Two Cells
  • Three Cells
  • Klondike Deal Three
  • Canfield Deal Three
  • Black Hole

One nice thing about these new games is that it creates 5 more opportunities for players to climb to the top of the standings (or ten, if one counts both tables for each game).

As this product was in beta testing, I noticed that, oddly, all of our Action Solitaire releases have been in odd years, starting in 2003:

  • Version 1.0 – December 9, 2003
  • Version 1.1 – April 18, 2005
  • Version 1.2 – May 24, 2007
  • Version 1.3 – June 16, 2009

Following this pattern, this would be the last update until the second part of July, 2011! However, a popular clambering for a Mac version would probably result in AS 2.0 well before that time.

Download and enjoy! [from here]

2009 People’s Choice Awards

Only two days left to vote!

This year, the leadership of the SIAF (Shareware Industry Awards Foundation), the group which produces the Software (nee Shareware) Industry Conference (SIC) each year, made the unfortunate decision not to present the Shareware Industry Awards this year. These premier awards were basically the Oscars of this industry, voted on by other industry members, and represented peer recognition. No SIA was presented for any standard game category last year (2008), so our own Pretty Good MahJongg was the last game to win one of these prestigious awards for the 2007 Best Non-Action Game.

In the absence of the Shareware Industry Awards, the People’s Choice Awards take center stage at the SIC banquet (presumably). With no nomination process, and voting open to anybody with an email address, there is no particular anticipation for these awards (and with no game PCA presented since 2006, even less for us). Nevertheless, I will support the awards process, so I submitted my ballot today.

The deadline is looming [Monday, June 15th], but if anybody has not yet voted and still has time to do so, we would certainly appreciate consideration of some of our products:

Although I certain could have done so, I did not fill all seven lines on my ballot with our games. I did an evaluation of the products that I use on a regular basis and which greatly aid my (development) productivity, and these products really stood out:

  • Beyond Compare is an absolutely indispensable part of my development toolkit, and I use it almost daily for code diffs, file syncing, single line editing, and even viewing of Japanese/Unicode resource files (which VC6 cannot handle).
  • Inno Setup is the easy choice for creating professional installers, and though it is not shareware, it is downloadable (free/donationware).
  • Help & Manual is simply the best help editor I have ever used (though I will admit to preferring version 4 without the ribbon interface).
  • PC-lint is critical to my C++ programming work and it is run, literally, alongside my compilations to guard against both silly mistakes and serious errors in order to help keep the quality of my code as high as possible (although there is no downloadable trial version, unfortunately).


To vote for the 2009 People’s Choice Awards, simply register to vote [Editor’s note: invalid link has been removed] (with just name and email address) and then follow the link that will be emailed to you and enter up to 7 software products. Easy.

Most Popular Solitaire 2.00

An update to yet another successful card solitaire game is released.

One week ago, Most Popular Solitaire 2.00 was published by Goodsol Development. This is a major upgrade to a product first released (for Windows) in 2003. Most Popular Solitaire is a collection of 30 of the most popular (surprise!) card solitaire games, including all of the favorites: Klondike (often known as simply Solitaire), FreeCell, Spider, and a number of (well, 27, obviously) others.

In terms of features, either the most important or least important, depending on ones system, is that Most Popular Solitaire 2.00 has equivalent versions for both Windows and Mac OS X available. This new version also includes Climb Mode and 13 bonus games in the full (purchased) version, as well as a number of other smaller features. (Of course, everything is a new feature on this initial Mac release, but it is an improvement on Pretty Good Solitaire Mac Edition 1.0, which included the same 30 games.)

In terms of technology, this release used the same revisions of our Goodsol Solitaire Engine that were used for Goodsol Solitaire 101 version 1.01 (on Windows) and Pretty Good Solitaire Mac Edition 2.01 (on Mac OS X). These are the last planned updates before the next GSE upgrade, which will add a few additional features and make some internal changes to reduce the source code differences between platforms.

The marketing challenge for this product is handling both the Windows and Mac OS X versions simultaneously. Having the same price (and registration codes) for both makes it easier, and also allows customers to switch to Mac (you know, or the other way) without having to repurchase. The biggest issue is the different approach to trial versions: whereas the Windows version can be converted into the full version by entry of the registration code, the Mac OS X version has a separate full version download.

In the three weeks since the latest Pretty Good Solitaire Mac Edition update, that product has risen (back) into the top 5 on Most Popular in the Cards & Puzzles category for Apple Downloads, but Most Popular Solitaire (Mac Edition) is now in the top 20 (and climbing) in only a week. Downloads of both products (trial versions) are increasing, but we will have to see how that translates into sales.

In any event, somebody is enjoying our games, and I dig that.

Pretty Good Solitaire Mac Edition 2.01

A update to our best-selling card solitaire game for the Mac is available.

Goodsol Development published Pretty Good Solitaire Mac Edition 2.01, a maintenance update to PGSME 2.0 announced here.

This version of Pretty Good Solitaire Mac Edition fixes about a dozen (i.e., all) bugs reported since the initial release, and also makes a few changes designed to improve ease of use and, thereby, reduce the number of customer support inquiries. In particular, many users did not understand the Climb Mode feature at all, much to my personal dismay, so it is no longer the default.

The most important bug fix in this version, and the one that took the longest time to find and track down, was an interface race condition which could allow code to be unexpectedly reentered, sometimes causing a crash or, more often, just creating illegal positions. The nature of the bug meant that some (most?) players would never experience a problem, but a few managed to trigger the error on a regular basis. Imagine clicking to redeal a waste pile back to the stock and then attempting to redeal from the stock during this process. Unfortunately, “Patience is a Virtue” was not an adequate response.

After the initial release, Pretty Good Solitaire Mac Edition 2.0 was a hit in the Top Apple Downloads, rising to #2 Most Popular in the Cards & Puzzles category (and still in the top 20 as I write this). It also flirted with the Top 5 overall in the general Games category, peaking at around #6. This is only the tip of the iceberg, though, as the upcoming PGSME version 2.1 will have 200 games, up from 101 in the current version.

Onward and upward…

Goodsol Solitaire 101 version 1.01

A maintenance update to our latest Windows solitaire game is released.

Goodsol Development has now published Goodsol Solitaire 101 version 1.01, an update to the initial version of GS101, which was released last November [2009]. (Internally, I refer to the product as GSCI to avoid confusing naming such as GS101101.) This version fixes a number of bugs that were discovered since the original release.

What makes this release interesting is that it shares its game data file with our Mac product, Pretty Good Solitaire Mac Edition 2.0, and both games are based on common source code, so several of the bugs that were fixed were originally discovered during beta testing for PGSME 2.0, and then confirmed and resolved on GS101. Of the various arguments I have heard for cross-platform development, additional testing of the fundamental program logic (on each system) was not mentioned, so this was a welcome surprise. It should only benefit the quality of both products.

For more information on the game, please visit the Goodsol Solitaire 101 web site, or just download the program and give it a try. This update is free to all customers who have already purchased GS101.

Pretty Good Solitaire Mac Edition 2.0

The next version of our card solitaire game for Mac OS X is now available.

Pretty Good Solitaire Mac Edition 2.0 has been published by Goodsol Development. This solitaire program includes 101 games (up from 30 in version 1.01), plus 34 bonus variants in the full (purchased) version. It also adds some features, including the introduction of Climb Mode. For more information on the basic features, see the screenshot tour.

This version of Pretty Good Solitaire Mac Edition is a major technological upgrade from the previous versions, now being based on our Goodsol Solitaire Engine, which is a cross-platform, data-driven game engine that has been the focus of our development over the last year or more. Although more improvements are still planned, the basic functionality of this engine has already been proven, and it will allow us to produce upgrades and expansions more quickly and easily.

Climb Mode is a feature where deals for a particular game are played in numerical order, with a fixed set of rules, for a cumulative game score. This feature was implemented originally as a solution to online statistics manipulation, but it has evolved into a good competition, especially in the card solitaire games. With the addition of Climb Mode and the supported 101 games, PGSME 2.0 is the Mac OS X equivalent of Goodsol Solitaire 101 on Windows, and they share online high score tables.

Because of the (overly?) generous upgrade policy, Pretty Good Solitaire Mac Edition 2.0 is free to all customers who purchased PGSME 1.0. If you have not purchased yet (why not?), it is available for $24.95 (plus $7.50 if you want it on CD) here.

One down, two to go! (See the second item in our company goals for 2009.)