# geopy

Python tools for manipulating .geo files, and Blender addon for exporting .geo files.

#Blender Addon

TODO: Write Blender addon installation and use instructions.

#Tools

## geo.py
Contains the Geo class, which represents the contents of .geo files. Can be run to test the reading and writing functionality.

geo.py <infile.geo> [<outfile.geo>]

If only an input .geo file is specified, it will read the input and dump the contents of the .geo to the console.

If an output .geo file is specified, it will read the input .geo file, and write the contents to the output as a new .geo file.

## stl_dump.py
Dumps the meshes of a .geo file to .stl files. Used for testing and validation, as .stl isn't useful for games.

stl_dump.py <file.geo>

Dumps all the meshes contained in <file.geo> to <geo_name>/<model_name.stl>. <geo_name> and <model_name> are read from the .geo.

## geo_edit.py
A command line tool for modifying a .geo file

geo_edit.py <infile.geo> <outfile.geo> <operation> [<operation options> ...]

Operation                   | Description
--------------------------- | ---------------------------
  del_model <reg_ex>  | Deletes all models whose name contains the regular expression <reg_ex>.
  geo_name <name>     | Change the .geo's name to <name>.
  rename_model <new> <old> | Rename a model from <new> to <old>.

Multiple operations can be specified and performed in the same run.

## Known Issues
 - Not all structures are handled (reflection quads)
 - Not all structures are regenerated when writing a .geo file. (Reductions)
 - Blender import of .geo files is currently a stub.