DART  6.6.2
Branch.hpp
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2011-2018, The DART development contributors
3  * All rights reserved.
4  *
5  * The list of contributors can be found at:
6  * https://github.com/dartsim/dart/blob/master/LICENSE
7  *
8  * This file is provided under the following "BSD-style" License:
9  * Redistribution and use in source and binary forms, with or
10  * without modification, are permitted provided that the following
11  * conditions are met:
12  * * Redistributions of source code must retain the above copyright
13  * notice, this list of conditions and the following disclaimer.
14  * * Redistributions in binary form must reproduce the above
15  * copyright notice, this list of conditions and the following
16  * disclaimer in the documentation and/or other materials provided
17  * with the distribution.
18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
19  * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
20  * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
21  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22  * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
23  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
26  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
27  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
29  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30  * POSSIBILITY OF SUCH DAMAGE.
31  */
32 
33 #ifndef DART_DYNAMICS_BRANCH_HPP_
34 #define DART_DYNAMICS_BRANCH_HPP_
35 
37 
38 namespace dart {
39 namespace dynamics {
40 
44 class Branch : public Linkage
45 {
46 public:
47 
48  struct Criteria
49  {
51  Criteria(BodyNode* _start);
52 
55  std::vector<BodyNode*> satisfy() const;
56 
59 
61  Linkage::Criteria convert() const;
62 
64  operator Linkage::Criteria() const;
65  };
66 
68  static BranchPtr create(const Branch::Criteria& _criteria,
69  const std::string& _name = "Branch");
70 
73  bool isStillBranch() const;
74 
75 protected:
76 
80  Branch(const Branch::Criteria& _criteria,
81  const std::string& _name = "Branch");
82 
83  // Documentation inherited
84  void update() override;
85 
87  std::vector<std::size_t> mNumChildNodes;
88 };
89 
90 } // namespace dynamics
91 } // namespace dart
92 
93 #endif // DART_DYNAMICS_BRANCH_HPP_
BodyNode class represents a single node of the skeleton.
Definition: BodyNode.hpp:78
Branch is a specialized type of Linkage that represents a complete subtree of a Skeleton.
Definition: Branch.hpp:45
bool isStillBranch() const
Returns false if a new BodyNode has been attached to any BodyNode of this Branch, or if a BodyNode of...
Definition: Branch.cpp:78
Branch(const Branch::Criteria &_criteria, const std::string &_name="Branch")
Constructor for the Branch class.
Definition: Branch.cpp:94
void update() override
Update any metadata needed by the Linkage or its derived classes.
Definition: Branch.cpp:101
std::vector< std::size_t > mNumChildNodes
The original number of child nodes for each BodyNode of this Branch.
Definition: Branch.hpp:87
static BranchPtr create(const Branch::Criteria &_criteria, const std::string &_name="Branch")
Create a Branch.
Definition: Branch.cpp:69
A Linkage is a ReferentialSkeleton with the special property that all the BodyNodes included in it fo...
Definition: Linkage.hpp:54
std::shared_ptr< Branch > BranchPtr
Definition: SmartPointer.hpp:75
Definition: BulletCollisionDetector.cpp:63
Definition: Branch.hpp:49
Criteria(BodyNode *_start)
Constructor. Requires a starting BodyNode.
Definition: Branch.cpp:40
WeakBodyNodePtr mStart
The BodyNode where the Branch starts.
Definition: Branch.hpp:58
Linkage::Criteria convert() const
Convert this Criteria into Linkage criteria.
Definition: Branch.cpp:53
std::vector< BodyNode * > satisfy() const
Return a vector of BodyNodes that form a full subtree, starting from mStart.
Definition: Branch.cpp:47
The Criteria class is used to specify how a Linkage should be constructed.
Definition: Linkage.hpp:59