]> git.saurik.com Git - wxWidgets.git/blame - demos/life/life.cpp
reSWIGged
[wxWidgets.git] / demos / life / life.cpp
CommitLineData
5a1dca12
GRG
1/////////////////////////////////////////////////////////////////////////////
2// Name: life.cpp
29b07a38 3// Purpose: The game of Life, created by J. H. Conway
5a1dca12
GRG
4// Author: Guillermo Rodriguez Garcia, <guille@iies.es>
5// Modified by:
6// Created: Jan/2000
7// RCS-ID: $Id$
8// Copyright: (c) 2000, Guillermo Rodriguez Garcia
9// Licence: wxWindows licence
10/////////////////////////////////////////////////////////////////////////////
11
12// ==========================================================================
e0a40292 13// headers, declarations, constants
5a1dca12
GRG
14// ==========================================================================
15
5a1dca12 16#ifdef __GNUG__
2480be69 17 #pragma implementation "life.h"
5a1dca12
GRG
18#endif
19
2fa7c206
JS
20// For compilers that support precompilation, includes "wx/wx.h".
21#include "wx/wxprec.h"
22
23#ifdef __BORLANDC__
29b07a38 24 #pragma hdrstop
2fa7c206
JS
25#endif
26
27#ifndef WX_PRECOMP
29b07a38 28 #include "wx/wx.h"
2fa7c206
JS
29#endif
30
5a1dca12 31#include "wx/statline.h"
f6bcfd97
BP
32#include "wx/wfstream.h"
33#include "wx/filedlg.h"
5d2ac6b8 34#include "wx/stockitem.h"
2480be69
GRG
35
36#include "life.h"
37#include "game.h"
38#include "dialogs.h"
f6bcfd97 39#include "reader.h"
5a1dca12
GRG
40
41// --------------------------------------------------------------------------
42// resources
43// --------------------------------------------------------------------------
44
e334d0ea 45#if defined(__WXGTK__) || defined(__WXMOTIF__) || defined(__WXMAC__) || defined(__WXMGL__) || defined(__WXX11__)
29b07a38 46 // application icon
5a1dca12
GRG
47 #include "mondrian.xpm"
48
49 // bitmap buttons for the toolbar
50 #include "bitmaps/reset.xpm"
f6bcfd97 51 #include "bitmaps/open.xpm"
5a1dca12
GRG
52 #include "bitmaps/play.xpm"
53 #include "bitmaps/stop.xpm"
e0a40292
GRG
54 #include "bitmaps/zoomin.xpm"
55 #include "bitmaps/zoomout.xpm"
f6bcfd97 56 #include "bitmaps/info.xpm"
29b07a38
GRG
57
58 // navigator
59 #include "bitmaps/north.xpm"
60 #include "bitmaps/south.xpm"
61 #include "bitmaps/east.xpm"
62 #include "bitmaps/west.xpm"
63 #include "bitmaps/center.xpm"
5a1dca12
GRG
64#endif
65
5a1dca12
GRG
66// --------------------------------------------------------------------------
67// constants
68// --------------------------------------------------------------------------
69
22c1c01b 70// IDs for the controls and the menu commands. Exluding those already defined
be5a51fb 71// by wxWidgets, such as wxID_NEW.
5a1dca12
GRG
72enum
73{
29b07a38 74 // timer
22c1c01b 75 ID_TIMER = wxID_HIGHEST,
29b07a38 76
f6bcfd97 77 // file menu
087e4f4a 78 ID_SAMPLES,
29b07a38 79
f6bcfd97 80 // view menu
29b07a38
GRG
81 ID_SHOWNAV,
82 ID_ORIGIN,
83 ID_CENTER,
84 ID_NORTH,
85 ID_SOUTH,
86 ID_EAST,
87 ID_WEST,
f6bcfd97
BP
88 ID_INFO,
89
90 // game menu
91 ID_START,
92 ID_STEP,
f6bcfd97
BP
93 ID_TOPSPEED,
94
95 // speed selection slider
22c1c01b 96 ID_SLIDER
5a1dca12
GRG
97};
98
99// --------------------------------------------------------------------------
be5a51fb 100// event tables and other macros for wxWidgets
5a1dca12
GRG
101// --------------------------------------------------------------------------
102
103// Event tables
5a1dca12 104BEGIN_EVENT_TABLE(LifeFrame, wxFrame)
5d2ac6b8
WS
105 EVT_MENU (wxID_NEW, LifeFrame::OnMenu)
106 EVT_MENU (wxID_OPEN, LifeFrame::OnOpen)
107 EVT_MENU (ID_SAMPLES, LifeFrame::OnSamples)
108 EVT_MENU (wxID_ABOUT, LifeFrame::OnMenu)
109 EVT_MENU (wxID_EXIT, LifeFrame::OnMenu)
110 EVT_MENU (ID_SHOWNAV, LifeFrame::OnMenu)
111 EVT_MENU (ID_ORIGIN, LifeFrame::OnNavigate)
112 EVT_BUTTON (ID_CENTER, LifeFrame::OnNavigate)
113 EVT_BUTTON (ID_NORTH, LifeFrame::OnNavigate)
114 EVT_BUTTON (ID_SOUTH, LifeFrame::OnNavigate)
115 EVT_BUTTON (ID_EAST, LifeFrame::OnNavigate)
116 EVT_BUTTON (ID_WEST, LifeFrame::OnNavigate)
117 EVT_MENU (wxID_ZOOM_IN, LifeFrame::OnZoom)
118 EVT_MENU (wxID_ZOOM_OUT,LifeFrame::OnZoom)
119 EVT_MENU (ID_INFO, LifeFrame::OnMenu)
120 EVT_MENU (ID_START, LifeFrame::OnMenu)
121 EVT_MENU (ID_STEP, LifeFrame::OnMenu)
122 EVT_MENU (wxID_STOP, LifeFrame::OnMenu)
123 EVT_MENU (ID_TOPSPEED, LifeFrame::OnMenu)
124 EVT_COMMAND_SCROLL (ID_SLIDER, LifeFrame::OnSlider)
125 EVT_TIMER (ID_TIMER, LifeFrame::OnTimer)
126 EVT_CLOSE ( LifeFrame::OnClose)
ecbdd409 127END_EVENT_TABLE()
5a1dca12 128
29b07a38
GRG
129BEGIN_EVENT_TABLE(LifeNavigator, wxMiniFrame)
130 EVT_CLOSE ( LifeNavigator::OnClose)
131END_EVENT_TABLE()
132
e0a40292
GRG
133BEGIN_EVENT_TABLE(LifeCanvas, wxWindow)
134 EVT_PAINT ( LifeCanvas::OnPaint)
135 EVT_SCROLLWIN ( LifeCanvas::OnScroll)
136 EVT_SIZE ( LifeCanvas::OnSize)
f6bcfd97
BP
137 EVT_MOTION ( LifeCanvas::OnMouse)
138 EVT_LEFT_DOWN ( LifeCanvas::OnMouse)
139 EVT_LEFT_UP ( LifeCanvas::OnMouse)
140 EVT_LEFT_DCLICK ( LifeCanvas::OnMouse)
e0a40292 141 EVT_ERASE_BACKGROUND( LifeCanvas::OnEraseBackground)
ecbdd409 142END_EVENT_TABLE()
5a1dca12 143
5a1dca12
GRG
144
145// Create a new application object
146IMPLEMENT_APP(LifeApp)
147
e0a40292 148
5a1dca12
GRG
149// ==========================================================================
150// implementation
151// ==========================================================================
152
2480be69 153// some shortcuts
f6bcfd97 154#define ADD_TOOL(id, bmp, tooltip, help) \
422d0ff0 155 toolBar->AddTool(id, bmp, wxNullBitmap, false, wxDefaultCoord, wxDefaultCoord, (wxObject *)NULL, tooltip, help)
2480be69 156
2480be69 157
5a1dca12
GRG
158// --------------------------------------------------------------------------
159// LifeApp
160// --------------------------------------------------------------------------
161
e0a40292 162// 'Main program' equivalent: the program execution "starts" here
5a1dca12
GRG
163bool LifeApp::OnInit()
164{
165 // create the main application window
166 LifeFrame *frame = new LifeFrame();
167
168 // show it and tell the application that it's our main window
22c1c01b 169 frame->Show(true);
5a1dca12
GRG
170 SetTopWindow(frame);
171
dbf75be7
GRG
172 // just for Motif
173#ifdef __WXMOTIF__
174 frame->UpdateInfoText();
175#endif
176
5a1dca12 177 // enter the main message loop and run the app
22c1c01b 178 return true;
5a1dca12
GRG
179}
180
181// --------------------------------------------------------------------------
182// LifeFrame
183// --------------------------------------------------------------------------
184
185// frame constructor
22c1c01b 186LifeFrame::LifeFrame() : wxFrame( (wxFrame *) NULL, wxID_ANY,
e4535381 187 _("Life!"), wxDefaultPosition )
5a1dca12
GRG
188{
189 // frame icon
190 SetIcon(wxICON(mondrian));
191
192 // menu bar
22c1c01b
DS
193 wxMenu *menuFile = new wxMenu(wxMENU_TEAROFF);
194 wxMenu *menuView = new wxMenu(wxMENU_TEAROFF);
195 wxMenu *menuGame = new wxMenu(wxMENU_TEAROFF);
196 wxMenu *menuHelp = new wxMenu(wxMENU_TEAROFF);
5a1dca12 197
5d2ac6b8
WS
198 menuFile->Append(wxID_NEW, wxGetStockLabel(wxID_NEW), _("Start a new game"));
199 menuFile->Append(wxID_OPEN, wxGetStockLabel(wxID_OPEN), _("Open an existing Life pattern"));
f6bcfd97 200 menuFile->Append(ID_SAMPLES, _("&Sample game..."), _("Select a sample configuration"));
5a1dca12 201 menuFile->AppendSeparator();
5d2ac6b8 202 menuFile->Append(wxID_EXIT, wxGetStockLabel(wxID_EXIT, true, _T("Alt-X")), _("Quit this program"));
087e4f4a 203
22c1c01b
DS
204 menuView->Append(ID_SHOWNAV, _("Navigation &toolbox"), _("Show or hide toolbox"), wxITEM_CHECK);
205 menuView->Check(ID_SHOWNAV, true);
29b07a38 206 menuView->AppendSeparator();
f6bcfd97
BP
207 menuView->Append(ID_ORIGIN, _("&Absolute origin"), _("Go to (0, 0)"));
208 menuView->Append(ID_CENTER, _("&Center of mass"), _("Find center of mass"));
209 menuView->Append(ID_NORTH, _("&North"), _("Find northernmost cell"));
210 menuView->Append(ID_SOUTH, _("&South"), _("Find southernmost cell"));
211 menuView->Append(ID_EAST, _("&East"), _("Find easternmost cell"));
212 menuView->Append(ID_WEST, _("&West"), _("Find westernmost cell"));
29b07a38 213 menuView->AppendSeparator();
5d2ac6b8
WS
214 menuView->Append(wxID_ZOOM_IN, wxGetStockLabel(wxID_ZOOM_IN, true, _T("Ctrl-I")), _("Zoom in"));
215 menuView->Append(wxID_ZOOM_OUT, wxGetStockLabel(wxID_ZOOM_OUT, true, _T("Ctrl-O")), _("Zoom out"));
22c1c01b 216 menuView->Append(ID_INFO, _("&Description\tCtrl-D"), _("View pattern description"));
29b07a38 217
087e4f4a
GRG
218 menuGame->Append(ID_START, _("&Start\tCtrl-S"), _("Start"));
219 menuGame->Append(ID_STEP, _("&Next\tCtrl-N"), _("Single step"));
5d2ac6b8
WS
220 menuGame->Append(wxID_STOP, wxGetStockLabel(wxID_STOP, true, _T("Ctrl-T")), _("Stop"));
221 menuGame->Enable(wxID_STOP, false);
087e4f4a 222 menuGame->AppendSeparator();
f6bcfd97 223 menuGame->Append(ID_TOPSPEED, _("T&op speed!"), _("Go as fast as possible"));
087e4f4a 224
22c1c01b
DS
225 menuHelp->Append(wxID_ABOUT, _("&About\tCtrl-A"), _("Show about dialog"));
226
5a1dca12
GRG
227 wxMenuBar *menuBar = new wxMenuBar();
228 menuBar->Append(menuFile, _("&File"));
29b07a38 229 menuBar->Append(menuView, _("&View"));
087e4f4a 230 menuBar->Append(menuGame, _("&Game"));
22c1c01b 231 menuBar->Append(menuHelp, _("&Help"));
5a1dca12
GRG
232 SetMenuBar(menuBar);
233
234 // tool bar
f6bcfd97 235 wxBitmap tbBitmaps[7];
471ed537 236
5a1dca12 237 tbBitmaps[0] = wxBITMAP(reset);
f6bcfd97
BP
238 tbBitmaps[1] = wxBITMAP(open);
239 tbBitmaps[2] = wxBITMAP(zoomin);
240 tbBitmaps[3] = wxBITMAP(zoomout);
241 tbBitmaps[4] = wxBITMAP(info);
242 tbBitmaps[5] = wxBITMAP(play);
243 tbBitmaps[6] = wxBITMAP(stop);
5a1dca12
GRG
244
245 wxToolBar *toolBar = CreateToolBar();
246 toolBar->SetMargins(5, 5);
247 toolBar->SetToolBitmapSize(wxSize(16, 16));
f6bcfd97 248
5d2ac6b8
WS
249 ADD_TOOL(wxID_NEW, tbBitmaps[0], wxGetStockLabel(wxID_NEW, false), _("Start a new game"));
250 ADD_TOOL(wxID_OPEN, tbBitmaps[1], wxGetStockLabel(wxID_OPEN, false), _("Open an existing Life pattern"));
e4535381
JS
251
252 // PocketPC only works with standard identifiers, and there's restricted space
253#ifndef __POCKETPC__
f6bcfd97 254 toolBar->AddSeparator();
5d2ac6b8
WS
255 ADD_TOOL(wxID_ZOOM_IN, tbBitmaps[2], wxGetStockLabel(wxID_ZOOM_IN, false), _("Zoom in"));
256 ADD_TOOL(wxID_ZOOM_OUT, tbBitmaps[3], wxGetStockLabel(wxID_ZOOM_OUT, false), _("Zoom out"));
f6bcfd97 257 ADD_TOOL(ID_INFO, tbBitmaps[4], _("Description"), _("Show description"));
e0a40292 258 toolBar->AddSeparator();
f6bcfd97 259 ADD_TOOL(ID_START, tbBitmaps[5], _("Start"), _("Start"));
5d2ac6b8 260 ADD_TOOL(wxID_STOP, tbBitmaps[6], wxGetStockLabel(wxID_STOP, false), _("Stop"));
e4535381 261#endif
f6bcfd97 262
5a1dca12 263 toolBar->Realize();
5d2ac6b8 264 toolBar->EnableTool(wxID_STOP, false); // must be after Realize() !
5a1dca12 265
67a99992 266#if wxUSE_STATUSBAR
5a1dca12
GRG
267 // status bar
268 CreateStatusBar(2);
269 SetStatusText(_("Welcome to Life!"));
67a99992 270#endif // wxUSE_STATUSBAR
5a1dca12 271
29b07a38
GRG
272 // game and timer
273 m_life = new Life();
274 m_timer = new wxTimer(this, ID_TIMER);
22c1c01b
DS
275 m_running = false;
276 m_topspeed = false;
29b07a38
GRG
277 m_interval = 500;
278 m_tics = 0;
5a1dca12 279
29b07a38
GRG
280 // We use two different panels to reduce flicker in wxGTK, because
281 // some widgets (like wxStaticText) don't have their own X11 window,
282 // and thus updating the text would result in a refresh of the canvas
283 // if they belong to the same parent.
284
22c1c01b
DS
285 wxPanel *panel1 = new wxPanel(this, wxID_ANY);
286 wxPanel *panel2 = new wxPanel(this, wxID_ANY);
29b07a38
GRG
287
288 // canvas
289 m_canvas = new LifeCanvas(panel1, m_life);
290
291 // info panel
22c1c01b 292 m_text = new wxStaticText(panel2, wxID_ANY,
29b07a38
GRG
293 wxEmptyString,
294 wxDefaultPosition,
295 wxDefaultSize,
296 wxALIGN_CENTER | wxST_NO_AUTORESIZE);
297
298 wxSlider *slider = new wxSlider(panel2, ID_SLIDER,
2480be69
GRG
299 5, 1, 10,
300 wxDefaultPosition,
422d0ff0 301 wxSize(200, wxDefaultCoord),
2480be69 302 wxSL_HORIZONTAL | wxSL_AUTOTICKS);
5a1dca12 303
29b07a38
GRG
304 UpdateInfoText();
305
5a1dca12 306 // component layout
29b07a38
GRG
307 wxBoxSizer *sizer1 = new wxBoxSizer(wxVERTICAL);
308 wxBoxSizer *sizer2 = new wxBoxSizer(wxVERTICAL);
309 wxBoxSizer *sizer3 = new wxBoxSizer(wxVERTICAL);
310
27dc5184 311#if wxUSE_STATLINE
22c1c01b 312 sizer1->Add( new wxStaticLine(panel1, wxID_ANY), 0, wxGROW );
27dc5184 313#endif // wxUSE_STATLINE
29b07a38 314 sizer1->Add( m_canvas, 1, wxGROW | wxALL, 2 );
27dc5184 315#if wxUSE_STATLINE
22c1c01b 316 sizer1->Add( new wxStaticLine(panel1, wxID_ANY), 0, wxGROW );
27dc5184 317#endif // wxUSE_STATLINE
29b07a38 318 panel1->SetSizer( sizer1 );
29b07a38
GRG
319 sizer1->Fit( panel1 );
320
321 sizer2->Add( m_text, 0, wxGROW | wxTOP, 4 );
322 sizer2->Add( slider, 0, wxCENTRE | wxALL, 4 );
281b0186 323
29b07a38 324 panel2->SetSizer( sizer2 );
29b07a38
GRG
325 sizer2->Fit( panel2 );
326
327 sizer3->Add( panel1, 1, wxGROW );
328 sizer3->Add( panel2, 0, wxGROW );
329 SetSizer( sizer3 );
e4535381 330#ifndef __WXWINCE__
29b07a38
GRG
331 sizer3->Fit( this );
332
333 // set minimum frame size
334 sizer3->SetSizeHints( this );
e4535381 335#endif
29b07a38
GRG
336
337 // navigator frame
338 m_navigator = new LifeNavigator(this);
5a1dca12
GRG
339}
340
341LifeFrame::~LifeFrame()
342{
343 delete m_timer;
5a1dca12
GRG
344}
345
346void LifeFrame::UpdateInfoText()
347{
348 wxString msg;
349
29b07a38 350 msg.Printf(_(" Generation: %u (T: %u ms), Population: %u "),
e0a40292
GRG
351 m_tics,
352 m_topspeed? 0 : m_interval,
353 m_life->GetNumCells());
5a1dca12
GRG
354 m_text->SetLabel(msg);
355}
356
e0a40292
GRG
357// Enable or disable tools and menu entries according to the current
358// state. See also wxEVT_UPDATE_UI events for a slightly different
359// way to do this.
360void LifeFrame::UpdateUI()
361{
a9cf4097 362 // start / stop
e0a40292 363 GetToolBar()->EnableTool(ID_START, !m_running);
5d2ac6b8 364 GetToolBar()->EnableTool(wxID_STOP, m_running);
4efbec35
JS
365 GetMenuBar()->Enable(ID_START, !m_running);
366 GetMenuBar()->Enable(ID_STEP, !m_running);
5d2ac6b8 367 GetMenuBar()->Enable(wxID_STOP, m_running);
4efbec35 368 GetMenuBar()->Enable(ID_TOPSPEED, !m_topspeed);
a9cf4097
GRG
369
370 // zooming
371 int cellsize = m_canvas->GetCellSize();
5d2ac6b8
WS
372 GetToolBar()->EnableTool(wxID_ZOOM_IN, cellsize < 32);
373 GetToolBar()->EnableTool(wxID_ZOOM_OUT, cellsize > 1);
374 GetMenuBar()->Enable(wxID_ZOOM_IN, cellsize < 32);
375 GetMenuBar()->Enable(wxID_ZOOM_OUT, cellsize > 1);
e0a40292
GRG
376}
377
f6bcfd97
BP
378// Event handlers -----------------------------------------------------------
379
380// OnMenu handles all events which don't have their own event handler
5a1dca12
GRG
381void LifeFrame::OnMenu(wxCommandEvent& event)
382{
383 switch (event.GetId())
384 {
22c1c01b 385 case wxID_NEW:
f6bcfd97
BP
386 {
387 // stop if it was running
388 OnStop();
389 m_life->Clear();
390 m_canvas->Recenter(0, 0);
391 m_tics = 0;
392 UpdateInfoText();
393 break;
394 }
22c1c01b 395 case wxID_ABOUT:
f6bcfd97
BP
396 {
397 LifeAboutDialog dialog(this);
398 dialog.ShowModal();
399 break;
400 }
22c1c01b 401 case wxID_EXIT:
f6bcfd97 402 {
22c1c01b
DS
403 // true is to force the frame to close
404 Close(true);
f6bcfd97
BP
405 break;
406 }
22c1c01b 407 case ID_SHOWNAV:
087e4f4a 408 {
29b07a38
GRG
409 bool checked = GetMenuBar()->GetMenu(1)->IsChecked(ID_SHOWNAV);
410 m_navigator->Show(checked);
e0a40292
GRG
411 break;
412 }
f6bcfd97
BP
413 case ID_INFO:
414 {
415 wxString desc = m_life->GetDescription();
22c1c01b 416
5d2ac6b8 417 if ( desc.empty() )
f6bcfd97
BP
418 desc = _("Not available");
419
420 // should we make the description editable here?
421 wxMessageBox(desc, _("Description"), wxOK | wxICON_INFORMATION);
422
423 break;
424 }
425 case ID_START : OnStart(); break;
426 case ID_STEP : OnStep(); break;
5d2ac6b8 427 case wxID_STOP : OnStop(); break;
e0a40292
GRG
428 case ID_TOPSPEED:
429 {
22c1c01b
DS
430 m_running = true;
431 m_topspeed = true;
e0a40292 432 UpdateUI();
22c1c01b 433 while (m_running && m_topspeed)
e0a40292 434 {
29b07a38 435 OnStep();
e0a40292
GRG
436 wxYield();
437 }
438 break;
439 }
f6bcfd97
BP
440 }
441}
442
443void LifeFrame::OnOpen(wxCommandEvent& WXUNUSED(event))
444{
445 wxFileDialog filedlg(this,
446 _("Choose a file to open"),
22c1c01b
DS
447 wxEmptyString,
448 wxEmptyString,
f6bcfd97
BP
449 _("Life patterns (*.lif)|*.lif|All files (*.*)|*.*"),
450 wxOPEN | wxFILE_MUST_EXIST);
451
452 if (filedlg.ShowModal() == wxID_OK)
453 {
2b15fdfc 454 wxFileInputStream stream(filedlg.GetPath());
f6bcfd97
BP
455 LifeReader reader(stream);
456
457 // the reader handles errors itself, no need to do anything here
458 if (reader.IsOk())
e0a40292 459 {
f6bcfd97 460 // stop if running and put the pattern
5a1dca12
GRG
461 OnStop();
462 m_life->Clear();
f6bcfd97
BP
463 m_life->SetPattern(reader.GetPattern());
464
465 // recenter canvas
e0a40292 466 m_canvas->Recenter(0, 0);
5a1dca12
GRG
467 m_tics = 0;
468 UpdateInfoText();
5a1dca12
GRG
469 }
470 }
471}
472
087e4f4a
GRG
473void LifeFrame::OnSamples(wxCommandEvent& WXUNUSED(event))
474{
475 // stop if it was running
476 OnStop();
477
471ed537 478 // dialog box
087e4f4a
GRG
479 LifeSamplesDialog dialog(this);
480
087e4f4a
GRG
481 if (dialog.ShowModal() == wxID_OK)
482 {
f6bcfd97 483 const LifePattern pattern = dialog.GetPattern();
087e4f4a 484
f6bcfd97 485 // put the pattern
e0a40292 486 m_life->Clear();
f6bcfd97 487 m_life->SetPattern(pattern);
087e4f4a 488
e0a40292
GRG
489 // recenter canvas
490 m_canvas->Recenter(0, 0);
087e4f4a
GRG
491 m_tics = 0;
492 UpdateInfoText();
493 }
494}
495
29b07a38
GRG
496void LifeFrame::OnZoom(wxCommandEvent& event)
497{
498 int cellsize = m_canvas->GetCellSize();
499
5d2ac6b8 500 if ((event.GetId() == wxID_ZOOM_IN) && cellsize < 32)
29b07a38
GRG
501 {
502 m_canvas->SetCellSize(cellsize * 2);
503 UpdateUI();
504 }
5d2ac6b8 505 else if ((event.GetId() == wxID_ZOOM_OUT) && cellsize > 1)
29b07a38
GRG
506 {
507 m_canvas->SetCellSize(cellsize / 2);
508 UpdateUI();
509 }
510}
511
512void LifeFrame::OnNavigate(wxCommandEvent& event)
513{
764835a5 514 LifeCell c;
29b07a38
GRG
515
516 switch (event.GetId())
517 {
22c1c01b 518 case ID_NORTH: c = m_life->FindNorth(); break;
29b07a38
GRG
519 case ID_SOUTH: c = m_life->FindSouth(); break;
520 case ID_WEST: c = m_life->FindWest(); break;
521 case ID_EAST: c = m_life->FindEast(); break;
522 case ID_CENTER: c = m_life->FindCenter(); break;
22c1c01b
DS
523 default :
524 wxFAIL;
525 // Fall through!
29b07a38
GRG
526 case ID_ORIGIN: c.i = c.j = 0; break;
527 }
528
529 m_canvas->Recenter(c.i, c.j);
530}
531
532void LifeFrame::OnSlider(wxScrollEvent& event)
533{
534 m_interval = event.GetPosition() * 100;
535
536 if (m_running)
537 {
538 OnStop();
539 OnStart();
540 }
22c1c01b 541
29b07a38
GRG
542 UpdateInfoText();
543}
544
545void LifeFrame::OnTimer(wxTimerEvent& WXUNUSED(event))
546{
547 OnStep();
548}
549
f6bcfd97
BP
550void LifeFrame::OnClose(wxCloseEvent& WXUNUSED(event))
551{
552 // Stop if it was running; this is absolutely needed because
553 // the frame won't be actually destroyed until there are no
554 // more pending events, and this in turn won't ever happen
555 // if the timer is running faster than the window can redraw.
556 OnStop();
22c1c01b 557 Destroy();
f6bcfd97
BP
558}
559
5a1dca12
GRG
560void LifeFrame::OnStart()
561{
087e4f4a
GRG
562 if (!m_running)
563 {
087e4f4a 564 m_timer->Start(m_interval);
22c1c01b 565 m_running = true;
e0a40292 566 UpdateUI();
087e4f4a 567 }
5a1dca12
GRG
568}
569
570void LifeFrame::OnStop()
571{
087e4f4a
GRG
572 if (m_running)
573 {
087e4f4a 574 m_timer->Stop();
22c1c01b
DS
575 m_running = false;
576 m_topspeed = false;
e0a40292 577 UpdateUI();
087e4f4a 578 }
5a1dca12
GRG
579}
580
29b07a38 581void LifeFrame::OnStep()
5a1dca12 582{
a36f0f83
GRG
583 if (m_life->NextTic())
584 m_tics++;
585 else
586 OnStop();
5a1dca12 587
e0a40292 588 m_canvas->DrawChanged();
a36f0f83 589 UpdateInfoText();
5a1dca12
GRG
590}
591
a36f0f83 592
5a1dca12 593// --------------------------------------------------------------------------
29b07a38 594// LifeNavigator miniframe
5a1dca12
GRG
595// --------------------------------------------------------------------------
596
29b07a38 597LifeNavigator::LifeNavigator(wxWindow *parent)
22c1c01b 598 : wxMiniFrame(parent, wxID_ANY,
29b07a38
GRG
599 _("Navigation"),
600 wxDefaultPosition,
601 wxDefaultSize,
602 wxCAPTION | wxSIMPLE_BORDER)
5a1dca12 603{
22c1c01b 604 wxPanel *panel = new wxPanel(this, wxID_ANY);
29b07a38
GRG
605 wxBoxSizer *sizer1 = new wxBoxSizer(wxVERTICAL);
606 wxBoxSizer *sizer2 = new wxBoxSizer(wxHORIZONTAL);
607
608 // create bitmaps and masks for the buttons
609 wxBitmap
610 bmpn = wxBITMAP(north),
22c1c01b 611 bmpw = wxBITMAP(west),
29b07a38 612 bmpc = wxBITMAP(center),
22c1c01b 613 bmpe = wxBITMAP(east),
29b07a38
GRG
614 bmps = wxBITMAP(south);
615
a99c96b0 616#if !defined(__WXGTK__) && !defined(__WXMOTIF__) && !defined(__WXMAC__)
29b07a38
GRG
617 bmpn.SetMask(new wxMask(bmpn, *wxLIGHT_GREY));
618 bmpw.SetMask(new wxMask(bmpw, *wxLIGHT_GREY));
619 bmpc.SetMask(new wxMask(bmpc, *wxLIGHT_GREY));
22c1c01b 620 bmpe.SetMask(new wxMask(bmpe, *wxLIGHT_GREY));
29b07a38
GRG
621 bmps.SetMask(new wxMask(bmps, *wxLIGHT_GREY));
622#endif
623
624 // create the buttons and attach tooltips to them
625 wxBitmapButton
626 *bn = new wxBitmapButton(panel, ID_NORTH, bmpn),
627 *bw = new wxBitmapButton(panel, ID_WEST , bmpw),
628 *bc = new wxBitmapButton(panel, ID_CENTER, bmpc),
629 *be = new wxBitmapButton(panel, ID_EAST , bmpe),
630 *bs = new wxBitmapButton(panel, ID_SOUTH, bmps);
631
7a85f3f9 632#if wxUSE_TOOLTIPS
29b07a38
GRG
633 bn->SetToolTip(_("Find northernmost cell"));
634 bw->SetToolTip(_("Find westernmost cell"));
635 bc->SetToolTip(_("Find center of mass"));
636 be->SetToolTip(_("Find easternmost cell"));
637 bs->SetToolTip(_("Find southernmost cell"));
7a85f3f9 638#endif
29b07a38
GRG
639
640 // add buttons to sizers
641 sizer2->Add( bw, 0, wxCENTRE | wxWEST, 4 );
642 sizer2->Add( bc, 0, wxCENTRE);
643 sizer2->Add( be, 0, wxCENTRE | wxEAST, 4 );
644 sizer1->Add( bn, 0, wxCENTRE | wxNORTH, 4 );
645 sizer1->Add( sizer2 );
646 sizer1->Add( bs, 0, wxCENTRE | wxSOUTH, 4 );
647
b538bf7e 648 // set the panel and miniframe size
29b07a38 649 panel->SetSizer(sizer1);
b538bf7e
JS
650
651 sizer1->Fit(panel);
652 SetClientSize(panel->GetSize());
653 wxSize sz = GetSize();
654 SetSizeHints(sz.x, sz.y, sz.x, sz.y);
29b07a38
GRG
655
656 // move it to a sensible position
657 wxRect parentRect = parent->GetRect();
658 wxSize childSize = GetSize();
659 int x = parentRect.GetX() +
660 parentRect.GetWidth();
661 int y = parentRect.GetY() +
662 (parentRect.GetHeight() - childSize.GetHeight()) / 4;
663 Move(x, y);
664
665 // done
22c1c01b 666 Show(true);
29b07a38
GRG
667}
668
669void LifeNavigator::OnClose(wxCloseEvent& event)
670{
dbf75be7 671 // avoid if we can
29b07a38
GRG
672 if (event.CanVeto())
673 event.Veto();
674 else
675 Destroy();
676}
677
5a1dca12
GRG
678
679// --------------------------------------------------------------------------
087e4f4a 680// LifeCanvas
5a1dca12
GRG
681// --------------------------------------------------------------------------
682
683// canvas constructor
087e4f4a 684LifeCanvas::LifeCanvas(wxWindow *parent, Life *life, bool interactive)
22c1c01b 685 : wxWindow(parent, wxID_ANY, wxDefaultPosition, wxSize(100, 100),
ee710d75 686 wxSUNKEN_BORDER|wxFULL_REPAINT_ON_RESIZE)
5a1dca12 687{
087e4f4a
GRG
688 m_life = life;
689 m_interactive = interactive;
690 m_cellsize = 8;
e0a40292
GRG
691 m_status = MOUSE_NOACTION;
692 m_viewportX = 0;
693 m_viewportY = 0;
694 m_viewportH = 0;
695 m_viewportW = 0;
696
697 if (m_interactive)
698 SetCursor(*wxCROSS_CURSOR);
699
700 // reduce flicker if wxEVT_ERASE_BACKGROUND is not available
22c1c01b 701 SetBackgroundColour(*wxWHITE);
5a1dca12
GRG
702}
703
704LifeCanvas::~LifeCanvas()
705{
22c1c01b 706 delete m_life;
5a1dca12
GRG
707}
708
e0a40292
GRG
709// recenter at the given position
710void LifeCanvas::Recenter(wxInt32 i, wxInt32 j)
5a1dca12 711{
e0a40292
GRG
712 m_viewportX = i - m_viewportW / 2;
713 m_viewportY = j - m_viewportH / 2;
5a1dca12 714
087e4f4a 715 // redraw everything
22c1c01b 716 Refresh(false);
5a1dca12
GRG
717}
718
e0a40292
GRG
719// set the cell size and refresh display
720void LifeCanvas::SetCellSize(int cellsize)
5a1dca12 721{
e0a40292
GRG
722 m_cellsize = cellsize;
723
724 // find current center
725 wxInt32 cx = m_viewportX + m_viewportW / 2;
726 wxInt32 cy = m_viewportY + m_viewportH / 2;
727
728 // get current canvas size and adjust viewport accordingly
2fa7c206 729 int w, h;
e0a40292
GRG
730 GetClientSize(&w, &h);
731 m_viewportW = (w + m_cellsize - 1) / m_cellsize;
732 m_viewportH = (h + m_cellsize - 1) / m_cellsize;
22c1c01b 733
e0a40292
GRG
734 // recenter
735 m_viewportX = cx - m_viewportW / 2;
736 m_viewportY = cy - m_viewportH / 2;
737
738 // adjust scrollbars
739 if (m_interactive)
740 {
741 SetScrollbar(wxHORIZONTAL, m_viewportW, m_viewportW, 3 * m_viewportW);
742 SetScrollbar(wxVERTICAL, m_viewportH, m_viewportH, 3 * m_viewportH);
743 m_thumbX = m_viewportW;
744 m_thumbY = m_viewportH;
745 }
22c1c01b
DS
746
747 Refresh(false);
e0a40292 748}
2480be69 749
e0a40292
GRG
750// draw a cell
751void LifeCanvas::DrawCell(wxInt32 i, wxInt32 j, bool alive)
752{
753 wxClientDC dc(this);
5a1dca12 754
e0a40292
GRG
755 dc.SetPen(alive? *wxBLACK_PEN : *wxWHITE_PEN);
756 dc.SetBrush(alive? *wxBLACK_BRUSH : *wxWHITE_BRUSH);
5a1dca12 757
e0a40292
GRG
758 dc.BeginDrawing();
759 DrawCell(i, j, dc);
5a1dca12 760 dc.EndDrawing();
5a1dca12
GRG
761}
762
e0a40292 763void LifeCanvas::DrawCell(wxInt32 i, wxInt32 j, wxDC &dc)
5a1dca12 764{
e0a40292
GRG
765 wxCoord x = CellToX(i);
766 wxCoord y = CellToY(j);
5a1dca12 767
e0a40292
GRG
768 // if cellsize is 1 or 2, there will be no grid
769 switch (m_cellsize)
770 {
771 case 1:
772 dc.DrawPoint(x, y);
773 break;
774 case 2:
775 dc.DrawRectangle(x, y, 2, 2);
776 break;
777 default:
778 dc.DrawRectangle(x + 1, y + 1, m_cellsize - 1, m_cellsize - 1);
779 }
5a1dca12
GRG
780}
781
e0a40292
GRG
782// draw all changed cells
783void LifeCanvas::DrawChanged()
5a1dca12 784{
e0a40292
GRG
785 wxClientDC dc(this);
786
787 size_t ncells;
764835a5 788 LifeCell *cells;
22c1c01b 789 bool done = false;
e0a40292
GRG
790
791 m_life->BeginFind(m_viewportX,
792 m_viewportY,
793 m_viewportX + m_viewportW,
794 m_viewportY + m_viewportH,
22c1c01b
DS
795 true);
796
e0a40292 797 dc.BeginDrawing();
e0a40292
GRG
798
799 if (m_cellsize == 1)
5a1dca12
GRG
800 {
801 dc.SetPen(*wxBLACK_PEN);
5a1dca12
GRG
802 }
803 else
804 {
e0a40292
GRG
805 dc.SetPen(*wxTRANSPARENT_PEN);
806 dc.SetBrush(*wxBLACK_BRUSH);
807 }
030d06e1 808 dc.SetLogicalFunction(wxINVERT);
e0a40292
GRG
809
810 while (!done)
811 {
812 done = m_life->FindMore(&cells, &ncells);
813
814 for (size_t m = 0; m < ncells; m++)
815 DrawCell(cells[m].i, cells[m].j, dc);
5a1dca12 816 }
e0a40292 817 dc.EndDrawing();
5a1dca12 818}
ecbdd409 819
5a1dca12 820// event handlers
babd36de 821void LifeCanvas::OnPaint(wxPaintEvent& WXUNUSED(event))
5a1dca12
GRG
822{
823 wxPaintDC dc(this);
e0a40292
GRG
824 wxRect rect = GetUpdateRegion().GetBox();
825 wxCoord x, y, w, h;
826 wxInt32 i0, j0, i1, j1;
827
828 // find damaged area
829 x = rect.GetX();
830 y = rect.GetY();
831 w = rect.GetWidth();
832 h = rect.GetHeight();
833
834 i0 = XToCell(x);
835 j0 = YToCell(y);
836 i1 = XToCell(x + w - 1);
837 j1 = YToCell(y + h - 1);
838
839 size_t ncells;
764835a5 840 LifeCell *cells;
5a1dca12 841
22c1c01b
DS
842 m_life->BeginFind(i0, j0, i1, j1, false);
843 bool done = m_life->FindMore(&cells, &ncells);
5a1dca12 844
e0a40292 845 // erase all damaged cells and draw the grid
5a1dca12 846 dc.BeginDrawing();
e0a40292 847 dc.SetBrush(*wxWHITE_BRUSH);
5a1dca12 848
e0a40292 849 if (m_cellsize <= 2)
5a1dca12 850 {
e0a40292
GRG
851 // no grid
852 dc.SetPen(*wxWHITE_PEN);
853 dc.DrawRectangle(x, y, w, h);
5a1dca12 854 }
e0a40292
GRG
855 else
856 {
857 x = CellToX(i0);
858 y = CellToY(j0);
859 w = CellToX(i1 + 1) - x + 1;
860 h = CellToY(j1 + 1) - y + 1;
861
862 dc.SetPen(*wxLIGHT_GREY_PEN);
863 for (wxInt32 yy = y; yy <= (y + h - m_cellsize); yy += m_cellsize)
864 dc.DrawRectangle(x, yy, w, m_cellsize + 1);
865 for (wxInt32 xx = x; xx <= (x + w - m_cellsize); xx += m_cellsize)
866 dc.DrawLine(xx, y, xx, y + h);
867 }
868
869 // draw all alive cells
870 dc.SetPen(*wxBLACK_PEN);
871 dc.SetBrush(*wxBLACK_BRUSH);
872
873 while (!done)
874 {
875 for (size_t m = 0; m < ncells; m++)
876 DrawCell(cells[m].i, cells[m].j, dc);
877
878 done = m_life->FindMore(&cells, &ncells);
879 }
880
881 // last set
882 for (size_t m = 0; m < ncells; m++)
883 DrawCell(cells[m].i, cells[m].j, dc);
5a1dca12 884
5a1dca12
GRG
885 dc.EndDrawing();
886}
887
888void LifeCanvas::OnMouse(wxMouseEvent& event)
889{
087e4f4a
GRG
890 if (!m_interactive)
891 return;
892
5a1dca12 893 // which cell are we pointing at?
e0a40292
GRG
894 wxInt32 i = XToCell( event.GetX() );
895 wxInt32 j = YToCell( event.GetY() );
896
67a99992 897#if wxUSE_STATUSBAR
e0a40292
GRG
898 // set statusbar text
899 wxString msg;
900 msg.Printf(_("Cell: (%d, %d)"), i, j);
29b07a38 901 ((LifeFrame *) wxGetApp().GetTopWindow())->SetStatusText(msg, 1);
67a99992 902#endif // wxUSE_STATUSBAR
5a1dca12 903
f6bcfd97
BP
904 // NOTE that wxMouseEvent::LeftDown() and wxMouseEvent::LeftIsDown()
905 // have different semantics. The first one is used to signal that the
906 // button was just pressed (i.e., in "button down" events); the second
907 // one just describes the current status of the button, independently
908 // of the mouse event type. LeftIsDown is typically used in "mouse
909 // move" events, to test if the button is _still_ pressed.
910
911 // is the button down?
5a1dca12
GRG
912 if (!event.LeftIsDown())
913 {
914 m_status = MOUSE_NOACTION;
7989fb37 915 return;
5a1dca12 916 }
5a1dca12 917
f6bcfd97
BP
918 // was it pressed just now?
919 if (event.LeftDown())
7989fb37 920 {
f6bcfd97 921 // yes: start a new action and toggle this cell
7989fb37 922 m_status = (m_life->IsAlive(i, j)? MOUSE_ERASING : MOUSE_DRAWING);
22c1c01b 923
7989fb37
GRG
924 m_mi = i;
925 m_mj = j;
926 m_life->SetCell(i, j, m_status == MOUSE_DRAWING);
927 DrawCell(i, j, m_status == MOUSE_DRAWING);
928 }
929 else if ((m_mi != i) || (m_mj != j))
930 {
f6bcfd97 931 // no: continue ongoing action
5e9ff6ad
GRG
932 bool alive = (m_status == MOUSE_DRAWING);
933
934 // prepare DC and pen + brush to optimize drawing
935 wxClientDC dc(this);
936 dc.SetPen(alive? *wxBLACK_PEN : *wxWHITE_PEN);
937 dc.SetBrush(alive? *wxBLACK_BRUSH : *wxWHITE_BRUSH);
938 dc.BeginDrawing();
939
7989fb37
GRG
940 // draw a line of cells using Bresenham's algorithm
941 wxInt32 d, ii, jj, di, ai, si, dj, aj, sj;
942 di = i - m_mi;
943 ai = abs(di) << 1;
944 si = (di < 0)? -1 : 1;
945 dj = j - m_mj;
946 aj = abs(dj) << 1;
947 sj = (dj < 0)? -1 : 1;
948
949 ii = m_mi;
950 jj = m_mj;
22c1c01b 951
7989fb37
GRG
952 if (ai > aj)
953 {
954 // iterate over i
22c1c01b
DS
955 d = aj - (ai >> 1);
956
7989fb37
GRG
957 while (ii != i)
958 {
5e9ff6ad
GRG
959 m_life->SetCell(ii, jj, alive);
960 DrawCell(ii, jj, dc);
7989fb37
GRG
961 if (d >= 0)
962 {
963 jj += sj;
22c1c01b 964 d -= ai;
7989fb37
GRG
965 }
966 ii += si;
967 d += aj;
968 }
969 }
970 else
5a1dca12 971 {
7989fb37
GRG
972 // iterate over j
973 d = ai - (aj >> 1);
974
975 while (jj != j)
976 {
5e9ff6ad
GRG
977 m_life->SetCell(ii, jj, alive);
978 DrawCell(ii, jj, dc);
7989fb37
GRG
979 if (d >= 0)
980 {
981 ii += si;
22c1c01b 982 d -= aj;
7989fb37
GRG
983 }
984 jj += sj;
985 d += ai;
986 }
5a1dca12 987 }
7989fb37
GRG
988
989 // last cell
5e9ff6ad
GRG
990 m_life->SetCell(ii, jj, alive);
991 DrawCell(ii, jj, dc);
7989fb37
GRG
992 m_mi = ii;
993 m_mj = jj;
5e9ff6ad
GRG
994
995 dc.EndDrawing();
5a1dca12 996 }
7989fb37 997
29b07a38 998 ((LifeFrame *) wxGetApp().GetTopWindow())->UpdateInfoText();
5a1dca12
GRG
999}
1000
1001void LifeCanvas::OnSize(wxSizeEvent& event)
1002{
e0a40292
GRG
1003 // find center
1004 wxInt32 cx = m_viewportX + m_viewportW / 2;
1005 wxInt32 cy = m_viewportY + m_viewportH / 2;
1006
1007 // get new size
5a1dca12
GRG
1008 wxCoord w = event.GetSize().GetX();
1009 wxCoord h = event.GetSize().GetY();
e0a40292
GRG
1010 m_viewportW = (w + m_cellsize - 1) / m_cellsize;
1011 m_viewportH = (h + m_cellsize - 1) / m_cellsize;
1012
1013 // recenter
1014 m_viewportX = cx - m_viewportW / 2;
1015 m_viewportY = cy - m_viewportH / 2;
1016
1017 // scrollbars
1018 if (m_interactive)
1019 {
1020 SetScrollbar(wxHORIZONTAL, m_viewportW, m_viewportW, 3 * m_viewportW);
1021 SetScrollbar(wxVERTICAL, m_viewportH, m_viewportH, 3 * m_viewportH);
1022 m_thumbX = m_viewportW;
1023 m_thumbY = m_viewportH;
1024 }
5a1dca12
GRG
1025
1026 // allow default processing
1027 event.Skip();
1028}
e0a40292
GRG
1029
1030void LifeCanvas::OnScroll(wxScrollWinEvent& event)
1031{
254a2129 1032 WXTYPE type = (WXTYPE)event.GetEventType();
e0a40292
GRG
1033 int pos = event.GetPosition();
1034 int orient = event.GetOrientation();
e0a40292
GRG
1035
1036 // calculate scroll increment
33e39147 1037 int scrollinc = 0;
764835a5 1038 if (type == wxEVT_SCROLLWIN_TOP)
e0a40292 1039 {
764835a5
GD
1040 if (orient == wxHORIZONTAL)
1041 scrollinc = -m_viewportW;
1042 else
1043 scrollinc = -m_viewportH;
1044 }
1045 else
1046 if (type == wxEVT_SCROLLWIN_BOTTOM)
1047 {
1048 if (orient == wxHORIZONTAL)
1049 scrollinc = m_viewportW;
1050 else
1051 scrollinc = m_viewportH;
1052 }
1053 else
1054 if (type == wxEVT_SCROLLWIN_LINEUP)
1055 {
1056 scrollinc = -1;
1057 }
1058 else
1059 if (type == wxEVT_SCROLLWIN_LINEDOWN)
1060 {
1061 scrollinc = +1;
1062 }
1063 else
1064 if (type == wxEVT_SCROLLWIN_PAGEUP)
1065 {
1066 scrollinc = -10;
1067 }
1068 else
1069 if (type == wxEVT_SCROLLWIN_PAGEDOWN)
1070 {
b1823f8b 1071 scrollinc = +10;
764835a5
GD
1072 }
1073 else
1074 if (type == wxEVT_SCROLLWIN_THUMBTRACK)
1075 {
1076 if (orient == wxHORIZONTAL)
e0a40292 1077 {
764835a5
GD
1078 scrollinc = pos - m_thumbX;
1079 m_thumbX = pos;
e0a40292 1080 }
764835a5 1081 else
33e39147 1082 {
764835a5
GD
1083 scrollinc = pos - m_thumbY;
1084 m_thumbY = pos;
33e39147 1085 }
e0a40292 1086 }
764835a5
GD
1087 else
1088 if (type == wxEVT_SCROLLWIN_THUMBRELEASE)
1089 {
1090 m_thumbX = m_viewportW;
1091 m_thumbY = m_viewportH;
1092 }
e0a40292 1093
dbf75be7
GRG
1094#if defined(__WXGTK__) || defined(__WXMOTIF__)
1095 // wxGTK and wxMotif update the thumb automatically (wxMSW doesn't);
1096 // so reset it back as we always want it to be in the same position.
33e39147 1097 if (type != wxEVT_SCROLLWIN_THUMBTRACK)
e0a40292
GRG
1098 {
1099 SetScrollbar(wxHORIZONTAL, m_viewportW, m_viewportW, 3 * m_viewportW);
1100 SetScrollbar(wxVERTICAL, m_viewportH, m_viewportH, 3 * m_viewportH);
1101 }
1102#endif
1103
1104 if (scrollinc == 0) return;
22c1c01b 1105
e0a40292
GRG
1106 // scroll the window and adjust the viewport
1107 if (orient == wxHORIZONTAL)
1108 {
1109 m_viewportX += scrollinc;
1110 ScrollWindow( -m_cellsize * scrollinc, 0, (const wxRect *) NULL);
1111 }
1112 else
1113 {
22c1c01b 1114 m_viewportY += scrollinc;
e0a40292
GRG
1115 ScrollWindow( 0, -m_cellsize * scrollinc, (const wxRect *) NULL);
1116 }
1117}
1118
1119void LifeCanvas::OnEraseBackground(wxEraseEvent& WXUNUSED(event))
1120{
1121 // do nothing. I just don't want the background to be erased, you know.
1122}
29b07a38
GRG
1123
1124