ObjIO.h

Go to the documentation of this file.

/********************************************************************
*
*   Project     Artec 3D Scanning SDK
*
*   Purpose:    Wavefront OBJ file format support
*
*  Copyright:   Artec Group
*
********************************************************************/

#ifndef _OBJIO_H_
#define _OBJIO_H_

#include <artec/sdk/base/BaseSdkDefines.h>
#include <artec/sdk/base/Errors.h>

namespace artec { namespace sdk { namespace base
{
    class IBlob;
    class IFrameMesh;
    class ICompositeMesh;
    class ICancellationToken;
    class IProgressInfo;

namespace io {

extern "C" {

    ///@{
    /** Save IFrameMesh/ICompositeMesh to OBJ file
    *   @param  path - file path to save mesh to
    *   @param  mesh - mesh to be saved
    *   @param  progr - progress interface
    *   @param  cncl - cancel interface
    *   @param  saveNormals - if we need to save normals in file
    *   @param  saveTexCoords - if texture coordinates should be saved
    *   @param  imageFormat   - format for texture images if they should be saved ("png","jpg","bmp")
    *   @return error code
    *   @note   if you set saveTexCoords flag then texture images will also be saved
    */
    ErrorCode ABASESDK_LINK_SPEC
        saveObjFrameToFile(const wchar_t* path, const IFrameMesh* mesh, IProgressInfo* progr = 0, ICancellationToken* cncl = 0,
        bool saveNormals = true, bool saveTexCoords = true, const wchar_t* imageFormat = L"png");
    ErrorCode ABASESDK_LINK_SPEC 
        saveObjCompositeToFile(const wchar_t* path, const ICompositeMesh* mesh, IProgressInfo* progr = 0, ICancellationToken* cncl = 0,
        bool saveNormals = true, bool saveTexCoords = true, const wchar_t* imageFormat = L"png");
    ///@}

    ///@{
    /** Save IFrameMesh/ICompositeMesh to OBJ blob
    *   @note   save only geometry, not texture and material also, because material and images is stored in separate blob
    *   @param  data - blob to save mesh to
    *   @param  mesh - mesh to be saved
    *   @param  progr - progress interface
    *   @param  cncl - cancel interface
    *   @param  saveNormals - if we need to save normals in file
    *   @param  saveTexCoords - if texture coordinates should be saved
    *   @return error code
    */
    ErrorCode ABASESDK_LINK_SPEC
        saveObjFrameToBlob(IBlob** data, const IFrameMesh* mesh, IProgressInfo* progr = 0, ICancellationToken* cncl = 0,
        bool saveNormals = true, bool saveTexCoords = true, const wchar_t* materialFilename = NULL);
    ErrorCode ABASESDK_LINK_SPEC 
        saveObjCompositeToBlob(IBlob** data, const ICompositeMesh* mesh, IProgressInfo* progr = 0, ICancellationToken* cncl = 0,
        bool saveNormals = true, bool saveTexCoords = true, const wchar_t* materialFilename = NULL);
    ///@}

    ///@{
    /** Load IFrameMesh/ICompositeMesh from OBJ file
    *   @param  mesh - loaded mesh
    *   @param  path - file path to load image from
    *   @param  progr - progress interface
    *   @param  cncl - cancel interface
    *   @return error code
    */
    ErrorCode ABASESDK_LINK_SPEC
        loadObjFrameFromFile(IFrameMesh** mesh, const wchar_t* path, IProgressInfo* progr = 0, ICancellationToken* cncl = 0);
    ErrorCode ABASESDK_LINK_SPEC 
        loadObjCompositeFromFile(ICompositeMesh** mesh, const wchar_t* path, IProgressInfo* progr = 0, ICancellationToken* cncl = 0);
    ///@}

    ///@{
    /** Load IFrameMesh/ICompositeMesh from OBJ blob 
    *   @note   load only geometry, not texture also, because image is stored in separate blob
    *   @param  mesh - loaded mesh
    *   @param  data - blob to load image from
    *   @param  progr - progress interface
    *   @param  cncl - cancel interface
    *   @return error code
    */
    ErrorCode ABASESDK_LINK_SPEC
        loadObjFrameFromBlob(IFrameMesh** mesh, const IBlob* data, IProgressInfo* progr = 0, ICancellationToken* cncl = 0);
    ErrorCode ABASESDK_LINK_SPEC 
        loadObjCompositeFromBlob(ICompositeMesh** mesh, const IBlob* data, IProgressInfo* progr = 0, ICancellationToken* cncl = 0);
    ///@}
}

