##### BEGIN GPL LICENSE BLOCK #####

  This program is free software; you can redistribute it and/or
  modify it under the terms of the GNU General Public License
  as published by the Free Software Foundation; either version 2
  of the License, or (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software Foundation,
  Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

 ##### END GPL LICENSE BLOCK #####

 ##### GENERAL INFORMATION #####
 
  This add-on allows importing/exporting v3o files in blender, including a multitude of export 
  options (see below). This add-on is based on the offical obj-Import/Export add-on for Blender by 
  Campbell Barton and Bastien Montagne and the V3O Import/Export script for Blender 2.7 by 
  Robert Smilie, published on the emergency-planet forum. Both those files have been 
  published under the GNU General Public License version 2, hence this add-on is 
  published under the same license.
 
 ##### END OF GENERAL INFORMATION #####

 ##### INSTALLATION #####
 
  Save the 'io_scene_v3o.zip' to a location of your choice. In blender select 
 
	Edit -> Preferences..
	
  Select the 'Add-ons' tab, then click on 'Install from Disk...'
  Navigate to the location of your file and select 'io_scene_v3o.zip'. The 
  add-on-browser should then display the add-on. Click on the checkbox to activate it.
 
  The export is now available under 
	
	File -> Export -> Emergency4 (.v3o)
 
 ##### END OF INSTALLATION #####
 
 ##### EXPORT OPTIONS #####
 
 'Selection Only'	:	Only the selected objects will be included in the export
 
 'By Name'			:	This option can be used to export multiple objects at once. 
						Every group of blender objects that is intended to be included 
						into one v3o file, should be grouped into one collection.
						The collection should be named in the following fashion:
						
							[prefix]_[sufix]
							
						[suffix] is the file name extension to be used for this v3o file.
						[prefix] indicates the type of this object. The following prefixes 
						can be used:
						
						EX 		For an object without animation.
						EXA		For an animated object, the animation name will be 'open'.
						EXR		For an animated object, the animation will be reversed 
								and named 'close'. 
						EXL		For an animated object, with forward and reverse animation.
								The animations will be named 'open' and 'close' respectively.
						EXC		For an object, whoose origin should be moved to the center of the v3o file
								
						Example: Consider the following Blender scene order, [C] stands for 
						collection, [O] for object:
						
						[C] EX
							[O] Front
							[O] Back
						[C] EXL_door01
							[O] DoorFrontLeft
						[C] EXL_door02
							[O] DoorFrontRight
							
						If this scene is exported 'By Name' to 'truck.v3o', the following files 
						will be created:
						
						- truck.v3o containing the objects 'Front' and 'Back' without animations
						- truck_door01.v3o containing the object 'DoorFontLeft' with two animations
						- truck_door02.v3o containing the object 'DoorFrontRight' with two animations
						
 'Center Objects'	:	This will move the objects to the center of the v3o file. Only usefull if 
						single objects are exported or all objects share their origin.
 
 'Apply Modifiers'	:	This will apply all modifiers before exporting.
 
 'Scale'			:	Scale the object. Scaling between 4000-6000 is typical for use in Emergency4
 
 'Path Mode'		:	This determines the way the reference to the texture is treated in the v3o file. 
						The options are as follows:
						
						Auto		Uses relative paths for files which are in a subdirectory of the 
									exported location, absolute for any directories outside that.
						Absolute	Uses full paths.
						Relative	Uses relative paths in every case.
						Match		Uses relative / absolute paths based on the paths used in Blender.
						Strip Path	Only write the filename and omit the path component.
						Copy		Copy the file on exporting and reference it with a relative path.
						
 'Forward'			:	Determines the world forward direction.
 
 'Up'				:	Determines the world up direction.
 
 'Frame Time'		:	Determines the time that is used per animation frame.
 
 'Frame Step'		:	Additional time per frame, negative entries are allowed.
 
 'Forward Animation Name'	:	Name of the forward animation
 
 'Reverse Animation Name'	:	Name of the reverse animation						
						
 'Add End States'	:	This will add the end state of animations as seperate animations, named opened 
						and closed respectively
 
 'Forward Animation':	Determines whether a forward animation should be included. This takes no effect
						if 'By Name' is selected.
						
 'Reverse Animation':	Determines whether a reverse animation should be included. This takes no effect
						if 'By Name' is selected.
 
 'Animation Normals':	If normals are distorted in an animated object, this might resolve the problem.
						Warning: This option drasticly increases the number of vertices and is gereally
						not necessary.
 
 ##### END OF EXPORT OPTIONS #####
 
 ##### IMPORT OPTIONS #####
 
 'Scale by 1/'		:	Determines the inverse scaling of the object. This should be the same number as
						scaling on import

 'Use Existing Materials':	If this is checked, the importer will try to use existing blender materials.
						If unchecked, a new material will always be created.

 'Import Smoothing'	:	Whether Smooth faces should be imported. This is experimental. If results are not
						as expected, please report to the author.
 
 'Forward'			:	Determines the world forward direction.
 
 'Up'				:	Determines the world up direction.
 
 'Apply Scaling'	:	Whether to apply scaling in blender.
 
 'Merge Vertices'	:	Single vertices from v3o files in the same location will be merged

 ##### END OF IMPORT OPTIONS #####