Document domain parameter of wxTranslations::GetTranslatedString().
[wxWidgets.git] / utils / emulator / src / emulator.cpp
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: emulator.cpp
3 // Purpose: Emulator wxWidgets sample
4 // Author: Julian Smart
5 // Modified by:
6 // Created: 04/01/98
7 // Copyright: (c) Julian Smart
8 // Licence: wxWindows licence
9 /////////////////////////////////////////////////////////////////////////////
10
11 // ============================================================================
12 // declarations
13 // ============================================================================
14
15 // ----------------------------------------------------------------------------
16 // headers
17 // ----------------------------------------------------------------------------
18
19 // For compilers that support precompilation, includes "wx/wx.h".
20 #include "wx/wxprec.h"
21
22 #ifdef __BORLANDC__
23 #pragma hdrstop
24 #endif
25
26 // for all others, include the necessary headers (this file is usually all you
27 // need because it includes almost all "standard" wxWidgets headers)
28 #ifndef WX_PRECOMP
29 #include "wx/wx.h"
30 #endif
31
32 #include "wx/confbase.h"
33 #include "wx/fileconf.h"
34 #include "wx/cmdline.h"
35 #include "wx/image.h"
36 #include "wx/file.h"
37 #include "wx/filename.h"
38
39 #ifdef __WXX11__
40 #include "wx/x11/reparent.h"
41 #endif
42
43 #include "emulator.h"
44
45 // ----------------------------------------------------------------------------
46 // resources
47 // ----------------------------------------------------------------------------
48
49 // the application icon (under Windows and OS/2 it is in resources)
50 #ifndef wxHAS_IMAGES_IN_RESOURCES
51 #include "emulator.xpm"
52 #endif
53
54 // ----------------------------------------------------------------------------
55 // event tables and other macros for wxWidgets
56 // ----------------------------------------------------------------------------
57
58 // the event tables connect the wxWidgets events with the functions (event
59 // handlers) which process them. It can be also done at run-time, but for the
60 // simple menu events like this the static method is much simpler.
61 BEGIN_EVENT_TABLE(wxEmulatorFrame, wxFrame)
62 EVT_MENU(Emulator_Quit, wxEmulatorFrame::OnQuit)
63 EVT_MENU(Emulator_About, wxEmulatorFrame::OnAbout)
64 EVT_CLOSE(wxEmulatorFrame::OnCloseWindow)
65 END_EVENT_TABLE()
66
67 // Create a new application object: this macro will allow wxWidgets to create
68 // the application object during program execution (it's better than using a
69 // static object for many reasons) and also declares the accessor function
70 // wxGetApp() which will return the reference of the right type (i.e. wxEmulatorApp and
71 // not wxApp)
72 IMPLEMENT_APP(wxEmulatorApp)
73
74 static const wxCmdLineEntryDesc sg_cmdLineDesc[] =
75 {
76 { wxCMD_LINE_OPTION, "u", "use-display", "display number to use (default 100)" },
77
78 { wxCMD_LINE_SWITCH, "h", "help", "displays help on the command line parameters" },
79 { wxCMD_LINE_SWITCH, "v", "version", "print version" },
80
81 { wxCMD_LINE_PARAM, NULL, NULL, "config file 1", wxCMD_LINE_VAL_STRING, wxCMD_LINE_PARAM_OPTIONAL },
82
83 wxCMD_LINE_DESC_END
84 };
85
86
87 // ============================================================================
88 // implementation
89 // ============================================================================
90
91 // ----------------------------------------------------------------------------
92 // the application class
93 // ----------------------------------------------------------------------------
94
95 wxEmulatorApp::wxEmulatorApp()
96 {
97 m_xnestWindow = NULL;
98 m_containerWindow = NULL;
99 m_displayNumber = wxT("100");
100 m_xnestPID = 0;
101
102 }
103
104 // 'Main program' equivalent: the program execution "starts" here
105 bool wxEmulatorApp::OnInit()
106 {
107 #if wxUSE_LOG
108 wxLog::DisableTimestamp();
109 #endif // wxUSE_LOG
110 wxInitAllImageHandlers();
111
112 wxString currentDir = wxGetCwd();
113
114 // Use argv to get current app directory
115 m_appDir = wxFindAppPath(argv[0], currentDir, wxT("WXEMUDIR"));
116
117 // If the development version, go up a directory.
118 #ifdef __WXMSW__
119 if ((m_appDir.Right(5).CmpNoCase(wxT("DEBUG")) == 0) ||
120 (m_appDir.Right(11).CmpNoCase(wxT("DEBUGSTABLE")) == 0) ||
121 (m_appDir.Right(7).CmpNoCase(wxT("RELEASE")) == 0) ||
122 (m_appDir.Right(13).CmpNoCase(wxT("RELEASESTABLE")) == 0)
123 )
124 m_appDir = wxPathOnly(m_appDir);
125 #endif
126
127 // Parse the command-line parameters and options
128 wxCmdLineParser parser(sg_cmdLineDesc, argc, argv);
129 int res;
130 {
131 wxLogNull log;
132 res = parser.Parse();
133 }
134 if (res == -1 || res > 0 || parser.Found(wxT("h")))
135 {
136 #ifdef __X__
137 wxLog::SetActiveTarget(new wxLogStderr);
138 #endif
139 parser.Usage();
140 return false;
141 }
142 if (parser.Found(wxT("v")))
143 {
144 #ifdef __X__
145 wxLog::SetActiveTarget(new wxLogStderr);
146 #endif
147 wxString msg;
148 msg.Printf(wxT("wxWidgets PDA Emulator (c) Julian Smart, 2002 Version %.2f, %s"), wxEMULATOR_VERSION, __DATE__);
149 wxLogMessage(msg);
150 return false;
151 }
152 if (parser.Found(wxT("u"), & m_displayNumber))
153 {
154 // Should only be number, so strip out anything before
155 // and including a : character
156 if (m_displayNumber.Find(wxT(':')) != -1)
157 {
158 m_displayNumber = m_displayNumber.AfterFirst(wxT(':'));
159 }
160 }
161 if (parser.GetParamCount() == 0)
162 {
163 m_emulatorInfo.m_emulatorFilename = wxT("default.wxe");
164 }
165 else if (parser.GetParamCount() > 0)
166 {
167 m_emulatorInfo.m_emulatorFilename = parser.GetParam(0);
168 }
169
170 // Load the emulation info
171 if (!LoadEmulator(m_appDir))
172 {
173 //wxMessageBox(wxT("Sorry, could not load this emulator. Please check bitmaps are valid."));
174 return false;
175 }
176
177 // create the main application window
178 wxEmulatorFrame *frame = new wxEmulatorFrame(wxT("wxEmulator"),
179 wxPoint(50, 50), wxSize(450, 340));
180
181 #if wxUSE_STATUSBAR
182 frame->SetStatusText(m_emulatorInfo.m_emulatorTitle, 0);
183
184 wxString sizeStr;
185 sizeStr.Printf(wxT("Screen: %dx%d"), (int) m_emulatorInfo.m_emulatorScreenSize.x,
186 (int) m_emulatorInfo.m_emulatorScreenSize.y);
187 frame->SetStatusText(sizeStr, 1);
188 #endif // wxUSE_STATUSBAR
189
190 m_containerWindow = new wxEmulatorContainer(frame, wxID_ANY);
191
192 frame->SetClientSize(m_emulatorInfo.m_emulatorDeviceSize.x,
193 m_emulatorInfo.m_emulatorDeviceSize.y);
194
195 // and show it (the frames, unlike simple controls, are not shown when
196 // created initially)
197 frame->Show(true);
198
199 #ifdef __WXX11__
200 m_xnestWindow = new wxAdoptedWindow;
201
202 wxString cmd;
203 cmd.Printf(wxT("Xnest :%s -geometry %dx%d"),
204 m_displayNumber.c_str(),
205 (int) m_emulatorInfo.m_emulatorScreenSize.x,
206 (int) m_emulatorInfo.m_emulatorScreenSize.y);
207
208 // Asynchronously executes Xnest
209 m_xnestPID = wxExecute(cmd);
210 if (0 == m_xnestPID)
211 {
212 frame->Destroy();
213 wxMessageBox(wxT("Sorry, could not run Xnest. Please check your PATH."));
214 return false;
215 }
216
217 wxReparenter reparenter;
218 if (!reparenter.WaitAndReparent(m_containerWindow, m_xnestWindow, wxT("Xnest")))
219 {
220 wxMessageBox(wxT("Sorry, could not reparent Xnest.."));
221 frame->Destroy();
222 return false;
223 }
224
225 #endif
226 m_containerWindow->DoResize();
227
228 // success: wxApp::OnRun() will be called which will enter the main message
229 // loop and the application will run. If we returned false here, the
230 // application would exit immediately.
231 return true;
232 }
233
234 // Prepend the current program directory to the name
235 wxString wxEmulatorApp::GetFullAppPath(const wxString& filename) const
236 {
237 wxString path(m_appDir);
238 if (path.Last() != '\\' && path.Last() != '/' && filename[0] != '\\' && filename[0] != '/')
239 #ifdef __X__
240 path += '/';
241 #else
242 path += '\\';
243 #endif
244 path += filename;
245
246 return path;
247 }
248
249
250 // Load the specified emulator.
251 // For now, hard-wired. TODO: make this configurable
252 bool wxEmulatorApp::LoadEmulator(const wxString& appDir)
253 {
254 // Load config file and bitmaps
255 return m_emulatorInfo.Load(appDir);
256 }
257
258 // ----------------------------------------------------------------------------
259 // main frame
260 // ----------------------------------------------------------------------------
261
262 // frame constructor
263 wxEmulatorFrame::wxEmulatorFrame(const wxString& title,
264 const wxPoint& pos, const wxSize& size)
265 : wxFrame(NULL, wxID_ANY, title, pos, size)
266 {
267 // set the frame icon
268 SetIcon(wxICON(emulator));
269
270 #if wxUSE_MENUS
271 // create a menu bar
272 wxMenu *menuFile = new wxMenu;
273
274 // the "About" item should be in the help menu
275 wxMenu *helpMenu = new wxMenu;
276 helpMenu->Append(Emulator_About, wxT("&About\tF1"), wxT("Show about dialog"));
277
278 menuFile->Append(Emulator_Quit, wxT("E&xit\tAlt-X"), wxT("Quit this program"));
279
280 // now append the freshly created menu to the menu bar...
281 wxMenuBar *menuBar = new wxMenuBar();
282 menuBar->Append(menuFile, wxT("&File"));
283 menuBar->Append(helpMenu, wxT("&Help"));
284
285 // ... and attach this menu bar to the frame
286 SetMenuBar(menuBar);
287 #endif // wxUSE_MENUS
288
289 #if wxUSE_STATUSBAR
290 // create a status bar just for fun (by default with 1 pane only)
291 CreateStatusBar(2);
292 #endif // wxUSE_STATUSBAR
293 }
294
295
296 // event handlers
297
298 void wxEmulatorFrame::OnQuit(wxCommandEvent& WXUNUSED(event))
299 {
300 // true is to force the frame to close
301 Close(true);
302 }
303
304 void wxEmulatorFrame::OnAbout(wxCommandEvent& WXUNUSED(event))
305 {
306 wxString msg;
307 msg.Printf( wxT("wxEmulator is an environment for testing embedded X11 apps.\n"));
308
309 wxMessageBox(msg, wxT("About wxEmulator"), wxOK | wxICON_INFORMATION, this);
310 }
311
312 void wxEmulatorFrame::OnCloseWindow(wxCloseEvent& WXUNUSED(event))
313 {
314 #ifdef __WXX11__
315 if (wxGetApp().m_xnestWindow)
316 {
317 wxGetApp().m_xnestWindow->SetHandle((WXWindow) NULL);
318 }
319 #endif
320 this->Destroy();
321 if (wxGetApp().m_xnestPID > 0)
322 {
323 wxKill(wxGetApp().m_xnestPID);
324 wxGetApp().m_xnestPID = 0;
325 }
326 }
327
328 IMPLEMENT_CLASS(wxEmulatorContainer, wxWindow)
329
330 BEGIN_EVENT_TABLE(wxEmulatorContainer, wxWindow)
331 EVT_SIZE(wxEmulatorContainer::OnSize)
332 EVT_PAINT(wxEmulatorContainer::OnPaint)
333 EVT_ERASE_BACKGROUND(wxEmulatorContainer::OnEraseBackground)
334 END_EVENT_TABLE()
335
336 wxEmulatorContainer::wxEmulatorContainer(wxWindow* parent, wxWindowID id):
337 wxWindow(parent, id, wxDefaultPosition, wxDefaultSize)
338 {
339 }
340
341 void wxEmulatorContainer::OnSize(wxSizeEvent& WXUNUSED(event))
342 {
343 DoResize();
344 }
345
346 void wxEmulatorContainer::DoResize()
347 {
348 wxSize sz = GetClientSize();
349 if (wxGetApp().m_xnestWindow
350 #ifdef __WXX11__
351 && wxGetApp().m_xnestWindow->X11GetMainWindow()
352 #endif
353 )
354 {
355 int deviceWidth = wxGetApp().m_emulatorInfo.m_emulatorDeviceSize.x;
356 int deviceHeight = wxGetApp().m_emulatorInfo.m_emulatorDeviceSize.y;
357
358 int x = wxMax(0, (int) ((sz.x - deviceWidth)/2.0));
359 int y = wxMax(0, (int) ((sz.y - deviceHeight)/2.0));
360
361 x += wxGetApp().m_emulatorInfo.m_emulatorScreenPosition.x;
362 y += wxGetApp().m_emulatorInfo.m_emulatorScreenPosition.y;
363
364 wxGetApp().m_xnestWindow->Move(x, y);
365 }
366 Refresh();
367 }
368
369 void wxEmulatorContainer::OnPaint(wxPaintEvent& WXUNUSED(event))
370 {
371 wxPaintDC dc(this);
372
373 wxSize sz = GetClientSize();
374 if (wxGetApp().m_emulatorInfo.m_emulatorBackgroundBitmap.IsOk())
375 {
376 int deviceWidth = wxGetApp().m_emulatorInfo.m_emulatorDeviceSize.x;
377 int deviceHeight = wxGetApp().m_emulatorInfo.m_emulatorDeviceSize.y;
378
379 int x = wxMax(0, (int) ((sz.x - deviceWidth)/2.0));
380 int y = wxMax(0, (int) ((sz.y - deviceHeight)/2.0));
381
382 dc.DrawBitmap(wxGetApp().m_emulatorInfo.m_emulatorBackgroundBitmap, x, y);
383 }
384 }
385
386 void wxEmulatorContainer::OnEraseBackground(wxEraseEvent& event)
387 {
388 wxDC* dc wxDUMMY_INITIALIZE(NULL);
389
390 if (event.GetDC())
391 {
392 dc = event.GetDC();
393 }
394 else
395 {
396 dc = new wxClientDC(this);
397 }
398
399 dc->SetBackground(wxBrush(wxGetApp().m_emulatorInfo.m_emulatorBackgroundColour, wxSOLID));
400 dc->Clear();
401
402 if (!event.GetDC())
403 delete dc;
404 }
405
406 // Information about the emulator decorations
407
408 void wxEmulatorInfo::Copy(const wxEmulatorInfo& info)
409 {
410 m_emulatorFilename = info.m_emulatorFilename;
411 m_emulatorTitle = info.m_emulatorTitle;
412 m_emulatorDescription = info.m_emulatorDescription;
413 m_emulatorScreenPosition = info.m_emulatorScreenPosition;
414 m_emulatorScreenSize = info.m_emulatorScreenSize;
415 m_emulatorBackgroundBitmap = info.m_emulatorBackgroundBitmap;
416 m_emulatorBackgroundBitmapName = info.m_emulatorBackgroundBitmapName;
417 m_emulatorBackgroundColour = info.m_emulatorBackgroundColour;
418 m_emulatorDeviceSize = info.m_emulatorDeviceSize;
419 }
420
421 // Initialisation
422 void wxEmulatorInfo::Init()
423 {
424 m_emulatorDeviceSize = wxSize(260, 340);
425 m_emulatorScreenSize = wxSize(240, 320);
426 }
427
428 // Loads bitmaps
429 bool wxEmulatorInfo::Load(const wxString& appDir)
430 {
431 // Try to find absolute path
432 wxString absoluteConfigPath = m_emulatorFilename;
433 if ( !::wxIsAbsolutePath(absoluteConfigPath) )
434 {
435 wxString currDir = wxGetCwd();
436 absoluteConfigPath = currDir + wxString(wxFILE_SEP_PATH) + m_emulatorFilename;
437 if ( !wxFile::Exists(absoluteConfigPath) )
438 {
439 absoluteConfigPath = appDir + wxString(wxFILE_SEP_PATH)
440 + m_emulatorFilename;
441 }
442 }
443
444 if ( !wxFile::Exists(absoluteConfigPath) )
445 {
446 wxString str;
447 str.Printf( wxT("Could not find config file %s"),
448 absoluteConfigPath.c_str() );
449
450 wxMessageBox(str);
451 return false;
452 }
453
454 wxString rootPath = wxPathOnly(absoluteConfigPath);
455
456 {
457 wxFileConfig config(wxT("wxEmulator"), wxT("wxWidgets"),
458 absoluteConfigPath, wxEmptyString, wxCONFIG_USE_LOCAL_FILE);
459
460 config.Read(wxT("/General/title"), & m_emulatorTitle);
461 config.Read(wxT("/General/description"), & m_emulatorDescription);
462 config.Read(wxT("/General/backgroundBitmap"), & m_emulatorBackgroundBitmapName);
463
464 wxString colString;
465 if (config.Read(wxT("/General/backgroundColour"), & colString) ||
466 config.Read(wxT("/General/backgroundColor"), & colString)
467 )
468 {
469 m_emulatorBackgroundColour = wxHexStringToColour(colString);
470 }
471
472 int x = 0, y = 0, w = 0, h = 0, dw = 0, dh = 0;
473 config.Read(wxT("/General/screenX"), & x);
474 config.Read(wxT("/General/screenY"), & y);
475 config.Read(wxT("/General/screenWidth"), & w);
476 config.Read(wxT("/General/screenHeight"), & h);
477 if (config.Read(wxT("/General/deviceWidth"), & dw) && config.Read(wxT("/General/deviceHeight"), & dh))
478 {
479 m_emulatorDeviceSize = wxSize(dw, dh);
480 }
481
482 m_emulatorScreenPosition = wxPoint(x, y);
483 m_emulatorScreenSize = wxSize(w, h);
484 }
485
486 if (!m_emulatorBackgroundBitmapName.empty())
487 {
488 wxString absoluteBackgroundBitmapName = rootPath + wxString(wxFILE_SEP_PATH) + m_emulatorBackgroundBitmapName;
489 if ( !wxFile::Exists(absoluteBackgroundBitmapName) )
490 {
491 wxString str;
492 str.Printf( wxT("Could not find bitmap %s"),
493 absoluteBackgroundBitmapName.c_str() );
494 wxMessageBox(str);
495 return false;
496 }
497
498 wxBitmapType type = wxDetermineImageType(m_emulatorBackgroundBitmapName);
499 if (type == wxBITMAP_TYPE_INVALID)
500 return false;
501
502 if (!m_emulatorBackgroundBitmap.LoadFile(m_emulatorBackgroundBitmapName, type))
503 {
504 wxString str;
505 str.Printf( wxT("Could not load bitmap file %s"),
506 m_emulatorBackgroundBitmapName.c_str() );
507 wxMessageBox(str);
508 return false;
509 }
510
511 m_emulatorDeviceSize = wxSize(m_emulatorBackgroundBitmap.GetWidth(),
512 m_emulatorBackgroundBitmap.GetHeight());
513 }
514 return true;
515 }
516
517 // Returns the image type, or -1, determined from the extension.
518 wxBitmapType wxDetermineImageType(const wxString& filename)
519 {
520 wxString path, name, ext;
521
522 wxFileName::SplitPath(filename, & path, & name, & ext);
523
524 ext.MakeLower();
525 if (ext == wxT("jpg") || ext == wxT("jpeg"))
526 return wxBITMAP_TYPE_JPEG;
527 if (ext == wxT("gif"))
528 return wxBITMAP_TYPE_GIF;
529 if (ext == wxT("bmp"))
530 return wxBITMAP_TYPE_BMP;
531 if (ext == wxT("png"))
532 return wxBITMAP_TYPE_PNG;
533 if (ext == wxT("pcx"))
534 return wxBITMAP_TYPE_PCX;
535 if (ext == wxT("tif") || ext == wxT("tiff"))
536 return wxBITMAP_TYPE_TIFF;
537
538 return wxBITMAP_TYPE_INVALID;
539 }
540
541 // Convert a colour to a 6-digit hex string
542 wxString wxColourToHexString(const wxColour& col)
543 {
544 wxString hex;
545
546 hex += wxDecToHex(col.Red());
547 hex += wxDecToHex(col.Green());
548 hex += wxDecToHex(col.Blue());
549
550 return hex;
551 }
552
553 // Convert 6-digit hex string to a colour
554 wxColour wxHexStringToColour(const wxString& hex)
555 {
556 unsigned char r = (unsigned char)wxHexToDec(hex.Mid(0, 2));
557 unsigned char g = (unsigned char)wxHexToDec(hex.Mid(2, 2));
558 unsigned char b = (unsigned char)wxHexToDec(hex.Mid(4, 2));
559
560 return wxColour(r, g, b);
561 }
562
563 // Find the absolute path where this application has been run from.
564 // argv0 is wxTheApp->argv[0]
565 // cwd is the current working directory (at startup)
566 // appVariableName is the name of a variable containing the directory for this app, e.g.
567 // MYAPPDIR. This is checked first.
568
569 wxString wxFindAppPath(const wxString& argv0, const wxString& cwd, const wxString& appVariableName)
570 {
571 wxString str;
572
573 // Try appVariableName
574 if (!appVariableName.empty())
575 {
576 str = wxGetenv(appVariableName);
577 if (!str.empty())
578 return str;
579 }
580
581 if (wxIsAbsolutePath(argv0))
582 return wxPathOnly(argv0);
583 else
584 {
585 // Is it a relative path?
586 wxString currentDir(cwd);
587 if (!wxEndsWithPathSeparator(currentDir))
588 currentDir += wxFILE_SEP_PATH;
589
590 str = currentDir + argv0;
591 if ( wxFile::Exists(str) )
592 return wxPathOnly(str);
593 }
594
595 // OK, it's neither an absolute path nor a relative path.
596 // Search PATH.
597
598 wxPathList pathList;
599 pathList.AddEnvList(wxT("PATH"));
600 str = pathList.FindAbsoluteValidPath(argv0);
601 if (!str.empty())
602 return wxPathOnly(str);
603
604 // Failed
605 return wxEmptyString;
606 }
607