···27272828// For implementation: same as IMPLEMENTATION_VERSION_*
2929// For user: expected IMPLEMENTATION_VERSION_*. Should be checked in runtime.
3030-constexpr int HEADER_VERSION_MAJOR = 2; //!< API Breakages
3030+constexpr int HEADER_VERSION_MAJOR = 3; //!< API Breakages
3131constexpr int HEADER_VERSION_MINOR = 0; //!< Backwards compatible API changes
3232constexpr int HEADER_VERSION_PATCH = 0; //!< Backw. comp. .h-implemented changes
3333···185185 constexpr int FID_##SHORT_NAME = ID; \
186186 constexpr int F_##NAME = ID;
187187188188+/*!
189189+ * Container of parameters for a pinhole camera calibration (fx, fy, cx, cy)
190190+ * with an optional distortion.
191191+ *
192192+ *`distortion_model` and its corresponding `distortion` parameters are not
193193+ * standardized in this struct to facilitate implementation prototyping.
194194+ */
188195struct cam_calibration {
189189- enum class cam_model { pinhole, fisheye };
190190-191196 int cam_index; //!< For multi-camera setups. For stereo 0 ~ left, 1 ~ right.
192192- int width, height; //<! Resolution
193193- double frequency; //<! Frames per second
194194- double fx, fy; //<! Focal point
195195- double cx, cy; //<! Principal point
196196- cam_model model;
197197- std::vector<double> model_params;
198198- cv::Matx<double, 4, 4> T_cam_imu; //!< Transformation from camera to imu space
197197+ int width, height; //<! Resolution
198198+ double frequency; //<! Frames per second
199199+ double fx, fy; //<! Focal point
200200+ double cx, cy; //<! Principal point
201201+ std::string distortion_model; //!< Models like: none, rt4, rt5, rt8, kb4
202202+ std::vector<double> distortion; //!< Parameters for the distortion_model
203203+ cv::Matx<double, 4, 4> t_imu_cam; //!< Transformation from IMU to camera
199204};
200205201206struct inertial_calibration {
···204209 //! This transform will be applied to raw measurements.
205210 cv::Matx<double, 3, 3> transform;
206211207207- //! Offset to apply to raw measurements to; called bias in other contexts.
212212+ //! Offset to add to raw measurements to; called bias in other contexts.
208213 cv::Matx<double, 3, 1> offset;
209214210215 // Parameters for the random processes that model this IMU. See section "2.1