# sugar-aware GUI classes # with boxes, sliders, spinbuttons, buttons, etc # # (c) Victor Lazzarini, 2006-08 # # This library is free software; you can redistribute it # and/or modify it under the terms of the GNU Lesser General Public # License as published by the Free Software Foundation; either # version 2.1 of the License, or (at your option) any later version. # # csndsugui is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public # License along with csndsugui; if not, write to the Free Software # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA # 02111-1307 USA # # As a special exception, if other files instantiate templates or # use macros or inline functions from this file, this file does not # by itself cause the resulting executable or library to be covered # by the GNU Lesser General Public License. This exception does not # however invalidate any other reasons why the library or executable # file might be covered by the GNU Lesser General Public License. # # # version 0.1.2 18/03/08 import pygtk pygtk.require('2.0') from sugar.activity import activity import gtk import sys import csnd import math import locale import os class BasicGUI: """Basic GUI with boxes, sliders, spins, buttons etc using pygtk/sugar, from which GUI classes can be derived for Csound use.""" def set_channel(self,name, val): """basic bus channel setting method, should be overriden for full-functionality.""" print "channel:%s, value:%.1f" % (name,val) def set_filechannel(self,chan,name): """basic filename channel setting method should be overriden for full-functionality.""" print "channel:%s, filename:%s" % (chan,name) def set_message(self, mess): """basic message setting method should be overriden for full-functionality.""" print mess def get_slider_value(self,name): """returns the slider value name: slider name (which should also be the attached bus channel name""" for i in self.sliders: if i[1] == name: return i[2] return 0 def get_button_value(self,name): """returns the button value (0 or 1) name: button name (which should also be the attached bus channel name)""" for i in self.buttons: if i[1] == name: return i[2] return 0 def get_slider(self,name): """returns the slider widget instance name: slider name""" for i in self.sliders: if i[1] == name: return i[0] return 0 def get_button(self,name): """returns the button widget instance name: button name""" for i in self.sliders: if i[1] == name: return i[0] return 0 def buttcallback(self, widget, data=None): for i in self.buttons: if i[0] == widget: if i[2]: i[2] = 0 i[0].modify_bg(gtk.STATE_NORMAL, gtk.gdk.Color(0x0FFF,0,0x00FF, 2)) i[0].modify_bg(gtk.STATE_PRELIGHT, gtk.gdk.Color(0xFFFF,0,0xFFFF, 2)) else: i[2] = 1 i[0].modify_bg(gtk.STATE_NORMAL, gtk.gdk.Color(0xFFFF,0,0, 1)) i[0].modify_bg(gtk.STATE_PRELIGHT, gtk.gdk.Color(0xFFFF,0,0, 2)) self.set_channel(i[1], i[2]) def mbuttcallback(self, widget, data=None): for i in self.buttons: if i[0] == widget: self.set_message(i[2]) def slidcallback(self,adj,widget): for i in self.sliders: if i[0] == widget: i[2] = adj.value if i[4]: self.set_channel(i[1],i[2]) i[3].set_text("%f" % i[2]) pass else: value = i[5]*pow(i[6]/i[5], i[2]/i[6]) self.set_channel(i[1], value) i[3].set_text("%.3f" % value) pass def spincallback(self,adj,widget): for i in self.spins: if i[0] == widget: i[2] = adj.value self.set_channel(i[1],i[2]) def filecallback(self,widget): name = self.curfile[0].get_filename() self.set_filechannel(self.curfile[1], name) self.filenames.update({self.curfile[1] : name}) self.curfile[0].destroy() # internal callback def fbuttcallback(self, widget, data=None): for i in self.buttons: if i[0] == widget: chooser = gtk.FileSelection(i[1]) self.curfile = (chooser, i[1]) chooser.set_filename(self.data_path) chooser.ok_button.connect("clicked", self.filecallback) chooser.cancel_button.connect("clicked", lambda h: chooser.destroy()) chooser.show() def cbbutton(self,box,callback,title=""): """Creates a callbackbutton box: parent box callback: click callback title: if given, the button name returns the widget instance""" self.cbbutts = self.cbbutts + 1 butt = gtk.Button(" %s " % title) box.pack_start(butt, False, False, 5) self.cbbuttons.append([butt,title,0]) butt.connect("clicked", callback) butt.show() return butt def button(self,box, title="",label=""): """Creates a button (on/off) box: parent box title: if given, the button name, which will also be the bus channel name. Otherwise a default name is given, BN, where N is button number in order of creation. label: if given, an alternative button name, which will be displayed instead of title returns the widget instance""" self.butts = self.butts + 1 if title == "": title = "B%d" % self.butts if label == "": name = title else: name = label butt = gtk.Button(" %s " % name) butt.modify_bg(gtk.STATE_ACTIVE, gtk.gdk.Color(0xFFFF,0,0, 1)) butt.modify_bg(gtk.STATE_PRELIGHT, gtk.gdk.Color(0xFFFF,0,0xFFFF, 2)) box.pack_start(butt, False, False, 5) self.buttons.append([butt,title,0]) butt.connect("clicked", self.buttcallback) butt.show() return butt def mbutton(self,box,mess,title=""): """Creates a mbutton (for sending a message) box: parent box title: if given, the button name, otherwise a default name is given, BN, where N is button number in order of creation. mess: message to be sent when button is clicked returns the widget instance""" self.mbutts = self.mbutts + 1 if title == "": title = "B%d" % self.mbutts butt = gtk.Button(title) butt.modify_bg(gtk.STATE_NORMAL, gtk.gdk.Color(0x0FFF,0,0x00FF, 1)) butt.modify_bg(gtk.STATE_PRELIGHT, gtk.gdk.Color(0xFFFF,0xFFFF,0x0000, 2)) box.pack_start(butt, False, False, 5) self.buttons.append([butt,title,mess]) butt.connect("clicked", self.mbuttcallback) butt.show() return butt def box(self,vert=True, parent=None, padding=5): """creates a box vert: True, creates a vertical box; horiz. otherwise parent: parent box, None if this is a toplevel box padding: box padding returns the widget instance""" if vert: box = gtk.VBox() else: box = gtk.HBox() if parent: parent.pack_start(box, False, False, padding) else: self.outbox.pack_start(box, False, False, padding) self.boxes.append(box) box.show() return box def filechooser(self,box,title,label=""): """Creates a filechooser button title: button name, also file bus channel name box: parent box label: if given, alternative name, for display purposes only otherwise button will display its title.""" if label == "": name = title else: name = label butt = gtk.Button(name) box.pack_start(butt, False, False, 5) self.buttons.append([butt,title]) butt.connect("clicked", self.fbuttcallback) self.set_filechannel(title,"0") self.filenames.update({title:"0"}) butt.show() return butt def slider(self,init, start, end, x, y, box, title="",vert=True,linear=True,dwid=100,label=""): """Creates a slider init: initial value start, end: start and end of slider range x, y: x and y sizes of slider box: parent box title: if given, the slider name, which will also be the bus channel name. Otherwise a default name is given, SN, where N is slider number in order of creation. vert: vertical slider (True), else horiz. linear: linear response (True), else exponential (zero or negative ranges are not allowed) dwid: display width in pixels label: if given, the alternative slider name, for display only returns the widget instance""" self.slids = self.slids + 1 if title == "": title = "S%d" % self.slids a = end - start if vert: step = a/y adj = gtk.Adjustment(init,start,end,step,step,0) slider = gtk.VScale(adj) slider.set_inverted(True) else: step = a/x adj = gtk.Adjustment(init,start,end,step,step,0) slider = gtk.HScale(adj) slider.set_draw_value(False) if step < 1.0: slider.set_digits(3) elif step < 10: slider.set_digits(2) elif step < 100: slider.set_digits(1) else: slider.set_digits(0) entry = gtk.Entry(5) if vert: entry.set_size_request(dwid,50) else: entry.set_size_request(dwid,50) entry.set_editable(False) if not linear: if (init <= 0) or (start <= 0) or (end <= 0): linear = True if not linear: pos = end*math.log(1,end/start) slider.set_range(pos, end) pos = end*math.log(init/start,end/start) slider.set_value(pos) if label == "": name = title else: name = label entry.set_text("%f" % init) label = gtk.Label(name) slider.set_size_request(x,y) box.pack_start(slider, False, False, 5) box.pack_start(entry, False, False, 2) box.pack_start(label, False, False, 2) self.sliders.append([slider,title,init,entry,linear,start,end]) adj.connect("value_changed", self.slidcallback, slider) slider.show() entry.show() label.show() self.set_channel(title, init) return slider def spin(self,init, start, end, step, page, box, accel=0,title="",label=""): """Creates a spin button init: initial value start, end: start and end of slider range step, page: small and large step sizes box: parent box accel: acceleration or 'climb rate' (0.0-1.0) title: if given, the spin button name, which will also be the bus channel name. Otherwise a default name is given, SPN, where N is spin number in order of creation. label: if given, the alternative name for the widget, for display only. returns the widget instance""" self.spinbs = self.spinbs + 1 if title == "": title = "SP%d" % self.spinbs adj = gtk.Adjustment(init,start,end,step,page,0) spin = gtk.SpinButton(adj,accel) if step < 1.0: spin.set_digits(3) elif step < 10: spin.set_digits(2) elif step < 100: spin.set_digits(1) else: spin.set_digits(0) if label == "": name = title else: name = label label = gtk.Label(name) box.pack_start(spin, False, False, 5) box.pack_start(label, False, False, 2) self.spins.append([spin,title,init]) adj.connect("value_changed", self.spincallback, spin) spin.show() label.show() self.set_channel(title, init) return spin def text(self, name, box=None,colour=(0,0,0)): """Creates a static text label name: text label box: parent box, None if text is to be placed toplevel colour: RGB values in a tuple (R,G,B) returns the widget instance""" label = gtk.Label(name) label.modify_fg(gtk.STATE_NORMAL, gtk.gdk.Color(colour[0],colour[1],colour[2], 0)) if box: box.pack_start(label, False, False, 5) else: self.outbox.pack_start(label, False, False, 5) label.show() return label def framebox(self, name, vert=True, parent=None, colour=(0,0,0), padding=5): """Creates a frame box name: text label vert: vertical (True) box, else horiz. parent: parent box, if None, this is a toplevel box colour: RGB values in a tuple (R,G,B) padding: padding space returns the box widget instance""" frame = gtk.Frame(name) frame.modify_bg(gtk.STATE_NORMAL, gtk.gdk.Color(colour[0],colour[1],colour[2], 0)) frame.get_label_widget().modify_fg(gtk.STATE_NORMAL, gtk.gdk.Color(colour[0],colour[1],colour[2], 0)) if parent: parent.pack_start(frame, False, False, padding) else: self.outbox.pack_start(frame, False, False, padding) if vert: box = gtk.VBox() else: box = gtk.HBox() frame.add(box) frame.show() box.show() return box def vsliderbank(self,items,init, start, end, x, y, box): """Creates a vertical slider bank items: number of sliders init: initial value start, end: start and end of slider range x, y: x and y sizes of slider box: parent box""" slid = self.slids for i in range(slid, slid+items): cbox = self.box(parent=box) self.slider(init,start,end,x,y,cbox) def hsliderbank(self,items,init, start, end, x, y, box): """Creates a horizontal slider bank items: number of sliders init: initial value start, end: start and end of slider range x, y: x and y sizes of slider box: parent box""" slid = self.slids for i in range(slid, slid+items): cbox = self.box(False,box) self.slider(init,start,end,x,y,cbox,"",False) def buttonbank(self,items, box): """Creates a button bank items: number of sliders box: parent box.""" start = self.butts for i in range(start, start+items): self.button(box) def delete_event(self, widget, event, data=None): return False def get_toolbox(self): """Returns the Activity toolbox""" return self.toolbox def __init__(self,act,colour=(-1,-1,-1),vert=True,toolbox=None): """Constructor act: activity object colour: bg colour RGB tuple (R,G, B) vert: True for vertical topmost arrangement, horiz. otherwise toolbox: activity toolbox object, if None (default) a standard toolbox will be supplied""" self.sliders = [] self.slids = 0 self.spins = [] self.spinbs = 0 self.buttons = [] self.butts = 0 self.cbbuttons = [] self.cbbutts = 0 self.mbuttons = [] self.mbutts = 0 self.boxes = [] self.filenames = dict() self.window = act if toolbox == None: self.toolbox = activity.ActivityToolbox(self.window) else: self.toolbox = toolbox self.window.set_toolbox(self.toolbox) self.toolbox.show() if colour[0] >= 0: self.window.modify_bg(gtk.STATE_NORMAL, gtk.gdk.Color(colour[0],colour[1],colour[2], 0)) if vert: self.outbox = gtk.VBox() else: self.outbox = gtk.HBox() self.window.set_canvas(self.outbox) self.data_path = os.path.join(act.get_activity_root(),"data/") self.outbox.show() class CsoundGUI(BasicGUI): """A class inheriting from BasicGUI containing a Csound instance and a performance thread instance.""" def set_channel(self,name,val): """overrides the base method. sets the bus channel value, called by the widget callbacks channel names 'play', 'pause' and 'reset' are reserved for these respective uses""" if not self.ready: if name == "play": self.play() elif name == "pause": self.pause() elif name == "reset": self.reset() self.csound.SetChannel(name,val) else: BasicGUI.set_channel(self,name,val) def set_filechannel(self,chan,name): """overrides the base method, setting the channel string""" if not self.ready: self.csound.SetChannel(chan,name) else: BasicGUI.set_filechannel(self,chan,name) def set_message(self, mess): """overrides the base method, sends a score message""" self.perf.InputMessage(mess) def play(self): """Starts a performance. """ if not self.on: if self.paused: return self.on = True self.perf.Play() else: self.on = False self.perf.Pause() def pause(self): """Pauses a performance. """ if self.on: self.on = False self.paused = True self.perf.Pause() elif self.paused: self.on = True self.paused = False self.perf.Play() def csd(self, name, extra=None): """Sets the source CSD and compiles it. name: CSD filename extra: a single extra parameter returns zero if successful""" self.extra = extra path = activity.get_bundle_path() if self.ready: if self.extra != None: res = self.csound.Compile("%s/%s" % (path,name), extra) else: res = self.csound.Compile("%s/%s" % (path,name)) if not res: self.ready = False self.path = path self.name = name return res def recompile(self): """Recompiles the set CSD. returns zero if successful""" if not self.ready and self.name != "0": self.perf.Stop() self.perf.Join() self.on = False self.paused = False self.perf = csnd.CsoundPerformanceThread(self.csound) if self.arglist != None: res = self.csound.Compile(self.arglist.argc(),self.arglist.argv()) elif self.extra != None: res = self.csound.Compile("%s/%s" % (self.path,self.name), self.extra) else: res = self.csound.Compile("%s/%s" % (self.path,self.name)) if(res): self.ready = True return res def compile(self,name,args): """Compiles Csound code. name: CSD filename args: list of arguments (as strings) returns 0 if successful , non-zero if not.""" if self.ready: self.arglist = csnd.CsoundArgVList() self.path = activity.get_bundle_path() self.name = name self.arglist.Append("csound") self.arglist.Append("%s/%s" % (self.path,self.name)) for i in args: self.arglist.Append(i) res = self.csound.Compile(self.arglist.argc(),self.arglist.argv()) if not res: self.ready = False return res # resets Csound ready for a new CSD def reset(self): """Resets Csound, ready for a new CSD""" if not self.ready: self.perf.Stop() self.perf.Join() self.on = False self.pause = False self.perf = csnd.CsoundPerformanceThread(self.csound) self.ready = True def close(self, event): self.reset() sys.exit(0) def __init__(self,act,colour=(-1,-1,-1),vert=True): """constructor act: activity object colour: bg colour RGB tuple (R,G, B) vert: True for vertical topmost arrangement, horiz. otherwise.""" locale.setlocale(locale.LC_NUMERIC, 'C') self.csound = csnd.Csound() self.perf = csnd.CsoundPerformanceThread(self.csound) BasicGUI.__init__(self,act,colour,vert) self.ready = True self.on = False self.paused = False self.name = "0" self.arglist = None