CalibrationExport.h

Go to the documentation of this file.

/**
* @file CalibrationExport.h
* @brief Calibration parameters for export
*
* @author LMI Technologies
*/

#ifndef _CalibrationExport_h
#define _CalibrationExport_h

#include "MeasurementDefs.h"

struct TCalibParDateTimeItem
{
   unsigned short m_wYear;
   unsigned short m_wMon;
   unsigned short m_wDay;
   unsigned short m_wHour;
   unsigned short m_wMin;
   unsigned short m_wSec;

   TCalibParDateTimeItem()
   {
      m_wYear = m_wMon = m_wDay = m_wHour = m_wMin = m_wSec = 0;
   };
};

struct TSimpleCalibParDateTime                              
{
    TCalibParDateTimeItem m_DateTimeRefPlane;            /**< Date / Time - Reference plane */
    TCalibParDateTimeItem m_DateTimeGrid;                /**< Date / Time - Grid */
    TCalibParDateTimeItem m_DateTimeGroove;              /**< Date / Time - Groove */
};

/**
Basic settings
*/
struct TSimpleCalibParBasic
{
   CalibrationType m_CalType;                                /**< Calibration type */
   long m_lNumAddPlanes;                                     /**< Number of additional planes */
   ProjectorPositionToCamera m_PositionToCamera;             /**< Projector position relating to the camera */
   bool m_bNumGridLinesLess25;                               /**< Less than 25 grid lines are in the camera image */
   CalibrationMeasProgram m_CalMeasProg;                     /**< Measurement program for calibration */

   TSimpleCalibParBasic()
   {
      m_CalType = CalibrationType_GrooveStandard;
      m_lNumAddPlanes = 0;
      m_PositionToCamera = ProjectorPositionToCamera_Left;
      m_bNumGridLinesLess25 = false;
      m_CalMeasProg = CalibrationMeasProgram_32_32;
   };
};

/**
Optical settings
*/
struct TSimpleCalibParOptic
{
   float m_fPixelSizeProjX;                                 /**< Pixel size X direction projector */
   float m_fPixelSizeProjY;                                 /**< Pixel size Y direction projector */
   float m_fFocalLengthProj;                                /**< Focal length projector */
   float m_fPixelSizeCamX;                                  /**< Pixel size X direction camera */
   float m_fPixelSizeCamY;                                  /**< Pixel size Y direction camera */
   float m_fFocalLengthCam;                                 /**< Focal length camera */

   TSimpleCalibParOptic()
   {
      m_fPixelSizeProjX = m_fPixelSizeProjY = 0.01f;
      m_fPixelSizeCamX = m_fPixelSizeCamY = 0.01f;
      m_fFocalLengthProj = m_fFocalLengthCam = 0.01f;
   };
};

/**
Calibration pieces
*/
struct TSimpleCalibParPieces
{
   float m_fGridX;                           /**< Grid pattern width in mm */
   float m_fGridY;                           /**< Grid pattern height in mm */
   float m_fGrooveDepth;                     /**< Groove depth in mm */

   TSimpleCalibParPieces()
   {
      m_fGridX = m_fGridY = 0.1f;
      m_fGrooveDepth = 0.1f;
   };
};

/**
Measurement Range
*/
struct TSimpleCalibParMeasRange
{
   float m_fXMin;
   float m_fXMax;
   float m_fYMin;
   float m_fYMax;
   float m_fZMin;
   float m_fZMax;
   float m_fZResolution;

   TSimpleCalibParMeasRange()
   {
      m_fXMin = m_fXMax = m_fYMin = m_fYMax = m_fZMin = m_fZMax = 0.0f;
      m_fZResolution = 1.0f;
   };
};

/**
Main structure
*/
struct TSimpleCalibPar
{
   TSimpleCalibParDateTime m_DateTime;
   TSimpleCalibParBasic m_Basic;
   TSimpleCalibParOptic m_Optic;
   TSimpleCalibParPieces m_Pieces;
   TSimpleCalibParMeasRange m_MeasRange;
};

