IFactory.h

//-*****************************************************************************
//
// Copyright (c) 2013-2015,
//  Sony Pictures Imageworks, Inc. and
//  Industrial Light & Magic, a division of Lucasfilm Entertainment Company Ltd.
//
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
// *       Redistributions of source code must retain the above copyright
// notice, this list of conditions and the following disclaimer.
// *       Redistributions in binary form must reproduce the above
// copyright notice, this list of conditions and the following disclaimer
// in the documentation and/or other materials provided with the
// distribution.
// *       Neither the name of Sony Pictures Imageworks, nor
// Industrial Light & Magic nor the names of their contributors may be used
// to endorse or promote products derived from this software without specific
// prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
//
//-*****************************************************************************
 
#ifndef Alembic_AbcCoreFactory_IFactory_h
#define Alembic_AbcCoreFactory_IFactory_h
 
#include <Alembic/AbcCoreAbstract/ReadArraySampleCache.h>
#include <Alembic/Abc/IArchive.h>
#include <Alembic/Util/Export.h>
 
namespace Alembic {
namespace AbcCoreFactory {
namespace ALEMBIC_VERSION_NS {
 
class ALEMBIC_EXPORT IFactory
{
public:
    IFactory();
    ~IFactory();

    enum CoreType
    {
        kHDF5,
        kOgawa,
        kLayer,
        kUnknown
    };

    Alembic::Abc::IArchive getArchive( const std::string & iFileName,
                                       CoreType & oType );

    Alembic::Abc::IArchive getArchive( const std::string & iFileName );

    Alembic::Abc::IArchive getArchive(
        const std::vector< std::string > & iFileNames );

    Alembic::Abc::IArchive getArchive(
        const std::vector< std::string > & iFileNames, CoreType & oType );

    Alembic::Abc::IArchive getArchive(
        const std::vector< std::istream * > & iStreams, CoreType & oType );
 
    // TODO, how do we best layer streams, and strings

    void setHDF5CacheHierarchy( bool iCacheHierarchy )
    {
        m_cacheHierarchy = iCacheHierarchy;
    }

    bool getHDF5CacheHierarchy() const { return m_cacheHierarchy; }

    void setSampleCache(
        Alembic::AbcCoreAbstract::ReadArraySampleCachePtr iCachePtr )
    {
        m_cachePtr = iCachePtr;
    }

    Alembic::AbcCoreAbstract::ReadArraySampleCachePtr getSampleCache() const
    {
        return m_cachePtr;
    }

    size_t getOgawaNumStreams() const { return m_numStreams; }

    void setOgawaNumStreams( size_t iNumStreams )
    {
        m_numStreams = iNumStreams;
    }
 
    enum OgawaReadStrategy
    {
        kFileStreams,
        kMemoryMappedFiles
    };

    OgawaReadStrategy getOgawaReadStrategy() { return m_readStrategy; }

    void setOgawaReadStrategy( OgawaReadStrategy iStrategy )
    {
        m_readStrategy = iStrategy;
    }
 

    Alembic::Abc::ErrorHandler::Policy getPolicy() { return m_policy; }

    void setPolicy( Alembic::Abc::ErrorHandler::Policy iPolicy )
    {
        m_policy = iPolicy;
    }
 
private:
    bool m_cacheHierarchy;
    size_t m_numStreams;
    OgawaReadStrategy m_readStrategy;
    Alembic::AbcCoreAbstract::ReadArraySampleCachePtr m_cachePtr;
    Alembic::Abc::ErrorHandler::Policy m_policy;
 
};
 
} // End namespace ALEMBIC_VERSION_NS
 
using namespace ALEMBIC_VERSION_NS;
 
} // End namespace Abc
} // End namespace Alembic
 
#endif