Changeset 1045 for cpp/frams/model/geometry/geometryutils.h

Timestamp:

12/11/20 20:23:42 (3 years ago)

Author:

oriona

Message:

Part of GeometryTestUtils? functions moved to GeometryUtils?.

File:

• cpp/frams/model/geometry/geometryutils.h (modified) (1 diff)

cpp/frams/model/geometry/geometryutils.h

@@ -180 +180 @@
         double calculateSolidVolume(Part *part);
         bool isSolidPartScaleValid(const Part::Shape &partShape, const Pt3D &scale);
+
+    /**
+    * @brief Adds anchor to the specified Model.
+    * @details An anchor has two functions. First is to provide Model consistency. Some functions in
+    *     GeometryTestUtils namespace requires Model passed to them as an argument to contain at
+    *     least one Part. All new Parts are bonded to the rest of Model using Joint connecting them
+    *     with first Part of Model. Second is to provide reference which helps to understand Model
+    *     position, scale and orientation. Anchor is built from four Parts: small sphere placed in
+    *     global coordinate system origin and three cuboids visualising global coordinate system
+    *     axes.
+    * @see addAxesToModel.
+    * @param[in] model Owner of Parts to be created.
+    */
+    void addAnchorToModel(Model &model);
+
+    /**
+     * @brief Adds point marker to Model.
+     * @details Marker of point is a small sphere (radius = 0.05).
+     * @param[in] point Location of marker.
+     * @param[in] model Owner of Part to be created, must contain at least one part.
+     */
+    void addPointToModel(const Pt3D &point, Model &model);
+
+    /**
+     * @brief Adds axes markers to Model.
+     * @details Axes markers are three streched (one of scales = 0.5, others = 0.05) and colored
+     *     cuboids. Cuboid visualising OX axis is red, OY - green, and OZ - blue.
+     * @param[in] sizes Axes visual lengths.
+     * @param[in] axes Axes orientation, relatively to global coordinate system axes.
+     * @param[in] center Axes intersection point, relatively to global coordinate system origin.
+     * @param[in] model Owner of Parts to be created, must contain at least one part.
+     */
+    void addAxesToModel(const Pt3D &sizes, const Orient &axes, const Pt3D &center, Model &model);
+
+    /**
+     * @brief Merges two Models.
+     * @details Moves all parts from source Model to target Model and - to provide Model
+     *     consistency - creates Joint between firsts Parts of each of them. Each model must contain
+     *     at least one Part.
+     * @param[in] target Target Model, must contain at least one part.
+     * @param[in] source Source Model, must contain at least one part.
+     */
+    void mergeModels(Model &target, Model &source);
+
+    /**
+     * @brief Randomizes position, scale and rotations of Part.
+     * @details Sets coords of Part position to random values from range (1.5, 2.5), scales to
+     *     random values from range (0.1, 1.0), and rotations around each axis to random values from
+     *     range (0, M_PI).
+     * @param[in] part Part which position, scale and orient should be randomized.
+     */
+    void randomizePositionScaleAndOrient(Part *part);
 }