1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
// 2009 © Václav Šmilauer <eudoxos@arcig.cz>
#pragma once
#include <lib/multimethods/Indexable.hpp>
#include <lib/serialization/Serializable.hpp>
#include <core/Dispatcher.hpp>
#include <core/State.hpp>
namespace yade { // Cannot have #include directive inside.
class Scene;
/*! Material properties associated with a body.
Historical note: this used to be part of the PhysicalParameters class.
The other data are now in the State class.
*/
class Material : public Serializable, public Indexable {
public:
virtual ~Material() {};
//! Function to return empty default-initialized instance of State that
// is supposed to go along with this Material. Don't override unless you need
// something else than basic State.
virtual shared_ptr<State> newAssocState() const { return shared_ptr<State>(new State); }
/*! Function that returns true if given State instance is what this material expects.
Base Material class has no requirements, but the check would normally look like this:
return (bool)dynamic_cast<State*> state;
*/
virtual bool stateTypeOk(State*) const { return true; }
static const shared_ptr<Material> byId(int id, Scene* scene = NULL);
static const shared_ptr<Material> byId(int id, shared_ptr<Scene> scene) { return byId(id, scene.get()); }
static const shared_ptr<Material> byLabel(const std::string& label, Scene* scene = NULL);
static const shared_ptr<Material> byLabel(const std::string& label, shared_ptr<Scene> scene) { return byLabel(label, scene.get()); }
// return index of material, given its label
static int byLabelIndex(const std::string& label, Scene* scene = NULL);
// clang-format off
YADE_CLASS_BASE_DOC_ATTRS_CTOR_PY(Material,Serializable,"Material properties of a :yref:`body<Body>`.",
((int,id,((void)"not shared",-1),Attr::readonly,"Numeric id of this material; is non-negative only if this Material is shared (i.e. in O.materials), -1 otherwise. This value is set automatically when the material is inserted to the simulation via :yref:`O.materials.append<MaterialContainer.append>`. (This id was necessary since before boost::serialization was used, shared pointers were not tracked properly; it might disappear in the future)"))
((string,label,,,"Textual identifier for this material; can be used for shared materials lookup in :yref:`MaterialContainer`."))
((Real,density,1000,,"Density of the material [kg/m³]")),
/* ctor */,
/*py*/
.def("newAssocState",&Material::newAssocState,"Return new :yref:`State` instance, which is associated with this :yref:`Material`. Some materials have special requirement on :yref:`Body::state` type and calling this function when the body is created will ensure that they match. (This is done automatically if you use utils.sphere, … functions from python).")
YADE_PY_TOPINDEXABLE(Material)
);
// clang-format on
REGISTER_INDEX_COUNTER(Material);
};
REGISTER_SERIALIZABLE(Material);
} // namespace yade
|
