FFT Map Viewer

Background

A few years ago, a user named Gomtuu over at FF Hacktics created a Python/OpenGL mapviewer and released the source. I took the source and modified it further to tag enemy starting positions, party starting positions, move-find item/trap positions, and Deep Dungeon exit panels win various colors. I believe there has not been a new version of that code since I first did my hack, though as of March 2012 I have not actually verified this. -If there's a newer version, we should be able to port my hacks fairly easily, as I can diff my mods versus those of the original version I manipulated.- There is no newer version than the one I'm working from, but I will try to maintain a diff anyway.

Installation

Because I needed to work from source, the files are available as uncompiled PY. They can't be run by users who don't have Python installed. Python is open-source and easy to install, though it's a little confusing to get all the pieces in place. To run this program, you need all of the following in compatible versions (at the time of this writing, I did them all for Python 2.7).

1. Python
2. Python Setuptools
3. Setuptools will include easy_install, which can be used to install the following packages:
   1. PIL
   2. PYOpenGL
   3. NumPY
4. wxPython

Google is your best bet for help with installing these - Python and Setuptools have nice easy executables, and you can use easy_install from the CLI to automatically grab matching packages for PIL, PYOpenGL, and NumPY. wxPython also has a nice executable. One catch is that Setuptools is not easy to configure for Win x64, so you might need to stick with the 32-bit version. PIL also didn't install properly for me in 2017 using easy_install (a part of Setuptools), so I ended up having to run an executable installer for that as well.

Climhazzard has a copy of the Python scripts that run the modified version. In the future, perhaps Clim's FTP will be organized again so we can link to the files here - for the time being, see me (Josh) to get the files.

Loading Maps

After installing all of these things, you should be able to run map2gl.py from the scripts. You will need a copy of the FFT PSX CD, preferably ripped to a hard drive for speed. map2gl will present to you a dialog to open a GNS file, which will be in the MAP folder of the PSX disc. The best list of map ID numbers to map locations is on FFH, as we don't need it on CoN (we have it in the DB, but don't show it to users per se, so it's just easier to get it from FFH): http://ffhacktics.com/maps.php

Using the Viewer

Taken directly from Gomtuu's readme, so it might not make total sense.

Camera Controls

• k: Decrease camera's altitude angle by 2 degrees
• i: Increase camera's altitude angle by 2 degrees
• K: Decrease camera's altitude angle to nearest snap (snap points at 0, 30, 45, 60, and 90 degress)
• I: Increase camera's altitude angle to nearest snap (snap points at 0, 30, 45, 60, and 90 degress)
• j: Stop camera's rotation, then decrease camera's azimuth angle by 2 degrees
• l: Stop camera's rotation, then increase camera's azimuth angle by 2 degrees
• J: Stop camera's rotation, then decrease camera's azimuth angle to nearest snap (snap points at multiples of 45 degrees)
• L: Stop camera's rotation, then increase camera's azimuth angle to nearest snap (snap points at multiple of 45 degrees)
• ,: Decrease the speed of the camera's rotation around the Y axis
• .: Increase the speed of the camera's rotation around the Y axis
• 0: (zero): Stop camera rotation, then set camera's altitude angle to 0 and azimuth angle to 0.
• -: Dolly the camera farther away from the map
• =: Dolly the camera closer to the map
• z: Set zoom level to 100% of in-game zoom level
• o: Toggle between orthographic (isometric) and perspective projection
• _: Decrease the camera's focal length (in perspective projection only)
• +: Increase the camera's focal length (in perspective projection only)

You can also click the mouse and drag to rotate the map arbitrarily.

Other Controls

• [: Select previous map
• ]: Select next map
• {: Select previous weather condition
• }: Select next weather condition From what I've seen, all new battles in the PSP version are existing maps with different weather (aka lighting) conditions. Eternal confirms.
• s: Toggle whether the black polygons around the edges of the map (which I call "skirt" polygons) are displayed
• x: Toggle display of axes (X=red, Y=green, Z=blue)
• g: Toggle between the map's natural light and full ambient light (useful for Deep Dungeon maps)
• T: Toggle display of texture
• c: Toggle "cutaway" mode (avoids drawing certain obstructed or obstructing polygons)
• t: Toggle terrain overlay mode Note: This is what removes the treasure and party positions.
• B: Toggle between the map's natural background and magenta background Note: This doesn't seem to work in my hack. Might need to use the stock version if you need this until I figure out what happened.
• a: Toggle mesh animation