1 |
# Copyright (C) 2001, 2002 by Intevation GmbH |
# Copyright (C) 2001, 2002, 2003 by Intevation GmbH |
2 |
# Authors: |
# Authors: |
3 |
# Jan-Oliver Wagner <[email protected]> |
# Jan-Oliver Wagner <[email protected]> |
4 |
# Bernhard Herzog <[email protected]> |
# Bernhard Herzog <[email protected]> |
19 |
|
|
20 |
from Thuban.Lib.connector import Publisher |
from Thuban.Lib.connector import Publisher |
21 |
|
|
22 |
|
from Thuban import _ |
23 |
from Thuban.Model.session import create_empty_session |
from Thuban.Model.session import create_empty_session |
24 |
from Thuban.Model.save import save_session |
from Thuban.Model.save import save_session |
25 |
from Thuban.Model.load import load_session |
from Thuban.Model.load import load_session |
26 |
|
from Thuban.Model.messages import MAPS_CHANGED |
27 |
|
|
28 |
import view |
import view |
29 |
import tree |
import tree |
|
from interactor import Interactor |
|
30 |
import mainwindow |
import mainwindow |
31 |
|
|
32 |
from messages import SESSION_CHANGED |
from messages import SESSION_REPLACED |
33 |
|
|
34 |
|
|
35 |
|
|
40 |
|
|
41 |
All wxWindows programs have to have an instance of an application |
All wxWindows programs have to have an instance of an application |
42 |
class derived from wxApp. In Thuban the application class holds |
class derived from wxApp. In Thuban the application class holds |
43 |
references to the main window, the session and the interactor. |
references to the main window and the session. |
44 |
""" |
""" |
45 |
|
|
46 |
def OnInit(self): |
def OnInit(self): |
47 |
|
self.splash = self.splash_screen() |
48 |
|
if self.splash is not None: |
49 |
|
self.splash.Show() |
50 |
self.read_startup_files() |
self.read_startup_files() |
51 |
self.interactor = Interactor(None) |
self.top = self.CreateMainWindow() |
52 |
top = mainwindow.MainWindow(NULL, -1, self, self.interactor) |
self.SetTopWindow(self.top) |
53 |
top.Show(true) |
if self.splash is None: |
54 |
self.top = top |
self.ShowMainWindow() |
|
self.SetTopWindow(top) |
|
55 |
self.session = None |
self.session = None |
56 |
self.create_session() |
self.create_session() |
57 |
return true |
return True |
58 |
|
|
59 |
|
def OnExit(self): |
60 |
|
"""Clean up code. |
61 |
|
|
62 |
|
Extend this in derived classes if needed. |
63 |
|
""" |
64 |
|
self.session.Destroy() |
65 |
|
Publisher.Destroy(self) |
66 |
|
|
67 |
|
def MainLoop(self): |
68 |
|
"""Call the inherited MainLoop method and then call OnExit. |
69 |
|
|
70 |
|
In wxPython OnExit isn't called automatically, unfortunately, so |
71 |
|
we do it here. |
72 |
|
""" |
73 |
|
wxApp.MainLoop(self) |
74 |
|
self.OnExit() |
75 |
|
|
76 |
def read_startup_files(self): |
def read_startup_files(self): |
77 |
"""Read the startup files.""" |
"""Read the startup files.""" |
87 |
if tb.tb_next is not None: |
if tb.tb_next is not None: |
88 |
# The ImportError exception was raised from |
# The ImportError exception was raised from |
89 |
# inside the thubanstart module. |
# inside the thubanstart module. |
90 |
sys.stderr.write("Cannot import the thubanstart" |
sys.stderr.write(_("Cannot import the thubanstart" |
91 |
"module\n") |
"module\n")) |
92 |
traceback.print_exc(None, sys.stderr) |
traceback.print_exc(None, sys.stderr) |
93 |
else: |
else: |
94 |
# There's no thubanstart module. |
# There's no thubanstart module. |
95 |
sys.stderr.write("No thubanstart module available\n") |
sys.stderr.write(_("No thubanstart module available\n")) |
96 |
finally: |
finally: |
97 |
# make sure we delete the traceback object, |
# make sure we delete the traceback object, |
98 |
# otherwise there's be circular references involving |
# otherwise there's be circular references involving |
99 |
# the current stack frame |
# the current stack frame |
100 |
del tb |
del tb |
101 |
except: |
except: |
102 |
sys.stderr.write("Cannot import the thubanstart module\n") |
sys.stderr.write(_("Cannot import the thubanstart module\n")) |
103 |
traceback.print_exc(None, sys.stderr) |
traceback.print_exc(None, sys.stderr) |
104 |
else: |
else: |
105 |
# There's no .thuban directory |
# There's no .thuban directory |
106 |
sys.stderr.write("No ~/.thuban directory\n") |
sys.stderr.write(_("No ~/.thuban directory\n")) |
107 |
|
|
108 |
|
def splash_screen(self): |
109 |
|
"""Create and return a splash screen. |
110 |
|
|
111 |
|
This method is called by OnInit to determine whether the |
112 |
|
application should have a splashscreen. If the application |
113 |
|
should display a splash screen override this method in a derived |
114 |
|
class and have it create and return the wxSplashScreen instance. |
115 |
|
The implementation of this method in the derived class should |
116 |
|
also arranged for ShowMainWindow to be called. |
117 |
|
|
118 |
|
The default implementation simply returns None so that no splash |
119 |
|
screen is shown and ShowMainWindow will be called automatically. |
120 |
|
""" |
121 |
|
return None |
122 |
|
|
123 |
|
def ShowMainWindow(self): |
124 |
|
"""Show the main window |
125 |
|
|
126 |
|
Normally this method is automatically called by OnInit to show |
127 |
|
the main window. However, if the splash_screen method has |
128 |
|
returned a splashscreen it is expected that the derived class |
129 |
|
also arranges for ShowMainWindow to be called at the appropriate |
130 |
|
time. |
131 |
|
""" |
132 |
|
self.top.Show(True) |
133 |
|
|
134 |
|
def CreateMainWindow(self): |
135 |
|
"""Create and return the main window for the application. |
136 |
|
|
137 |
|
Override this in subclasses to instantiate the Thuban mainwindow |
138 |
|
with different parameters or to use a different class for the |
139 |
|
main window. |
140 |
|
""" |
141 |
|
msg = (_("This is the wxPython-based Graphical User Interface" |
142 |
|
" for exploring geographic data")) |
143 |
|
return mainwindow.MainWindow(NULL, -1, "Thuban", self, None, |
144 |
|
initial_message = msg) |
145 |
|
|
146 |
def Session(self): |
def Session(self): |
147 |
"""Return the application's session object""" |
"""Return the application's session object""" |
150 |
def SetSession(self, session): |
def SetSession(self, session): |
151 |
"""Make session the new session. |
"""Make session the new session. |
152 |
|
|
153 |
Issue SESSION_CHANGED. |
Issue SESSION_REPLACED after self.session has become the new |
154 |
|
session. After the session has been assigned call |
155 |
|
self.subscribe_session() with the new session and |
156 |
|
self.unsubscribe_session with the old one. |
157 |
""" |
""" |
158 |
oldsession = self.session |
oldsession = self.session |
159 |
self.session = session |
self.session = session |
160 |
self.issue(SESSION_CHANGED) |
self.subscribe_session(self.session) |
161 |
self.interactor.SetSession(session) |
self.issue(SESSION_REPLACED) |
162 |
self.set_map() |
self.maps_changed() |
163 |
if oldsession is not None: |
if oldsession is not None: |
164 |
|
self.unsubscribe_session(oldsession) |
165 |
oldsession.Destroy() |
oldsession.Destroy() |
166 |
|
|
167 |
|
def subscribe_session(self, session): |
168 |
|
"""Subscribe to some of the sessions channels. |
169 |
|
|
170 |
|
Extend this method in derived classes if you need additional |
171 |
|
channels. |
172 |
|
""" |
173 |
|
session.Subscribe(MAPS_CHANGED, self.maps_changed) |
174 |
|
|
175 |
|
def unsubscribe_session(self, session): |
176 |
|
"""Unsubscribe from the sessions channels. |
177 |
|
|
178 |
|
Extend this method in derived classes if you subscribed to |
179 |
|
additional channels in subscribe_session(). |
180 |
|
""" |
181 |
|
session.Unsubscribe(MAPS_CHANGED, self.maps_changed) |
182 |
|
|
183 |
def create_session(self): |
def create_session(self): |
184 |
# Create a simple default session |
"""Create a default session. |
185 |
|
|
186 |
|
Override this method in derived classes to instantiate the |
187 |
|
session differently or to use a different session class. Don't |
188 |
|
subscribe to channels here yet. Do that in the |
189 |
|
subscribe_session() method. |
190 |
|
""" |
191 |
self.SetSession(create_empty_session()) |
self.SetSession(create_empty_session()) |
192 |
|
|
193 |
def OpenSession(self, filename): |
def OpenSession(self, filename): |
199 |
def SaveSession(self): |
def SaveSession(self): |
200 |
save_session(self.session, self.session.filename) |
save_session(self.session, self.session.filename) |
201 |
|
|
202 |
def set_map(self): |
def maps_changed(self, *args): |
203 |
if self.session.HasMaps(): |
if self.session.HasMaps(): |
204 |
self.top.SetMap(self.session.Maps()[0]) |
self.top.SetMap(self.session.Maps()[0]) |
205 |
else: |
else: |