/Tools/pynche/ListViewer.py

  1"""ListViewer class.
  2
  3This class implements an input/output view on the color model.  It lists every
  4unique color (e.g. unique r/g/b value) found in the color database.  Each
  5color is shown by small swatch and primary color name.  Some colors have
  6aliases -- more than one name for the same r/g/b value.  These aliases are
  7displayed in the small listbox at the bottom of the screen.
  8
  9Clicking on a color name or swatch selects that color and updates all other
 10windows.  When a color is selected in a different viewer, the color list is
 11scrolled to the selected color and it is highlighted.  If the selected color
 12is an r/g/b value without a name, no scrolling occurs.
 13
 14You can turn off Update On Click if all you want to see is the alias for a
 15given name, without selecting the color.
 16"""
 17
 18from Tkinter import *
 19import ColorDB
 20
 21ADDTOVIEW = 'Color %List Window...'
 22
 23class 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()