VRS - The Virtual Rendering System

version 3.3

objectloader.h

Go to the documentation of this file.

/******************************************************************************
 * VRS - The Virtual Rendering System
 * Copyright (C) 2000-2008 Computer Graphics Systems Group at the 
 * Hasso-Plattner-Institute (HPI), Potsdam, Germany.
 *
 * This  library  is  free  software; you can redistribute it and/or  modify it
 * under the terms of the GNU Lesser General Public  License  as  published  by
 * the  Free  Software  Foundation;  either  version 2.1 of the License, or (at
 * your option) any later version. This library  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 Lesser General Public License for more details. You should have received
 * a copy of the GNU Lesser+ General Public License along with this library; if
 * not, write to the FreeSoftware Foundation, Inc., 59 Temple Place, Suite 330,
 * Boston, MA, 02111-1307, USA.
 ******************************************************************************/

#ifndef VRS_IO_OBJECTLOADER_H
#define VRS_IO_OBJECTLOADER_H

#include <vrs/io/dataresource.h>
#include <vrs/io/ioexceptions.h>
#include <vector>

namespace VRS {

class ObjectReader;
class DataFilter;

class VRS_CORE_API ObjectLoader : public SharedObj {
public:
    static bool install(SO<ObjectReader> readerToInstall);
    static bool uninstall(SO<ObjectReader> readerToUninstall);
    static SO<Iterator<SO<ObjectReader> > > objectReaders();

    static bool install(SO<DataFilter> filterToInstall);
    static bool uninstall(SO<DataFilter> filterToUninstall);
    static SO<Iterator<SO<DataFilter> > > dataFilters();

    static SO<SharedObj> readFile(
        const std::string& filename,
        const ID& targetType = SharedObj::ClassNameVRS(),
        bool throwExceptions = false
    );
    static SO<SharedObj> read(
        SO<DataResource> resource,
        const ID& targetType = SharedObj::ClassNameVRS(),
        bool throwExceptions = false
    );


    static void setAssociatedResources(
        SO<SharedObj> master,
        const std::vector<std::string>& resources = std::vector<std::string>()
    );

    static std::vector<std::string> getAssociatedResources(
        SO<SharedObj> master
    );

    static std::string supportedFileExtensions(
        const ID& targetType,
        const std::string& prefix = "*.",
        const std::string& separator = " ",
        const std::string& postfix = ""
    );
    static std::string supportedFileExtensions(
        const std::vector<ID>& targetTypes,
        const std::string& prefix = "*.",
        const std::string& separator = " ",
        const std::string& postfix = ""
    );
    static std::string supportedFiles(
        const ID& targetType,
        bool addFormatName = true,
        bool addParenthesis = true,
        const std::string& formatSeparator = "\n",
        const std::string& extPrefix = "*.",
        const std::string& extSeparator = " ",
        const std::string& extSuffix = ""
    );
    static std::string supportedFiles(
        const std::vector<ID>& targetTypes,
        bool addFormatName = true,
        bool addParenthesis = true,
        const std::string& formatSeparator = "\n",
        const std::string& extPrefix = "*.",
        const std::string& extSeparator = " ",
        const std::string& extSuffix = ""
    );
    VRS_TYPEINFO(ObjectLoader, SharedObj);
};

#define VRS_LOAD_OBJECT_THROW(TARGET_TYPE, FILE_NAME) \
    VRS_Cast(TARGET_TYPE, ::VRS::ObjectLoader::readFile((FILE_NAME), TARGET_TYPE::ClassNameVRS(), true))

#define VRS_LOAD_OBJECT(TARGET_TYPE, FILE_NAME) \
    VRS_Cast(TARGET_TYPE, ::VRS::ObjectLoader::readFile((FILE_NAME), TARGET_TYPE::ClassNameVRS(), false))

#define VRS_LoadObject(TARGET_TYPE, FILE_NAME) \
    VRS_LOAD_OBJECT(TARGET_TYPE, FILE_NAME)

#define VRS_GuardedLoadObject(TARGET_TYPE, FILE_NAME) \
    VRS_GuardedCast(TARGET_TYPE, ::VRS::ObjectLoader::readFile((FILE_NAME), TARGET_TYPE::ClassNameVRS()))

#define VRS_REGISTER_READER(READER)                                                             \
    namespace {                                                                                 \
        bool VRS_ANONYMOUS_IDENTIFIER(registration) = ::VRS::ObjectLoader::install(new READER); \
    }

} // namespace VRS

#endif // VRS_IO_OBJECTLOADER_H

---

Generated on Wed May 23 06:00:13 2012 by Doxygen 1.5.6

© 2001-2010 Hasso-Plattner-Institut | Impressum | Contact