/**
Multi level calibration - calibration method
*/
enum MultiLevelCalibrationMethod
{
    MultiLevelCalibrationMethod_ManMultiplePlanes,                   /** Manual, grid, multiple planes */
    MultiLevelCalibrationMethod_ManMultipleParallelPlanes,           /** Manual, grid, multiple parallel planes */
    MultiLevelCalibrationMethod_AutoMultiplePlanes,                  /** Automatic, grid, multiple planes */
    MultiLevelCalibrationMethod_AutoMultipleParallelPlanes,          /** Automatic, grid, multiple parallel planes */
    MultiLevelCalibrationMethod_AutoMultipleParallelPlanesFix,       /** Automatic, grid, multiple parallel planes with fixed distance */

    MultiLevelCalibrationMethod_Last,                                /** Last item */
};

/** 
Multi level calibration - grid mode
*/
enum MultiLevelCalibrationGridMode
{
    MultiLevelCalibrationGridMode_Grid,                              /** Grid without diffuse light */
    MultiLevelCalibrationGridMode_GridDiffuseLight,                  /** Grid with diffuse light */
    MultiLevelCalibrationGridMode_GridPlane,                         /** Grid without diffuse light + plane */
    MultiLevelCalibrationGridMode_GridDiffuseLightPlane,             /** Grid with diffuse light + plane */
    MultiLevelCalibrationGridMode_GridColorYellowPurple,             /** Grid with color yellow / purple */

    MultiLevelCalibrationGridMode_Last,                              /** Last item */
};

/**
Multi level calibration - system calibration mode
*/
enum MultiLevelCalibrationSysCalibMode
{
    MultiLevelCalibrationSysCalibMode_TeleCyl,                      /** Telecentric lenses with cylinder (measuring field < 5x5 cm²) */
    MultiLevelCalibrationSysCalibMode_TeleGroove,                   /** Telecentric lenses with groove (measuring field < 20x20 cm²) */
    MultiLevelCalibrationSysCalibMode_TeleGroovePlane,              /** Telecentric lenses with groove and additional plane (measuring field < 20x20 cm²) */
    MultiLevelCalibrationSysCalibMode_TeleGrooveMultiPlane,         /** Telecentric lenses with groove and multiple planes (measuring field > 20x20 cm²) */
    MultiLevelCalibrationSysCalibMode_2Planes,                      /** Normal lenses with 2 parallel planes */
    MultiLevelCalibrationSysCalibMode_MultiPlane,                   /** Normal lenses with multiple planes */
    MultiLevelCalibrationSysCalibMode_MultiPlaneCorr,               /** Normal lenses with multiple planes + plane correction */
    MultiLevelCalibrationSysCalibMode_MultiPlaneCorrParallelZCorr,  /** Normal lenses with multiple planes + plane correction + parallel planes + Z correction */
    MultiLevelCalibrationSysCalibMode_MultiPlaneParallelZCorr,      /** Normal lenses with multiple planes + parallel planes + Z correction */

    MultiLevelCalibrationSysCalibMode_Last,                         /** Last item */
};

/**
Multi level calibration - camera mirror mode
*/
enum MultiLevelCalibrationCameraMirrorMode
{
    MultiLevelCalibrationCameraMirrorMode_None,                     /** No mirroring */
    MultiLevelCalibrationCameraMirrorMode_Hor,                      /** Mirroring in horizontal direction */
    MultiLevelCalibrationCameraMirrorMode_Vert,                     /** Mirroring in vertical direction */
    MultiLevelCalibrationCameraMirrorMode_Rot180,                   /** Rotation 180° */
    MultiLevelCalibrationCameraMirrorMode_Mirror90Left,             /** Mirroring + rotation 90° anticlockwise */
    MultiLevelCalibrationCameraMirrorMode_90Left,                   /** Rotation 90° anticlockwise */
    MultiLevelCalibrationCameraMirrorMode_90Right,                  /** Rotation 90° clockwise */
    MultiLevelCalibrationCameraMirrorMode_Mirror90Right,            /** Mirroring + rotation 90° clockwise */

    MultiLevelCalibrationCameraMirrorMode_Last,                     /** Last item */
};

/**
Multi level calibration - sensor texture mode
*/
enum MultiLevelCalibrationTextureMode
{
    MultiLevelCalibrationTextureMode_None,                          /**  No texture */
    MultiLevelCalibrationTextureMode_Gray,                          /**  Texture gray */
    MultiLevelCalibrationTextureMode_Color,                         /**  Texture colored */
    MultiLevelCalibrationTextureMode_Extern,                        /**  Texture external */

    MultiLevelCalibrationTextureMode_Last,                          /** Last item */
};

#endif // _SimpleCalibrationExport_h