TopoToImage reads digital elevation data, the height of the ground at every point on a grid, and turns it into a picture. You choose an area on a world map and a color gradient. The program colors each point by its height, lights the terrain from one side, and can cast soft shadows across the valleys. It works at any scale, from a single mountain range to the whole planet with the ocean floor.
Maps made with TopoToImage 4
2025 to 2026History
1997 to 2026The 1990s program
In late 1996 the U.S. Geological Survey finished GTOPO30, the first detailed elevation model of the whole earth. No Macintosh software could use it, so I started writing my own. I wanted it for my maps at Time Magazine and for freelance work, and I wanted a product to sell to other mapmakers.
The program was written in BASIC on the Mac. By 1999 it drew cast shadows with soft edges, spooled to disk so maps did not have to fit in memory, and kept a library of color gradients. Terra Data sold GTOPO30 data and TOPOtoIMAGE as a package for $750, alongside the Geocart map projection program. Cartographers bought it, and I used it for maps in Time.
Version 3 moved to Mac OS X and ran on both PowerPC and Intel Macs. It saved layered files for Photoshop and a PDF key with the elevations and colors of every map. I kept working on it until about 2009.
The 2025 recreation
Apple later dropped support for the system the old program was built on, and it stopped running on new Macs. In June 2025 I began rebuilding it with Claude Code, an AI programming assistant, working from my original source code and help pages. The new version is written in Python and keeps the look and features of the old one.
It added things the old program could not do: GeoTIFF output that GIS programs can read, data that crosses the 180th meridian, current data sets such as GMTED2010, ASTER and GEBCO, and gradients of up to 64 colors. Betas came out in October 2025. Version 4.0 was released in June 2026, with rendering made many times faster.
TopoToImage is free and open source.
From the original program
1999 to 2009Download
TopoToImage 4.0 for Macs with Apple silicon (M1 or later). Free, MIT license. The download includes sample elevation data, a user guide, and a guide to finding elevation data for anywhere in the world.
The app is not signed by Apple, so macOS blocks it the first time. The included README explains the one-line fix. On Intel Macs, Windows or Linux, run it from the Python source on GitHub.