4 <style type='text/css'><!--
6 border: 1px solid black;
41 .wiki h1, .wiki h2, .wiki h3, .wiki h4, .wiki h5, .wiki h6 {
45 border-bottom: 1px solid #bbbbbb;
73 .wiki code, .wiki pre {
76 border: 1px dashed #888888;
81 border-top: 1px solid #888888;
82 border-left: 1px solid #888888;
83 border-spacing: 0px; border-collapse: collapse;
86 border-bottom: 1px solid #888888;
87 border-right: 1px solid #888888;
92 border-bottom: 1px solid #888888;
93 border-right: 1px solid #888888;
104 <table cellpadding=8><tr><td>
105 <a href='http://www.imitationpickles.org/pgu/'><img src='skin/logo.gif' alt="Phil's pyGame Utilities" border=0></a>
106 <td style='font-size:48px'>Documentation
111 <hr width=500 align=center>
113 <table width='100%'><tr><td valign=top width=120 style='padding-right:6px;border-right: 1px solid black;'>
114 <a href='index.html'>Overview</a><br><br>
115 <strong>Scripts</strong><br>
116 <a href="tileedit.html">tileedit</a>
117 | <a href="leveledit.html">leveledit</a>
118 | <a href="tganew.html">tganew</a>
119 | <a href="levelfancy.html">levelfancy</a>
121 <strong>Reference</strong><br>
122 <a href="algo.html">algo</a>
123 | <a href="ani.html">ani</a>
124 | <a href="engine.html">engine</a>
125 | <a href="fonts.html">fonts</a>
126 | <a href="high.html">high</a>
127 | <a href="html.html">html</a>
128 | <a href="layout.html">layout</a>
129 | <a href="text.html">text</a>
130 | <a href="timer.html">timer</a>
131 | <a href="vid.html">vid</a>
133 <strong>Tutorials</strong><br>
134 <a href="tilevid1.html">1</a>
135 | <a href="tilevid2.html">2</a>
136 | <a href="tilevid3.html">3</a>
137 | <a href="tilevid4.html">4</a>
138 | <a href="tilevid5.html">5</a>
140 <strong>GUI Ref.</strong><br>
141 <a href="gui.theme.html">theme</a>
142 | <a href="gui.style.html">style</a>
143 | <a href="gui.widget.html">widget</a>
144 | <a href="gui.surface.html">surface</a>
145 | <a href="gui.const.html">const</a>
147 <strong>Containers</strong><br>
148 <a href="gui.container.html">container</a>
149 | <a href="gui.app.html">app</a>
150 | <a href="gui.table.html">table</a>
151 | <a href="gui.document.html">document</a>
152 | <a href="gui.area.html">area</a>
154 <strong>Forms</strong><br>
155 <a href="gui.form.html">form</a>
156 | <a href="gui.group.html">group</a>
158 <strong>Widgets</strong><br>
159 <a href="gui.basic.html">basic</a>
160 | <a href="gui.button.html">button</a>
161 | <a href="gui.input.html">input</a>
162 | <a href="gui.keysym.html">keysym</a>
163 | <a href="gui.slider.html">slider</a>
164 | <a href="gui.select.html">select</a>
165 | <a href="gui.misc.html">misc</a>
167 <strong>Other</strong><br>
168 <a href="gui.menus.html">menus</a>
169 | <a href="gui.dialog.html">dialog</a>
171 <strong>Tutorials</strong><br>
172 <a href="gui1.html">1</a>
173 | <a href="gui2.html">2</a>
174 | <a href="gui3.html">3</a>
175 | <a href="gui4.html">4</a>
176 | <a href="gui5.html">5</a>
177 | <a href="gui6.html">6</a>
178 | <a href="gui7.html">7</a>
179 | <a href="gui8.html">8</a>
180 | <a href="gui9.html">9</a>
181 | <a href="gui10.html">10</a>
184 <td valign=top style='padding-left:6px;'>
187 <table class='sections' align=right>
188 <tr><th>sections</th>
189 <tr><td class='h1'><a href='#App'>App</a>
190 <tr><td class='h2'><a href='#App.__init__'>App.__init__</a>
191 <tr><td class='h2'><a href='#App.set_global_app'>App.set_global_app</a>
192 <tr><td class='h2'><a href='#App.init'>App.init</a>
193 <tr><td class='h2'><a href='#App.event'>App.event</a>
194 <tr><td class='h2'><a href='#App.loop'>App.loop</a>
195 <tr><td class='h2'><a href='#App.paint'>App.paint</a>
196 <tr><td class='h2'><a href='#App.update'>App.update</a>
197 <tr><td class='h2'><a href='#App.run'>App.run</a>
198 <tr><td class='h2'><a href='#App.open'>App.open</a>
199 <tr><td class='h2'><a href='#App.close'>App.close</a>
200 <tr><td class='h1'><a href='#Desktop'>Desktop</a>
206 Defines the top-level application widget
211 The top-level widget for an application.
217 widget = gui.Button("Testing")
220 app.init(widget=widget)
225 <a name="App.__init__">
226 <h3>App.__init__</h3>
228 Create a new application given the (optional) theme instance.
230 <a name="App.set_global_app">
231 <h3>App.set_global_app</h3>
233 Registers this app as _the_ global PGU application. You
234 generally shouldn't need to call this function.
239 Initialize the application.
242 widget -- the top-level widget in the application
243 screen -- the pygame surface to render to
244 area -- the rectangle (within 'screen') to use for rendering
250 Pass an event to the main widget. If you are managing your own
251 mainloop, this function should be called periodically when you are
252 processing pygame events.
258 Performs one iteration of the PGU application loop, which
259 processes events and update the pygame display.
264 Renders the application onto the given pygame surface
266 <a name="App.update">
269 Update the screen in a semi-efficient manner, and returns
270 a list of pygame rects to be updated.
277 Automatically calls App.init and then forever loops while
278 calling App.event and App.update
281 widget -- the top-level widget to use
282 screen -- the pygame surface to render to
283 delay -- the delay between updates (in milliseconds)
289 Opens the given PGU window and positions it on the screen
294 Closes the previously opened PGU window
299 Create an App using the desktop theme class.
306 <hr width=500 align=center>
307 <div align='center'>all content (c) 2006 Phil Hassey - <a href='http://www.imitationpickles.org/pgu/'>Phil's pyGame Utilities</a></div>