    class Obj
    {
    public:
        ///@{
        /** Save IFrameMesh/ICompositeMesh to OBJ file
        *   @param  path - file path to save mesh to
        *   @param  mesh - mesh to be saved
        *   @param  progr - progress interface
        *   @param  cncl - cancel interface
        *   @param  saveNormals - if we need to save normals in file
        *   @param  saveTexCoords - if texture coordinates should be saved
        *   @param  imageFormat   - format for texture images if they should be saved ("png","jpg","bmp")
        *   @return error code
        *   @note   if you set saveTexCoords flag then texture images will also be saved
        */
        static ErrorCode
            save(const wchar_t* path, const IFrameMesh* mesh, IProgressInfo* progr = 0, ICancellationToken* cncl = 0,
            bool saveNormals = true, bool saveTexCoords = true, const wchar_t* imageFormat = L"png")
        {
            return saveObjFrameToFile(path, mesh, progr, cncl, saveNormals, saveTexCoords, imageFormat);
        }

        static ErrorCode
            save(const wchar_t* path, const ICompositeMesh* mesh, IProgressInfo* progr = 0, ICancellationToken* cncl = 0,
            bool saveNormals = true, bool saveTexCoords = true, const wchar_t* imageFormat = L"png")
        {
            return saveObjCompositeToFile(path, mesh, progr, cncl, saveNormals, saveTexCoords, imageFormat);
        }
        ///@}

        ///@{
        /** Save IFrameMesh/ICompositeMesh to OBJ blob
        *   @note   save only geometry, not texture and material also, because material and images is stored in separate blob
        *   @param  data - blob to save mesh to
        *   @param  mesh - mesh to be saved
        *   @param  progr - progress interface
        *   @param  cncl - cancel interface
        *   @param  saveNormals - if we need to save normals in file
        *   @param  saveTexCoords - if texture coordinates should be saved
        *   @return error code
        */
        static ErrorCode
            save(IBlob** data, const IFrameMesh* mesh, IProgressInfo* progr = 0, ICancellationToken* cncl = 0,
                bool saveNormals = true, bool saveTexCoords = true, const wchar_t* materialFilename = NULL)
        {
            return saveObjFrameToBlob(data, mesh, progr, cncl, saveNormals, saveTexCoords, materialFilename);
        }

        static ErrorCode 
            save(IBlob** data, const ICompositeMesh* mesh, IProgressInfo* progr = 0, ICancellationToken* cncl = 0,
                bool saveNormals = true, bool saveTexCoords = true, const wchar_t* materialFilename = NULL)
        {
            return saveObjCompositeToBlob(data, mesh, progr, cncl, saveNormals, saveTexCoords, materialFilename);
        }
        ///@}

        ///@{
        /** Load IFrameMesh/ICompositeMesh from OBJ file
        *   @param  mesh - loaded mesh
        *   @param  path - file path to load image from
        *   @param  progr - progress interface
        *   @param  cncl - cancel interface
        *   @return error code
        */
        static ErrorCode load(IFrameMesh** mesh, const wchar_t* path, IProgressInfo* progr = 0, ICancellationToken* cncl = 0)
        {
            return  loadObjFrameFromFile(mesh, path, progr, cncl);
        }

        static ErrorCode load(ICompositeMesh** mesh, const wchar_t* path, IProgressInfo* progr = 0, ICancellationToken* cncl = 0)
        {
            return  loadObjCompositeFromFile(mesh, path, progr, cncl);
        }
        ///@}

        ///@{
        /** Load IFrameMesh/ICompositeMesh from OBJ blob
        *   @note   load only geometry, not texture also, because image is stored in separate blob
        *   @param  mesh - loaded mesh
        *   @param  data - blob to load image from
        *   @param  progr - progress interface
        *   @param  cncl - cancel interface
        *   @return error code
        */
        static ErrorCode load(IFrameMesh** mesh, const IBlob* data, IProgressInfo* progr = 0, ICancellationToken* cncl = 0)
        {
            return  loadObjFrameFromBlob(mesh, data, progr, cncl);
        }

        static ErrorCode load(ICompositeMesh** mesh, const IBlob* data, IProgressInfo* progr = 0, ICancellationToken* cncl = 0)
        {
            return  loadObjCompositeFromBlob(mesh, data, progr, cncl);
        }
        ///@}

    };

} } } } // namespace artec::sdk::base::io

#endif // _OBJIO_H_