================================================================================
GS TOOLS modified by eis_os
================================================================================

This tool package allows exporting / importing models 
for the Game Cities in Motion by Colossal Order.

New version can be found at:
http://www.bytetransfer.de/projects/cim/tools/


--------------------------------------------------------------------------------
Special notes for Blender Users
--------------------------------------------------------------------------------
Please use a very recent Version of Blender > 2.59.
Any older version may create broken material or meshes,
and imports are garbage!

While gsobj_import will remove the Mesh_ prefix, 
it won't change the postfix of material names,
you need to manually replace the name in the obj and mtl file
or use a patched blender obj exporter


Export OBJ Settings in Blender 2.6
-----------------------------------------
x = check, * see text

[*] Selection Only
[ ] Animation
[x] Apply Modifers
[ ] Apply Modifers
[x] Include Normals
[x] Include UVs
[x] Write Materials
[*] (Only with patch) Basic Materialnames 
[x] Triangulate Faces
[ ] Write Nurbs
[ ] Polygroups
[*] Objects as OBJ Objects
[ ] Objects as OBJ Groups
[ ] Material Groups
[ ] Keep Vertex Order

Selection Only: 
	If you only want to export a subset or only one mesh.
Objects as OBJ Objects: 
	Should be use only if you have one object, 
	this will allow to use the name as in Blender.

	Since 13.11.2011 it's possible to merge objects,
	please disable this option, 
	the object name is derived by filename!
	
	Notice:
	This will only work reliable if all objects share the same material 
	or the material won't be reused by a later object.

Basic Materialnames:
	If have a patched io_blender_obj script,
	you can activate this option to get sane material names

--------------------------------------------------------------------------------
Materials
--------------------------------------------------------------------------------
gsobj_import has limited multi material support.
This means a file with serveral materials won't create an error,
however a mesh needs to be sorted by material (Blender does this)
so a material won't be used twice!

	.MATERIAL -> .MTL
	DIFFUSEMAP -> map_kd
	SPECULARMAP -> map_ks
	NORMALMAP -> map_bump


--------------------------------------------------------------------------------
Paths
--------------------------------------------------------------------------------
The internal paths for CIM objects can be exported to a obj file and text file.

gsobj_export creates two files:
	.paths     => Editable by Texteditor and can be imported to CIM
	_paths.obj => Can be loaded in 3D Software, no way to import!
	              (For Blender: Use wireframe view, no texture attached)

So if you want to make any changes, only modify the ".paths" file and then check
your work by converting file ".paths" to "_paths.obj" via gs_path2obj.exe

If you add or remove any entries,
be sure to check the relevant script file for your object!

If you don't want to use the internal quat rotation CIM uses,
uncomment the rotation line, and use a degree rotation instead.



