You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
72 lines
2.9 KiB
Markdown
72 lines
2.9 KiB
Markdown
# geopy
|
|
|
|
Python tools for manipulating .geo files, and Blender add-on for exporting .geo files.
|
|
|
|
# Blender Add-On
|
|
|
|
The Blender add-on allows you to export .geo files.
|
|
|
|
## Installing the Add-On
|
|
|
|
1. Download geopy-v0.1.zip
|
|
2. In Blender open "User Preferences" then select the "Add-ons" tab.
|
|
3. Click the "Install Add-on from File..." button and select the downloaded zip.
|
|
4. Enable the add-on and click the "Save User Preferences" button.
|
|
|
|
## Using the Add-On
|
|
|
|
1. Select the meshes to export in object mode.
|
|
2. From the menu select File->Export->"City of Heroes (Feet) (.geo)" (or "City of Heroes (Meters) (.geo)" if your meshes have been scaled in meters).
|
|
3. Browse to the file you want to create and click "Export GEO".
|
|
|
|
# Tools
|
|
|
|
These command line tools allow inspection and modification of .geo files.
|
|
|
|
## 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 <old> <new> | Rename a model from <old> to <new>.
|
|
rename_texture <old> <new> | Rename a texture from <old> to <new>.
|
|
rescale_all <scale> | Rescale all vertices in all models by multiplying them all by <scale> .
|
|
set_model_scale <model> <x> <y> <z> | Set the scale properties of the given model (not the same as rescaling).
|
|
Multiple operations can be specified and performed in the same run.
|
|
|
|
Unless noted otherwise, model names and regular expressions are case sensitive.
|
|
|
|
## geo_list.py
|
|
|
|
A command line tool for list the model name inside of 1 or more .geo files.
|
|
|
|
geo_list.py <file.geo> [<file.geo> ...]
|
|
|
|
The output format is:
|
|
<geo_name> : <model_name>
|
|
|
|
## 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.
|