From 4f69ebdf1db88d38d8e68d6ac9a2d7b78cae48e8 Mon Sep 17 00:00:00 2001 From: TigerKat Date: Sat, 3 Apr 2021 00:39:23 +0930 Subject: [PATCH] Updated README to reflect new features in the Blender add-on. --- README.md | 34 ++++++++++++++++++++++++++++------ 1 file changed, 28 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 3ee8fc4..733a66b 100644 --- a/README.md +++ b/README.md @@ -1,27 +1,49 @@ # 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 -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 -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. 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 +###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). 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__", where 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