/**
* \namespace Gfx::ModelInput
* \brief Functions related to model loading
*/
/**
* \namespace Gfx::ModelOutput
* \brief Functions related to model saving
*/
/**
* \page models Models
*
* Model formats and associated issues are described briefly for graphics designers and developers.
*
* \section format Model format
*
* \todo Update for the new model format
*
* Colobot models are basically a collection of triangles with some associated data.
* <span style="text-decoration: line-through;">In the code, the class Gfx::CModel (src/graphics/model/model.h)
* is responsible for reading/writing model files.</span> Each triangle of model contains the information
* as stored in Gfx::ModelTriangle struct defined in model_triangle.h header, that is:
* * 3 triangle points (coordinates, normals, UV texture coordinates for 2 textures)
* * material (ambient, diffuse, specular colors)
* * file names for 1st and 2nd texture (or, for 2nd texture - variable flag)
* * rendering state
* * <span style="text-decoration: line-through;">min and max values of LOD (= level of details)</span>
*
* \subsection textures Textures
*
* 1st texture is always static - the assigned image name.
*
* 2nd texture can be set explicitly in 2nd texture name, with variable flag set to false.
* It is then static as 1st texture.
*
* But if variable flag is set, the texture will be applied dynamically by the graphics engine.
* It will be one of dirtyXX.png textures, depending on current setup.
*
* \subsection renderstates Rendering states
*
* Rendering state is one of Gfx::CEngine's rendering states, that is a mask of enum Gfx::EngineRenderState values
* from src/graphics/engine/engine.h.
*
* For most purposes, the default render (Gfx::ENG_RSTATE_NORMAL = 0) state will be sufficient.
* This state enables regular one-texture rendering.
*
* To use 2nd texture, set one of Gfx::ENG_RSTATE_DUAL_BLACK or Gfx::ENG_RSTATE_DUAL_WHITE states.
* Other states, enabling specific behavior may be used in rare cases.
*
* \subsection lod Min and max LOD
*
* <span style="text-decoration: line-through;">LOD is used to display different model triangles based
* on distance to viewer. The given triangle will only be displayed if the distance is within bounds [min, max].</span>
*
* <span style="text-decoration: line-through;">For now, use standard definitions of min and max which
* fall into 3 categories:</span>
* * <span style="text-decoration: line-through;">min = 0, max = 100 - max detail</span>
* * <span style="text-decoration: line-through;">min = 100, max = 200 - medium detail</span>
* * <span style="text-decoration: line-through;">min = 200, max = 1 000 000 - low detail</span>
*
* \section fileformats File formats
*
* There are currently 3 file formats recognized by Gfx::ModelInput and Gfx::ModelOutput:
* * old binary format (in 3 versions, though mostly only the 3rd one is used) - this is the format
* of original model files; it is deprecated now and will be removed in the future
* * new text format - preferred for now, as it is easy to handle and convert to other formats as necessary
* * new binary format - contains the same information as new text format
*
* \section blenderimport Import/export in Blender
*
* The plugin to import and export models in Blender is contained in \p tools/blender-scipts.py.
* To use it, install it as per instructions [on Blender wiki](http://wiki.blender.org/index.php/Doc:2.6/Manual/Extensions/Python/Add-Ons).
* It will register new menu entries under File -> Import and File -> Export. Import is always active, but to export,
* you have to select a mesh object first.
*
* Textures are loaded from the same directory as the model file.
*
* Additional data like state, variable texture flag and min and max LOD can be given as user attributes.
*
* If you have any problems, please contact \b piotrdz on ICC forum or IRC channels.
*/
baa616050a