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 surf - surface to be saved
/// @param width,height - dimensions of range image
/// @param interpolate_holes - if true then holes will be linearly interpolated on cylinder
/// @param cut_edge - cut top and bottom of cylinder if percent of populated cells in range image 
///                   there lesser than edge_quality_factor
/// @param edge_quality_factor - 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* surf, int width, int height, 
    bool interpolate_holes, bool cut_edges = false, int edge_quality_factor = 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 surf - surface to be saved
    /// @param width,height - dimensions of range image
    /// @param interpolate_holes - if true then holes will be linearly interpolated on cylinder
    /// @param cut_edge - cut top and bottom of cylinder if percent of populated cells in range image 
    ///                   there lesser than edge_quality_factor
    /// @param edge_quality_factor - 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* surf, int width, int height, 
            bool interpolate_holes, bool cut_edges = false, int edge_quality_factor = 80)
    {
        return  saveAopMeshToFile(path, surf, width, height, interpolate_holes, cut_edges, edge_quality_factor);
    }
};

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

#endif//__ArtecBaseSDK_AOPIO_H_