1 // fg_commands.cxx - internal FGFS commands.
3 #include <string.h> // strcmp()
5 #include <simgear/compiler.h>
6 #include <simgear/misc/exception.hxx>
11 #include <simgear/debug/logstream.hxx>
12 #include <simgear/misc/commands.hxx>
13 #include <simgear/misc/props.hxx>
16 #include <Cockpit/panel.hxx>
17 #include <Cockpit/panel_io.hxx>
18 #include <Scenery/tilemgr.hxx>
19 #include <Time/tmp.hxx>
21 #include "fg_commands.hxx"
24 #if !defined(SG_HAVE_NATIVE_SGI_COMPILERS)
25 SG_USING_STD(ifstream);
26 SG_USING_STD(ofstream);
29 #include "fg_props.hxx"
31 #include "globals.hxx"
32 #include "viewmgr.hxx"
36 ////////////////////////////////////////////////////////////////////////
37 // Saved command states.
38 ////////////////////////////////////////////////////////////////////////
42 * Base saved state for property commands.
44 * Since this class isn't publicly visible, it is simply an aggregate
45 * of all the stuff any property command needs.
47 class PropertyCommandState : public SGCommandState
50 PropertyCommandState (const SGPropertyNode * arg);
51 virtual SGPropertyNode * getProp () const { return _prop; }
52 virtual SGPropertyNode * getProp2 () const { return _prop2; }
53 virtual const SGPropertyNode * getValue () const
54 { return _value ? _value : &_dummy_0; }
55 virtual const bool hasStep () const { return _step != 0; }
56 virtual const SGPropertyNode * getStep () const
57 { return _step ? _step : &_dummy_0; }
58 virtual const SGPropertyNode * getMin () const { return _min; }
59 virtual const SGPropertyNode * getMax () const { return _max; }
60 virtual const SGPropertyNode * getWrap () const
61 { return _wrap ? _wrap : &_dummy_0; }
62 virtual const SGPropertyNode * getFactor () const
63 { return _factor ? _factor : &_dummy_1; }
64 virtual const SGPropertyNode * getSquared () const
65 { return _squared ? _squared : &_dummy_0; }
66 virtual const SGPropertyNode * getSetting () const
67 { return _setting ? _setting : &_dummy_0; }
68 virtual const SGPropertyNode * getOffset () const
69 { return _offset ? _offset : &_dummy_0; }
71 static SGPropertyNode _dummy_0;
72 static SGPropertyNode _dummy_1;
73 mutable SGPropertyNode * _prop;
74 mutable SGPropertyNode * _prop2;
75 const SGPropertyNode * _value;
76 const SGPropertyNode * _step;
77 const SGPropertyNode * _min;
78 const SGPropertyNode * _max;
79 const SGPropertyNode * _wrap;
80 const SGPropertyNode * _factor;
81 const SGPropertyNode * _squared;
82 const SGPropertyNode * _setting;
83 const SGPropertyNode * _offset;
86 SGPropertyNode PropertyCommandState::_dummy_0;
87 SGPropertyNode PropertyCommandState::_dummy_1;
89 PropertyCommandState::PropertyCommandState (const SGPropertyNode * arg)
90 : SGCommandState(arg),
91 _prop(fgGetNode(arg->getStringValue("property[0]", "/null"), true)),
92 _prop2(fgGetNode(arg->getStringValue("property[1]", "/null"), true)),
93 _value(arg->getNode("value")),
94 _step(arg->getNode("step")),
95 _min(arg->getNode("min")),
96 _max(arg->getNode("max")),
97 _wrap(arg->getNode("wrap")),
98 _factor(arg->getNode("factor")),
99 _squared(arg->getNode("squared")),
100 _setting(arg->getNode("setting")),
101 _offset(arg->getNode("offset"))
103 // It would be better not to do this
104 // every time, but it's not that big
105 // a deal. I don't know enough about
106 // C++ static initialization to fix it.
107 _dummy_1.setDoubleValue(1.0);
113 ////////////////////////////////////////////////////////////////////////
114 // Command implementations.
115 ////////////////////////////////////////////////////////////////////////
119 * Built-in command: do nothing.
122 do_null (const SGPropertyNode * arg, SGCommandState ** state)
129 * Built-in command: exit FlightGear.
131 * TODO: show a confirm dialog.
134 do_exit (const SGPropertyNode * arg, SGCommandState ** state)
136 SG_LOG(SG_INPUT, SG_ALERT, "Program exit requested.");
143 * Built-in command: load flight.
145 * file (optional): the name of the file to load (relative to current
146 * directory). Defaults to "fgfs.sav".
149 do_load (const SGPropertyNode * arg, SGCommandState ** state)
151 const string &file = arg->getStringValue("file", "fgfs.sav");
152 ifstream input(file.c_str());
153 if (input.good() && fgLoadFlight(input)) {
155 SG_LOG(SG_INPUT, SG_INFO, "Restored flight from " << file);
158 SG_LOG(SG_INPUT, SG_ALERT, "Cannot load flight from " << file);
165 * Built-in command: save flight.
167 * file (optional): the name of the file to save (relative to the
168 * current directory). Defaults to "fgfs.sav".
171 do_save (const SGPropertyNode * arg, SGCommandState ** state)
173 const string &file = arg->getStringValue("file", "fgfs.sav");
174 bool write_all = arg->getBoolValue("write-all", false);
175 SG_LOG(SG_INPUT, SG_INFO, "Saving flight");
176 ofstream output(file.c_str());
177 if (output.good() && fgSaveFlight(output, write_all)) {
179 SG_LOG(SG_INPUT, SG_INFO, "Saved flight to " << file);
182 SG_LOG(SG_INPUT, SG_ALERT, "Cannot save flight to " << file);
189 * Built-in command: (re)load the panel.
191 * path (optional): the file name to load the panel from
192 * (relative to FG_ROOT). Defaults to the value of /sim/panel/path,
193 * and if that's unspecified, to "Panels/Default/default.xml".
196 do_panel_load (const SGPropertyNode * arg, SGCommandState ** state)
199 arg->getStringValue("path",
200 fgGetString("/sim/panel/path",
201 "Panels/Default/default.xml"));
202 FGPanel * new_panel = fgReadPanel(panel_path);
203 if (new_panel == 0) {
204 SG_LOG(SG_INPUT, SG_ALERT,
205 "Error reading new panel from " << panel_path);
208 SG_LOG(SG_INPUT, SG_INFO, "Loaded new panel from " << panel_path);
209 current_panel->unbind();
210 delete current_panel;
211 current_panel = new_panel;
212 current_panel->bind();
218 * Built-in command: pass a mouse click to the panel.
220 * button: the mouse button number, zero-based.
221 * is-down: true if the button is down, false if it is up.
222 * x-pos: the x position of the mouse click.
223 * y-pos: the y position of the mouse click.
226 do_panel_mouse_click (const SGPropertyNode * arg, SGCommandState ** state)
228 if (current_panel != 0)
230 ->doMouseAction(arg->getIntValue("button"),
231 arg->getBoolValue("is-down") ? PU_DOWN : PU_UP,
232 arg->getIntValue("x-pos"),
233 arg->getIntValue("y-pos"));
240 * Built-in command: (re)load preferences.
242 * path (optional): the file name to load the panel from (relative
243 * to FG_ROOT). Defaults to "preferences.xml".
246 do_preferences_load (const SGPropertyNode * arg, SGCommandState ** state)
248 const string &path = arg->getStringValue("path", "preferences.xml");
249 SGPath props_path(globals->get_fg_root());
250 props_path.append(path);
251 SG_LOG(SG_INPUT, SG_INFO, "Reading global preferences from "
252 << props_path.str());
254 readProperties(props_path.str(), globals->get_props());
255 } catch (const sg_exception &e) {
256 guiErrorMessage("Error reading global preferences: ", e);
259 SG_LOG(SG_INPUT, SG_INFO, "Successfully read global preferences.");
267 if ( !strcmp(fgGetString("/sim/flight-model"), "ada") ) {
268 globals->get_props()->setBoolValue( "/sim/hud/visibility", true );
269 if ( globals->get_viewmgr()->get_current() == 1 ) {
270 globals->get_props()->setBoolValue( "/sim/hud/visibility", false );
278 globals->get_current_view()->setHeadingOffset_deg(0.0);
279 globals->get_viewmgr()->next_view();
280 fix_hud_visibility();
281 global_tile_mgr.refresh_view_timestamps();
287 globals->get_current_view()->setHeadingOffset_deg(0.0);
288 globals->get_viewmgr()->prev_view();
289 fix_hud_visibility();
290 global_tile_mgr.refresh_view_timestamps();
294 * Built-in command: cycle view.
297 do_view_cycle (const SGPropertyNode * arg, SGCommandState ** state)
299 globals->get_current_view()->setHeadingOffset_deg(0.0);
300 globals->get_viewmgr()->next_view();
301 fix_hud_visibility();
302 global_tile_mgr.refresh_view_timestamps();
303 // fgReshape(fgGetInt("/sim/startup/xsize"), fgGetInt("/sim/startup/ysize"));
308 * Built-in command: capture screen.
311 do_screen_capture (const SGPropertyNode * arg, SGCommandState ** state)
319 * Reload the tile cache.
322 do_tile_cache_reload (const SGPropertyNode * arg, SGCommandState ** state)
324 static const SGPropertyNode *master_freeze
325 = fgGetNode("/sim/freeze/master");
326 bool freeze = master_freeze->getBoolValue();
327 SG_LOG(SG_INPUT, SG_INFO, "ReIniting TileCache");
329 fgSetBool("/sim/freeze/master", true);
332 if ( global_tile_mgr.init() ) {
333 // Load the local scenery data
334 double visibility_meters = fgGetDouble("/environment/visibility-m");
335 global_tile_mgr.update(fgGetDouble("/position/longitude-deg"),
336 fgGetDouble("/position/latitude-deg"),
339 SG_LOG( SG_GENERAL, SG_ALERT,
340 "Error in Tile Manager initialization!" );
345 fgSetBool("/sim/freeze/master", false);
352 * Update the lighting manually.
355 do_lighting_update (const SGPropertyNode * arg, SGCommandState ** state)
357 fgUpdateSkyAndLightingParams();
363 * Built-in command: toggle a bool property value.
365 * property: The name of the property to toggle.
368 do_property_toggle (const SGPropertyNode * arg, SGCommandState ** state)
371 *state = new PropertyCommandState(arg);
372 SGPropertyNode * prop = ((PropertyCommandState *)(*state))->getProp();
373 return prop->setBoolValue(!prop->getBoolValue());
378 * Built-in command: assign a value to a property.
380 * property: the name of the property to assign.
381 * value: the value to assign.
384 do_property_assign (const SGPropertyNode * arg, SGCommandState ** state)
387 *state = new PropertyCommandState(arg);
388 SGPropertyNode * prop = ((PropertyCommandState *)(*state))->getProp();
389 const SGPropertyNode * value =
390 ((PropertyCommandState *)(*state))->getValue();
392 switch (prop->getType()) {
393 case SGPropertyNode::BOOL:
394 return prop->setBoolValue(value->getBoolValue());
395 case SGPropertyNode::INT:
396 return prop->setIntValue(value->getIntValue());
397 case SGPropertyNode::LONG:
398 return prop->setLongValue(value->getLongValue());
399 case SGPropertyNode::FLOAT:
400 return prop->setFloatValue(value->getFloatValue());
401 case SGPropertyNode::DOUBLE:
402 return prop->setDoubleValue(value->getDoubleValue());
403 case SGPropertyNode::STRING:
404 return prop->setStringValue(value->getStringValue());
406 return prop->setUnspecifiedValue(value->getStringValue());
412 * Built-in command: increment or decrement a property value.
414 * property: the name of the property to increment or decrement.
415 * step: the amount of the increment or decrement (default: 0).
416 * offset: a normalized amount to offset by (if step is not present).
417 * factor: the amount by which to multiply the offset (if step is not present).
418 * min: the minimum allowed value (default: no minimum).
419 * max: the maximum allowed value (default: no maximum).
420 * wrap: true if the value should be wrapped when it passes min or max;
421 * both min and max must be present for this to work (default:
425 do_property_adjust (const SGPropertyNode * arg, SGCommandState ** state)
428 *state = new PropertyCommandState(arg);
429 bool hasStep = ((PropertyCommandState *)(*state))->hasStep();
430 SGPropertyNode * prop = ((PropertyCommandState *)(*state))->getProp();
431 const SGPropertyNode * step = ((PropertyCommandState *)(*state))->getStep();
432 const SGPropertyNode * offset =
433 ((PropertyCommandState *)(*state))->getOffset();
434 const SGPropertyNode * factor =
435 ((PropertyCommandState *)(*state))->getFactor();
436 const SGPropertyNode * min = ((PropertyCommandState *)(*state))->getMin();
437 const SGPropertyNode * max = ((PropertyCommandState *)(*state))->getMax();
438 bool wrap = ((PropertyCommandState *)(*state))->getWrap()->getBoolValue();
442 amount = offset->getDoubleValue() * factor->getDoubleValue();
446 switch (prop->getType()) {
447 case SGPropertyNode::BOOL:
450 value = step->getBoolValue();
452 value = (0.0 != amount);
454 return prop->setBoolValue(!prop->getBoolValue());
457 case SGPropertyNode::INT: {
460 value = prop->getIntValue() + step->getIntValue();
462 value = prop->getIntValue() + int(amount);
463 if (min && (value < min->getIntValue())) {
465 value = max->getIntValue();
467 value = min->getIntValue();
469 if (max && value > max->getIntValue()) {
471 value = min->getIntValue();
473 value = max->getIntValue();
475 return prop->setIntValue(value);
477 case SGPropertyNode::LONG: {
480 value = prop->getLongValue() + step->getLongValue();
482 value = prop->getLongValue() + long(amount);
483 if (min && (value < min->getLongValue())) {
485 value = max->getLongValue();
487 value = min->getLongValue();
489 if (max && value > max->getLongValue()) {
491 value = min->getLongValue();
493 value = max->getLongValue();
495 return prop->setLongValue(value);
497 case SGPropertyNode::FLOAT: {
500 value = prop->getFloatValue() + step->getFloatValue();
502 value = prop->getFloatValue() + float(amount);
503 if (min && (value < min->getFloatValue())) {
505 value = max->getFloatValue();
507 value = min->getFloatValue();
509 if (max && value > max->getFloatValue()) {
511 value = min->getFloatValue();
513 value = max->getFloatValue();
515 return prop->setFloatValue(value);
517 case SGPropertyNode::DOUBLE:
518 case SGPropertyNode::UNSPECIFIED:
519 case SGPropertyNode::NONE: {
522 value = prop->getDoubleValue() + step->getDoubleValue();
524 value = prop->getDoubleValue() + amount;
525 if (min && (value < min->getDoubleValue())) {
527 value = max->getDoubleValue();
529 value = min->getDoubleValue();
531 if (max && value > max->getDoubleValue()) {
533 value = min->getDoubleValue();
535 value = max->getDoubleValue();
537 return prop->setDoubleValue(value);
539 case SGPropertyNode::STRING: // doesn't make sense with strings
540 SG_LOG(SG_INPUT, SG_ALERT, "Cannot adjust a string value");
543 SG_LOG(SG_INPUT, SG_ALERT, "Unknown value type");
550 * Built-in command: multiply a property value.
552 * property: the name of the property to multiply.
553 * factor: the amount by which to multiply.
556 do_property_multiply (const SGPropertyNode * arg, SGCommandState ** state)
559 *state = new PropertyCommandState(arg);
560 SGPropertyNode * prop = ((PropertyCommandState *)(*state))->getProp();
561 const SGPropertyNode * factor =
562 ((PropertyCommandState *)(*state))->getFactor();
564 switch (prop->getType()) {
565 case SGPropertyNode::BOOL:
566 return prop->setBoolValue(prop->getBoolValue() &&
567 factor->getBoolValue());
568 case SGPropertyNode::INT:
569 return prop->setIntValue(int(prop->getIntValue()
570 * factor->getDoubleValue()));
571 case SGPropertyNode::LONG:
572 return prop->setLongValue(long(prop->getLongValue()
573 * factor->getDoubleValue()));
574 case SGPropertyNode::FLOAT:
575 return prop->setFloatValue(float(prop->getFloatValue()
576 * factor->getDoubleValue()));
577 case SGPropertyNode::DOUBLE:
578 case SGPropertyNode::UNSPECIFIED:
579 case SGPropertyNode::NONE:
580 return prop->setDoubleValue(prop->getDoubleValue()
581 * factor->getDoubleValue());
582 default: // doesn't make sense with strings
589 * Built-in command: swap two property values.
591 * property[0]: the name of the first property.
592 * property[1]: the name of the second property.
595 do_property_swap (const SGPropertyNode * arg, SGCommandState ** state)
598 *state = new PropertyCommandState(arg);
599 SGPropertyNode * prop1 = ((PropertyCommandState *)(*state))->getProp();
600 SGPropertyNode * prop2 = ((PropertyCommandState *)(*state))->getProp2();
602 // FIXME: inefficient
603 const string & tmp = prop1->getStringValue();
604 return (prop1->setUnspecifiedValue(prop2->getStringValue()) &&
605 prop2->setUnspecifiedValue(tmp.c_str()));
610 * Set a property to an axis or other moving input.
612 * property: the name of the property to set.
613 * setting: the current input setting, usually between -1.0 and 1.0.
614 * offset: the offset to shift by, before applying the factor.
615 * factor: the factor to multiply by (use negative to reverse).
618 do_property_scale (const SGPropertyNode * arg, SGCommandState ** state)
621 *state = new PropertyCommandState(arg);
622 SGPropertyNode * prop = ((PropertyCommandState *)(*state))->getProp();
624 ((PropertyCommandState *)(*state))->getSetting()->getDoubleValue();
626 ((PropertyCommandState *)(*state))->getOffset()->getDoubleValue();
628 ((PropertyCommandState *)(*state))->getFactor()->getDoubleValue();
630 ((PropertyCommandState *)(*state))->getSquared()->getBoolValue();
633 setting = (setting < 0 ? -1 : 1) * setting * setting;
634 double result = (setting + offset) * factor;
636 return prop->setDoubleValue(result);
641 ////////////////////////////////////////////////////////////////////////
643 ////////////////////////////////////////////////////////////////////////
647 * Table of built-in commands.
649 * New commands do not have to be added here; any module in the application
650 * can add a new command using globals->get_commands()->addCommand(...).
654 SGCommandMgr::command_t command;
660 { "panel-load", do_panel_load },
661 { "panel-mouse-click", do_panel_mouse_click },
662 { "preferences-load", do_preferences_load },
663 { "view-cycle", do_view_cycle },
664 { "screen-capture", do_screen_capture },
665 { "tile-cache-reload", do_tile_cache_reload },
666 { "lighting-update", do_lighting_update },
667 { "property-toggle", do_property_toggle },
668 { "property-assign", do_property_assign },
669 { "property-adjust", do_property_adjust },
670 { "property-multiply", do_property_multiply },
671 { "property-swap", do_property_swap },
672 { "property-scale", do_property_scale },
673 { 0, 0 } // zero-terminated
678 * Initialize the default built-in commands.
680 * Other commands may be added by other parts of the application.
685 SG_LOG(SG_GENERAL, SG_INFO, "Initializing basic built-in commands:");
686 for (int i = 0; built_ins[i].name != 0; i++) {
687 SG_LOG(SG_GENERAL, SG_INFO, " " << built_ins[i].name);
688 globals->get_commands()->addCommand(built_ins[i].name,
689 built_ins[i].command);
692 typedef bool (*dummy)();
693 fgTie( "/command/view/next", dummy(0), do_view_next );
694 fgTie( "/command/view/prev", dummy(0), do_view_prev );
697 // end of fg_commands.cxx