add ovphysx 0.3.7 docs

Author: jcarius-nv

ovphysx/0.3.7/SECURITY.html

@@ -0,0 +1 @@
+0.3.7

ovphysx/0.3.7/VERSION

@@ -0,0 +1,99 @@
+// SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+// SPDX-License-Identifier: BSD-3-Clause
+//
+
+#ifndef OVPHYSX_EXPERIMENTAL_HELPERS_HPP
+#define OVPHYSX_EXPERIMENTAL_HELPERS_HPP
+
+//
+// C++17 Helper utilities for ovphysx C API
+// Provides RAII wrappers and convenience functions for complex operations
+//
+
+#include <string>
+#include <vector>
+#include <cstring>
+
+#include "ovphysx/ovphysx.h"
+
+namespace ovphysx {
+namespace physx {
+
+/**
+ * @brief RAII wrapper for ovphysx_op_wait_result_t
+ * 
+ * Automatically calls ovphysx_destroy_wait_result when destroyed.
+ * Use get() to pass to ovphysx_wait_op.
+ *
+ * Example:
+ *   WaitResult wait;
+ *   ovphysx_result_t r = ovphysx_wait_op(handle, op_index, timeout, wait.get());
+ *
+ *   if (wait.hasErrors()) {
+ *       for (size_t i = 0; i < wait.errorCount(); ++i) {
+ *           ovphysx_string_t err = ovphysx_get_last_op_error(wait.errorOpIndexAt(i));
+ *           std::cerr << "Op " << wait.errorOpIndexAt(i) << " failed: "
+ *                     << std::string(err.ptr, err.length) << std::endl;
+ *       }
+ *   }
+ *   // wait result freed automatically when wait goes out of scope
+ */
+class WaitResult {
+public:
+    WaitResult() : m_result{} {}
+    
+    ~WaitResult() {
+        release();
+    }
+    
+    WaitResult(WaitResult&& other) noexcept : m_result(other.m_result) {
+        other.m_result = ovphysx_op_wait_result_t{};
+    }
+    
+    WaitResult& operator=(WaitResult&& other) noexcept {
+        if (this != &other) {
+            release();
+            m_result = other.m_result;
+            other.m_result = ovphysx_op_wait_result_t{};
+        }
+        return *this;
+    }
+    
+    // Non-copyable
+    WaitResult(const WaitResult&) = delete;
+    WaitResult& operator=(const WaitResult&) = delete;
+    
+    /// Get pointer to underlying result (pass to ovphysx_wait_op)
+    ovphysx_op_wait_result_t* get() { return &m_result; }
+    const ovphysx_op_wait_result_t* get() const { return &m_result; }
+    
+    /// Check if there were any errors
+    bool hasErrors() const { return m_result.num_errors > 0; }
+    
+    /// Number of errors
+    size_t errorCount() const { return m_result.num_errors; }
+    
+    /// Get lowest pending operation index (0 if all complete)
+    ovphysx_op_index_t lowestPendingOpIndex() const { return m_result.lowest_pending_op_index; }
+    
+    /// Get the failed operation index at position i
+    ovphysx_op_index_t errorOpIndexAt(size_t i) const {
+        if (m_result.error_op_indices && i < m_result.num_errors) {
+            return m_result.error_op_indices[i];
+        }
+        return 0;
+    }
+
+private:
+    void release() {
+        ovphysx_destroy_wait_result(&m_result);
+        m_result = ovphysx_op_wait_result_t{};
+    }
+    
+    ovphysx_op_wait_result_t m_result;
+};
+
+} // namespace physx
+} // namespace ovphysx
+
+#endif // OVPHYSX_EXPERIMENTAL_HELPERS_HPP