Tharify: Vorticons ←→ Galaxy level converter

Here is where to post about the latest Commander Keen fangame or modification you've finished, a new website you've made, or another Keen-related creation.
Post Reply
User avatar
Tool Smith
Posts: 1314
Joined: Fri Dec 12, 2008 1:21
Location: Abiathar C&C

Tharify: Vorticons ←→ Galaxy level converter

Post by Fleexy » Sat Mar 14, 2015 21:19

Alright, this is the third and final thing that I'm going to release this Keen Day.

Tharify is the first step in expanding Abiathar's compatibility beyond the Keen Galaxy map format. It's fairly simple: you can convert from the Vorticons level style to Galaxy (tharification), and when you're done editing with Abiathar you can convert back to Vorticons (detharification). This also works on, among other things, Hovertank 3D.

Links (the bridge/switch offsets) are automatically converted between the Vorticons relative yyxx and the Galaxy absolute xxyy.

When converting to Galaxy, Tharify creates a foreground tileset bitmap corresponding to the Vorticons tiles and an infoplane tileset bitmap containing sprite icons. The background tileset contains two tiles: the first Vorticons tile (because the first foreground tile is always rendered completely transparent) and a "not a link" text tile, the presence of which suppresses the infoplane value link adjustment when converting back to Vorticons. Graphics will not be converted back to Vorticons EGA.

To tharify, run Tharify with the first parameter set to "/thar". You must specify the level extension with "/ext" and the name of the Abiathar ADEPS file with "/adeps". If you renamed any of your Vorticons EGA resources, use "/ega <head> <latch> <sprit>" after specifying /ext. If you don't have Vorticons EGA graphics, use "/levelsonly" (which takes no extra parameters) to skip creation of the ADEPS and the graphics. (You'll need to create your own ADEPS if you use that.)

Supplying the "/saveconf" option plus a filename writes the setup to a file for easy detharifying later: use the "/conf" option to load options from a file rather than the command line.

  • Convert all Keen 2 levels to a Galaxy set bound to an Abiathar file called k2.adeps: tharify.exe /thar /ext ck2 /adeps k2.adeps
  • Convert all Keen 3 levels supplying the names of renamed EGA resources and saving configuration for ease of detharification later: tharify.exe /thar /ext ck3 /ega GFXHEAD.CK3 GFXTILES.CK3 SPRITES.CK3 /adeps k3.adeps /saveconf k3.thfy
  • Convert Hovertank 3D levels, but don't do a graphics conversion (Hovertank has sort-of-Galaxy-style graphics): tharify.exe /thar /ext hov /levelsonly
To detharify back into Vorticons-style levels, start with the "/vort" option. Specify the ADEPS file with "/adeps" and the extension with "/ext". Or, you could instead simply use "/conf" and supply the configuration file you created with "/saveconf" earlier. However, if you used /saveconf and /levelsonly in tharification, you'll need to also specify /adeps.

  • Convert Keen 1 levels back to Vorticons: tharify.exe /vort /adeps k1.adeps /ext ck1
  • Convert back to Vorticons using a saved configuration file: tharify.exe /vort /conf thfy.txt
  • Convert Hovertank levels back to individual HOV files: tharify.exe /vort /adeps hov3d.adeps /ext HOV /levelsonly
(You'll need to supply your own image files for Hovertank - it seems to only use "pictures", which Abiathar cannot process as tiles.)

Tharify must be placed in a directory containing Abiathar and its DLLs.


Download Tharify

This is a temporary solution until native support for the Vorticons format is added to Abiathar, though it is fun to play with. (It's kind of like how I released FxTomDMh and ManTliMh separately until they were supplanted by actual Abiathar/FleexCore2 support.)

Happy Keen Day, everyone!

Last edited by Fleexy on Tue Mar 07, 2017 20:38, edited 1 time in total.
Reason: fix encoding and link

Post Reply