Add feature to bake down from SceneGraph to FlatScene.

A EvaluationObjects object was added to store all required nodes for
evaluation, rather than using 'rust::Vec' in C++ because it appears
it wont link to the library.

Link against 'Bcrypt' library because from Rust 1.57+ it's now required.
rust-lang/rust#91974

Issue #114.

Author: david-cattermole

src/mmscenegraph/cppbind/include/mmscenegraph/_cxxbridge.h

@@ -816,6 +816,8 @@ namespace mmscenegraph {
   struct MarkerNode;
   struct ShimAttrDataBlock;
   struct ShimSceneGraph;
+  struct ShimFlatScene;
+  struct ShimEvaluationObjects;
   struct Camera;
 }
 
@@ -1082,6 +1084,7 @@ struct ShimSceneGraph final : public ::rust::Opaque {
   MMSCENEGRAPH_API_EXPORT ::mmscenegraph::MarkerNode create_marker_node(::mmscenegraph::MarkerAttrIds marker_attrs) noexcept;
   MMSCENEGRAPH_API_EXPORT bool link_marker_to_camera(::mmscenegraph::NodeId mkr_node_id, ::mmscenegraph::NodeId cam_node_id) noexcept;
   MMSCENEGRAPH_API_EXPORT bool link_marker_to_bundle(::mmscenegraph::NodeId mkr_node_id, ::mmscenegraph::NodeId bnd_node_id) noexcept;
+  MMSCENEGRAPH_API_EXPORT bool set_node_parent(::mmscenegraph::NodeId child_node_id, ::mmscenegraph::NodeId parent_node_id) noexcept;
   ~ShimSceneGraph() = delete;
 
 private:
@@ -1093,6 +1096,45 @@ struct ShimSceneGraph final : public ::rust::Opaque {
 };
 #endif // CXXBRIDGE1_STRUCT_mmscenegraph$ShimSceneGraph
 
+#ifndef CXXBRIDGE1_STRUCT_mmscenegraph$ShimFlatScene
+#define CXXBRIDGE1_STRUCT_mmscenegraph$ShimFlatScene
+struct ShimFlatScene final : public ::rust::Opaque {
+  MMSCENEGRAPH_API_EXPORT void evaluate(const ::mmscenegraph::ShimAttrDataBlock &attrdb, ::rust::Slice<const ::std::uint32_t> frame_list) noexcept;
+  ~ShimFlatScene() = delete;
+
+private:
+  friend ::rust::layout;
+  struct layout {
+    static ::std::size_t size() noexcept;
+    static ::std::size_t align() noexcept;
+  };
+};
+#endif // CXXBRIDGE1_STRUCT_mmscenegraph$ShimFlatScene
+
+#ifndef CXXBRIDGE1_STRUCT_mmscenegraph$ShimEvaluationObjects
+#define CXXBRIDGE1_STRUCT_mmscenegraph$ShimEvaluationObjects
+struct ShimEvaluationObjects final : public ::rust::Opaque {
+  MMSCENEGRAPH_API_EXPORT void clear_all() noexcept;
+  MMSCENEGRAPH_API_EXPORT void clear_bundles() noexcept;
+  MMSCENEGRAPH_API_EXPORT void clear_markers() noexcept;
+  MMSCENEGRAPH_API_EXPORT void clear_cameras() noexcept;
+  MMSCENEGRAPH_API_EXPORT ::std::size_t num_bundles() const noexcept;
+  MMSCENEGRAPH_API_EXPORT ::std::size_t num_markers() const noexcept;
+  MMSCENEGRAPH_API_EXPORT ::std::size_t num_cameras() const noexcept;
+  MMSCENEGRAPH_API_EXPORT void add_bundle(const ::mmscenegraph::BundleNode &bnd_node) noexcept;
+  MMSCENEGRAPH_API_EXPORT void add_camera(const ::mmscenegraph::CameraNode &cam_node) noexcept;
+  MMSCENEGRAPH_API_EXPORT void add_marker(const ::mmscenegraph::MarkerNode &mkr_node) noexcept;
+  ~ShimEvaluationObjects() = delete;
+
+private:
+  friend ::rust::layout;
+  struct layout {
+    static ::std::size_t size() noexcept;
+    static ::std::size_t align() noexcept;
+  };
+};
+#endif // CXXBRIDGE1_STRUCT_mmscenegraph$ShimEvaluationObjects
+
 #ifndef CXXBRIDGE1_STRUCT_mmscenegraph$Camera
 #define CXXBRIDGE1_STRUCT_mmscenegraph$Camera
 struct Camera final {
@@ -1113,6 +1155,10 @@ MMSCENEGRAPH_API_EXPORT ::rust::Box<::mmscenegraph::ShimAttrDataBlock> shim_crea
 
 MMSCENEGRAPH_API_EXPORT ::rust::Box<::mmscenegraph::ShimSceneGraph> shim_create_scene_graph_box() noexcept;
 
+MMSCENEGRAPH_API_EXPORT ::rust::Box<::mmscenegraph::ShimFlatScene> shim_bake_scene_graph(const ::rust::Box<::mmscenegraph::ShimSceneGraph> &sg, const ::rust::Box<::mmscenegraph::ShimEvaluationObjects> &eval_objects) noexcept;
+
+MMSCENEGRAPH_API_EXPORT ::rust::Box<::mmscenegraph::ShimEvaluationObjects> shim_create_evaluation_objects_box() noexcept;
+
 MMSCENEGRAPH_API_EXPORT void foo(::std::uint32_t number) noexcept;
 
 MMSCENEGRAPH_API_EXPORT ::std::uint32_t foobar(::std::uint32_t number) noexcept;

src/mmscenegraph/cppbind/include/mmscenegraph/attrdatablock.h

@@ -44,13 +44,26 @@ class AttrDataBlock {
     AttrId create_attr_static(Real value) noexcept;
 
     MMSCENEGRAPH_API_EXPORT
-    AttrId create_attr_anim_dense(rust::Vec<Real> values, FrameValue frame_start) noexcept;
+    AttrId
+    create_attr_anim_dense(
+        rust::Vec<Real> values,
+        FrameValue frame_start
+    ) noexcept;
 
     MMSCENEGRAPH_API_EXPORT
-    Real get_attr_value(AttrId attr_id, FrameValue frame) const noexcept;
+    Real
+    get_attr_value(
+        AttrId attr_id,
+        FrameValue frame
+    ) const noexcept;
 
     MMSCENEGRAPH_API_EXPORT
-    void set_attr_value(AttrId attr_id, FrameValue frame, Real value) noexcept;
+    void
+    set_attr_value(
+        AttrId attr_id,
+        FrameValue frame,
+        Real value
+    ) noexcept;
 
 private:
     rust::Box<ShimAttrDataBlock> inner_;

src/mmscenegraph/cppbind/include/mmscenegraph/evaluationobjects.h

@@ -0,0 +1,76 @@
+/*
+ * Copyright (C) 2020, 2021 David Cattermole.
+ *
+ * This file is part of mmSolver.
+ *
+ * mmSolver is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * mmSolver is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with mmSolver.  If not, see <https://www.gnu.org/licenses/>.
+ * ====================================================================
+ *
+ */
+
+#pragma once
+
+#include <memory>
+#include <string>
+
+#include "_cxx.h"
+#include "_cxxbridge.h"
+#include "_symbol_export.h"
+
+namespace mmscenegraph {
+
+class EvaluationObjects {
+public:
+
+    MMSCENEGRAPH_API_EXPORT
+    EvaluationObjects() noexcept;
+
+    MMSCENEGRAPH_API_EXPORT
+    rust::Box<ShimEvaluationObjects> get_inner() noexcept;
+
+    MMSCENEGRAPH_API_EXPORT
+    size_t num_bundles() const noexcept;
+
+    MMSCENEGRAPH_API_EXPORT
+    size_t num_cameras() const noexcept;
+
+    MMSCENEGRAPH_API_EXPORT
+    size_t num_markers() const noexcept;
+
+    MMSCENEGRAPH_API_EXPORT
+    void clear_all() noexcept;
+
+    MMSCENEGRAPH_API_EXPORT
+    void clear_bundles() noexcept;
+
+    MMSCENEGRAPH_API_EXPORT
+    void clear_cameras() noexcept;
+
+    MMSCENEGRAPH_API_EXPORT
+    void clear_markers() noexcept;
+
+    MMSCENEGRAPH_API_EXPORT
+    void add_bundle(BundleNode &bnd_node) noexcept;
+
+    MMSCENEGRAPH_API_EXPORT
+    void add_camera(CameraNode &cam_node) noexcept;
+
+    MMSCENEGRAPH_API_EXPORT
+    void add_marker(MarkerNode &mkr_node) noexcept;
+
+private:
+    rust::Box<ShimEvaluationObjects> inner_;
+};
+
+} // namespace mmscenegraph

src/mmscenegraph/cppbind/include/mmscenegraph/flatscene.h

@@ -0,0 +1,43 @@
+/*
+ * Copyright (C) 2020, 2021 David Cattermole.
+ *
+ * This file is part of mmSolver.
+ *
+ * mmSolver is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * mmSolver is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with mmSolver.  If not, see <https://www.gnu.org/licenses/>.
+ * ====================================================================
+ *
+ */
+
+#pragma once
+
+#include <memory>
+#include <string>
+
+#include "_cxx.h"
+#include "_cxxbridge.h"
+#include "_symbol_export.h"
+
+namespace mmscenegraph {
+
+class FlatScene {
+public:
+
+    MMSCENEGRAPH_API_EXPORT
+    FlatScene(rust::Box<ShimFlatScene> flat_scene) noexcept;
+
+private:
+    rust::Box<ShimFlatScene> inner_;
+};
+
+} // namespace mmscenegraph

src/mmscenegraph/cppbind/include/mmscenegraph/mmscenegraph.h

@@ -16,12 +16,15 @@
  * You should have received a copy of the GNU Lesser General Public License
  * along with mmSolver.  If not, see <https://www.gnu.org/licenses/>.
  * ====================================================================
+ *
  */
 
 #pragma once
 
 #include "_cxx.h"
 #include "_cxxbridge.h"
 #include "_types.h"
-#include "scenegraph.h"
 #include "attrdatablock.h"
+#include "flatscene.h"
+#include "scenebake.h"
+#include "scenegraph.h"

src/mmscenegraph/cppbind/include/mmscenegraph/scenebake.h

@@ -0,0 +1,43 @@
+/*
+ * Copyright (C) 2020, 2021 David Cattermole.
+ *
+ * This file is part of mmSolver.
+ *
+ * mmSolver is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * mmSolver is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with mmSolver.  If not, see <https://www.gnu.org/licenses/>.
+ * ====================================================================
+ *
+ */
+
+#pragma once
+
+#include <memory>
+
+#include "_cxx.h"
+#include "_cxxbridge.h"
+#include "_symbol_export.h"
+#include "scenebake.h"
+#include "flatscene.h"
+#include "scenegraph.h"
+#include "evaluationobjects.h"
+
+namespace mmscenegraph {
+
+MMSCENEGRAPH_API_EXPORT
+FlatScene
+bake_scene_graph(
+    SceneGraph &sg,
+    EvaluationObjects &solve_objects
+) noexcept;
+
+} // namespace mmscenegraph

src/mmscenegraph/cppbind/include/mmscenegraph/scenegraph.h

@@ -36,6 +36,14 @@ class SceneGraph {
     MMSCENEGRAPH_API_EXPORT
     SceneGraph() noexcept;
 
+    MMSCENEGRAPH_API_EXPORT
+    rust::Box<ShimSceneGraph>
+    get_inner() noexcept;
+
+    MMSCENEGRAPH_API_EXPORT
+    void
+    SceneGraph::set_inner(rust::Box<ShimSceneGraph> value) noexcept;
+
     MMSCENEGRAPH_API_EXPORT
     void clear() noexcept;
 
@@ -61,15 +69,17 @@ class SceneGraph {
         Translate3DAttrIds translate_attrs,
         Rotate3DAttrIds rotate_attrs,
         Scale3DAttrIds scale_attrs,
-        RotateOrder rotate_order) noexcept;
+        RotateOrder rotate_order
+    ) noexcept;
 
     MMSCENEGRAPH_API_EXPORT
     BundleNode
     create_bundle_node(
         Translate3DAttrIds translate_attrs,
         Rotate3DAttrIds rotate_attrs,
         Scale3DAttrIds scale_attrs,
-        RotateOrder rotate_order) noexcept;
+        RotateOrder rotate_order
+    ) noexcept;
 
     MMSCENEGRAPH_API_EXPORT
     CameraNode
@@ -78,20 +88,36 @@ class SceneGraph {
         Rotate3DAttrIds rotate_attrs,
         Scale3DAttrIds scale_attrs,
         CameraAttrIds camera_attrs,
-        RotateOrder rotate_order) noexcept;
+        RotateOrder rotate_order
+    ) noexcept;
 
     MMSCENEGRAPH_API_EXPORT
     MarkerNode
-    create_marker_node(MarkerAttrIds marker_attrs) noexcept;
+    create_marker_node(
+        MarkerAttrIds marker_attrs
+    ) noexcept;
 
     MMSCENEGRAPH_API_EXPORT
     bool
-    link_marker_to_camera(NodeId mkr_node_id, NodeId cam_node_id) noexcept;
+    link_marker_to_camera(
+        NodeId mkr_node_id,
+        NodeId cam_node_id
+    ) noexcept;
 
     MMSCENEGRAPH_API_EXPORT
     bool
-    link_marker_to_bundle(NodeId mkr_node_id, NodeId bnd_node_id) noexcept;
-    
+    link_marker_to_bundle(
+        NodeId mkr_node_id,
+        NodeId bnd_node_id
+    ) noexcept;
+
+    MMSCENEGRAPH_API_EXPORT
+    bool
+    set_node_parent(
+        NodeId child_node_id,
+        NodeId parent_node_id
+    ) noexcept;
+
 private:
     rust::Box<ShimSceneGraph> inner_;
 };