IScan.h

Go to the documentation of this file.

/********************************************************************
*
*   Project     Artec 3D Scanning SDK
*
*   Purpose:    Container for sequence of scanned frames
*
*   Copyright:  Artec Group
*
********************************************************************/
#ifndef _ISCAN_H_
#define _ISCAN_H_

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

namespace artec { namespace sdk { namespace base
{

class IFrameMesh;
class IScan;
class IBlob;

extern "C"
{
    /**
    *   Create new Scan
    *   @param pContainer - destination Scan
    *   @param scannerType - use ScannerType_Unknown as unknown scanner type
    *   @param textureMappingMatrix - matrix for texture coordinates calculation
    *
    * @return 
    *  error code
    */
    ErrorCode ABASESDK_LINK_SPEC createScan(IScan** pContainer, ScannerType scannerType = ScannerType_Unknown,
        const Matrix3x4D* textureMappingMatrix = NULL);

    /**
    *   Accumulates all meshes from a the given IScan to given IFrameMesh
    *   coordinates are transformed according current scan and frame transformation matrices
    */
    ErrorCode ABASESDK_LINK_SPEC mergeToFrameMesh(IFrameMesh *mesh, const IScan *scanContainer, bool skipTextureData = true);

    /**
    * clone all Scan content
    * @param out - destination Scan
    * @param in  - Scan to take elements from 
    *
    * @return 
    *  error code
    */
    ErrorCode ABASESDK_LINK_SPEC cloneScan(IScan* out, const IScan* in);

    /**
    * Creates Scan with identical attributes
    * @param    out New Scan
    * @param    in  Scan to copy attributes from
    *
    * @note The shallow(!) copy of attributes takes place here.
    *
    * @return
    *  error code
    */
    ErrorCode ABASESDK_LINK_SPEC createSimilarScan( IScan** out, const IScan* attributesPattern );
}

class IScan : public IRef
{
    /*
    *   This is a scanned frame container with transformation and some
    *   additional information on each surface
    */
public:
    // Element operations

    /// Element access. Index must be in range [0...getSize()) 
    virtual IFrameMesh* getElement(int index) const = 0;
    virtual ErrorCode setElement(int index, IFrameMesh* mesh) = 0;

    /// Add/remove frame to scan
    virtual ErrorCode add(IFrameMesh* frame) = 0;
    virtual ErrorCode add(IFrameMesh* frame, const Matrix4x4D& matrix, IBlob* frameAttributes = NULL) = 0;
    virtual ErrorCode remove(int index) = 0;

    /// Access frame orientation by index
    /// Matrix with zero elements will be returned for invalid element index
    virtual const Matrix4x4D& getTransformation(int index) const = 0;
    virtual ErrorCode setTransformation(int index, const Matrix4x4D& m) = 0;

    /// Get frame attributes by index
    virtual IBlob* getAttributes(int index) const = 0;
    virtual ErrorCode setAttributes(int index, IBlob* attributes) = 0;
    
    
    // Scan operations
    
    /// Get the data origin device type
    virtual ScannerType getScannerType() const = 0;

    /// Get scan transformation
    virtual const Matrix4x4D& getScanTransformation() const = 0;
    virtual void setScanTransformation(const Matrix4x4D& m) = 0;

    /// Get scan attributes by index
    virtual IBlob* getScanAttributes() const = 0;
    virtual void setScanAttributes(IBlob* attributes) = 0;

    /// Access matrix for texture mapping
    virtual const Matrix3x4D& getTextureMappingMatrix() const = 0;
    virtual void setTextureMappingMatrix(const Matrix3x4D& m) = 0;


    // Container operations

    /// Get elements number in scan
    virtual int getSize() const = 0;

    /// Delete all scan elements
    virtual void clear() = 0;
};

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

#endif // _ISCAN_H_