518356c347a50d0372303ab114c645e95e1ad676
[openpandora.oe.git] / recipes / pandora-system / pandora-scripts / TVoutConfig.py
1 #!/usr/bin/python
2
3 import os
4 import re
5 import sys
6 import gtk
7 import optparse
8
9 from ConfigModel import *
10
11 # ================================================================
12 # Todos and known bugs
13 # ================================================================
14 # Todo
15 # - compute PreviewPane constants PP_DX and PP_DY
16 # - test commandline interface
17
18 # ================================================================
19 # Constants
20 # ================================================================
21
22 # configuration files
23 GUI_DESCRIPTION = 'tvout.glade'
24 PROFILES = '/etc/pandora/conf/tvout-profiles.conf'
25
26 # Shell command to change settings:
27 SET_CONFIG_CMD = 'sudo /usr/pandora/scripts/op_tvout.sh %s'
28 CONFIG_PARAMS = '-t %(encoding)s -c %(connection)s -l %(layer)s -%(type)ss %(width)s,%(height)s -%(type)sp %(x)s,%(y)s'
29
30 # Maximum vertical resolutions
31 Y_RES_PAL = 574
32 Y_RES_NTSC = 482
33
34 # Profile header string, should be a single line only
35 # This does NOT conflict with profile names.
36 PROF_HEADER = 'Last written configuration:'
37
38 # Paths for reading different configuration options
39 SETTINGS = dict(
40     size='/sys/devices/platform/omapdss/overlay2/output_size',
41     position='/sys/devices/platform/omapdss/overlay2/position',
42     enabled='/sys/devices/platform/omapdss/display1/enabled',
43     connection='/sys/devices/platform/omapdss/display1/venc_type', # if it exists
44     fb0='/sys/class/graphics/fb0/overlays',
45     fb1='/sys/class/graphics/fb1/overlays',
46 )
47
48 # format for saving/loading
49 FILE_ORDER = (
50     "enabled", "encoding", "connection", "layer", "x", "y", "width", "height")
51
52 # Default configurations
53 DC_DISABLED = "Disabled"
54 DC_DISABLED_DICT = dict(
55     enabled="False", encoding="pal", connection="composite", 
56     layer="0", width="658", height="520", x="35", y="35")
57 DC_DEFAULTS = {
58     DC_DISABLED: DC_DISABLED_DICT,
59     }
60
61 # Widget names
62 W_RADIO_BUTTONS = ('pal', 'ntsc', 'composite', 'svideo', 'layer0', 'layer1')
63 W_ADJUSTMENTS = ('x', 'y', 'width', 'height')
64 W_WIDGETS = ('enabled', 'pal', 'ntsc', 'composite', 'svideo', 
65              'layer0', 'layer1', 'width', 'height', 'x', 'y')
66
67 # Preview pane
68 PP_WIDGET = 'previewAlignment'
69 PP_HANDLES = ('xPaned', 'yPaned', 'widthPaned', 'heightPaned')
70 PP_DX = 26.0 # Todo: compute these
71 PP_DY = 14.0 # (they might be theme dependent)
72
73 ENABLED_USERDATA = 'enabled'
74 RADIO_USERDATA = dict(
75     pal='encoding', ntsc='encoding',
76     composite='connection', svideo='connection',
77     layer0='layer', layer1='layer')
78 ADJUSTMENT_USERDATA = ('width', 'height', 'x', 'y')
79
80 # Documentation for commandline options
81 HELP_ENABLED = "Enable TV-out. Valid values: True, False"
82 HELP_ENCODING = "Set encoding type (pal or ntsc)."
83 HELP_CONNECTION = "Set connection type (composite or svideo)"
84 HELP_LAYER = "Sets video layer to either main (0) or HW scaler / overlay (1)"
85 HELP_WIDTH = "Screen width (max 720)"
86 HELP_HEIGHT = "Screen height (max %s for pal and %s for ntsc)" % (Y_RES_PAL, Y_RES_NTSC)
87 HELP_X = "X coordinate of top left corner of the display area. Max 720 - width."
88 HELP_Y = "Y coordinate of top left corner of the display area. Y + HEIGHT may not exceed the max values specified in the height option."
89 HELP_SAVE = "Store current configuration as specified profile."
90 HELP_APPLY = "Activate the currently specified configuration."
91 HELP_LOAD = "Load and apply the specified configuration profile."
92 HELP_DEL = "Delete specified configuration profile."
93
94 # Commandline input type checking
95 TYPECHECK = dict(
96     enabled='(True|False)', layer='(0|1)',
97     encoding='(pal|ntsc)', connection='(composite|svideo)',
98     width='(\d+)', height='(\d+)', x='(\d+)', y='(\d+)',
99 )
100 RE_FORMAT = ' '.join(TYPECHECK[k] for k in FILE_ORDER)
101 BOUNDS = dict(width=(0,720), height=(0, Y_RES_PAL),
102               x=(0,720), y=(0,Y_RES_PAL))
103
104 # ================================================================
105 # Misc. auxiliary functions
106 # ================================================================
107
108 def Validate(value):
109     """Verifies all values in a profile string (see TVoutModel).
110
111     This is used to validate inputs passed through the commandline interface.
112
113     @value: a profile string.
114     """
115     mo = re.match(RE_FORMAT, value)
116     if mo is None:
117         return {}
118     else: # verify bounds
119         values = dict(zip(FILE_ORDER, mo.groups()))
120     
121         x = int(values['x'])
122         y = int(values['y'])
123         w = int(values['width'])
124         h = int(values['height'])
125         Y = Y_RES_PAL if values['encoding'] == 'pal' else Y_RES_NTSC
126         
127         if 720 < x + w:
128             print "Invalid position and/or size specified, x (%s) + width (%s) may not exceed 720." % (x, w)
129             sys.exit(1)
130         if Y < y + h:
131             print "Invalid position and/or size specified, y (%s) + height (%s) may not exceed %s." % (y, h, Y)
132             sys.exit(1)
133
134         if not all(BOUNDS[k][0] <= int(values[k]) <= BOUNDS[k][1] for k in BOUNDS):
135             print "Invalid position and/or size bounds specified"
136             sys.exit(1)
137         else:
138             return values
139
140 # ================================================================
141 # Main model & gui classes
142 # ================================================================
143
144 class TVoutModel(ConfigModel):
145     """Model for TV-out configuration.
146
147     Since not all TV-out settings can be easily read back from the system,
148     the last-saved profile is stored to fill in the gaps (mainly encoding).
149
150     This currently stores the following key/value pairs (all strings):
151     - "enabled": "True" | "False" # TV-out turned on/off
152     - "encoding": "pal" | "ntsc"  # which colour encoding is utilized
153     - "connection": "composite" | "svideo"
154     - "layer": "0" | "1"          # main video layer or hw scaler/overlay
155     - "x": "\d+"                  # left side of area displayed area
156     - "y": "\d+"                  # top side of the displayed area
157     - "width": "\d+"              # right side of the displayed area, 
158                                   # relative to "x"
159     - "height": "\d+"             # bottom side of the displayed area,
160                                   # relative to "y"
161     """
162     def __init__(self, *views):
163         self.last_written = None
164         ConfigModel.__init__(self, PROFILES, *views, **DC_DEFAULTS)
165
166     def fetch_profiles(self):
167         """Loads the profiles.
168
169         The header line is ignored and is included for user documentation only.
170         The second line is the last written profile.
171         The remainder of the file consists of a series of lines which 
172         alternating contain the profile name and a profile.
173
174         Profiles are stored as space separated values, in the following order:
175         <enabled> <encoding> <connection> <layer> <x> <y> <width> <height>
176         """
177         with open(self.profiles_file, 'r') as f:
178             f.readline() # header
179             self.last_written = self.string_to_profile(f.readline().strip()) # last_saved profile
180
181             name = None
182             for line in f:
183                 if name is None:
184                     name = line.rstrip()
185                 else:
186                     self.profiles[name] = self.string_to_profile(line.rstrip())
187                     name = None
188
189     def store_profiles(self):
190         """Write profiles to file.
191
192         Refer to the doc-string of fetch_profiles for the file format.
193         """
194         with open(self.profiles_file, 'w') as f:
195             f.write('%s\n%s\n' % (PROF_HEADER, self.profile_to_string(self.last_written)))
196             for name in sorted(self.profiles.keys()):
197                 f.write('%s\n%s\n' % (name, self.profile_to_string(self.profiles[name])))
198
199     def read_settings(self):
200         """Reads current TV-out configuration from the system.
201
202         The way the encoding is stored is tricky to convert back to pal/ntsc 
203         and might change in later hotfixes / firmware releases. Therefore this
204         value is read from the last written profile instead.
205
206         Layer is determined by interpreting the framebuffer values. 
207         If an unknown configuration is encountered, which is quite possible, 
208         then the last written configuration is read instead.
209         """
210         # Uncomment to test on desktop linux:
211         # self.load_profile(self.last_written)
212         # return
213
214         settings = {}
215         for key, path in SETTINGS.iteritems():
216             try:
217                 with open(path, 'r') as f:
218                     settings[key] = f.readline().strip()
219             except:
220                 settings[key] = self.last_written[key] if key in self.last_written else None
221
222         # This one is quite tricky to read directly from the system, yet unlikely to change often.
223         settings['encoding'] = self.last_written['encoding']
224
225         # These ones are stored as a single value
226         settings['width'], settings['height'] = settings.pop('size').split(',')
227         settings['x'], settings['y'] = settings.pop('position').split(',')
228
229         # To determine the layer we interpret the framebuffer values
230         fb0 = settings.pop('fb0')
231         fb1 = settings.pop('fb1')
232         settings['layer'] = ('1' if fb0 == '0' and fb1 == '1,2' else 
233                              ('0' if fb0 == '0,2' and fb1 == '1' else 
234                               self.last_written['layer']))
235
236         self.load_profile(settings)
237
238     def write_settings(self):
239         """Write configuration to the system.
240
241         This relies on op_tvout.sh to write the configuration, such that
242         the details can be easily changed in later firmware versions.
243
244         Documentation for op_tvout.sh:
245         op_tvout.sh [-d] [-t pal|ntsc] [-c composite|svideo] [-l 0|1] 
246                     [-{p|n}s w,h] [-{p|n}p x,y]
247
248         - op_tvout.sh -d      # just disables tv-out
249         - t ntsc -c composite # enable NTSC/composite mode
250         - l 1      
251           layer, 0 is the main layer and 1 is hardware scaler/overlay
252           (video layer, used by some emus too), only one can be used at a time)
253         - pp 0,0 -ps 640 480 
254           display position and size in 720xSomething space, 
255           this has to be tuned for every TV by user for best results, 
256           can't go out of range of 720xSomething (I think).
257         - np 0,0 -ns 640 480 # same for NTSC
258
259         The script expects you to supply everything at once.
260         """
261         self.last_written.update(self.settings)
262         if self.settings['enabled'] == 'False':
263             #print SET_CONFIG_CMD % '-d'
264             os.system(SET_CONFIG_CMD % '-d')
265         else:
266             pp = self.settings.copy()
267             pp['type'] = self.settings['encoding'][0]
268             #print SET_CONFIG_CMD % (CONFIG_PARAMS % pp)
269             os.system(SET_CONFIG_CMD % (CONFIG_PARAMS % pp))
270
271     def profile_to_string(self, dct):
272         """Converts settings dictionary to a string.
273
274         Profiles are stored as space separated values, in the following order:
275         <enabled> <encoding> <connection> <layer> <x> <y> <width> <height>
276         """
277         return ' '.join(dct[k] for k in FILE_ORDER)
278     
279     def string_to_profile(self, s):
280         """Converts a profile string back to a settings dictionary.
281
282         Profiles are stored as space separated values, in the following order:
283         <enabled> <encoding> <connection> <layer> <x> <y> <width> <height>
284         """
285         return dict(zip(FILE_ORDER, s.split(' ')))
286
287 class TVoutConfig(object):
288     """GUI application for modifying the pandora TV-out configuration
289
290     Design (tvout.glade):
291     +------------+---------------+--------------------+
292     |            | Position----- | Size-------------- |
293     |  Logo      | X: <spin btn> | Width: <spin btn>  |
294     |            | Y: <spin btn> | Height: <spin btn> |
295     +------------+---------------+--------------------+
296     |Encoding    | Overscan                           |
297     |. pal       | +--------------------------------+ |
298     |. ntsc      | |      <undisplayed area>        | |
299     +------------+ |   +-----------------------+    | |
300     |Connection  | |   |                       |    | |
301     |. composite | |   |   <displayed area>    |    | |
302     |. S-video   | |   |                       |    | |
303     +------------+ |   |                       |    | |
304     |Layer       | |   +-----------------------+    | |
305     |. Main      | |                                | |
306     |. overlay   | +--------------------------------+ |
307     +------------+------------------------------------+
308     |[v] enabled | [ Read settings ] [Write settings] |
309     |[delete p.] | {.............|v} [ Save profile ] |  
310     +------------+------------------------------------+
311
312     Important widget names:
313     - X,Y,Width and Height spinbuttons: x,y,width and height
314     - Radio buttons (for Encoding, Connection, Layer):
315       pal, ntsc, composite, svideo, layer0, layer1
316
317       These names correspond to their values as they are written,
318       except for layer0 and layer1 which are stored as strings(!) 0 and 1.
319     - The checkbox is called: enabled
320     - The buttons are called: 
321       readSettings, writeSettings, deleteProfile, saveProfile
322     - The combobox is called: ProfileComboEntry
323     - The displayed area is created by a set of GtkHPaned and GtkVPaned 
324       widgets called: xPaned, yPaned, widthPaned, heightPaned
325       They are contained in a frame called previewAlignment which can be
326       used to determine the total allocated size.
327     """
328
329     def __init__(self):
330         """Initialize the GUI application.
331         
332         Loads glade file, creates widget references, connects unbound handlers
333         (mainly those handlers which require userdata) and finally initializes
334         the model.
335         """
336         builder = gtk.Builder()
337         builder.add_from_file(
338             os.path.join(os.path.dirname(__file__), GUI_DESCRIPTION))
339         builder.connect_signals(self)
340
341         self.widgets = {}
342         for widgetname in W_WIDGETS:
343             self.widgets[widgetname] = builder.get_object(widgetname)
344
345         # Bind radiobutton signals
346         for widget, setting in RADIO_USERDATA.iteritems():
347             self.widgets[widget].connect('clicked', self.on_clicked, 
348                                       setting, widget.lstrip('layer'))
349
350         # Bind adjustment signals
351         for widget in ADJUSTMENT_USERDATA:
352             self.widgets[widget].get_adjustment().connect(
353                 'value_changed', self.on_value_changed, widget)
354         
355
356         # The allocated size of this widget is utilized to convert the 
357         # slider positions to absolute x,y,width and height values.
358         self.previewPane = builder.get_object(PP_WIDGET)
359
360         self.panedwidgets = {}
361         # Bind previewpane handle signals
362         for key in PP_HANDLES:
363             w = builder.get_object(key)
364             self.panedwidgets[key] = w
365             w.connect("notify::position", self.on_paned_position_change, key)
366
367         self.model = TVoutModel(self)
368
369         # We have two sets of widgets manipulating position and size
370         # (spinbuttons and the handles in the previewpane).
371         # To prevent an update race between these sets, the following flags 
372         # are set to block the handlers of the widgets which we are NOT 
373         # manipulating. The spinbuttons are more precise and therefore leading.
374         self.suppress_handles = False
375         self.suppress_spinbuttons = False
376
377         self.statusbar = builder.get_object('statusbar')
378         self.contextid = self.statusbar.get_context_id('')
379
380         self.profiles = gtk.ListStore(str)
381         for profile in DC_DEFAULTS:
382             self.profiles.append([profile])
383         for name in self.model.profiles:
384             self.profiles.append([name])
385
386         self.comboentry = builder.get_object('ProfileComboEntry')
387         self.comboentry.set_model(self.profiles)
388         self.comboentry.set_text_column(0)
389         self.comboentry.connect('changed', self.on_combo_changed)
390
391         self.entry = self.comboentry.get_child()
392         self.entry.connect('activate', self.on_LoadProfile_clicked)
393
394         # we need a reference to change their sensitive
395         # setting according to the profile
396         self.delete = builder.get_object('deleteProfile')
397         self.save = builder.get_object('saveProfile')
398
399         # this also changes sensitive of self.save & self.load
400         self.comboentry.set_active(0)
401
402         self.window = builder.get_object("window")
403         self.window.show_all()
404
405         accelgrp = gtk.AccelGroup()
406         key, mod = gtk.accelerator_parse('<Control>Q')
407         accelgrp.connect_group(key, mod, 0, self.on_window_destroy)
408         self.window.add_accel_group(accelgrp)
409
410         # read current config
411         self.model.read_settings()
412
413     def Notify(self, message):
414         """Displays a message on the statusbar"""
415         self.statusbar.pop(self.contextid)
416         self.statusbar.push(self.contextid, message)
417
418     def get_y_resolution(self):
419         """Returns the (mode-dependent) maximum Y resolution"""
420         return Y_RES_PAL if self.widgets['pal'].get_active() else Y_RES_NTSC
421
422     # --------------------------------
423     # View updates when model changes
424     # --------------------------------
425
426     def _update_profile_list(self, new, profiles):
427         """Show all default profiles and then the custom profiles.
428         
429         @new: name of newly selected profile
430         @profiles: dictionary of all profiles.
431         """
432         self.profiles.clear()
433         activate = 0
434         for i, key in enumerate(DC_DEFAULTS):
435             self.profiles.append([key])
436             if key == new:
437                 activate = i
438         offset = len(DC_DEFAULTS)
439         for i, key in enumerate(sorted(profiles.keys())):
440             self.profiles.append([key])
441             if key == new:
442                 activate = i + offset
443         self.comboentry.set_active(activate)
444             
445     def _update_widgets(self, settings):
446         """Update all widgets to reflect the configuration in settings"""
447         enabled = eval(settings['enabled'])
448         self.widgets['enabled'].set_active(enabled)
449
450         self.widgets[settings['encoding']].set_active(True)
451         self.widgets[settings['connection']].set_active(True)
452         self.widgets['layer'+settings['layer']].set_active(True)
453
454         for key in W_ADJUSTMENTS:
455             w = self.widgets[key]
456             w.get_adjustment().set_value(eval(settings[key]))
457             w.set_sensitive(enabled)
458         
459         for key in W_RADIO_BUTTONS:
460             self.widgets[key].set_sensitive(enabled)
461
462     def update_view(self, reason, *data):
463         """Dispatcher for events generated by the model."""
464         if reason == MODEL_PROFILE_CHANGE:
465             self._update_profile_list(*data)
466         elif reason == MODEL_VALUE_CHANGE:
467             self._update_widgets(*data)
468
469     def update_adjustments(self):
470         """Update all Gtk adjustments to recompute their maximum.
471
472         The value of x+width should not exceed 720.
473         The value of y+height should not exceed the maximum Y resolution.
474         """
475         x = self.widgets['x'].get_adjustment()
476         y = self.widgets['y'].get_adjustment()
477
478         xval = int(self.model.settings['x'])
479         yval = int(self.model.settings['y'])
480         wval = int(self.model.settings['width'])
481         hval = int(self.model.settings['height'])
482
483         # update vertical resolution thresholds
484         y.set_upper(self.get_y_resolution())
485         y.set_value(min(yval, y.get_upper()))
486
487         # update width thresholds
488         width = self.widgets['width'].get_adjustment()
489         width.set_upper(x.get_upper()-xval)
490         width.set_value(min(wval, width.get_upper()))
491
492         # update height thresholds
493         height = self.widgets['height'].get_adjustment()
494         height.set_upper(y.get_upper()-yval)
495         height.set_value(min(hval, height.get_upper()))
496
497     # --------------------------------
498     # Handling of widget changes
499     # --------------------------------
500
501     def on_toggled(self, widget, *data):
502         """Handles changes of the enabled radio button."""
503         enabled = widget.get_active()
504         self.model.settings[ENABLED_USERDATA] = str(enabled)
505         for name, widget in self.widgets.iteritems():
506             if name != 'enabled':
507                 widget.set_sensitive(enabled)
508
509     def on_clicked(self, widget, key=None, value=None):
510         """Handles changes of the radio buttons.
511         
512         @key: the setting being changed, i.e.
513               - "encoding" for pal/ntsc, 
514               - "connection" for composite/svideo
515               - "layer" for layer0/layer1. 
516         These correspond to the keys in the profile settings dictionaries.
517         @value: the value to be written to the dictionary.
518
519         When the encoding changes, so does the maximum Y resolution.
520         Hence it requires the adjustments to be updated.
521         """
522         if key:
523             self.model.settings[key] = value
524         if key == 'encoding':
525             self.update_adjustments()
526
527     def on_value_changed(self, widget, data):
528         """Handles spinbutton events.
529
530         If the user manipulates the spinbutton, the model is updated.
531         Note that suppress_handles is set to prevent the GtkPaned widgets
532         from retriggering an update. The precision of the Paned widgets
533         depends on screen resolution and tends to be less precise than
534         that of the spinbuttons causing an update-race.
535         """
536         if self.suppress_spinbuttons:
537             return
538
539         self.model.settings[data] = str(int(widget.get_value()))
540         self.update_adjustments()
541         yresolution = self.get_y_resolution()
542
543         # update the handle displays, but don't generate a new signal.
544         self.suppress_handles = True
545         self.set_pane_position(data + 'Paned', yresolution)
546         self.suppress_handles = False
547
548     # --------------------------------
549     # Button clicks
550     # --------------------------------
551
552     def on_readSettings_clicked(self, widget, *data):
553         """Handles a click on the readSettings button.
554         
555         Since it doesn't require userdata, this is connected through glade.
556         """
557         self.model.read_settings()
558         self.Notify("Active TV-out configuration loaded.")
559
560     def on_writeSettings_clicked(self, widget, *data):
561         """Handles a click on the writeSettings button.
562
563         Since it doesn't require userdata, this is connected through glade.
564         """
565         self.model.write_settings()
566         self.Notify("TV-out configuration updated.")
567
568     def on_deleteProfile_clicked(self, widget, *data):
569         """Handles a click on the deleteProfile button.
570
571         Since it doesn't require userdata, this is connected through glade.
572         The touch-screen is not the highest precision input and has no 
573         visual feedback before a click. Therefore we better prompt for
574         confirmation. Having an undo instead would probably be better.
575         """
576         name = self.entry.get_text()
577         if name not in self.model.profiles or name in DC_DEFAULTS:
578             self.Notify("Cannot remove profile, please select an existing non-default profile.")
579         else:
580             dialog = gtk.MessageDialog(flags=gtk.DIALOG_MODAL, type=gtk.MESSAGE_WARNING,
581                  buttons=gtk.BUTTONS_YES_NO,
582                  message_format="Are you sure you want to delete profile %s?" % name)
583             if dialog.run() == gtk.RESPONSE_YES:
584                 self.model.delete_profile(name)
585             dialog.destroy()
586
587     def on_saveProfile_clicked(self, widget, *data):
588         """Handles a click on the saveProfile button.
589
590         Since it doesn't require userdata, this is connected through glade.
591         Default profiles cannot be overwritten.
592         """
593         name = self.entry.get_text()
594         if name == '' or name in DC_DEFAULTS:
595             self.Notify("Invalid profile name")
596         else:
597             self.model.set_profile(name, self.model.settings)
598             self.Notify("Profile saved as: %s" % name)
599
600     # --------------------------------
601     # ComboBox
602     # --------------------------------
603
604     def _lose_active(self):
605         """Forces the comboboxentry to lose its active selection.
606         
607         This ensures that it also generates a changed signal when we
608         select the same value twice in a row such that a user can undo
609         any changes made to a loaded profile by loading the profile again.
610         """
611         temp = self.entry.get_text()
612         self.entry.set_text('')
613         self.entry.set_text(temp)
614
615     def on_combo_changed(self, widget, *data):
616         """Handles selection in the profile combo box."""
617         name = self.entry.get_text()
618         self.delete.set_sensitive(name in self.model.profiles)
619         self.save.set_sensitive(name != '' and name not in DC_DEFAULTS)
620         if self.comboentry.get_active() != -1:
621             self.on_LoadProfile_clicked(None)
622
623     def on_LoadProfile_clicked(self, widget, *data):
624         """Loads profile in the entry widget (by name).
625
626         It is directly activated by the activation event of the combobox entry
627         (i.e. when the user presses enter) and indirectly called by 
628         on_combo_changed (when the user performs a mouse selection).
629         """
630         self._lose_active()          # force widget to always emit changed signals,
631         name = self.entry.get_text() # ok since we always lookup by text value anyway
632         if not name:
633             return
634         elif name not in self.model.profiles and name not in DC_DEFAULTS:
635             self.Notify("Cannot load profile, please select an existing profile.")
636         else:
637             self.model.load_named_profile(name)
638             self.Notify("Profile loaded, hit 'Write settings' to make it active")
639
640     # --------------------------------
641
642     def set_pane_position(self, key, yresolution):
643         """Sync the GtkPaned widgets with the spinbuttons.
644
645         The Paned handles need their position specified in pixels.
646         This converts an absolute value to a relative position as the pane is 
647         not actually 720 pixels wide (nor high). 
648
649         PP_DX and PP_DY are corrections for the border around the client area.
650         They are measured for a specific theme, I'm not sure if changing theme
651         can invalidate this value but I guess it can.
652         """
653         value = int(self.model.settings[key.rstrip('Paned')])
654         widget = self.panedwidgets[key]
655         if key == 'widthPaned' or key == 'xPaned':
656             maxval = self.previewPane.allocation.width - PP_DX
657             newpos = (value / 720.) * maxval
658         else:
659             maxval = self.previewPane.allocation.height - PP_DY
660             newpos = (value / float(yresolution)) * maxval
661         widget.set_position(int(newpos))
662
663     def on_paned_position_change(self, widget, param, key):
664         """Handle dragging of the GtkPaned widgets.
665
666         This turns of handling of the spinbuttons as otherwise the spinbutton
667         update would re-trigger this event handler causing an update race due
668         to differences in precision.
669         """
670         if self.suppress_handles:
671             return
672
673         yresolution = self.get_y_resolution()
674         self.suppress_spinbuttons = True
675
676         maxval = self.previewPane.allocation.width - PP_DX        
677         for key in ('xPaned', 'widthPaned'):
678             pos = int((self.panedwidgets[key].get_position()/maxval)*720)
679             adj = self.widgets[key.rstrip('Paned')].get_adjustment()
680             adj.set_value(pos)
681             self.model.settings[key.rstrip('Paned')] = str(int(pos))
682
683         maxval = self.previewPane.allocation.height - PP_DY
684         for key in ('yPaned', 'heightPaned'):
685             pos = (self.panedwidgets[key].get_position()/maxval) * yresolution
686             adj = self.widgets[key.rstrip('Paned')].get_adjustment()
687             adj.set_value(int(pos))
688             self.model.settings[key.rstrip('Paned')] = str(int(pos))
689
690         self.update_adjustments()
691         self.suppress_spinbuttons = False
692         
693     def on_window_destroy(self, widget, *data):
694         """Handle application shutdown."""
695         self.Notify("Storing profiles...")
696         self.model.store_profiles()
697         gtk.main_quit()
698
699 # ================================================================
700
701 def main(args):
702     """Runs the application.
703
704     @args: command-line arguments (typically sys.argv).
705     """
706     if len(args) == 1: # no params: run gui app
707         app = TVoutConfig()
708         gtk.main()
709     else: # run command line app
710         parser = optparse.OptionParser()
711
712         parser.add_option('-e', '--enabled', default='', help=HELP_ENABLED)
713         parser.add_option('-t', '--encoding_type', default='', help=HELP_ENCODING)
714         parser.add_option('-c', '--connection_type', default='', help=HELP_CONNECTION)
715         parser.add_option('-l', '--layer', default='', help=HELP_LAYER)
716         parser.add_option('-w', '--width', default='', help=HELP_WIDTH)
717         parser.add_option('-g', '--height', default='', help=HELP_HEIGHT)
718         parser.add_option('-x', '--x_position', default='', help=HELP_X)
719         parser.add_option('-y', '--y_position', default='', help=HELP_Y)
720
721         parser.add_option('-s', '--save_profile', default='', help=HELP_SAVE)
722         parser.add_option('-a', '--apply', default=False, action='store_true', help=HELP_APPLY)
723         parser.add_option('-p', '--load_profile', default='', help=HELP_LOAD)
724         parser.add_option('-d', '--remove_profile', default='', help=HELP_DEL)
725
726         options, args = parser.parse_args()
727                           
728         model = TVoutModel()
729         model.read_settings()
730         if options.enabled:
731             model.settings['enabled'] = options.enabled
732         if options.encoding_type:
733             model.settings['encoding'] = options.encoding_type
734         if options.connection_type:
735             model.settings['connection'] = options.connection_type
736         if options.layer:
737             model.settings['layer'] = options.layer
738         if options.width:
739             model.settings['width'] = options.width
740         if options.height:
741             model.settings['height'] = options.height
742         if options.x_position:
743             model.settings['x'] = options.x_position
744         if options.y_position:
745             model.settings['y'] = options.y_position
746
747         profile_string = model.profile_to_string(model.settings)
748         config = Validate(profile_string)
749
750         if not config:
751             print "Invalid values encountered in profile (%s), terminating." % profile_string
752             sys.exit(1)
753
754         if options.save_profile and options.save_profile not in DC_DEFAULTS:
755             model.set_profile(options.save_profile, self.model.settings)
756         if options.apply:
757             model.write_settings()
758         if options.load_profile:
759             model.load_named_profile(options.load_profile)
760             model.write_settings()
761         if options.remove_profile:
762             model.delete_profile(options.remove_profile)
763
764         if options.save_profile or options.remove_profile:
765             model.store_profiles()
766
767 if __name__ == '__main__':
768     try:
769         main(sys.argv)
770     except Exception, e:
771         print e
772         sys.exit(1)
773     else:
774         sys.exit(0)