Tools/pynche/ListViewer.py

   1 """ListViewer class.
   2
   3 This class implements an input/output view on the color model.  It lists every
   4 unique color (e.g. unique r/g/b value) found in the color database.  Each
   5 color is shown by small swatch and primary color name.  Some colors have
   6 aliases -- more than one name for the same r/g/b value.  These aliases are
   7 displayed in the small listbox at the bottom of the screen.
   8
   9 Clicking on a color name or swatch selects that color and updates all other
  10 windows.  When a color is selected in a different viewer, the color list is
  11 scrolled to the selected color and it is highlighted.  If the selected color
  12 is an r/g/b value without a name, no scrolling occurs.
  13
  14 You can turn off Update On Click if all you want to see is the alias for a
  15 given name, without selecting the color.
  16 """
  17
  18 from Tkinter import *
  19 import ColorDB
  20
  21 ADDTOVIEW = 'Color %List Window...'
  22
  23 class ListViewer:
  24     def __init__(self, switchboard, master=None):
  25         self.__sb = switchboard
  26         optiondb = switchboard.optiondb()
  27         self.__lastbox = None
  28         self.__dontcenter = 0
  29         # GUI
  30         root = self.__root = Toplevel(master, class_='Pynche')
  31         root.protocol('WM_DELETE_WINDOW', self.withdraw)
  32         root.title('Pynche Color List')
  33         root.iconname('Pynche Color List')
  34         root.bind('<Alt-q>', self.__quit)
  35         root.bind('<Alt-Q>', self.__quit)
  36         root.bind('<Alt-w>', self.withdraw)
  37         root.bind('<Alt-W>', self.withdraw)
  38         #
  39         # create the canvas which holds everything, and its scrollbar
  40         #
  41         frame = self.__frame = Frame(root)
  42         frame.pack()
  43         canvas = self.__canvas = Canvas(frame, width=160, height=300,
  44                                         borderwidth=2, relief=SUNKEN)
  45         self.__scrollbar = Scrollbar(frame)
  46         self.__scrollbar.pack(fill=Y, side=RIGHT)
  47         canvas.pack(fill=BOTH, expand=1)
  48         canvas.configure(yscrollcommand=(self.__scrollbar, 'set'))
  49         self.__scrollbar.configure(command=(canvas, 'yview'))
  50         self.__populate()
  51         #
  52         # Update on click
  53         self.__uoc = BooleanVar()
  54         self.__uoc.set(optiondb.get('UPONCLICK', 1))
  55         self.__uocbtn = Checkbutton(root,
  56                                     text='Update on Click',
  57                                     variable=self.__uoc,
  58                                     command=self.__toggleupdate)
  59         self.__uocbtn.pack(expand=1, fill=BOTH)
  60         #
  61         # alias list
  62         self.__alabel = Label(root, text='Aliases:')
  63         self.__alabel.pack()
  64         self.__aliases = Listbox(root, height=5,
  65                                  selectmode=BROWSE)
  66         self.__aliases.pack(expand=1, fill=BOTH)
  67
  68     def __populate(self):
  69         #
  70         # create all the buttons
  71         colordb = self.__sb.colordb()
  72         canvas = self.__canvas
  73         row = 0
  74         widest = 0
  75         bboxes = self.__bboxes = []
  76         for name in colordb.unique_names():
  77             exactcolor = ColorDB.triplet_to_rrggbb(colordb.find_byname(name))
  78             canvas.create_rectangle(5, row*20 + 5,
  79                                     20, row*20 + 20,
  80                                     fill=exactcolor)
  81             textid = canvas.create_text(25, row*20 + 13,
  82                                         text=name,
  83                                         anchor=W)
  84             x1, y1, textend, y2 = canvas.bbox(textid)
  85             boxid = canvas.create_rectangle(3, row*20+3,
  86                                             textend+3, row*20 + 23,
  87                                             outline='',
  88                                             tags=(exactcolor, 'all'))
  89             canvas.bind('<ButtonRelease>', self.__onrelease)
  90             bboxes.append(boxid)
  91             if textend+3 > widest:
  92                 widest = textend+3
  93             row += 1
  94         canvheight = (row-1)*20 + 25
  95         canvas.config(scrollregion=(0, 0, 150, canvheight))
  96         for box in bboxes:
  97             x1, y1, x2, y2 = canvas.coords(box)
  98             canvas.coords(box, x1, y1, widest, y2)
  99
 100     def __onrelease(self, event=None):
 101         canvas = self.__canvas
 102         # find the current box
 103         x = canvas.canvasx(event.x)
 104         y = canvas.canvasy(event.y)
 105         ids = canvas.find_overlapping(x, y, x, y)
 106         for boxid in ids:
 107             if boxid in self.__bboxes:
 108                 break
 109         else:
 110 ##            print 'No box found!'
 111             return
 112         tags = self.__canvas.gettags(boxid)
 113         for t in tags:
 114             if t[0] == '#':
 115                 break
 116         else:
 117 ##            print 'No color tag found!'
 118             return
 119         red, green, blue = ColorDB.rrggbb_to_triplet(t)
 120         self.__dontcenter = 1
 121         if self.__uoc.get():
 122             self.__sb.update_views(red, green, blue)
 123         else:
 124             self.update_yourself(red, green, blue)
 125             self.__red, self.__green, self.__blue = red, green, blue
 126
 127     def __toggleupdate(self, event=None):
 128         if self.__uoc.get():
 129             self.__sb.update_views(self.__red, self.__green, self.__blue)
 130
 131     def __quit(self, event=None):
 132         self.__root.quit()
 133
 134     def withdraw(self, event=None):
 135         self.__root.withdraw()
 136
 137     def deiconify(self, event=None):
 138         self.__root.deiconify()
 139
 140     def update_yourself(self, red, green, blue):
 141         canvas = self.__canvas
 142         # turn off the last box
 143         if self.__lastbox:
 144             canvas.itemconfigure(self.__lastbox, outline='')
 145         # turn on the current box
 146         colortag = ColorDB.triplet_to_rrggbb((red, green, blue))
 147         canvas.itemconfigure(colortag, outline='black')
 148         self.__lastbox = colortag
 149         # fill the aliases
 150         self.__aliases.delete(0, END)
 151         try:
 152             aliases = self.__sb.colordb().aliases_of(red, green, blue)[1:]
 153         except ColorDB.BadColor:
 154             self.__aliases.insert(END, '<no matching color>')
 155             return
 156         if not aliases:
 157             self.__aliases.insert(END, '<no aliases>')
 158         else:
 159             for name in aliases:
 160                 self.__aliases.insert(END, name)
 161         # maybe scroll the canvas so that the item is visible
 162         if self.__dontcenter:
 163             self.__dontcenter = 0
 164         else:
 165             ig, ig, ig, y1 = canvas.coords(colortag)
 166             ig, ig, ig, y2 = canvas.coords(self.__bboxes[-1])
 167             h = int(canvas['height']) * 0.5
 168             canvas.yview('moveto', (y1-h) / y2)
 169
 170     def save_options(self, optiondb):
 171         optiondb['UPONCLICK'] = self.__uoc.get()
 172
 173     def colordb_changed(self, colordb):
 174         self.__canvas.delete('all')
 175         self.__populate()