Tools/pynche/Main.py

   1 """Pynche -- The PYthon Natural Color and Hue Editor.
   2
   3 Contact: %(AUTHNAME)s
   4 Email:   %(AUTHEMAIL)s
   5 Version: %(__version__)s
   6
   7 Pynche is based largely on a similar color editor I wrote years ago for the
   8 SunView window system.  That editor was called ICE: the Interactive Color
   9 Editor.  I'd always wanted to port the editor to X but didn't feel like
  10 hacking X and C code to do it.  Fast forward many years, to where Python +
  11 Tkinter provides such a nice programming environment, with enough power, that
  12 I finally buckled down and implemented it.  I changed the name because these
  13 days, too many other systems have the acronym `ICE'.
  14
  15 This program currently requires Python 2.2 with Tkinter.
  16
  17 Usage: %(PROGRAM)s [-d file] [-i file] [-X] [-v] [-h] [initialcolor]
  18
  19 Where:
  20     --database file
  21     -d file
  22         Alternate location of a color database file
  23
  24     --initfile file
  25     -i file
  26         Alternate location of the initialization file.  This file contains a
  27         persistent database of the current Pynche options and color.  This
  28         means that Pynche restores its option settings and current color when
  29         it restarts, using this file (unless the -X option is used).  The
  30         default is ~/.pynche
  31
  32     --ignore
  33     -X
  34         Ignore the initialization file when starting up.  Pynche will still
  35         write the current option settings to this file when it quits.
  36
  37     --version
  38     -v
  39         print the version number and exit
  40
  41     --help
  42     -h
  43         print this message
  44
  45     initialcolor
  46         initial color, as a color name or #RRGGBB format
  47 """
  48
  49 __version__ = '1.4.1'
  50
  51 import sys
  52 import os
  53 import getopt
  54 import ColorDB
  55
  56 from PyncheWidget import PyncheWidget
  57 from Switchboard import Switchboard
  58 from StripViewer import StripViewer
  59 from ChipViewer import ChipViewer
  60 from TypeinViewer import TypeinViewer
  61
  62
  63 \f
  64 PROGRAM = sys.argv[0]
  65 AUTHNAME = 'Barry Warsaw'
  66 AUTHEMAIL = 'barry@python.org'
  67
  68 # Default locations of rgb.txt or other textual color database
  69 RGB_TXT = [
  70     # Solaris OpenWindows
  71     '/usr/openwin/lib/rgb.txt',
  72     # Linux
  73     '/usr/lib/X11/rgb.txt',
  74     # The X11R6.4 rgb.txt file
  75     os.path.join(sys.path[0], 'X/rgb.txt'),
  76     # add more here
  77     ]
  78
  79
  80 \f
  81 # Do this because PyncheWidget.py wants to get at the interpolated docstring
  82 # too, for its Help menu.
  83 def docstring():
  84     return __doc__ % globals()
  85
  86
  87 def usage(code, msg=''):
  88     print docstring()
  89     if msg:
  90         print msg
  91     sys.exit(code)
  92
  93
  94 \f
  95 def initial_color(s, colordb):
  96     # function called on every color
  97     def scan_color(s, colordb=colordb):
  98         try:
  99             r, g, b = colordb.find_byname(s)
 100         except ColorDB.BadColor:
 101             try:
 102                 r, g, b = ColorDB.rrggbb_to_triplet(s)
 103             except ColorDB.BadColor:
 104                 return None, None, None
 105         return r, g, b
 106     #
 107     # First try the passed in color
 108     r, g, b = scan_color(s)
 109     if r is None:
 110         # try the same color with '#' prepended, since some shells require
 111         # this to be escaped, which is a pain
 112         r, g, b = scan_color('#' + s)
 113     if r is None:
 114         print 'Bad initial color, using gray50:', s
 115         r, g, b = scan_color('gray50')
 116     if r is None:
 117         usage(1, 'Cannot find an initial color to use')
 118         # does not return
 119     return r, g, b
 120
 121
 122 \f
 123 def build(master=None, initialcolor=None, initfile=None, ignore=None,
 124           dbfile=None):
 125     # create all output widgets
 126     s = Switchboard(not ignore and initfile)
 127     # defer to the command line chosen color database, falling back to the one
 128     # in the .pynche file.
 129     if dbfile is None:
 130         dbfile = s.optiondb().get('DBFILE')
 131     # find a parseable color database
 132     colordb = None
 133     files = RGB_TXT[:]
 134     if dbfile is None:
 135         dbfile = files.pop()
 136     while colordb is None:
 137         try:
 138             colordb = ColorDB.get_colordb(dbfile)
 139         except (KeyError, IOError):
 140             pass
 141         if colordb is None:
 142             if not files:
 143                 break
 144             dbfile = files.pop(0)
 145     if not colordb:
 146         usage(1, 'No color database file found, see the -d option.')
 147     s.set_colordb(colordb)
 148
 149     # create the application window decorations
 150     app = PyncheWidget(__version__, s, master=master)
 151     w = app.window()
 152
 153     # these built-in viewers live inside the main Pynche window
 154     s.add_view(StripViewer(s, w))
 155     s.add_view(ChipViewer(s, w))
 156     s.add_view(TypeinViewer(s, w))
 157
 158     # get the initial color as components and set the color on all views.  if
 159     # there was no initial color given on the command line, use the one that's
 160     # stored in the option database
 161     if initialcolor is None:
 162         optiondb = s.optiondb()
 163         red = optiondb.get('RED')
 164         green = optiondb.get('GREEN')
 165         blue = optiondb.get('BLUE')
 166         # but if there wasn't any stored in the database, use grey50
 167         if red is None or blue is None or green is None:
 168             red, green, blue = initial_color('grey50', colordb)
 169     else:
 170         red, green, blue = initial_color(initialcolor, colordb)
 171     s.update_views(red, green, blue)
 172     return app, s
 173
 174
 175 def run(app, s):
 176     try:
 177         app.start()
 178     except KeyboardInterrupt:
 179         pass
 180
 181
 182 \f
 183 def main():
 184     try:
 185         opts, args = getopt.getopt(
 186             sys.argv[1:],
 187             'hd:i:Xv',
 188             ['database=', 'initfile=', 'ignore', 'help', 'version'])
 189     except getopt.error, msg:
 190         usage(1, msg)
 191
 192     if len(args) == 0:
 193         initialcolor = None
 194     elif len(args) == 1:
 195         initialcolor = args[0]
 196     else:
 197         usage(1)
 198
 199     ignore = False
 200     dbfile = None
 201     initfile = os.path.expanduser('~/.pynche')
 202     for opt, arg in opts:
 203         if opt in ('-h', '--help'):
 204             usage(0)
 205         elif opt in ('-v', '--version'):
 206             print """\
 207 Pynche -- The PYthon Natural Color and Hue Editor.
 208 Contact: %(AUTHNAME)s
 209 Email:   %(AUTHEMAIL)s
 210 Version: %(__version__)s""" % globals()
 211             sys.exit(0)
 212         elif opt in ('-d', '--database'):
 213             dbfile = arg
 214         elif opt in ('-X', '--ignore'):
 215             ignore = True
 216         elif opt in ('-i', '--initfile'):
 217             initfile = arg
 218
 219     app, sb = build(initialcolor=initialcolor,
 220                     initfile=initfile,
 221                     ignore=ignore,
 222                     dbfile=dbfile)
 223     run(app, sb)
 224     sb.save_views()
 225
 226
 227 \f
 228 if __name__ == '__main__':
 229     main()