1 // Implementation of FGATC - ATC subsystem base class.
3 // Written by David Luff, started February 2002.
5 // Copyright (C) 2002 David C Luff - david.luff@nottingham.ac.uk
7 // This program is free software; you can redistribute it and/or
8 // modify it under the terms of the GNU General Public License as
9 // published by the Free Software Foundation; either version 2 of the
10 // License, or (at your option) any later version.
12 // This program is distributed in the hope that it will be useful, but
13 // WITHOUT ANY WARRANTY; without even the implied warranty of
14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 // General Public License for more details.
17 // You should have received a copy of the GNU General Public License
18 // along with this program; if not, write to the Free Software
19 // Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
25 #include <simgear/sound/soundmgr_openal.hxx>
27 #include <Main/globals.hxx>
28 #include <Main/fg_props.hxx>
31 #include "ATCdisplay.hxx"
37 runResponseCounter = false;
38 _runReleaseCounter = false;
45 // Transmission timing stuff
46 pending_transmission = "";
51 _transmitting = false;
61 // Derived classes wishing to use the response counter should call this from their own Update(...).
62 void FGATC::Update(double dt) {
63 if(runResponseCounter) {
64 //cout << responseCounter << '\t' << responseTime << '\n';
65 if(responseCounter >= responseTime) {
66 runResponseCounter = false;
68 //cout << "RESPOND\n";
70 responseCounter += dt;
74 if(_runReleaseCounter) {
75 if(_releaseCounter >= _releaseTime) {
77 _runReleaseCounter = false;
79 _releaseCounter += dt;
83 // Transmission stuff cribbed from AIPlane.cxx
86 //cout << "TUNED STATION FREQ CLEAR\n";
90 _transmitting = false;
92 if(_timeout > 0.0) { // allows count down to be avoided by initially setting it to zero
97 // timed out - don't render.
105 _max_count = 5.0; // FIXME - hardwired length of message - need to calculate it!
107 //cout << "Transmission = " << pending_transmission << '\n';
109 //Render(pending_transmission, ident, false);
110 Render(pending_transmission);
111 // At the moment Render only works for ATIS
112 //globals->get_ATC_display()->RegisterSingleMessage(pending_transmission);
114 // Run the callback regardless of whether on same freq as user or not.
115 //cout << "_callback_code = " << _callback_code << '\n';
117 ProcessCallback(_callback_code);
120 _transmitting = true;
121 } else if(_transmitting) {
122 if(_counter >= _max_count) {
123 //NoRender(plane.callsign); commented out since at the moment NoRender is designed just to stop repeating messages,
124 // and this will be primarily used on single messages.
125 _transmitting = false;
126 //if(tuned_station) tuned_station->NotifyTransmissionFinished(plane.callsign);
127 // TODO - need to let the plane the transmission is aimed at that it's finished.
128 // However, for now we'll just release the frequency since if we don't it all goes pear-shaped
129 _releaseCounter = 0.0;
131 _runReleaseCounter = true;
137 void FGATC::ReceiveUserCallback(int code) {
138 SG_LOG(SG_ATC, SG_WARN, "WARNING - whichever ATC class was intended to receive callback code " << code << " didn't get it!!!");
141 void FGATC::SetResponseReqd(string rid) {
144 respond = false; // TODO - this ignores the fact that more than one plane could call this before response
145 // Shouldn't happen with AI only, but user could confuse things??
147 runResponseCounter = true;
148 responseCounter = 0.0;
149 responseTime = 1.8; // TODO - randomize this slightly.
152 void FGATC::NotifyTransmissionFinished(string rid) {
153 //cout << "Transmission finished, callsign = " << rid << '\n';
157 runResponseCounter = true;
158 responseCounter = 0.0;
159 responseTime = 1.2; // TODO - randomize this slightly, and allow it to be dependent on the transmission and how busy the ATC is.
160 respond = false; // TODO - this ignores the fact that more than one plane could call this before response
161 // Shouldn't happen with AI only, but user could confuse things??
167 void FGATC::Transmit(int callback_code) {
168 SG_LOG(SG_ATC, SG_INFO, "Transmit called by " << ident << " " << _type << ", msg = " << pending_transmission);
170 _callback_code = callback_code;
174 void FGATC::ConditionalTransmit(double timeout, int callback_code) {
175 SG_LOG(SG_ATC, SG_INFO, "Timed transmit called by " << ident << " " << _type << ", msg = " << pending_transmission);
177 _callback_code = callback_code;
181 void FGATC::ImmediateTransmit(int callback_code) {
182 SG_LOG(SG_ATC, SG_INFO, "Immediate transmit called by " << ident << " " << _type << ", msg = " << pending_transmission);
184 //Render(pending_transmission, ident, false);
185 Render(pending_transmission);
186 // At the moment Render doesn't work except for ATIS
187 //globals->get_ATC_display()->RegisterSingleMessage(pending_transmission);
190 ProcessCallback(callback_code);
194 // Derived classes should override this.
195 void FGATC::ProcessCallback(int code) {
198 void FGATC::AddPlane(string pid) {
201 int FGATC::RemovePlane() {
205 void FGATC::SetData(ATCData* d) {
218 // Render a transmission
219 // Outputs the transmission either on screen or as audio depending on user preference
220 // The refname is a string to identify this sample to the sound manager
221 // The repeating flag indicates whether the message should be repeated continuously or played once.
222 void FGATC::Render(string msg, string refname, bool repeating) {
223 #ifdef ENABLE_AUDIO_SUPPORT
224 _voice = (_voiceOK && fgGetBool("/sim/sound/voice"));
227 unsigned char* buf = _vPtr->WriteMessage((char*)msg.c_str(), len, _voice);
229 SGSoundSample *simple
230 = new SGSoundSample(buf, len, 8000, false);
231 // TODO - at the moment the volume is always set off comm1
232 // and can't be changed after the transmission has started.
233 simple->set_volume(5.0 * fgGetDouble("/instrumentation/comm[0]/volume"));
234 globals->get_soundmgr()->add(simple, refname);
236 globals->get_soundmgr()->play_looped(refname);
238 globals->get_soundmgr()->play_once(refname);
243 #endif // ENABLE_AUDIO_SUPPORT
245 // first rip the underscores and the pause hints out of the string - these are for the convienience of the voice parser
246 for(unsigned int i = 0; i < msg.length(); ++i) {
247 if((msg.substr(i,1) == "_") || (msg.substr(i,1) == "/")) {
252 globals->get_ATC_display()->RegisterRepeatingMessage(msg);
254 globals->get_ATC_display()->RegisterSingleMessage(msg);
261 // Cease rendering a transmission.
262 void FGATC::NoRender(string refname) {
265 #ifdef ENABLE_AUDIO_SUPPORT
266 globals->get_soundmgr()->stop(refname);
267 globals->get_soundmgr()->remove(refname);
270 globals->get_ATC_display()->CancelRepeatingMessage();
276 // Generate the text of a message from its parameters and the current context.
277 string FGATC::GenText(const string& m, int c) {
281 ostream& operator << (ostream& os, atc_type atc) {
283 case(INVALID): return(os << "INVALID");
284 case(ATIS): return(os << "ATIS");
285 case(GROUND): return(os << "GROUND");
286 case(TOWER): return(os << "TOWER");
287 case(APPROACH): return(os << "APPROACH");
288 case(DEPARTURE): return(os << "DEPARTURE");
289 case(ENROUTE): return(os << "ENROUTE");
291 return(os << "ERROR - Unknown switch in atc_type operator << ");