AopIO.h

Go to the documentation of this file.

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

#ifndef __ArtecBaseSDK_AOPIO_H_
#define __ArtecBaseSDK_AOPIO_H_

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

namespace artec { namespace sdk { namespace base
{

class IMesh;
class IRangeImageCylindric;

namespace io {

extern "C" {

/// Save range image to AOP file
/// @param path  File path to save mesh to
/// @param ri  Range image to be saved
ErrorCode ABASESDK_LINK_SPEC
    saveAopImageToFile(const wchar_t* path, const IRangeImageCylindric* ri);

/// Save surface in AOP format, converting it to image
/// @param path  File path to save mesh to
/// @param surface  Surface to be saved
/// @param width,height  Dimensions of range image texture in pixels
/// @param interpolateHoles  If true then holes will be linearly interpolated on cylinder
/// @param cutEdges  Cut top and bottom of cylinder if percent of populated cells in range image 
///                   there lesser than edgeQualityFactor
/// @param edgeQualityFactor  Necessary percent in [0..100] of populated cells on edges. 
/// @note Surface should be in origin, aligned along OY axis, so that OY is inside surface
ErrorCode ABASESDK_LINK_SPEC
    saveAopMeshToFile(const wchar_t* path, const IMesh* surface, int width, int height, 
    bool interpolateHoles, bool cutEdges = false, int edgeQualityFactor = 80);
}

class Aop
{
public:

    /// Save range image in AOP format
    /// @param path  File path to save mesh to
    /// @param ri  Range image to be saved
    static ErrorCode save(const wchar_t* path, const IRangeImageCylindric* ri)
    {
        return  saveAopImageToFile(path, ri);
    }

    /// Save surface in AOP format, converting it to image
    /// @param path  File path to save mesh to
    /// @param surface  Surface to be saved
    /// @param width,height  Dimensions of range image texture in pixels
    /// @param interpolateHoles  If true then holes will be linearly interpolated on cylinder
    /// @param cutEdges  Cut top and bottom of cylinder if percent of populated cells in range image 
    ///                   there lesser than edgeQualityFactor
    /// @param edgeQualityFactor  Necessary percent in [0..100] of populated cells on edges. 
    /// @note Surface should be in origin, aligned along OY axis, so that OY is inside surface
    static ErrorCode
        save(const wchar_t* path, const IMesh* surface, int width, int height, 
            bool interpolateHoles, bool cutEdges = false, int edgeQualityFactor = 80)
    {
        return  saveAopMeshToFile(path, surface, width, height, interpolateHoles, cutEdges, edgeQualityFactor);
    }
};

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

#endif//__ArtecBaseSDK_AOPIO_H_