// ---------------------------------------------------------------------------- // - Open3D: www.open3d.org - // ---------------------------------------------------------------------------- // The MIT License (MIT) // // Copyright (c) 2018 www.open3d.org // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS // IN THE SOFTWARE. // ---------------------------------------------------------------------------- #pragma once #include #include "Open3D/Utility/IJsonConvertible.h" namespace open3d { namespace camera { /// \enum PinholeCameraIntrinsicParameters /// /// \brief Sets default camera intrinsic parameters for sensors. enum class PinholeCameraIntrinsicParameters { /// Default settings for PrimeSense camera sensor. PrimeSenseDefault = 0, /// Default settings for Kinect2 depth camera. Kinect2DepthCameraDefault = 1, /// Default settings for Kinect2 color camera. Kinect2ColorCameraDefault = 2, }; /// \class PinholeCameraIntrinsic /// /// \brief Contains the pinhole camera intrinsic parameters. class PinholeCameraIntrinsic : public utility::IJsonConvertible { public: /// \brief Default Constructor. PinholeCameraIntrinsic(); /// \brief Parameterized Constructor. /// /// \param param Sets the camera parameters to /// the default settings of one of the sensors. PinholeCameraIntrinsic(PinholeCameraIntrinsicParameters param); /// \brief Parameterized Constructor. /// /// \param width width of the image. /// \param height height of the image. /// \param fx focal length along the X-axis. /// \param fy focal length along the Y-axis. /// \param cx principal point of the X-axis. /// \param cy principal point of the Y-axis. PinholeCameraIntrinsic( int width, int height, double fx, double fy, double cx, double cy); ~PinholeCameraIntrinsic() override; public: /// \brief Set camera intrinsic parameters. /// /// \param width - width of the image. /// \param height - height of the image. /// \param fx - focal length along the X-axis. /// \param fy - focal length along the Y-axis. /// \param cx - principal point of the X-axis. /// \param cy - principal point of the Y-axis. void SetIntrinsics( int width, int height, double fx, double fy, double cx, double cy) { width_ = width; height_ = height; intrinsic_matrix_.setIdentity(); intrinsic_matrix_(0, 0) = fx; intrinsic_matrix_(1, 1) = fy; intrinsic_matrix_(0, 2) = cx; intrinsic_matrix_(1, 2) = cy; } /// Returns the focal length in a tuple of X-axis and Y-axis focal lengths. std::pair GetFocalLength() const { return std::make_pair(intrinsic_matrix_(0, 0), intrinsic_matrix_(1, 1)); } /// Returns the principle point in a tuple of X-axis and Y-axis principle /// point. std::pair GetPrincipalPoint() const { return std::make_pair(intrinsic_matrix_(0, 2), intrinsic_matrix_(1, 2)); } /// Returns the skew. double GetSkew() const { return intrinsic_matrix_(0, 1); } /// Returns `true` iff both the width and height are greater than 0. bool IsValid() const { return (width_ > 0 && height_ > 0); } bool ConvertToJsonValue(Json::Value &value) const override; bool ConvertFromJsonValue(const Json::Value &value) override; public: /// Width of the image. int width_ = -1; /// Height of the image. int height_ = -1; /// 3x3 matrix. \n /// Intrinsic camera matrix:\n ///``[[fx, 0, cx],``\n ///`` [0, fy, cy],``\n ///`` [0, 0, 1]]`` Eigen::Matrix3d intrinsic_matrix_; }; } // namespace camera } // namespace open3d