Sync docs from develop

Author: jlblancoc

doc/CrossCompilingMRPT.md

@@ -38,7 +38,6 @@ cmake -S. -Bbuild-cross-arm \
   -DCMAKE_TOOLCHAIN_FILE=doc/toolchain-gcc8-arm.cmake \
   -DMRPT_EIGEN_USE_EMBEDDED_VERSION=ON \
   -DDISABLE_ASSIMP=ON \
-  -DDISABLE_ROS=ON \
   -DDISABLE_WXWIDGETS=ON \
   -DMRPT_BUILD_APPLICATIONS=OFF \
   -DMRPT_BUILD_EXAMPLES=OFF \

doc/man-pages/CMakeLists.txt

@@ -78,7 +78,6 @@ if (PROG_GZIP AND PROG_POD2MAN AND MRPT_BUILD_MANPAGES)
 	CREATE_MANPAGE_PROJECT(benchmarking-image-features)
 	CREATE_MANPAGE_PROJECT(yaml2ini)
 	CREATE_MANPAGE_PROJECT(ini2yaml)
-	CREATE_MANPAGE_PROJECT(rosbag2rawlog)
 	CREATE_MANPAGE_PROJECT(mrpt-performance)
 	CREATE_MANPAGE_PROJECT(3d-rotation-converter)
 	CREATE_MANPAGE_PROJECT(ros-map-yaml2mrpt)

doc/man-pages/pod/rosbag2rawlog.pod

@@ -5,7 +5,7 @@ charset-normalizer==3.2.0
 docutils==0.17.1
 idna==3.7
 imagesize==1.4.1
-Jinja2==3.1.5
+Jinja2==3.1.6
 latexcodec==2.0.1
 m2r2==0.3.2
 MarkupSafe==2.1.3
@@ -15,7 +15,7 @@ pybtex==0.24.0
 pybtex-docutils==1.0.3
 Pygments==2.16.1
 PyYAML==6.0.1
-requests==2.32.0
+requests==2.32.4
 six==1.16.0
 snowballstemmer==2.2.0
 Sphinx==5.3.0
@@ -29,4 +29,4 @@ sphinxcontrib-jquery==4.1
 sphinxcontrib-jsmath==1.0.1
 sphinxcontrib-qthelp==1.0.6
 sphinxcontrib-serializinghtml==1.1.9
-urllib3==2.2.2
+urllib3==2.5.0

doc/requirements.txt

@@ -33,8 +33,9 @@ Minimum compiler requisites:
     
        # All Ubuntu versions:
        sudo apt install build-essential pkg-config cmake \
-         libeigen3-dev zlib1g-dev
-
+         libopencv-dev libeigen3-dev zlib1g-dev \
+         libsuitesparse-dev libjpeg-dev
+         
        # plus, only for Ubuntu < 22.10:
        sudo apt install libwxgtk3.0-gtk3-dev
 
@@ -64,23 +65,6 @@ Minimum compiler requisites:
     If your Ubuntu distribution is old and does not have any of the packages
     above, do not worry and ignore it, MRPT CMake scripts will handle it.
 
-    **ROS1 support:** Install additional dependencies for ros1bridge using
-    official Ubuntu repositories. If you already have a ROS distribution installed,
-    doing ``source /opt/ros/xxx/setup.bash`` is enough, no further packages
-    must be installed. Do not install these packages if you do not need
-    the `mrpt::ros1bridge <group_mrpt_ros1bridge_grp.html>`_ module.
-
-    .. code-block:: bash
-
-       sudo apt install libcv-bridge-dev libgeometry-msgs-dev libnav-msgs-dev \
-            librosbag-storage-dev libroscpp-dev libsensor-msgs-dev \
-    		libstd-srvs-dev libstereo-msgs-dev libtf2-dev \
-    		libtf2-msgs-dev libbz2-dev
-
-    **ROS2 support:** Invoke your ROS2 distribution ``setup.bash`` as usual before
-    running MRPT cmake configure to enable building of
-    the `mrpt::ros2bridge <group_mrpt_ros2bridge_grp.html>`_ module.
-
 .. dropdown:: Windows
 
     **CMake (Mandatory)**
@@ -126,6 +110,12 @@ Minimum compiler requisites:
            nmake -f makefile.vc BUILD=release SHARED=1 RUNTIME_LIBS=dynamic DEBUG_INFO=0 VENDOR=mrpt USE_OPENGL=1 TARGET_CPU=amd64
            nmake -f makefile.vc BUILD=debug SHARED=1 RUNTIME_LIBS=dynamic DEBUG_INFO=1 VENDOR=mrpt USE_OPENGL=1 TARGET_CPU=amd64
 
+    **OpenCV (Optional, but strongly recommended)**
+
+    Download the `latest OpenCV release <https://github.com/opencv/opencv/releases/latest>`_
+    either as source code and compile it, or (easier) install the provided
+    ``opencv-x.y.z-vcZZ.exe`` installer.
+
     **FFmpeg for Win32 (Optional)**
 
     These libraries are optional, you will need them only if you plan to read
@@ -192,8 +182,11 @@ For all platforms/compilers:
 - ``MRPT_WITH_KINECT``: By default ON. Uncheck if you don’t have the required dependencies (read above for your OS).
 - ``BUILD_SHARED_LIBS``: Build static libraries if set to OFF, or dynamic libraries (.so/.dll) otherwise. Default is ON, and it’s strongly recommended to always use shared libs unless you have special need for static ones.
 - ``MRPT_EIGEN_USE_EMBEDDED_VERSION``: By default O, instructs MRPT to use the Eigen headers in MRPT/otherlibs/eigen3/. Uncheck if you have Eigen installed in the system and it’s visible through pkg-config. It’s recommended to uncheck this option if you have eigen3 installed in your system (today, eigen3 it’s not yet in any distro repository, that’s why it’s ON by default).
