1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/libs/assimp/ASELoader.h	Sat Feb 01 19:58:19 2014 +0200
     1.3 @@ -0,0 +1,205 @@
     1.4 +/*
     1.5 +Open Asset Import Library (assimp)
     1.6 +----------------------------------------------------------------------
     1.7 +
     1.8 +Copyright (c) 2006-2012, assimp team
     1.9 +All rights reserved.
    1.10 +
    1.11 +Redistribution and use of this software in source and binary forms, 
    1.12 +with or without modification, are permitted provided that the 
    1.13 +following conditions are met:
    1.14 +
    1.15 +* Redistributions of source code must retain the above
    1.16 +  copyright notice, this list of conditions and the
    1.17 +  following disclaimer.
    1.18 +
    1.19 +* Redistributions in binary form must reproduce the above
    1.20 +  copyright notice, this list of conditions and the
    1.21 +  following disclaimer in the documentation and/or other
    1.22 +  materials provided with the distribution.
    1.23 +
    1.24 +* Neither the name of the assimp team, nor the names of its
    1.25 +  contributors may be used to endorse or promote products
    1.26 +  derived from this software without specific prior
    1.27 +  written permission of the assimp team.
    1.28 +
    1.29 +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
    1.30 +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
    1.31 +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
    1.32 +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 
    1.33 +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
    1.34 +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 
    1.35 +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
    1.36 +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 
    1.37 +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
    1.38 +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 
    1.39 +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    1.40 +
    1.41 +----------------------------------------------------------------------
    1.42 +*/
    1.43 +
    1.44 +/** @file  ASELoader.h
    1.45 + *  @brief Definition of the .ASE importer class.
    1.46 + */
    1.47 +#ifndef AI_ASELOADER_H_INCLUDED
    1.48 +#define AI_ASELOADER_H_INCLUDED
    1.49 +
    1.50 +#include "BaseImporter.h"
    1.51 +#include "assimp/types.h"
    1.52 +
    1.53 +struct aiNode;
    1.54 +#include "ASEParser.h"
    1.55 +
    1.56 +namespace Assimp {
    1.57 +
    1.58 +
    1.59 +// --------------------------------------------------------------------------------
    1.60 +/** Importer class for the 3DS ASE ASCII format.
    1.61 + *
    1.62 + */
    1.63 +class ASEImporter : public BaseImporter	{
    1.64 +public:
    1.65 +	ASEImporter();
    1.66 +	~ASEImporter();
    1.67 +
    1.68 +
    1.69 +public:
    1.70 +
    1.71 +	// -------------------------------------------------------------------
    1.72 +	/** Returns whether the class can handle the format of the given file. 
    1.73 +	 * See BaseImporter::CanRead() for details.	
    1.74 +	 */
    1.75 +	bool CanRead( const std::string& pFile, IOSystem* pIOHandler,
    1.76 +		bool checkSig) const;
    1.77 +
    1.78 +protected:
    1.79 +
    1.80 +	// -------------------------------------------------------------------
    1.81 +	/** Return importer meta information.
    1.82 +	 * See #BaseImporter::GetInfo for the details
    1.83 +	 */
    1.84 +	const aiImporterDesc* GetInfo () const;
    1.85 +
    1.86 +
    1.87 +	// -------------------------------------------------------------------
    1.88 +	/** Imports the given file into the given scene structure. 
    1.89 +	* See BaseImporter::InternReadFile() for details
    1.90 +	*/
    1.91 +	void InternReadFile( const std::string& pFile, aiScene* pScene,
    1.92 +		IOSystem* pIOHandler);
    1.93 +
    1.94 +
    1.95 +	// -------------------------------------------------------------------
    1.96 +	/** Called prior to ReadFile().
    1.97 +	* The function is a request to the importer to update its configuration
    1.98 +	* basing on the Importer's configuration property list.
    1.99 +	*/
   1.100 +	void SetupProperties(const Importer* pImp);
   1.101 +
   1.102 +
   1.103 +private:
   1.104 +
   1.105 +	// -------------------------------------------------------------------
   1.106 +	/** Generate normal vectors basing on smoothing groups
   1.107 +	 * (in some cases the normal are already contained in the file)
   1.108 +	 * \param mesh Mesh to work on
   1.109 +	 * \return false if the normals have been recomputed
   1.110 +	 */
   1.111 +	bool GenerateNormals(ASE::Mesh& mesh);
   1.112 +
   1.113 +
   1.114 +	// -------------------------------------------------------------------
   1.115 +	/** Create valid vertex/normal/UV/color/face lists.
   1.116 +	 *  All elements are unique, faces have only one set of indices
   1.117 +	 *  after this step occurs.
   1.118 +	 * \param mesh Mesh to work on
   1.119 +	 */
   1.120 +	void BuildUniqueRepresentation(ASE::Mesh& mesh);
   1.121 +
   1.122 +
   1.123 +	/** Create one-material-per-mesh meshes ;-)
   1.124 +	 * \param mesh Mesh to work with
   1.125 +	 *  \param Receives the list of all created meshes
   1.126 +	 */
   1.127 +	void ConvertMeshes(ASE::Mesh& mesh, std::vector<aiMesh*>& avOut);
   1.128 +
   1.129 +
   1.130 +	// -------------------------------------------------------------------
   1.131 +	/** Convert a material to a aiMaterial object
   1.132 +	 * \param mat Input material
   1.133 +	 */
   1.134 +	void ConvertMaterial(ASE::Material& mat);
   1.135 +
   1.136 +
   1.137 +	// -------------------------------------------------------------------
   1.138 +	/** Setup the final material indices for each mesh
   1.139 +	 */
   1.140 +	void BuildMaterialIndices();
   1.141 +
   1.142 +
   1.143 +	// -------------------------------------------------------------------
   1.144 +	/** Build the node graph
   1.145 +	 */
   1.146 +	void BuildNodes(std::vector<ASE::BaseNode*>& nodes);
   1.147 +
   1.148 +
   1.149 +	// -------------------------------------------------------------------
   1.150 +	/** Build output cameras
   1.151 +	 */
   1.152 +	void BuildCameras();
   1.153 +
   1.154 +
   1.155 +	// -------------------------------------------------------------------
   1.156 +	/** Build output lights
   1.157 +	 */
   1.158 +	void BuildLights();
   1.159 +
   1.160 +
   1.161 +	// -------------------------------------------------------------------
   1.162 +	/** Build output animations
   1.163 +	 */
   1.164 +	void BuildAnimations(const std::vector<ASE::BaseNode*>& nodes);
   1.165 +
   1.166 +
   1.167 +	// -------------------------------------------------------------------
   1.168 +	/** Add sub nodes to a node
   1.169 +	 *  \param pcParent parent node to be filled
   1.170 +	 *  \param szName Name of the parent node
   1.171 +	 *  \param matrix Current transform
   1.172 +	 */
   1.173 +	void AddNodes(const std::vector<ASE::BaseNode*>& nodes,
   1.174 +		aiNode* pcParent,const char* szName);
   1.175 +
   1.176 +	void AddNodes(const std::vector<ASE::BaseNode*>& nodes,
   1.177 +		aiNode* pcParent,const char* szName,
   1.178 +		const aiMatrix4x4& matrix);
   1.179 +
   1.180 +	void AddMeshes(const ASE::BaseNode* snode,aiNode* node);
   1.181 +
   1.182 +	// -------------------------------------------------------------------
   1.183 +	/** Generate a default material and add it to the parser's list
   1.184 +	 *  Called if no material has been found in the file (rare for ASE,
   1.185 +	 *  but not impossible)
   1.186 +	 */
   1.187 +	void GenerateDefaultMaterial();
   1.188 +
   1.189 +protected:
   1.190 +
   1.191 +	/** Parser instance */
   1.192 +	ASE::Parser* mParser;
   1.193 +
   1.194 +	/** Buffer to hold the loaded file */
   1.195 +	char* mBuffer;
   1.196 +
   1.197 +	/** Scene to be filled */
   1.198 +	aiScene* pcScene;
   1.199 +
   1.200 +	/** Config options: Recompute the normals in every case - WA
   1.201 +	    for 3DS Max broken ASE normal export */
   1.202 +	bool configRecomputeNormals;
   1.203 +	bool noSkeletonMesh;
   1.204 +};
   1.205 +
   1.206 +} // end of namespace Assimp
   1.207 +
   1.208 +#endif // AI_3DSIMPORTER_H_INC