Add Camera Mosaic plugin

BUILDING.md

@@ -415,6 +415,7 @@ List of supported parameters (passed as `-DPARAMETER=VALUE`):
 | USE_PLUGIN_LENSDISTORTIONESTIMATOR | bool   | ON      | Enable building the Lens Distortion Estimator plugin
 | USE_PLUGIN_METEORSHOWERS           | bool   | ON      | Enable building the Meteor Showers plugin
 | USE_PLUGIN_MISSINGSTARS            | bool   | ON      | Enable building the Missing Stars plugin
+| USE_PLUGIN_MOSAICCAMERA            | bool   | OFF     | Enable building the Mosaic Camera plugin
 | USE_PLUGIN_NAVSTARS                | bool   | ON      | Enable building the Navigational Stars plugin
 | USE_PLUGIN_NOVAE                   | bool   | ON      | Enable building the Bright Novae plugin
 | USE_PLUGIN_OBSERVABILITY           | bool   | ON      | Enable building the Observability Analysis plugin

CMakeLists.txt

@@ -150,8 +150,8 @@ IF(${CMAKE_BUILD_TYPE} MATCHES "Debug")
                APPEND_COVERAGE_COMPILER_FLAGS()
                MESSAGE(STATUS "Found lcov ${LCOV_PATH} (enable coverage support)")
                SETUP_TARGET_FOR_COVERAGE_LCOV(
-                    NAME coverage 
-                    EXECUTABLE ctest -j ${PROCESSOR_COUNT} 
+                    NAME coverage
+                    EXECUTABLE ctest -j ${PROCESSOR_COUNT}
                     DEPENDENCIES buildTests
                )
           ENDIF()
@@ -174,7 +174,7 @@ ELSE()
           EXECUTE_PROCESS(COMMAND ${GIT_EXECUTABLE} describe --tags --abbrev=0 WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR} TIMEOUT 30 OUTPUT_VARIABLE GIT_TAGS OUTPUT_STRIP_TRAILING_WHITESPACE ERROR_VARIABLE GIT_ERROR)
 	  IF(GIT_REVISION)
                # Let's use short hash in all cases
-               STRING(SUBSTRING ${GIT_REVISION} 0 7 REVISION)               
+               STRING(SUBSTRING ${GIT_REVISION} 0 7 REVISION)
 	       ADD_DEFINITIONS(-DGIT_REVISION="${REVISION}")
                ADD_DEFINITIONS(-DGIT_BRANCH="${GIT_BRANCH}")
 	  ENDIF()
@@ -371,7 +371,7 @@ IF("${CMAKE_CXX_COMPILER_ID}" MATCHES "Clang")
 ENDIF()
 
 # FreeBSD-specific compiler flags
-# resolve bug for FreeBSD/amd64 and NVIDIA proprietary drivers 
+# resolve bug for FreeBSD/amd64 and NVIDIA proprietary drivers
 IF(${CMAKE_SYSTEM_NAME} STREQUAL "FreeBSD")
      # Use -pthread compilation option to properly link to threading library
      SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -pthread -Wno-unused-local-typedefs")
@@ -544,6 +544,7 @@ ADD_PLUGIN(Calendars 1)
 ADD_PLUGIN(Exoplanets 1)
 ADD_PLUGIN(EquationOfTime 1)
 ADD_PLUGIN(MeteorShowers 1)
+ADD_PLUGIN(MosaicCamera 1)
 ADD_PLUGIN(NavStars 1)
 ADD_PLUGIN(Novae 1)
 ADD_PLUGIN(Observability 1)
@@ -717,7 +718,7 @@ IF(ENABLE_SHOWMYSKY)
         MESSAGE(STATUS "Will build ShowMySky library")
         INCLUDE(GNUInstallDirs)
 	IF(APPLE)
