nuclear@0: /*
nuclear@0: Open Asset Import Library (assimp)
nuclear@0: ----------------------------------------------------------------------
nuclear@0: 
nuclear@0: Copyright (c) 2006-2012, assimp team
nuclear@0: All rights reserved.
nuclear@0: 
nuclear@0: Redistribution and use of this software in source and binary forms, 
nuclear@0: with or without modification, are permitted provided that the 
nuclear@0: following conditions are met:
nuclear@0: 
nuclear@0: * Redistributions of source code must retain the above
nuclear@0:   copyright notice, this list of conditions and the
nuclear@0:   following disclaimer.
nuclear@0: 
nuclear@0: * Redistributions in binary form must reproduce the above
nuclear@0:   copyright notice, this list of conditions and the
nuclear@0:   following disclaimer in the documentation and/or other
nuclear@0:   materials provided with the distribution.
nuclear@0: 
nuclear@0: * Neither the name of the assimp team, nor the names of its
nuclear@0:   contributors may be used to endorse or promote products
nuclear@0:   derived from this software without specific prior
nuclear@0:   written permission of the assimp team.
nuclear@0: 
nuclear@0: THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
nuclear@0: "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
nuclear@0: LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
nuclear@0: A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 
nuclear@0: OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
nuclear@0: SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 
nuclear@0: LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
nuclear@0: DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 
nuclear@0: THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
nuclear@0: (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 
nuclear@0: OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
nuclear@0: 
nuclear@0: ----------------------------------------------------------------------
nuclear@0: */
nuclear@0: 
nuclear@0: /** @file  PLYLoader.h
nuclear@0:  *  @brief Declaration of the .ply importer class.
nuclear@0:  */
nuclear@0: #ifndef AI_PLYLOADER_H_INCLUDED
nuclear@0: #define AI_PLYLOADER_H_INCLUDED
nuclear@0: 
nuclear@0: #include "BaseImporter.h"
nuclear@0: #include "assimp/types.h"
nuclear@0: 
nuclear@0: struct aiNode;
nuclear@0: 
nuclear@0: #include "PlyParser.h"
nuclear@0: 
nuclear@0: namespace Assimp	{
nuclear@0: 
nuclear@0: 
nuclear@0: using namespace PLY;
nuclear@0: 
nuclear@0: // ---------------------------------------------------------------------------
nuclear@0: /** Importer class to load the stanford PLY file format
nuclear@0: */
nuclear@0: class PLYImporter : public BaseImporter
nuclear@0: {
nuclear@0: public:
nuclear@0: 	PLYImporter();
nuclear@0: 	~PLYImporter();
nuclear@0: 
nuclear@0: 
nuclear@0: public:
nuclear@0: 
nuclear@0: 	// -------------------------------------------------------------------
nuclear@0: 	/** Returns whether the class can handle the format of the given file. 
nuclear@0: 	 * See BaseImporter::CanRead() for details.
nuclear@0:  	 */
nuclear@0: 	bool CanRead( const std::string& pFile, IOSystem* pIOHandler,
nuclear@0: 		bool checkSig) const;
nuclear@0: 
nuclear@0: protected:
nuclear@0: 
nuclear@0: 	// -------------------------------------------------------------------
nuclear@0: 	/** Return importer meta information.
nuclear@0: 	 * See #BaseImporter::GetInfo for the details
nuclear@0: 	 */
nuclear@0: 	const aiImporterDesc* GetInfo () const;
nuclear@0: 
nuclear@0: 	// -------------------------------------------------------------------
nuclear@0: 	/** Imports the given file into the given scene structure. 
nuclear@0: 	* See BaseImporter::InternReadFile() for details
nuclear@0: 	*/
nuclear@0: 	void InternReadFile( const std::string& pFile, aiScene* pScene,
nuclear@0: 		IOSystem* pIOHandler);
nuclear@0: 
nuclear@0: protected:
nuclear@0: 
nuclear@0: 
nuclear@0: 	// -------------------------------------------------------------------
nuclear@0: 	/** Extract vertices from the DOM
nuclear@0: 	*/
nuclear@0: 	void LoadVertices(std::vector<aiVector3D>* pvOut,
nuclear@0: 		bool p_bNormals = false);
nuclear@0: 
nuclear@0: 	// -------------------------------------------------------------------
nuclear@0: 	/** Extract vertex color channels from the DOM
nuclear@0: 	*/
nuclear@0: 	void LoadVertexColor(std::vector<aiColor4D>* pvOut);
nuclear@0: 
nuclear@0: 	// -------------------------------------------------------------------
nuclear@0: 	/** Extract texture coordinate channels from the DOM
nuclear@0: 	*/
nuclear@0: 	void LoadTextureCoordinates(std::vector<aiVector2D>* pvOut);
nuclear@0: 
nuclear@0: 	// -------------------------------------------------------------------
nuclear@0: 	/** Extract a face list from the DOM
nuclear@0: 	*/
nuclear@0: 	void LoadFaces(std::vector<PLY::Face>* pvOut);
nuclear@0: 
nuclear@0: 	// -------------------------------------------------------------------
nuclear@0: 	/** Extract a material list from the DOM
nuclear@0: 	*/
nuclear@0: 	void LoadMaterial(std::vector<aiMaterial*>* pvOut);
nuclear@0: 
nuclear@0: 
nuclear@0: 	// -------------------------------------------------------------------
nuclear@0: 	/** Validate material indices, replace default material identifiers
nuclear@0: 	*/
nuclear@0: 	void ReplaceDefaultMaterial(std::vector<PLY::Face>* avFaces,
nuclear@0: 		std::vector<aiMaterial*>* avMaterials);
nuclear@0: 
nuclear@0: 
nuclear@0: 	// -------------------------------------------------------------------
nuclear@0: 	/** Convert all meshes into our ourer representation
nuclear@0: 	*/
nuclear@0: 	void ConvertMeshes(std::vector<PLY::Face>* avFaces,
nuclear@0: 		const std::vector<aiVector3D>* avPositions,
nuclear@0: 		const std::vector<aiVector3D>* avNormals,
nuclear@0: 		const std::vector<aiColor4D>* avColors,
nuclear@0: 		const std::vector<aiVector2D>* avTexCoords,
nuclear@0: 		const std::vector<aiMaterial*>* avMaterials,
nuclear@0: 		std::vector<aiMesh*>* avOut);
nuclear@0: 
nuclear@0: 
nuclear@0: 	// -------------------------------------------------------------------
nuclear@0: 	/** Static helper to parse a color from four single channels in
nuclear@0: 	*/
nuclear@0: 	static void GetMaterialColor(
nuclear@0: 		const std::vector<PLY::PropertyInstance>& avList,
nuclear@0: 		unsigned int aiPositions[4], 
nuclear@0: 		PLY::EDataType aiTypes[4],
nuclear@0: 		aiColor4D* clrOut);
nuclear@0: 
nuclear@0: 
nuclear@0: 	// -------------------------------------------------------------------
nuclear@0: 	/** Static helper to parse a color channel value. The input value
nuclear@0: 	*  is normalized to 0-1.
nuclear@0: 	*/
nuclear@0: 	static float NormalizeColorValue (
nuclear@0: 		PLY::PropertyInstance::ValueUnion val,
nuclear@0: 		PLY::EDataType eType);
nuclear@0: 
nuclear@0: 
nuclear@0: 	/** Buffer to hold the loaded file */
nuclear@0: 	unsigned char* mBuffer;
nuclear@0: 
nuclear@0: 	/** Document object model representation extracted from the file */
nuclear@0: 	PLY::DOM* pcDOM;
nuclear@0: };
nuclear@0: 
nuclear@0: } // end of namespace Assimp
nuclear@0: 
nuclear@0: #endif // AI_3DSIMPORTER_H_INC