CameraInterface.h

Go to the documentation of this file.

/*
 *
 *                             C@@o         ____  _____   __ _
 *                        oC8@@@@@@@o      |___ \|  __ \ / _| |
 *                    o@@@@@@@@@@@@O         __) | |  | | |_| | _____      __
 *         O@O        8@@@@@@@@@O           |__ <| |  | |  _| |/ _ \ \ /\ / /
 *       o@@@@@@@O    OOOOOCo               ___) | |__| | | | | (_) \ V  V /
 *       C@@@@@@@@@@@@Oo                   |____/|_____/|_| |_|\___/ \_/\_/
 *          o8@@@@@@@@@@@@@@@@8OOCCCC
 *              oO@@@@@@@@@@@@@@@@@@@o          3Dflow s.r.l. - www.3dflow.net
 *                   oO8@@@@@@@@@@@@o           Copyright 2022
 *       oO88@@@@@@@@8OCo                       All Rights Reserved
 *  O@@@@@@@@@@@@@@@@@@@@@@@@@8OCCoooooooCCo
 *   @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@O
 *    @@@Oo            oO8@@@@@@@@@@@@@@@@8
 *
 */
 
#ifndef FLOWENGINECAMERAINTERFACE_H
#define FLOWENGINECAMERAINTERFACE_H
 
#pragma once
 
#include "CommonDef.h"
 
#include "NamedObjectInterface.h"
 
namespace FlowEngine
{
    class CameraCalibrationInterface;
    class ControlPointConstraintInterface;
    class SettingsInterface;
 
    class CameraInterface : public NamedObjectInterface
    {
        public:
 
            FLE_DLL virtual ~CameraInterface() = default;
 
        public:
 
            FLE_DLL virtual bool isReconstructed() const = 0;
 
            FLE_DLL virtual ReconstructionID reconstructionId() const = 0;
 
        public:
 
            FLE_DLL virtual Result loadImage( ConstStringBuffer filePath ) = 0;
 
            FLE_DLL virtual Result loadMask( ConstStringBuffer filePath, const SettingsInterface &settings ) = 0;
 
            FLE_DLL virtual void resetMask() = 0;
 
            FLE_DLL virtual Result loadPreviousFrame( ConstStringBuffer filePath ) = 0;
 
            FLE_DLL virtual Result loadPivotFrame( ConstStringBuffer filePath ) = 0;
 
        public:
 
            FLE_DLL virtual Result getImageFilePath( StringBuffer outImageFilePath ) const = 0;
 
            FLE_DLL virtual Size getImageFilePathLength() const = 0;
 
            FLE_DLL virtual Result getPPM( Buffer< double > outPPM ) const = 0;
 
            FLE_DLL virtual Result getR( Buffer< double > outR ) const = 0;
 
            FLE_DLL virtual Result getT( Point3 &outTranslation ) const = 0;
 
            FLE_DLL virtual void getCameraCalibration( CameraCalibrationInterface &outCameraCalibration ) const = 0;
 
            FLE_DLL virtual void getDimensions( int &outWidth, int &outHeight ) const = 0;
 
        public:
 
            FLE_DLL virtual void setCameraCalibration( const CameraCalibrationInterface &cameraCalibration ) = 0;
 
            FLE_DLL virtual Result setPPM( ConstBuffer< double > ppm ) = 0;
 
            FLE_DLL virtual Result setR( ConstBuffer< double > rot ) = 0;
 
            FLE_DLL virtual Result setT( ConstBuffer< double > translation ) = 0;
 
        public:
 
            FLE_DLL virtual Result orientWithControlPointConstraints( ConstBuffer< ControlPointConstraintInterface * > controlPoints, bool adjustInternalParameters, bool adjustRadialDistortion ) = 0;
 
        public:
 
            FLE_DLL virtual Result projectPoint( const Point3 &point, Point2 &outImageCoords ) const = 0;
 
            FLE_DLL virtual Result computeGroundSampleDistance( double &outMin, double &outMax, double &outMean ) const = 0;
 
        public:
 
            FLE_DLL virtual Result loadFromXmp( ConstStringBuffer filePath ) = 0;
 
            FLE_DLL virtual Result saveToXmp( ConstStringBuffer filePath ) const = 0;
 
        public:
 
            FLE_DLL virtual Result saveUndistortedImage( ConstStringBuffer filePath, Size width = 0, Size height = 0, Size channelBitDepth = 0 ) const = 0;
 
        public:
 
            FLE_DLL virtual Result generateSTMap( Image &inOutImage ) const = 0;
    };
 
    FLOWENGINE_FACTORY CameraInterface *CreateCamera();
 
    FLOWENGINE_FACTORY void DestroyCamera( CameraInterface *camera );
}
 
#endif