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()
176