JSBSim Flight Dynamics Model  1.2.0 (05 Nov 2023)
An Open Source Flight Dynamics and Control Software Library in C++
FGPropertyReader.cpp
1 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2 
3  Module: FGPropertyReader.cpp
4  Author: Bertrand Coconnier
5  Date started: 12/30/13
6  Purpose: Read and manage properties from XML data
7 
8  ------------- Copyright (C) 2013 Bertrand Coconnier -------------
9 
10  This program is free software; you can redistribute it and/or modify it under
11  the terms of the GNU Lesser General Public License as published by the Free Software
12  Foundation; either version 2 of the License, or (at your option) any later
13  version.
14 
15  This program is distributed in the hope that it will be useful, but WITHOUT
16  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
17  FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
18  details.
19 
20  You should have received a copy of the GNU Lesser General Public License along with
21  this program; if not, write to the Free Software Foundation, Inc., 59 Temple
22  Place - Suite 330, Boston, MA 02111-1307, USA.
23 
24  Further information about the GNU Lesser General Public License can also be found on
25  the world wide web at http://www.gnu.org.
26 
27 FUNCTIONAL DESCRIPTION
28 --------------------------------------------------------------------------------
29 This class reads and manages properties defined in XML data
30 
31 HISTORY
32 --------------------------------------------------------------------------------
33 12/30/13 BC Created
34 
35 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
36 INCLUDES
37 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
38 
39 #include "FGPropertyReader.h"
40 #include "FGPropertyManager.h"
41 #include "FGXMLElement.h"
42 #include "FGJSBBase.h"
43 
44 using namespace std;
45 
46 namespace JSBSim {
47 
48 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
49 CLASS IMPLEMENTATION
50 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
51 
52 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
53 
54 bool FGPropertyReader::ResetToIC(void)
55 {
56  for (auto v: interface_prop_initial_value) {
57  SGPropertyNode* node = v.first;
58  if (!node->getAttribute(SGPropertyNode::PRESERVE))
59  node->setDoubleValue(v.second);
60  }
61 
62  return true;
63 }
64 
65 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
66 
67 void FGPropertyReader::Load(Element* el, FGPropertyManager* PM, bool override_props)
68 {
69  Element *property_element = el->FindElement("property");
70  if (property_element && FGJSBBase::debug_lvl > 0) {
71  cout << endl << " ";
72  if (override_props)
73  cout << "Overriding";
74  else
75  cout << "Declared";
76  cout << " properties" << endl << endl;
77  }
78 
79  while (property_element) {
80  SGPropertyNode* node = nullptr;
81  double value=0.0;
82  bool has_value_attribute = !property_element->GetAttributeValue("value").empty();
83 
84  if (has_value_attribute)
85  value = property_element->GetAttributeValueAsNumber("value");
86 
87  string interface_property_string = property_element->GetDataLine();
88  if (PM->HasNode(interface_property_string)) {
89  node = PM->GetNode(interface_property_string);
90  if (override_props) {
91 
92  if (FGJSBBase::debug_lvl > 0) {
93  if (interface_prop_initial_value.find(node) == interface_prop_initial_value.end()) {
94  cout << property_element->ReadFrom()
95  << " The following property will be overridden but it has not been" << endl
96  << " defined in the current model '" << el->GetName() << "'" << endl;
97  }
98 
99  cout << " " << "Overriding value for property " << interface_property_string << endl
100  << " (old value: " << node->getDoubleValue() << " new value: " << value << ")"
101  << endl << endl;
102  }
103 
104  node->setDoubleValue(value);
105  }
106  else {
107  if (has_value_attribute) {
108  cerr << property_element->ReadFrom()
109  << " Property " << interface_property_string
110  << " is already defined." << endl
111  << " Its value (" << node->getDoubleValue() << ") will not"
112  << " be overridden." << endl;
113  }
114  property_element = el->FindNextElement("property");
115  continue;
116  }
117  } else {
118  node = PM->GetNode(interface_property_string, true);
119  if (node) {
120  node->setDoubleValue(value);
121 
122  if (FGJSBBase::debug_lvl > 0)
123  cout << " " << interface_property_string << " (initial value: "
124  << value << ")" << endl << endl;
125  }
126  else {
127  cerr << "Could not create property " << interface_property_string
128  << endl;
129  property_element = el->FindNextElement("property");
130  continue;
131  }
132  }
133  interface_prop_initial_value[node] = value;
134  if (property_element->GetAttributeValue("persistent") == string("true"))
135  node->setAttribute(SGPropertyNode::PRESERVE, true);
136 
137  property_element = el->FindNextElement("property");
138  }
139 
140  // End of interface property loading logic
141 }
142 }