+- ``MRPT_ALWAYS_CHECKS_DEBUG``: If set to ON, additional security checks will be performed at run-time in many classes. Default is OFF.
+- ``MRPT_ALWAYS_CHECKS_DEBUG_MATRICES``: If set to ON, additional security checks will be performed at run-time in several Matrix operations. Default is ON.
 - ``MRPT_ENABLE_EMBEDDED_ENABLED_PROFILER``: If enabled, all code blocks within macros "MRPT_BEGIN/MRPT_END" will be profiled and the statistics dumped to the console at the end of execution of any program. Default is OFF.
 - ``MRPT_HAS_ASIAN_FONTS``: Enables Asian fonts in mrpt::img::CCanvas (see this page), but increases library size by 1.5Mb. Default is ON.
+- ``MRPT_HAS_SVS``: To enable integration of the Videre SVS libraries to interface their stereo cameras. You’ll need the vendor libraries installed in the system before to enable this option. After setting this option to “ON”, the new configuration fields “SVS_ROOT_DIR” will appear and will be tried to be set pointing to the directory where the library is (As of Aug/2010, this option only works in GNU/Linux).
 - ``MRPT_OCCUPANCY_GRID_CELLSIZE``: Can be either 8 or 16 (bits). The size of each cell in the class mrpt::slam::COccupancyGridMap2D. Default is 8 bits. More on this here.
 
 For Windows only:

doc/source/compiling.rst

@@ -1,7 +1,58 @@
 \page changelog Change Log
 
-# Version 2.14.8: UNRELEASED
-(None yet)
+# Version 2.15.0: UNRELEASED
+- None yet
+
+# Version 2.14.16: Released Oct 15th, 2025
+- Changes in libraries:
+  - \ref mrpt_rtti_grp
+    - More informative error message when calling clone() on a class without copy constructor.
+- BUG FIXES:
+  - Fix build building deprecated warnings in WorkerThreadsPool.
+  - Fix mrpt::opengl::CPointCloudColoured throwing if the source cloud map may have color and color/intensity channels are actually empty.
+
+# Version 2.14.15: Released Sep 29th, 2025
+- BUG FIXES:
+  - Fix regression in OpenGL application crashing after last update.
+
+# Version 2.14.14: Released Sep 27th, 2025
+- BUG FIXES:
+  - Fix missing backported fix to build mrpt::lockHelper() on modern gcc
+  - Fix OpenGL crashes under specific build flags: OpenGL Buffers and VBO changed so they are initialized after constructor.
+
+# Version 2.14.13: Released Sep 27th, 2025
+- Changes in libraries:
+  - \ref mrpt_math_grp
+    - New classes mrpt::math::TOrientedBox, mrpt::math::TOrientedBoxf
+- BUG FIXES:
+  - Fix mrpt::opengl::CEllipsoid3D wrong direction.
+  - Fix potential race conditions in TBB-parallel particle filters with 2D gridmap.
+  - Harden opengl unit tests against crashes on non-GPU runners.
+  - Fix build against ffmpeg 8.0 (Debian bug #1115064)
+
+# Version 2.14.12: Released Aug 31rd, 2025
+- Changes in libraries:
+  - \ref mrpt_opengl_grp
+    - New method mrpt::opengl::CPointCloudColoured::setAllPointsAlpha().
+
+# Version 2.14.11: Released May 31rd, 2025
+- BUG FIXES:
+  - Fix build against all tf2 versions in all active ROS 2 distributions.
+
+# Version 2.14.10: Released May 23rd, 2025
+- BUG FIXES:
+  - Fix build in ROS rolling: ``Unknown CMake command "ament_target_dependencies".``
+
+# Version 2.14.9: Released May 17th, 2025
+- BUG FIXES:
+  - Fix build with latest tf2 version.
+
+# Version 2.14.8: Released Apr 25th, 2025
+- Build system:
+  - Fix build w/o OpenCV.
+- BUG FIXES:
+  - RawLogViewer scan matching module GUI was broken.
+  - CCameraSensor would crash at the end of a video file input.
 
 # Version 2.14.7: Released Dec 9th, 2024
 - Changes in apps:

doc/source/doxygen-docs/changelog.md

@@ -57,7 +57,8 @@ numerical value (e.g. ``1``) will be interpreted as "true".
 
 - ``MRPT_WXSUBSYS_TIMEOUT_MS``: The timeout in milliseconds to wait
   in mrpt::gui windows constructors until the wxWidgets thread processes and
-  really creates the window, before reporting an error.
+  really creates the window, before reporting an error. It's also used in
+  the function mrpt::hwdrivers::prepareVideoSourceFromUserSelection().
   Default: ``5000`` in Release builds, ``30000`` in Debug builds.
 
 - ``MRPT_YAML_PARSER_VERBOSE``: Set to ``1`` to show verbose debug information

doc/source/env-vars.rst

@@ -42,8 +42,6 @@ Each MRPT library source code can be found under ``${MRPT_ROOT}/libs``.
   group_mrpt_opengl_grp.rst
   group_mrpt_poses_grp.rst
   group_mrpt_random_grp.rst
-  group_mrpt_ros1bridge_grp.rst
-  group_mrpt_ros2bridge_grp.rst
   group_mrpt_round.rst
   group_mrpt_rtti_grp.rst
   group_mrpt_serialization_grp.rst