Updated README to reflect new features in the Blender add-on.

master
TigerKat 4 years ago
parent 4f8e162b91
commit 4f69ebdf1d

@ -1,27 +1,49 @@
# geopy # geopy
Python tools for manipulating .geo files, and Blender add-on for exporting .geo files. A Blender add-on and Python tools for manipulating .geo and .anim files.
# Blender Add-On # Blender Add-On
The Blender add-on allows you to export .geo files. The Blender add-on allows you to:
- export .geo files
- import .geo files
- import skeletons from skel_*.anim files
## Installing the Add-On ## Installing the Add-On
1. Download geopy-v0.2.1.zip 1. Download geopy-v0.2.5.zip
2. In Blender open "User Preferences" then select the "Add-ons" tab. 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. 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. 4. Enable the add-on and click the "Save User Preferences" button.
## Using the Add-On ## Using the Add-On
###Exporting models
1. Select the meshes to export in object mode. 1. Select 1 or more 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). 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". 3. Browse to the file you want to create and click "Export GEO".
## Notes Notes: Models are exported with the name of the mesh they come from, so having the meshes named correctly is recommended.
Models are exported with the name of the mesh they come from, so having the meshes named correctly is recommended. ### Importing models
1. From the menu select File->Import->"City of Heroes (Feet) (.geo)" (or "City of Heroes (Meters) (.geo)" if your converting to meters).
2. Browse to the file you want to import and click "Import GEO". All models in the .geo file will then be imported.
Note: A model's name is expected to be in the format of "GEO_<bone>_<name>", where <bone> is the bone the model will be anchored to.
Note: If multiple armatures exist, the armature you wish to use must be selected. Otherwise it will use the first armature it will find.
Note: Presently LOD models are excluded from imports.
### Importing skeletons
1. From the menu select File->Import->"City of Heroes (Feet) (skel_*.anim).
2. Browse to the file you want to import and click "Import".
Note: A new aramature will be created using the name found inside the file.
Note: The import will fail if the .anim file is missing a skeleton hierarchy.
# Tools # Tools

Loading…
Cancel
Save