]> git.saurik.com Git - wxWidgets.git/blob - wxPython/demo/ColourDB.py
Fixed OOR typo
[wxWidgets.git] / wxPython / demo / ColourDB.py
1
2 import wx
3 import wx.lib.colourdb
4
5 import images
6
7
8 #----------------------------------------------------------------------
9
10 class TestWindow(wx.ScrolledWindow):
11 def __init__(self, parent):
12 wx.ScrolledWindow.__init__(self, parent, -1)
13
14 # Populate our color list
15 self.clrList = wx.lib.colourdb.getColourList()
16
17 # Just for style points, we'll use this as a background image.
18 #self.clrList.sort()
19 self.bg_bmp = images.getGridBGBitmap()
20
21 # Event handlers
22 self.Bind(wx.EVT_PAINT, self.OnPaint)
23 self.Bind(wx.EVT_ERASE_BACKGROUND, self.OnEraseBackground)
24
25 # This could also be done by getting the window's default font;
26 # either way, we need to have a font loaded for later on.
27 #self.SetBackgroundColour("WHITE")
28 self.font = wx.Font(10, wx.SWISS, wx.NORMAL, wx.NORMAL)
29
30 # Create drawing area and set its font
31 dc = wx.ClientDC(self)
32 dc.SetFont(self.font)
33
34 # Using GetFullTextExtent(), we calculate a basic 'building block'
35 # that will be used to draw a depiction of the color list. We're
36 # using 'Wy' as the model becuase 'W' is a wide character and 'y'
37 # has a descender. This constitutes a 'worst case' scenario, which means
38 # that no matter what we draw later, text-wise, we'll have room for it
39 w,h,d,e = dc.GetFullTextExtent("Wy")
40
41 # Height plus descender
42 self.textHeight = h + d
43
44 # Pad a little bit
45 self.lineHeight = self.textHeight + 5
46
47 # ... and this is the basic width.
48 self.cellWidth = w
49
50 # jmg 11/8/03: why 24?
51 numCells = 24
52
53 # 'prep' our scroll bars.
54 self.SetScrollbars(
55 self.cellWidth, self.lineHeight, numCells, len(self.clrList) + 2
56 )
57
58
59 # tile the background bitmap loaded in __init__()
60 def TileBackground(self, dc):
61 sz = self.GetClientSize()
62 w = self.bg_bmp.GetWidth()
63 h = self.bg_bmp.GetHeight()
64
65 # adjust for scrolled position
66 spx, spy = self.GetScrollPixelsPerUnit()
67 vsx, vsy = self.GetViewStart()
68 dx, dy = (spx * vsx) % w, (spy * vsy) % h
69
70 x = -dx
71
72 while x < sz.width:
73 y = -dy
74 while y < sz.height:
75 dc.DrawBitmap(self.bg_bmp, (x, y))
76 y = y + h
77
78 x = x + w
79
80 # Redraw the background over a 'damaged' area.
81 def OnEraseBackground(self, evt):
82 dc = evt.GetDC()
83
84 if not dc:
85 dc = wx.ClientDC(self)
86 rect = self.GetUpdateRegion().GetBox()
87 dc.SetClippingRect(rect)
88
89 self.TileBackground(dc)
90
91
92 def OnPaint(self, evt):
93 dc = wx.PaintDC(self)
94 self.PrepareDC(dc)
95 self.Draw(dc, self.GetUpdateRegion(), self.GetViewStart())
96
97
98 def Draw(self, dc, rgn=None, vs=None):
99 dc.BeginDrawing()
100 dc.SetTextForeground("BLACK")
101 dc.SetPen(wx.Pen("BLACK", 1, wx.SOLID))
102 dc.SetFont(self.font)
103 colours = self.clrList
104 numColours = len(colours)
105
106 if rgn:
107 # determine the subset of the color list that has been exposed
108 # and needs drawn. This is based on all the precalculation we
109 # did in __init__()
110 rect = rgn.GetBox()
111 pixStart = vs[1]*self.lineHeight + rect.y
112 pixStop = pixStart + rect.height
113 start = pixStart / self.lineHeight - 1
114 stop = pixStop / self.lineHeight
115 else:
116 start = 0
117 stop = numColours
118
119 for line in range(max(0,start), min(stop,numColours)):
120 clr = colours[line]
121 y = (line+1) * self.lineHeight + 2
122
123 # Updated for 2.5 - now takes tuple for pos
124 dc.DrawText(clr, (self.cellWidth, y))
125
126 brush = wx.Brush(clr, wx.SOLID)
127 dc.SetBrush(brush)
128 dc.DrawRectangle((12 * self.cellWidth, y),
129 (6 * self.cellWidth, self.textHeight))
130
131 dc.EndDrawing()
132
133
134 # On wxGTK there needs to be a panel under wx.ScrolledWindows if they are
135 # going to be in a wxNotebook. And, in this demo, we are.
136 class TestPanel(wx.Panel):
137 def __init__(self, parent):
138 wx.Panel.__init__(self, parent, -1)
139 self.win = TestWindow(self)
140 self.Bind(wx.EVT_SIZE, self.OnSize)
141
142
143 def OnSize(self, evt):
144 self.win.SetSize(evt.GetSize())
145
146
147
148 #----------------------------------------------------------------------
149
150
151 def runTest(frame, nb, log):
152 # This loads a whole bunch of new color names and values
153 # into TheColourDatabase
154 #
155 # Note 11/24/03 - jg - I moved this into runTest() because
156 # there must be a wx.App existing before this function
157 # can be called - this is a change from 2.4 -> 2.5.
158 wx.lib.colourdb.updateColourDB()
159
160 win = TestPanel(nb)
161
162 return win
163
164 #----------------------------------------------------------------------
165
166 overview = """
167 <html>
168 <body>
169 <B><font size=+2>ColourDB</font></b>
170
171 <p>wxWindows maintains a database of standard RGB colours for a predefined
172 set of named colours (such as "BLACK'', "LIGHT GREY''). The application
173 may add to this set if desired by using Append. There is only one instance
174 of this class: <b>TheColourDatabase</b>.
175
176 <p>The <code>colourdb</code> library is a lightweight API that pre-defines
177 a multitude of colors for you to use 'out of the box', and this demo serves
178 to show you these colors (it also serves as a handy reference).
179
180 <p>A secondary benefit of this demo is the use of the <b>ScrolledWindow</b> class
181 and the use of various *DC() classes, including background tiling and the use of
182 font data to generate a "building block" type of construct for repetitive use.
183
184 <p>
185 <B><font size=+2>Important note</font></b>
186
187 <p>
188 With implementation of V2.5 and later, it is required to have a wx.App already
189 initialized before <b><code>wx.updateColourDB()</code></b> can be called.
190 Trying to do otherwise will cause an exception to be raised.
191 </body>
192 </html>
193 """
194
195
196 if __name__ == '__main__':
197 import sys,os
198 import run
199 run.main(['', os.path.basename(sys.argv[0])] + sys.argv[1:])
200