[1.3.50] 2025-09-22

- Updated PugiXML library from version 1.7 to 1.15 with compact mode and XPath disabled for improved performance

- Fixed a bug in `Context::loadOBJ()` where materials that have a texture mask (`map_d`) and a diffuse color `Kd` were not being loaded correctly. The texture was being applied but it was using the default color.
- Fixed a bug where copied primitives with texture color overridden were not copying the constant RGB color.
- Enhanced OBJ/MTL loading system with improved default color handling in `loadMTL()` function
- Added `isDirectoryPath()` utility function to distinguish between directory and file paths using multiple heuristics

- Fixed a bug that could cause plant parameter contamination between different plant types in the scene.
- Added Bougainvillea flower 3D model assets (OBJ/MTL files and Blender source)
- Updated strawberry and tomato fruit models with improved geometry
- Enhanced documentation with collision detection schematics and perception cone diagrams

- Fixes to headless rendering mode, including ability to save images without opening a window
- Significant changes to front/back buffer detection hopefully to fix issues with `Visualizer::printWindow()` producing black images. Automated tests added for this in headless and windowed mode.
- Improved shader management and geometry handling
- Enhanced documentation with updated API references

- Updates to RadiationCamera file path discovery to check whether the file is a directory or file, and handle accordingly

Author: bnbailey-psl

core/include/Context.h

@@ -2262,7 +2262,7 @@ namespace helios {
             OBJmaterial(const RGBcolor &a_color, std::string a_texture, uint a_materialID) : color{a_color}, texture{std::move(a_texture)}, materialID{a_materialID} {};
         };
 
-        std::map<std::string, OBJmaterial> loadMTL(const std::string &filebase, const std::string &material_file);
+        std::map<std::string, OBJmaterial> loadMTL(const std::string &filebase, const std::string &material_file, const RGBcolor &default_color);
 
         void loadPData(pugi::xml_node p, uint UUID);
 

core/include/global.h

@@ -1169,6 +1169,14 @@ namespace helios {
      */
     [[nodiscard]] bool validateOutputPath(std::string &output_directory, const std::vector<std::string> &allowable_file_extensions = {});
 
+    //! Check whether a path string represents a directory path (as opposed to a file path)
+    /**
+     * \param[in] path String containing the path to check
+     * \return True if the path represents a directory, false if it represents a file
+     * \note This function uses multiple heuristics: trailing slash, existing filesystem paths, and common file extensions
+     */
+    [[nodiscard]] bool isDirectoryPath(const std::string &path);
+
     //--------------------- ASSET PATH RESOLUTION -----------------------------------//
 
     //! Resolve asset file path using cpplocate, allowing executables to run from any directory

core/lib/pugixml/pugiconfig.hpp

@@ -1,14 +1,12 @@
 /**
- * pugixml parser - version 1.7
+ * pugixml parser - version 1.15
  * --------------------------------------------------------
- * Copyright (C) 2006-2015, by Arseny Kapoulkine (arseny.kapoulkine@gmail.com)
- * Report bugs and download new versions at http://pugixml.org/
+ * Report bugs and download new versions at https://pugixml.org/
  *
- * This library is distributed under the MIT License. See notice at the end
- * of this file.
+ * SPDX-FileCopyrightText: Copyright (C) 2006-2025, by Arseny Kapoulkine (arseny.kapoulkine@gmail.com)
+ * SPDX-License-Identifier: MIT
  *
- * This work is based on the pugxml parser, which is:
- * Copyright (C) 2003, by Kristen Wegner (kristen@tima.net)
+ * See LICENSE.md or notice at the end of this file.
  */
 
 #ifndef HEADER_PUGICONFIG_HPP
@@ -18,10 +16,10 @@
 // #define PUGIXML_WCHAR_MODE
 
 // Uncomment this to enable compact mode
-// #define PUGIXML_COMPACT
+#define PUGIXML_COMPACT
 
 // Uncomment this to disable XPath
-// #define PUGIXML_NO_XPATH
+#define PUGIXML_NO_XPATH
 
 // Uncomment this to disable STL
 // #define PUGIXML_NO_STL
@@ -40,16 +38,22 @@
 // #define PUGIXML_MEMORY_OUTPUT_STACK 10240
 // #define PUGIXML_MEMORY_XPATH_PAGE_SIZE 4096
 
+// Tune this constant to adjust max nesting for XPath queries
+// #define PUGIXML_XPATH_DEPTH_LIMIT 1024
+
 // Uncomment this to switch to header-only version
 // #define PUGIXML_HEADER_ONLY
 
-// Uncomment this to enable long long support
+// Uncomment this to enable long long support (usually enabled automatically)
 // #define PUGIXML_HAS_LONG_LONG
 
+// Uncomment this to enable support for std::string_view (usually enabled automatically)
+// #define PUGIXML_HAS_STRING_VIEW
+
 #endif
 
 /**
- * Copyright (c) 2006-2015 Arseny Kapoulkine
+ * Copyright (c) 2006-2025 Arseny Kapoulkine
  *
  * Permission is hereby granted, free of charge, to any person
  * obtaining a copy of this software and associated documentation
@@ -62,7 +66,7 @@
  *
  * 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