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

@@ -541,6 +541,7 @@ ADD_PLUGIN(Calendars 1)
 ADD_PLUGIN(Exoplanets 1)
 ADD_PLUGIN(EquationOfTime 1)
 ADD_PLUGIN(MeteorShowers 1)
+ADD_PLUGIN(MosaicCamera 1)
 ADD_PLUGIN(MissingStars 1)
 ADD_PLUGIN(NavStars 1)
 ADD_PLUGIN(Novae 1)

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.