mitkCameraIntrinsics.h

Go to the documentation of this file.

/*============================================================================
 
The Medical Imaging Interaction Toolkit (MITK)
 
Copyright (c) German Cancer Research Center (DKFZ)
All rights reserved.
 
Use of this source code is governed by a 3-clause BSD license that can be
found in the LICENSE file.
 
============================================================================*/
 
 
#ifndef mitkCameraIntrinsics_h
#define mitkCameraIntrinsics_h
 
#include <mitkCommon.h>
#include <mitkNumericTypes.h>
#include <itkDataObject.h>
#include <vnl/vnl_matrix_fixed.h>
#include "mitkXMLSerializable.h"
#include <MitkCameraCalibrationExports.h>
 
#include "opencv2/core.hpp"
 
#include <mutex>
 
int mitkCameraIntrinsicsTest(int, char* []);
 
namespace mitk
{
  class MITKCAMERACALIBRATION_EXPORT CameraIntrinsics: virtual public itk::Object,
    virtual public mitk::XMLSerializable
  {
  public:
    friend int mitkCameraIntrinsicsTest(int argc, char* argv[]);
    mitkClassMacroItkParent(CameraIntrinsics, itk::Object);
    itkFactorylessNewMacro(Self);
 
    itkCloneMacro(Self);
 
    void Copy(const CameraIntrinsics* other);
 
    bool Equals( const CameraIntrinsics* other ) const;
 
    vnl_matrix_fixed<mitk::ScalarType, 3, 3> GetVnlCameraMatrix() const;
 
    vnl_matrix_fixed<mitk::ScalarType, 3, 4> GetVnlCameraMatrix3x4() const;
 
    bool IsValid() const;
    void SetValid(bool valid);
    cv::Mat GetCameraMatrix() const;
    cv::Mat GetDistorsionCoeffs();
    cv::Mat GetDistorsionCoeffs() const;
    void ToXML(tinyxml2::XMLElement* elem) const override;
    std::string ToString() const;
    std::string GetString();
    double GetFocalLengthX() const;
    double GetFocalLengthY() const;
    double GetPrincipalPointX() const;
    double GetPrincipalPointY() const;
    mitk::Point4D GetDistorsionCoeffsAsPoint4D() const;
    mitk::Point3D GetFocalPoint() const;
    mitk::Point3D GetPrincipalPoint() const;
    vnl_vector_fixed<mitk::ScalarType, 2> GetFocalPointAsVnlVector() const;
    vnl_vector_fixed<mitk::ScalarType, 2> GetPrincipalPointAsVnlVector() const;
 
    void SetCameraMatrix( const vnl_matrix_fixed<mitk::ScalarType, 3, 3>&
                        _CameraMatrix );
 
    void SetIntrinsics( const cv::Mat& _CameraMatrix
                        , const cv::Mat& _DistorsionCoeffs);
 
    void SetFocalLength( double x, double y );
    void SetPrincipalPoint( double x, double y );
    void SetDistorsionCoeffs( double k1, double k2, double p1, double p2 );
 
    void SetIntrinsics( const mitk::Point3D& focalPoint,
                        const mitk::Point3D& principalPoint,
                        const mitk::Point4D& distortionCoefficients);
 
    void FromXML(const tinyxml2::XMLElement* elem) override;
    void FromGMLCalibrationXML(const tinyxml2::XMLElement* elem);
    std::string ToOctaveString(const std::string& varName="CameraIntrinsics");
 
    ~CameraIntrinsics() override;
 
  protected:
    CameraIntrinsics();
    CameraIntrinsics(const CameraIntrinsics& other);
 
    cv::Mat m_CameraMatrix;
    cv::Mat m_DistorsionCoeffs;
    bool m_Valid;
    mutable std::mutex m_Mutex;
 
  private:
 
    itk::LightObject::Pointer InternalClone() const override;
  };
 
} // namespace mitk
 
MITKCAMERACALIBRATION_EXPORT std::ostream& operator<<
    (std::ostream& os, mitk::CameraIntrinsics::Pointer p);
 
#endif