Method ReadFile

Engine/lib/assimp/code/Common/Importer.cpp:581–792

------------------------------------------------------------------------------------------------ Reads the given file and returns its contents if successful.

// ------------------------------------------------------------------------------------------------
// Reads the given file and returns its contents if successful.
const aiScene* Importer::ReadFile( const char* _pFile, unsigned int pFlags) {
    ai_assert(nullptr != pimpl);

    ASSIMP_BEGIN_EXCEPTION_REGION();
    const std::string pFile(_pFile);

    // ----------------------------------------------------------------------
    // Put a large try block around everything to catch all std::exception's
    // that might be thrown by STL containers or by new().
    // ImportErrorException's are throw by ourselves and caught elsewhere.
    //-----------------------------------------------------------------------

    WriteLogOpening(pFile);

#ifdef ASSIMP_CATCH_GLOBAL_EXCEPTIONS
    try
#endif // ! ASSIMP_CATCH_GLOBAL_EXCEPTIONS
    {
        // Check whether this Importer instance has already loaded
        // a scene. In this case we need to delete the old one
        if (pimpl->mScene)  {

            ASSIMP_LOG_DEBUG("(Deleting previous scene)");
            FreeScene();
        }

        // First check if the file is accessible at all
        if( !pimpl->mIOHandler->Exists( pFile)) {

            pimpl->mErrorString = "Unable to open file \"" + pFile + "\".";
            ASSIMP_LOG_ERROR(pimpl->mErrorString);
            return nullptr;
        }

        std::unique_ptr<Profiler> profiler(GetPropertyInteger(AI_CONFIG_GLOB_MEASURE_TIME, 0) ? new Profiler() : nullptr);
        if (profiler) {
            profiler->BeginRegion("total");
        }

        // Find an worker class which can handle the file extension.
        // Multiple importers may be able to handle the same extension (.xml!); gather them all.
        SetPropertyInteger("importerIndex", -1);
        struct ImporterAndIndex {
            BaseImporter * importer;
            unsigned int   index;
        };
        std::vector<ImporterAndIndex> possibleImporters;
        for (unsigned int a = 0; a < pimpl->mImporter.size(); a++)  {

            // Every importer has a list of supported extensions.
            std::set<std::string> extensions;
            pimpl->mImporter[a]->GetExtensionList(extensions);

            // CAUTION: Do not just search for the extension!
            // GetExtension() returns the part after the *last* dot, but some extensions have dots
            // inside them, e.g. ogre.mesh.xml. Compare the entire end of the string.
            for (std::set<std::string>::const_iterator it = extensions.cbegin(); it != extensions.cend(); ++it) {