-	    INSTALL(TARGETS ShowMySky LIBRARY DESTINATION Frameworks)	
+	    INSTALL(TARGETS ShowMySky LIBRARY DESTINATION Frameworks)
 	ELSE()
 	    INSTALL(TARGETS ShowMySky
 		    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
@@ -737,7 +738,7 @@ IF(ENABLE_SHOWMYSKY)
         GET_TARGET_PROPERTY(ShowMySky_LIBRARY
             ShowMySky::ShowMySky LOCATION)
         IF(EXISTS ${ShowMySky_LIBRARY})
-            MESSAGE(STATUS "Found ShowMySky library: ${ShowMySky_LIBRARY}")	    
+            MESSAGE(STATUS "Found ShowMySky library: ${ShowMySky_LIBRARY}")
         ELSE()
             MESSAGE(FATAL_ERROR "Could NOT found ShowMySky library")
         ENDIF()
@@ -856,7 +857,7 @@ IF(UNIX AND NOT WIN32)
      IF(APPLE)
           SET(CMAKE_INSTALL_PREFIX "${PROJECT_BINARY_DIR}/Stellarium.app/Contents")
      ELSE()
-          ADD_DEFINITIONS(-DINSTALL_DATADIR="${CMAKE_INSTALL_PREFIX}/${SDATALOC}")          
+          ADD_DEFINITIONS(-DINSTALL_DATADIR="${CMAKE_INSTALL_PREFIX}/${SDATALOC}")
           # Used in generating the documentation (doc/stellarium.pod.cmake):
           SET(INSTALL_DATADIR "${CMAKE_INSTALL_PREFIX}/${SDATALOC}")
      ENDIF()

plugins/MosaicCamera/CMakeLists.txt

@@ -0,0 +1,14 @@
+# This is the cmake config file for the MosaicCamera
+SET(MOSAICCAMERA_VERSION "0.0.0")
+ADD_DEFINITIONS(-DBUILD_DYNAMIC_PLUGIN=0)
+ADD_DEFINITIONS(-DMOSAICCAMERA_PLUGIN_VERSION="${MOSAICCAMERA_VERSION}")
+ADD_DEFINITIONS(-DMOSAICCAMERA_PLUGIN_LICENSE="GNU GPLv2 or later")
+
+ADD_SUBDIRECTORY( src )
+
+IF(APPLE)
+     SET(CMAKE_INSTALL_PREFIX $ENV{HOME}/Library/Application\ Support/Stellarium)
+ElSE(APPLE)
+     SET(CMAKE_INSTALL_PREFIX $ENV{HOME}/.stellarium)
+ENDIF(APPLE)
+INSTALL(FILES DESTINATION "modules/MosaicCamera")

plugins/MosaicCamera/ChangeLog

@@ -0,0 +1,2 @@
+0.0.0 [2024-12-10]
+Created basic plugin

plugins/MosaicCamera/README

@@ -0,0 +1,68 @@
+Mosaic Camera Overlay Stellarium plugin
+=======================================
+
+Overlays mosaic camera sensor outlines on the Stellarium celestial sphere.
+
+Available Cameras
+=================
+
+Built-in cameras include:
+  LSSTCam : https://www.lsst.org/about/camera
+  HSC : https://www.naoj.org/Projects/HSC/
+  DECam : https://www.darkenergysurvey.org/the-des-project/instrument/the-camera/
+  MegaPrime : https://www.cfht.hawaii.edu/Instruments/Imaging/Megacam/
+  Latiss : https://noirlab.edu/public/programs/vera-c-rubin-observatory/rubin-auxtel/
+
+Camera sensors are specified via their corners, which are assumed to form spherical
+polygons.  The corners should be specified as gnomonic projections from the sphere to a
+tangent plane in radians.  Multiple groups of sensors can compose the same camera.  For
+example, LSSTCam has separate sensor groups for wavefront sensors, guider sensors, and
+each of two types of science sensors.
+
+Each camera is defined via a JSON file with the structure:
+
+[
+    {
+        "name": "name-of-group-1",
+        "corners": [
+            [
+                [corner1_x, corner1_y],
+                [corner2_x, corner2_y],
+                ...
+            ], # sensor 1
+            [
+                ...
+            ], # sensor 2
+            ...
+        ]
+        "color": {
+            "value": [R, G, B, alpha]
+        }
+    },
+    {
+        "name": "name-of-group-2",
+        ...
+    },
+    ...
+]
+
+Cameras are loaded according to the order in
+
+camera_order.json
+
+which has the structure:
+{
+    "order": [
+        "LSSTCam",
+        "DECam",
+        ...
+    ]
+}
+
+
+TCP Server
+==========
+The mosaic camera plugin starts a TCP server listening on port 5772.  Messages can be
+sent to the port in the format: "[name],[ra],[dec],[rot]" where [name] is the name of
+one of the cameras, [ra] and [dec] indicate the camera boresight and [rot] the camera
+rotation, all in degrees.