class HyperlinkShow(Show): """ Aimed at touchscreens but can be used for any purpose where the user is required to follow hyperlinks between tracks Profiles for media tracks (message, image, video, audio ) specify links to other tracks In a link a symbolic name of an input is associated with a track-reference The show begins at a special track specified in the profiile called the First Track and moves to other tracks - when a link is executed by a input event with a specified symbolic name - at the natural end of the track using the special pp-onend symbolic name If using the 'call' link command PP keeps a record of the tracks it has visited so the 'return' command can go back. Executes timeout-track if no user input is received (includes pp-onend but not repeat) There is a another special track with Home Track. The home command returns here and the 'return n' command will not go back past here. This was designed to allow the timeout to go back to First Track which would advertise the show. Once the user had been enticed and clicked a link to move to Home pressing home or return would not return him to First Track You can make the Home Track and the First Track the same track if you want. You may want a track, if it is a video or audio track, to repeat. You can use repeat for this and it will not cancel the timeout. Image and message tracks can have a zero duration so they never end naturally so repeat is not required. links are of the form: symbolic-name command [track-ref] link commands: call <track-ref> play track-ref and add it to the path return - return 1 back up the path removing the track from the path, stops at home-track. return n - return n tracks back up the path removing the track from the path, stops at home-track. return <track-ref> return to <track-ref> removing tracks from the path home - return to home-track removing tracks from the path jump <track-ref-> - play track-ref forgetting the path back to home-track goto <track-ref> - play track-ref, forget the path repeat - repeat the track exit - end the hyperlink show null - inhibits the link defined in the show with the same symbolic name. reserved symbolic names pp-onend command - pseudo symbolic name for end of a track interface: * __init__ - initlialises the show * play - selects the first track to play (first-track) * input_pressed, - receives user events passes them to a Shower/Player if a track is playing, otherwise actions them depending on the symbolic name supplied * exit - stops the show from another show * terminate - aborts the show, used whan clsing or after errors * track_ready_callback - called by the next track to be played to remove the previous track from display * subshow_ready_callback - called by the subshow to get the last track of the parent show * subshow_ended_callback - called at the start of a parent show to get the last track of the subshow """ # ********************* # external interface # ******************** def __init__(self, show_id, show_params, root, canvas, showlist, pp_dir, pp_home, pp_profile, command_callback): """ show_id - index of the top level show caling this (for debug only) show_params - dictionary section for the menu canvas - the canvas that the menu is to be written on showlist - the showlist pp_dir - Pi Presents directory pp_home - Pi presents data_home directory pp_profile - Pi presents profile directory """ # init the common bits Show.base__init__(self, show_id, show_params, root, canvas, showlist, pp_dir, pp_home, pp_profile, command_callback) # instatiatate the screen driver - used only to access enable and hide click areas self.sr=ScreenDriver() # create a path stack and control path debugging if self.show_params['debug-path']=='yes': self.debug=True else: self.debug=False self.path = PathManager() self.allowed_links=('return','home','call','null','exit','goto','play','jump','repeat','pause','no-command','stop','pause-on','pause-off','mute','unmute','go') # init variables self.track_timeout_timer=None self.show_timeout_timer=None self.next_track_signal=False self.next_track_ref='' self.current_track_ref='' self.current_track_type='' self.req_next='' def play(self,end_callback,show_ready_callback,parent_kickback_signal,level,controls_list): """ starts the hyperlink show at start-track end_callback - function to be called when the show exits show_ready_callback - callback to get previous show and track level is 0 when the show is top level (run from [start] or from show control) parent_kickback_signal is not used passed to subshow by base class as parent_kickback_signal """ # need to instantiate the medialist here as in gapshow done in derived class self.medialist=MediaList('ordered') Show.base_play(self,end_callback,show_ready_callback, parent_kickback_signal,level,controls_list) #dummy as it gets passed down to subshow, however it isn't actuallly used. self.controls_list=[] self.mon.trace(self, self.show_params['show-ref']) # read show destinations self.first_track_ref=self.show_params['first-track-ref'] self.home_track_ref=self.show_params['home-track-ref'] self.timeout_track_ref=self.show_params['timeout-track-ref'] #parse the show and track timeouts reason,message,self.show_timeout=Show.calculate_duration(self,self.show_params['show-timeout']) if reason =='error': self.mon.err(self,'Show Timeout has bad time: '+self.show_params['show-timeout']) self.end('error','show timeout, bad time: '+self.show_params['show-timeout']) reason,message,self.track_timeout=Show.calculate_duration(self,self.show_params['track-timeout']) if reason=='error': self.mon.err(self,'Track Timeout has bad time: '+self.show_params['track-timeout']) self.end('error','track timeout, bad time: ' +self.show_params['track-timeout']) # and delete eggtimer if self.previous_shower is not None: self.previous_shower.delete_eggtimer() self.do_first_track() # exit received from another concurrent show via ShowManager def exit(self): self.stop_timers() Show.base_exit(self) # show timeout happened def show_timeout_stop(self): self.stop_timers() Show.base_show_timeout_stop(self) # kill or error def terminate(self): self.stop_timers() Show.base_terminate(self) # respond to inputs - call base_input_pressed to pass to subshow def handle_input_event(self,symbol): Show.base_handle_input_event(self,symbol) def handle_input_event_this_show(self,symbol): # does the symbol match a link, if so execute it # some link commands do a subset of the internal operations # find the first entry in links that matches the symbol and execute its operation found,link_op,link_arg=self.path.find_link(symbol,self.links) if found is True: # cancel the show timeout when playing another track if self.show_timeout_timer is not None: self.canvas.after_cancel(self.show_timeout_timer) self.show_timeout_timer=None if link_op == 'home': self.decode_home() self.stop_current_track() elif link_op == 'return': self.decode_return(link_arg) self.stop_current_track() elif link_op == 'call': self.decode_call(link_arg) self.stop_current_track() elif link_op == 'goto': self.decode_goto(link_arg) self.stop_current_track() elif link_op == 'jump': self.decode_jump(link_arg) self.stop_current_track() elif link_op == 'repeat': self.decode_repeat() self.stop_current_track() elif link_op == 'exit': self.exit() elif link_op == 'stop': self.do_stop() elif link_op in ('no-command','null'): return # in-track operations elif link_op in ('pause','pause-on','pause-off','mute','unmute','go'): if self.current_player is not None: self.current_player.input_pressed(link_op) elif link_op[0:4] == 'omx-' or link_op[0:6] == 'mplay-'or link_op[0:5] == 'uzbl-': if self.current_player is not None: self.current_player.input_pressed(link_op) else: self.mon.err(self,"unknown link command: "+ link_op) self.end('error',"unknown link command: " + link_op) def do_operation(self,operation): if operation == 'stop': self.do_stop() def do_stop(self): # print link_op,self.current_player,self.current_track_ref,self.level #quiescent in all tracks if self.level != 0: # lower level so exit to level above self.stop_timers() self.user_stop_signal=True if self.current_player is not None: self.current_player.input_pressed('stop') else: # at top do nothing pass # ********************* # INTERNAL FUNCTIONS # ******************** # ********************* # Show Sequencer # ********************* def track_timeout_callback(self): self.mon.trace(self, 'goto ' + self.timeout_track_ref) self.next_track_op='goto' self.next_track_arg=self.timeout_track_ref self.what_next_after_showing() def stop_current_track(self): if self.shower is not None: self.shower.do_operation('stop') elif self.current_player is not None: self.current_player.input_pressed('stop') else: self.what_next_after_showing() def decode_call(self,track_ref): if track_ref != self.current_track_ref: self.mon.log(self, 'call: '+track_ref) self.next_track_signal=True self.next_track_op='call' self.next_track_arg=track_ref def decode_goto(self,to): self.mon.log(self,'goto: '+to) self.next_track_signal=True self.next_track_op='goto' self.next_track_arg=to def decode_jump(self,to): self.mon.log(self,'jump to: '+to) self.next_track_signal=True self.next_track_op='jump' self.next_track_arg=to def decode_repeat(self): self.mon.log(self,'repeat: ') self.next_track_signal=True self.next_track_op='repeat' def decode_return(self,to): self.next_track_signal=True if to.isdigit() or to == '': self.mon.log(self,'hyperlink command - return by: '+to) self.next_track_op='return-by' if to == '': self.next_track_arg='1' else: self.next_track_arg=to else: self.mon.log(self,'hyperlink command - return to: '+to) self.next_track_op='return-to' self.next_track_arg=to def decode_home(self): self.mon.log(self,'hyperlink command - home') self.next_track_signal=True self.next_track_op='home' def do_first_track(self): index = self.medialist.index_of_track(self.first_track_ref) if index >=0: self.continue_timeout=False # don't use select the track as not using selected_track in hyperlinkshow first_track=self.medialist.track(index) self.current_track_ref=first_track['track-ref'] self.path.append(first_track['track-ref']) if self.debug: print 'First Track: ' + first_track['track-ref']+self.path.pretty_path() self.start_load_show_loop(first_track) else: self.mon.err(self,"first-track not found in medialist: "+ self.show_params['first-track-ref']) self.end('error',"first track not found in medialist: "+ self.show_params['first-track-ref']) def start_load_show_loop(self,selected_track): # shuffle players Show.base_shuffle(self) self.mon.trace(self, '') self.display_eggtimer() # start the show timer when displaying the first track if self.current_track_ref == self.first_track_ref: if self.show_timeout_timer is not None: self.canvas.after_cancel(self.show_timeout_timer) self.show_timeout_timer=None if self.show_timeout != 0: self.show_timeout_timer=self.canvas.after(self.show_timeout*1000 ,self.show_timeout_stop) # start timeout for the track if required ???? differnet to radiobuttonshow if self.continue_timeout is False: if self.track_timeout_timer is not None: self.canvas.after_cancel(self.track_timeout_timer) self.track_timeout_timer=None if self.current_track_ref != self.first_track_ref and self.track_timeout != 0: self.track_timeout_timer=self.canvas.after(self.track_timeout*1000,self.track_timeout_callback) # get control bindings for this show # needs to be done for each track as track can override the show controls # read the show links. Track links will be added by track_ready_callback if self.show_params['disable-controls'] == 'yes': self.links=[] else: reason,message,self.links=self.path.parse_links(self.show_params['links'],self.allowed_links) if reason == 'error': self.mon.err(self,message + " in show") self.end('error',message + " in show") # load the track or show # params - track,, track loaded callback, end eshoer callback,enable_menu Show.base_load_track_or_show(self,selected_track,self.what_next_after_load,self.end_shower,False) # track has loaded so show it. def what_next_after_load(self,status,message): self.mon.trace(self, ' - load complete with status: ' + status + ' message: ' + message) if self.current_player.play_state == 'load-failed': self.mon.err(self,'load failed') self.req_next='error' self.what_next_after_showing() else: if self.show_timeout_signal is True or self.terminate_signal is True or self.exit_signal is True or self.user_stop_signal is True: self.what_next_after_showing() else: self.mon.trace(self, ' - showing track') self.current_player.show(self.track_ready_callback,self.finished_showing,self.closed_after_showing) def finished_showing(self,reason,message): # showing has finished with 'pause at end'. Player is paused and track instance is alive for hiding the x_content # this will happen in track_ready_callback of next track or in end????? self.mon.trace(self, ' - pause at end') self.mon.log(self,"pause at end of showing track with reason: "+reason+ ' and message: '+ message) self.sr.hide_click_areas(self.links) if self.current_player.play_state == 'show-failed': self.req_next = 'error' else: self.req_next='finished-player' self.what_next_after_showing() def closed_after_showing(self,reason,message): # showing has finished with closing of player. Track instance is alive for hiding the x_content # this will happen in track_ready_callback of next track or in end????? self.mon.trace(self, ' - closed after showing') self.mon.log(self,"Closed after showing track with reason: "+reason+ ' and message: '+ message) self.sr.hide_click_areas(self.links) if self.current_player.play_state == 'show-failed': self.req_next = 'error' else: self.req_next='closed-player' self.what_next_after_showing() # subshow or child show has ended def end_shower(self,show_id,reason,message): self.mon.log(self,self.show_params['show-ref']+ ' '+ str(self.show_id)+ ': Returned from shower with ' + reason +' ' + message) self.sr.hide_click_areas(self.links) if reason == 'error': self.req_next='error' self.what_next_after_showing() else: Show.base_end_shower(self) self.next_track_signal=True self.next_track_op='return-by' self.next_track_arg='1' self.what_next_after_showing() def what_next_after_showing(self): self.mon.trace(self, '') # need to terminate if self.terminate_signal is True: self.terminate_signal=False # what to do when closed or unloaded self.ending_reason='killed' Show.base_close_or_unload(self) elif self.req_next== 'error': self.req_next='' # set what to do after closed or unloaded self.ending_reason='error' Show.base_close_or_unload(self) # show timeout elif self.show_timeout_signal is True: self.show_timeout_signal=False # what to do when closed or unloaded self.ending_reason='show-timeout' Show.base_close_or_unload(self) # used by exit for stopping show from other shows. elif self.exit_signal is True: self.exit_signal=False self.ending_reason='exit' Show.base_close_or_unload(self) # user wants to stop elif self.user_stop_signal is True: self.user_stop_signal=False self.ending_reason='user-stop' Show.base_close_or_unload(self) # user has selected another track elif self.next_track_signal is True: self.next_track_signal=False self.continue_timeout=False # home if self.next_track_op in ('home'): # back to 1 before home back_ref=self.path.back_to(self.home_track_ref) if back_ref == '': self.mon.err(self,"home - home track not in path: "+self.home_track_ref) self.end('error',"home - home track not in path: "+self.home_track_ref) # play home self.next_track_ref=self.home_track_ref self.path.append(self.next_track_ref) if self.debug: print 'Executed Home ' + self.path.pretty_path() # return-by elif self.next_track_op in ('return-by'): if self.current_track_ref != self.home_track_ref: # back n stopping at home # back one more and return it back_ref=self.path.back_by(self.home_track_ref,self.next_track_arg) # use returned track self.next_track_ref=back_ref self.path.append(self.next_track_ref) if self.debug: print 'Executed Return By' + self.next_track_arg + self.path.pretty_path() # repeat is return by 1 elif self.next_track_op in ('repeat'): # print 'current', self.current_track_ref # print 'home', self.home_track_ref self.path.pop_for_sibling() self.next_track_ref=self.current_track_ref self.path.append(self.current_track_ref) self.continue_timeout=True if self.debug: print 'Executed Repeat ' + self.path.pretty_path() # return-to elif self.next_track_op in ('return-to'): # back to one before return-to track back_ref=self.path.back_to(self.next_track_arg) if back_ref == '': self.mon.err(self,"return-to - track not in path: "+self.next_track_arg) self.end('error',"return-to - track not in path: "+self.next_track_arg) # and append the return to track self.next_track_ref=self.next_track_arg self.path.append(self.next_track_ref) if self.debug: print 'Executed Return To' + self.next_track_arg + self.path.pretty_path() # call elif self.next_track_op in ('call'): # append the required track self.path.append(self.next_track_arg) self.next_track_ref=self.next_track_arg if self.debug: print 'Executed Call ' + self.next_track_arg + self.path.pretty_path() # goto elif self.next_track_op in ('goto'): self.path.empty() # add the goto track self.next_track_ref=self.next_track_arg self.path.append(self.next_track_arg) if self.debug: print 'Executed Goto ' + self.next_track_arg + self.path.pretty_path() # jump elif self.next_track_op in ('jump'): # back to home and remove it back_ref=self.path.back_to(self.home_track_ref) if back_ref == '': self.mon.err(self,"jump - home track not in path: "+self.home_track_ref) self.end('error',"jump - track not in path: "+self.home_track_ref) # add back the home track without playing it self.path.append(self.home_track_ref) # append the jumped to track self.next_track_ref=self.next_track_arg self.path.append(self.next_track_ref) if self.debug: print 'Executed Jump ' + self.next_track_arg + self.path.pretty_path() else: self.mon.err(self,"unaddressed what next: "+ self.next_track_op+ ' '+self.next_track_arg) self.end('error',"unaddressed what next: " + self.next_track_op+ ' '+self.next_track_arg) self.current_track_ref=self.next_track_ref index = self.medialist.index_of_track(self.next_track_ref) if index >=0: Show.write_stats(self,self.next_track_op,self.show_params,self.medialist.track(index)) # don't use select the track as not using selected_track in hyperlinkshow self.start_load_show_loop(self.medialist.track(index)) else: self.mon.err(self,"next-track not found in medialist: "+ self.next_track_ref) self.end('error',"next track not found in medialist: "+ self.next_track_ref) else: # track ends naturally look to see if there is a pp-onend link found,link_op,link_arg=self.path.find_link('pp-onend',self.links) if found is True: if link_op=='exit': self.user_stop_signal=True self.current_player.input_pressed('stop') self.what_next_after_showing() elif link_op == 'home': self.decode_home() self.what_next_after_showing() elif link_op == 'return': self.decode_return(link_arg) self.what_next_after_showing() elif link_op == 'call': self.decode_call(link_arg) self.what_next_after_showing() elif link_op == 'goto': self.decode_goto(link_arg) self.what_next_after_showing() elif link_op == 'jump': self.decode_jump(link_arg) self.what_next_after_showing() elif link_op == 'repeat': self.decode_repeat() self.what_next_after_showing() else: self.mon.err(self,"unknown link command for pp_onend: "+ link_op) self.end('error',"unkown link command for pp-onend: "+ link_op) else: if self.show_params['disable-controls']!='yes': self.mon.err(self,"pp-onend for this track not found: "+ link_op) self.end('error',"pp-onend for this track not found: "+ link_op) ## else: ## # returning from subshow or a track that does not have pp-onend ## self.next_track_op='return-by' ## self,next_track_arg='1' ## print 'subshow finishes or no on-end' ## self.what_next_after_showing() def track_ready_callback(self,enable_show_background): # called from a Player when ready to play, merge the links from the track with those from the show # and then enable the click areas self.delete_eggtimer() if self.show_params['disable-controls'] == 'yes': track_links=[] else: links_text=self.current_player.get_links() reason,message,track_links=self.path.parse_links(links_text,self.allowed_links) if reason == 'error': self.mon.err(self,message + " in track: "+ self.current_player.track_params['track-ref']) self.req_next='error' self.what_next_after_showing() self.path.merge_links(self.links,track_links) # enable the click-area that are in the list of links self.sr.enable_click_areas(self.links) Show.base_track_ready_callback(self,enable_show_background) # callback from begining of a subshow, provide previous shower and player to called show def subshow_ready_callback(self): return Show.base_subshow_ready_callback(self) # ********************* # End the show # ********************* # finish the player for killing, error or normally # this may be called directly sub/child shows or players are not running # if they might be running then need to call terminate. def end(self,reason,message): self.mon.log(self,"Ending hyperlinkshow: "+ self.show_params['show-ref']) self.stop_timers() Show.base_end(self,reason,message) def stop_timers(self): pass
class HyperlinkShow: """ Aimed at touchscreens but can be used for any purpose where the user is required to follow hyperlinks between tracks Profiles for media tracks (message, image, video, audio ) specify links to other tracks In a link a symbolic name of an input is associated with a track-reference The show begins at a special track specified in the profiile called the First Track and moves to other tracks - when a link is executed by a input event with a specified symbolic name - at the natural end of the track using the special pp-onend symbolic name If using the 'call' link command PP keeps a record of the tracks it has visited so the 'return' command can go back. Executes timeout-track if no user input is received (includes pp-onend but not repeat) There is a another special track with Home Track. The home command returns here and the 'return n' command will not go back past here. This was designed to allow the timeout to go back to First Track which would advertise the show. Once the user had been enticed and clicked a link to move to Home pressing home or return would not return him to First Track You can make the Home Track and the First Track the same track if you want. You may want a track, if it is a video or audio track, to repeat. You can use repeat for this and it will not cancel the timeout. Image and message tracks can have a zero duration so they never end naturally so repeat is not required. links are of the form: symbolic-name command [track-ref] link commands: call <track-ref> play track-ref and add it to the path return - return 1 back up the path removing the track from the path, stops at home-track. return n - return n tracks back up the path removing the track from the path, stops at home-track. return <track-ref> return to <track-ref> removing tracks from the path home - return to home-track removing tracks from the path jump <track-ref-> - play track-ref forgetting the path back to home-track goto <track-ref> - play track-ref, forget the path repeat - repeat the track exit - end the hyperlink show null - inhibits the link defined in the show with the same symbolic name. reserved symbolic names pp-onend command - pseudo symbolic name for end of a track interface: * play - selects the first track to play (first-track) * input_pressed, - receives user events passes them to a Shower/Player if a track is playing, otherwise actions them depending on the symbolic name supplied """ # ********************* # external interface # ******************** def __init__(self, show_params, root, canvas, showlist, pp_dir, pp_home, pp_profile): """ canvas - the canvas that the tracks of the event show are to be written on show_params - the name of the configuration dictionary section for the hyperlinkshow showlist - the showlist, to enable runningnof show type tracks. pp_home - Pi presents data_home directory pp_profile - Pi presents profile directory """ self.mon = Monitor() self.mon.on() self.debug = False # remove # to enable debugging trace #self.debug=True #instantiate arguments self.show_params = show_params self.root = root self.showlist = showlist self.canvas = canvas self.pp_dir = pp_dir self.pp_home = pp_home self.pp_profile = pp_profile # open resources self.rr = ResourceReader() #create a path stack self.path = PathManager() # init variables self.drawn = None self.player = None self.shower = None self.timeout_running = None self.error = False def play(self, show_id, end_callback, ready_callback, top=False, command='nil'): """ starts the hyperlink show at start-track end_callback - function to be called when the show exits ready_callback - callback when event-show is ready to display its forst track (not used?) top is True when the show is top level (run from [start] or from show control) command is not used """ #instantiate arguments self.show_id = show_id self.end_callback = end_callback self.ready_callback = ready_callback self.top = top self.command = command # check data files are available. self.medialist_file = self.pp_profile + "/" + self.show_params[ 'medialist'] if not os.path.exists(self.medialist_file): self.mon.err(self, "Medialist file not found: " + self.medialist_file) self.end('error', "Medialist file not found") #create a medialist object for the hyperlinkshow and read the file into it. self.medialist = MediaList() if self.medialist.open_list(self.medialist_file, self.showlist.sissue()) == False: self.mon.err(self, "Version of medialist different to Pi Presents") self.end('error', "Version of medialist different to Pi Presents") #get controls for this show if top level controlsmanager = ControlsManager() if self.top == True: self.controls_list = controlsmanager.default_controls() # and merge in controls from profile self.controls_list = controlsmanager.merge_show_controls( self.controls_list, self.show_params['controls']) # read show links and destinations self.first_track_ref = self.show_params['first-track-ref'] self.home_track_ref = self.show_params['home-track-ref'] self.timeout_track_ref = self.show_params['timeout-track-ref'] # state variables and signals self.end_hyperlinkshow_signal = False self.egg_timer = None self.next_track_signal = False self.next_track_ref = '' self.current_track_ref = '' self.current_track_type = '' # ready callback for show if self.ready_callback <> None: self.ready_callback() self.canvas.delete('pp-content') self.canvas.config(bg='black') self.do_first_track() #stop received from another concurrent show via ShowManager def managed_stop(self): # set signal to stop the hyperlinkshow when all sub-shows and players have ended self.end_hyperlinkshow_signal = True # then stop and shows or tracks. if self.shower <> None: self.shower.managed_stop() elif self.player <> None: self.player.input_pressed('stop') else: self.end('normal', 'stopped by ShowManager') # kill or error def terminate(self, reason): self.end_hyperlinkshow_signal = True if self.shower <> None: self.shower.terminate(reason) elif self.player <> None: self.player.terminate(reason) else: self.end(reason, 'terminated without terminating shower or player') # respond to inputs def input_pressed(self, symbol, edge, source): self.mon.log(self, "received symbol: " + symbol) #does the symbol match a link, if so execute it if self.is_link(symbol, edge, source) == True: return # controls are disabled so ignore anything else if self.show_params['disable-controls'] == 'yes': return # does it match a control # if at top convert symbolic name to operation otherwise lower down we have received an operatio # look through list of controls to find match if self.top == True: operation = self.lookup_control(symbol, self.controls_list) else: operation = symbol # print 'operation',operation if operation <> '': self.do_operation(operation, edge, source) def do_operation(self, operation, edge, source): if self.shower <> None: # if next lower show is running pass down to stop the show and lower level self.shower.input_pressed(operation, edge, source) else: # control this show and its tracks if operation == 'stop': if self.player <> None: if self.current_track_ref == self.first_track_ref and self.top == False: self.end_radiobuttonshow_signal = True self.player.input_pressed('stop') elif operation == 'pause': if self.player <> None: self.player.input_pressed(operation) elif operation[0:4] == 'omx-' or operation[ 0:6] == 'mplay-' or operation[0:5] == 'uzbl-': if self.player <> None: self.player.input_pressed(operation) def is_link(self, symbol, edge, source): # find the first entry in links that matches the symbol and execute its operation # print 'hyperlinkshow ',symbol found = False for link in self.links: #print link if symbol == link[0]: found = True if link[1] <> 'null': # print 'match',link[0] link_operation = link[1] if link_operation == 'home': self.do_home(edge, source) elif link_operation == 'return': self.do_return(link[2], edge, source) elif link_operation == 'call': self.do_call(link[2], edge, source) elif link_operation == 'goto': self.do_goto(link[2], edge, source) elif link_operation == 'jump': self.do_jump(link[2], edge, source) elif link_operation == 'repeat': self.do_repeat(edge, source) elif link_operation == 'exit': self.end('normal', 'executed exit command') return found def lookup_control(self, symbol, controls_list): for control in controls_list: if symbol == control[0]: return control[1] return '' # ********************* # INTERNAL FUNCTIONS # ******************** # ********************* # Show Sequencer # ********************* def timeout_callback(self): if self.debug: print '\nTimeout Event - goto', self.timeout_track_ref self.do_goto(self.timeout_track_ref, 'front', 'timeout') def do_call(self, track_ref, edge, source): if track_ref <> self.current_track_ref: self.mon.log(self, 'call: ' + track_ref) self.next_track_signal = True self.next_track_op = 'call' self.next_track_arg = track_ref if self.shower <> None: self.shower.input_pressed('stop', edge, source) elif self.player <> None: self.player.input_pressed('stop') else: self.what_next() def do_goto(self, to, edge, source): #if to<>self.current_track_ref: self.mon.log(self, 'goto: ' + to) self.next_track_signal = True self.next_track_op = 'goto' self.next_track_arg = to if self.shower <> None: self.shower.input_pressed('stop', edge, source) elif self.player <> None: self.player.input_pressed('stop') else: self.what_next() def do_jump(self, to, edge, source): #if to<>self.current_track_ref: self.mon.log(self, 'jump to: ' + to) self.next_track_signal = True self.next_track_op = 'jump' self.next_track_arg = to if self.shower <> None: self.shower.input_pressed('stop', edge, source) elif self.player <> None: self.player.input_pressed('stop') else: self.what_next() def do_repeat(self, edge, source): self.mon.log(self, 'repeat: ') self.next_track_signal = True self.next_track_op = 'repeat' if self.shower <> None: self.shower.input_pressed('stop', edge, source) elif self.player <> None: self.player.input_pressed('stop') else: self.what_next() def do_return(self, to, edge, source): self.next_track_signal = True if to.isdigit() or to == '': self.mon.log(self, 'hyperlink command - return by: ' + to) self.next_track_op = 'return-by' if to == '': self.next_track_arg = '1' else: self.next_track_arg = to else: self.mon.log(self, 'hyperlink command - return to: ' + to) self.next_track_op = 'return-to' self.next_track_arg = to if self.shower <> None: self.shower.input_pressed('stop', edge, source) elif self.player <> None: self.player.input_pressed('stop') else: self.what_next() def do_home(self, edge, source): # if self.current_track_ref<>self.home_track_ref: self.mon.log(self, 'hyperlink command - home') self.next_track_signal = True self.next_track_op = 'home' if self.shower <> None: self.shower.input_pressed('stop', edge, source) elif self.player <> None: self.player.input_pressed('stop') else: self.what_next() def do_first_track(self): index = self.medialist.index_of_track(self.first_track_ref) if index >= 0: #don't use select the track as not using selected_track in hyperlinkshow first_track = self.medialist.track(index) self.current_track_ref = first_track['track-ref'] self.path.append(first_track['track-ref']) self.continue_timeout = False if self.debug: print '\nFirst Track', first_track['track-ref'] self.path.print_path() self.play_selected_track(first_track) else: self.mon.err( self, "first-track not found in medialist: " + self.show_params['first-track-ref']) self.end('error', "first track not found in medialist") def what_next(self): # user wants to end the show if self.end_hyperlinkshow_signal == True: self.end_hyperlinkshow_signal = False self.end('normal', "show ended by user") # user has selected another track elif self.next_track_signal == True: self.next_track_signal = False self.continue_timeout = False # home if self.next_track_op in ('home'): # back to 1 before home back_ref = self.path.back_to(self.home_track_ref) if back_ref == '': self.mon.err( self, "home - home track not in path: " + self.home_track_ref) self.end('error', "home - home track not in path") # play home self.next_track_ref = self.home_track_ref self.path.append(self.next_track_ref) if self.debug: print '\nExecuted Home' self.path.print_path() # return-by elif self.next_track_op in ('return-by'): if self.current_track_ref <> self.home_track_ref: # back n stopping at home # back one more and return it back_ref = self.path.back_by(self.home_track_ref, self.next_track_arg) # use returned track self.next_track_ref = back_ref self.path.append(self.next_track_ref) if self.debug: print '\nExecuted Return', self.next_track_arg self.path.print_path() # repeat is return by 1 elif self.next_track_op in ('repeat'): #print 'current', self.current_track_ref #print 'home', self.home_track_ref #if self.current_track_ref<>self.home_track_ref: self.path.pop_for_sibling() self.next_track_ref = self.current_track_ref self.path.append(self.current_track_ref) self.continue_timeout = True if self.debug: print '\nExecuted Repeat' self.path.print_path() # return-to elif self.next_track_op in ('return-to'): #back to one before return-to track back_ref = self.path.back_to(self.next_track_arg) if back_ref == '': self.mon.err( self, "return-to - track not in path: " + self.next_track_arg) self.end('error', "return-to - track not in path") # and append the return to track self.next_track_ref = self.next_track_arg self.path.append(self.next_track_ref) if self.debug: print '\nExecuted Return', self.next_track_arg self.path.print_path() # call elif self.next_track_op in ('call'): # append the required track self.path.append(self.next_track_arg) self.next_track_ref = self.next_track_arg if self.debug: print '\nExecuted Call', self.next_track_arg self.path.print_path() # goto elif self.next_track_op in ('goto'): self.path.empty() #add the goto track self.next_track_ref = self.next_track_arg self.path.append(self.next_track_arg) if self.debug: print '\nExecuted Goto', self.next_track_arg self.path.print_path() # jump elif self.next_track_op in ('jump'): # back to home and remove it back_ref = self.path.back_to(self.home_track_ref) if back_ref == '': self.mon.err( self, "jump - home track not in path: " + self.home_track_ref) self.end('error', "jump - track not in path") # add back the home track without playing it self.path.append(self.home_track_ref) # append the jumped to track self.next_track_ref = self.next_track_arg self.path.append(self.next_track_ref) if self.debug: print '\nExecuted Jump', self.next_track_arg self.path.print_path() else: self.mon.err( self, "unaddressed what next: " + self.next_track_op + ' ' + self.next_track_arg) self.end('error', "unaddressed what next") self.current_track_ref = self.next_track_ref index = self.medialist.index_of_track(self.next_track_ref) if index >= 0: #don't use select the track as not using selected_track in hyperlinkshow next_track = self.medialist.track(index) self.play_selected_track(next_track) else: self.mon.err( self, "next-track not found in medialist: " + self.next_track_ref) self.end('error', "next track not found in medialist") else: #track ends naturally #then input pp-onend symbolic name if self.debug: print '\nCreated pp-onend event' self.input_pressed('pp-onend', 'front', 'key') # ********************* # Dispatching to Players # ********************* def page_callback(self): # called from a Player when ready to play, merge the links from the track with those from the show # and then enable the click areas self.delete_eggtimer() links_text = self.player.get_links() reason, message, track_links = self.path.parse_links(links_text) if reason == 'error': self.mon.err(self, message + " in page") self.end('error', message) self.path.merge_links(self.links, track_links) # enable the click-area that are in the list of links self.enable_click_areas() def enable_click_areas(self): for link in self.links: #print 'trying link ',link[0] if not ('key-' in link[0]) and link[1] <> 'null' and link[0] <> 'pp-auto': # print 'enabling link ',link[0] self.canvas.itemconfig(link[0], state='normal') def play_selected_track(self, selected_track): """ selects the appropriate player from type field of the medialist and computes the parameters for that type selected track is a dictionary for the track/show """ if self.timeout_running <> None and self.continue_timeout == False: self.canvas.after_cancel(self.timeout_running) self.timeout_running = None # self.canvas.delete(ALL) self.display_eggtimer(self.resource('hyperlinkshow', 'm01')) self.current_track_type = selected_track['type'] #read the show links. Track links will be added by ready_callback links_text = self.show_params['links'] reason, message, self.links = self.path.parse_links(links_text) if reason == 'error': self.mon.err(self, message + " in show") self.end('error', message) #start timeout for the track if required if self.continue_timeout == False and self.current_track_ref <> self.first_track_ref and int( self.show_params['timeout']) <> 0: self.timeout_running = self.canvas.after( int(self.show_params['timeout']) * 1000, self.timeout_callback) # dispatch track by type self.player = None self.shower = None track_type = selected_track['type'] self.mon.log(self, "Track type is: " + track_type) if track_type == "video": # create a videoplayer track_file = self.complete_path(selected_track) self.player = VideoPlayer(self.show_id, self.root, self.canvas, self.show_params, selected_track, self.pp_dir, self.pp_home, self.pp_profile) self.player.play(track_file, self.showlist, self.end_player, self.page_callback, enable_menu=False) elif track_type == "audio": # create a audioplayer track_file = self.complete_path(selected_track) self.player = AudioPlayer(self.show_id, self.root, self.canvas, self.show_params, selected_track, self.pp_dir, self.pp_home, self.pp_profile) self.player.play(track_file, self.showlist, self.end_player, self.page_callback, enable_menu=False) elif track_type == "image": track_file = self.complete_path(selected_track) self.player = ImagePlayer(self.show_id, self.root, self.canvas, self.show_params, selected_track, self.pp_dir, self.pp_home, self.pp_profile) self.player.play( track_file, self.showlist, self.end_player, self.page_callback, enable_menu=False, ) elif track_type == "web": # create a browser track_file = self.complete_path(selected_track) self.player = BrowserPlayer(self.show_id, self.root, self.canvas, self.show_params, selected_track, self.pp_dir, self.pp_home, self.pp_profile) self.player.play(track_file, self.showlist, self.end_player, self.page_callback, enable_menu=False) elif track_type == "message": # bit odd because MessagePlayer is used internally to display text. text = selected_track['text'] self.player = MessagePlayer(self.show_id, self.root, self.canvas, self.show_params, selected_track, self.pp_dir, self.pp_home, self.pp_profile) self.player.play(text, self.showlist, self.end_player, self.page_callback, enable_menu=False) elif track_type == "show": self.enable_click_areas() # get the show from the showlist index = self.showlist.index_of_show(selected_track['sub-show']) if index >= 0: self.showlist.select(index) selected_show = self.showlist.selected_show() else: self.mon.err( self, "Show not found in showlist: " + selected_track['sub-show']) self.end("Unknown show") if selected_show['type'] == "mediashow": self.shower = MediaShow(selected_show, self.root, self.canvas, self.showlist, self.pp_dir, self.pp_home, self.pp_profile) self.shower.play(self.show_id, self.end_shower, self.ready_callback, top=False, command='nil') elif selected_show['type'] == "liveshow": self.shower = LiveShow(selected_show, self.root, self.canvas, self.showlist, self.pp_dir, self.pp_home, self.pp_profile) self.shower.play(self.show_id, self.end_shower, self.ready_callback, top=False, command='nil') elif selected_show['type'] == "radiobuttonshow": self.shower = RadioButtonShow(selected_show, self.root, self.canvas, self.showlist, self.pp_dir, self.pp_home, self.pp_profile) self.shower.play(self.show_id, self.end_shower, self.ready_callback, top=False, command='nil') elif selected_show['type'] == "hyperlinkshow": self.shower = HyperlinkShow(selected_show, self.root, self.canvas, self.showlist, self, pp_dir, self.pp_home, self.pp_profile) self.shower.play(self.show_id, self.end_shower, self.ready_callback, top=False, command='nil') elif selected_show['type'] == "menu": self.shower = MenuShow(selected_show, self.root, self.canvas, self.showlist, self.pp_dir, self.pp_home, self.pp_profile) self.shower.play(self.show_id, self.end_shower, self.ready_callback, top=False, command='nil') else: self.mon.err(self, "Unknown Show Type: " + selected_show['type']) self.end("Unknown show type") else: self.mon.err(self, "Unknown Track Type: " + track_type) self.end("Unknown track type") # callback from when player ends def end_player(self, reason, message): self.mon.log(self, "Returned from player with message: " + message) self.player = None # this does not seem to change the colour of the polygon self.canvas.itemconfig('pp-click-area', state='hidden') self.canvas.update_idletasks() if reason in ("killed", "error"): self.end(reason, message) else: self.display_eggtimer(self.resource('hyperlinkshow', 'm02')) self.what_next() # callback from when shower ends def end_shower(self, show_id, reason, message): self.mon.log(self, "Returned from shower with message: " + message) self.shower = None self.canvas.itemconfig('pp-click-area', state='hidden') self.canvas.update_idletasks() if reason in ("killed", "error"): self.end(reason, message) else: self.display_eggtimer(self.resource('hyperlinkshow', 'm03')) self.what_next() # ********************* # End the show # ********************* # finish the player for killing, error or normally # this may be called directly sub/child shows or players are not running # if they might be running then need to call terminate. def end(self, reason, message): self.mon.log(self, "Ending hyperlinkshow: " + self.show_params['show-ref']) self.end_callback(self.show_id, reason, message) self = None return # ********************* # displaying things # ********************* def display_eggtimer(self, text): #self.egg_timer=self.canvas.create_text(int(self.canvas['width'])/2, #int(self.canvas['height'])/2, #text= text, # fill='white', # font="Helvetica 20 bold") #self.canvas.update_idletasks( ) pass def delete_eggtimer(self): if self.egg_timer != None: self.canvas.delete(self.egg_timer) # ********************* # utilities # ********************* def complete_path(self, selected_track): # complete path of the filename of the selected entry track_file = selected_track['location'] if track_file <> '' and track_file[0] == "+": track_file = self.pp_home + track_file[1:] self.mon.log(self, "Track to play is: " + track_file) return track_file def resource(self, section, item): value = self.rr.get(section, item) if value == False: self.mon.err(self, "resource: " + section + ': ' + item + " not found") # players or showers may be running so need terminate self.terminate("error") else: return value
class HyperlinkShow(Show): """ Aimed at touchscreens but can be used for any purpose where the user is required to follow hyperlinks between tracks Profiles for media tracks (message, image, video, audio ) specify links to other tracks In a link a symbolic name of an input is associated with a track-reference The show begins at a special track specified in the profiile called the First Track and moves to other tracks - when a link is executed by a input event with a specified symbolic name - at the natural end of the track using the special pp-onend symbolic name If using the 'call' link command PP keeps a record of the tracks it has visited so the 'return' command can go back. Executes timeout-track if no user input is received (includes pp-onend but not repeat) There is a another special track with Home Track. The home command returns here and the 'return n' command will not go back past here. This was designed to allow the timeout to go back to First Track which would advertise the show. Once the user had been enticed and clicked a link to move to Home pressing home or return would not return him to First Track You can make the Home Track and the First Track the same track if you want. You may want a track, if it is a video or audio track, to repeat. You can use repeat for this and it will not cancel the timeout. Image and message tracks can have a zero duration so they never end naturally so repeat is not required. links are of the form: symbolic-name command [track-ref] link commands: call <track-ref> play track-ref and add it to the path return - return 1 back up the path removing the track from the path, stops at home-track. return n - return n tracks back up the path removing the track from the path, stops at home-track. return <track-ref> return to <track-ref> removing tracks from the path home - return to home-track removing tracks from the path jump <track-ref-> - play track-ref forgetting the path back to home-track goto <track-ref> - play track-ref, forget the path repeat - repeat the track exit - end the hyperlink show null - inhibits the link defined in the show with the same symbolic name. reserved symbolic names pp-onend command - pseudo symbolic name for end of a track interface: * __init__ - initlialises the show * play - selects the first track to play (first-track) * input_pressed, - receives user events passes them to a Shower/Player if a track is playing, otherwise actions them depending on the symbolic name supplied * exit - stops the show from another show * terminate - aborts the show, used whan clsing or after errors * track_ready_callback - called by the next track to be played to remove the previous track from display * subshow_ready_callback - called by the subshow to get the last track of the parent show * subshow_ended_callback - called at the start of a parent show to get the last track of the subshow """ # ********************* # external interface # ******************** def __init__(self, show_id, show_params, root, canvas, showlist, pp_dir, pp_home, pp_profile, command_callback): """ show_id - index of the top level show caling this (for debug only) show_params - dictionary section for the menu canvas - the canvas that the menu is to be written on showlist - the showlist pp_dir - Pi Presents directory pp_home - Pi presents data_home directory pp_profile - Pi presents profile directory """ # init the common bits Show.base__init__(self, show_id, show_params, root, canvas, showlist, pp_dir, pp_home, pp_profile, command_callback) # instatiatate the screen driver - used only to access enable and hide click areas self.sr = ScreenDriver() # create a path stack and control path debugging if self.show_params['debug-path'] == 'yes': self.debug = True else: self.debug = False self.path = PathManager() self.allowed_links = ('return', 'home', 'call', 'null', 'exit', 'goto', 'play', 'jump', 'repeat', 'pause', 'no-command', 'stop') # init variables self.track_timeout_timer = None self.show_timeout_timer = None self.next_track_signal = False self.next_track_ref = '' self.current_track_ref = '' self.current_track_type = '' self.req_next = '' def play(self, end_callback, show_ready_callback, parent_kickback_signal, level, controls_list): """ starts the hyperlink show at start-track end_callback - function to be called when the show exits show_ready_callback - callback to get previous show and track level is 0 when the show is top level (run from [start] or from show control) parent_kickback_signal is not used passed to subshow by base class as parent_kickback_signal """ # need to instantiate the medialist here as in gapshow done in derived class self.medialist = MediaList('ordered') Show.base_play(self, end_callback, show_ready_callback, parent_kickback_signal, level, controls_list) #dummy as it gets passed down to subshow, however it isn't actuallly used. self.controls_list = [] self.mon.trace(self, self.show_params['show-ref']) # read show destinations self.first_track_ref = self.show_params['first-track-ref'] self.home_track_ref = self.show_params['home-track-ref'] self.timeout_track_ref = self.show_params['timeout-track-ref'] #parse the show and track timeouts reason, message, self.show_timeout = Show.calculate_duration( self, self.show_params['show-timeout']) if reason == 'error': self.mon.err( self, 'Show Timeout has bad time: ' + self.show_params['show-timeout']) self.end( 'error', 'show timeout, bad time: ' + self.show_params['show-timeout']) reason, message, self.track_timeout = Show.calculate_duration( self, self.show_params['track-timeout']) if reason == 'error': self.mon.err( self, 'Track Timeout has bad time: ' + self.show_params['track-timeout']) self.end( 'error', 'track timeout, bad time: ' + self.show_params['track-timeout']) # and delete eggtimer if self.previous_shower is not None: self.previous_shower.delete_eggtimer() self.do_first_track() # exit received from another concurrent show via ShowManager def exit(self): self.stop_timers() Show.base_exit(self) # show timeout happened def show_timeout_stop(self): self.stop_timers() Show.base_show_timeout_stop(self) # kill or error def terminate(self): self.stop_timers() Show.base_terminate(self) # respond to inputs - call base_input_pressed to pass to subshow def handle_input_event(self, symbol): Show.base_handle_input_event(self, symbol) def handle_input_event_this_show(self, symbol): # does the symbol match a link, if so execute it # some link commands do a subset of the internal operations # find the first entry in links that matches the symbol and execute its operation found, link_op, link_arg = self.path.find_link(symbol, self.links) if found is True: # cancel the show timeout when playing another track if self.show_timeout_timer is not None: self.canvas.after_cancel(self.show_timeout_timer) self.show_timeout_timer = None if link_op == 'home': self.decode_home() self.stop_current_track() elif link_op == 'return': self.decode_return(link_arg) self.stop_current_track() elif link_op == 'call': self.decode_call(link_arg) self.stop_current_track() elif link_op == 'goto': self.decode_goto(link_arg) self.stop_current_track() elif link_op == 'jump': self.decode_jump(link_arg) self.stop_current_track() elif link_op == 'repeat': self.decode_repeat() self.stop_current_track() elif link_op == 'exit': self.exit() elif link_op == 'stop': self.do_stop() elif link_op in ('no-command', 'null'): return # in-track operations elif link_op == 'pause': if self.current_player is not None: self.current_player.input_pressed(link_op) elif link_op[0:4] == 'omx-' or link_op[0:6] == 'mplay-' or link_op[ 0:5] == 'uzbl-': if self.current_player is not None: self.current_player.input_pressed(link_op) else: self.mon.err(self, "unknown link command: " + link_op) self.end('error', "unknown link command: " + link_op) def do_operation(self, operation): if operation == 'stop': self.do_stop() def do_stop(self): # print link_op,self.current_player,self.current_track_ref,self.level #quiescent in all tracks if self.level != 0: # lower level so exit to level above self.stop_timers() self.user_stop_signal = True if self.current_player is not None: self.current_player.input_pressed('stop') else: # at top do nothing pass # ********************* # INTERNAL FUNCTIONS # ******************** # ********************* # Show Sequencer # ********************* def track_timeout_callback(self): self.mon.trace(self, 'goto ' + self.timeout_track_ref) self.next_track_op = 'goto' self.next_track_arg = self.timeout_track_ref self.what_next_after_showing() def stop_current_track(self): if self.shower is not None: self.shower.do_operation('stop') elif self.current_player is not None: self.current_player.input_pressed('stop') else: self.what_next_after_showing() def decode_call(self, track_ref): if track_ref != self.current_track_ref: self.mon.log(self, 'call: ' + track_ref) self.next_track_signal = True self.next_track_op = 'call' self.next_track_arg = track_ref def decode_goto(self, to): self.mon.log(self, 'goto: ' + to) self.next_track_signal = True self.next_track_op = 'goto' self.next_track_arg = to def decode_jump(self, to): self.mon.log(self, 'jump to: ' + to) self.next_track_signal = True self.next_track_op = 'jump' self.next_track_arg = to def decode_repeat(self): self.mon.log(self, 'repeat: ') self.next_track_signal = True self.next_track_op = 'repeat' def decode_return(self, to): self.next_track_signal = True if to.isdigit() or to == '': self.mon.log(self, 'hyperlink command - return by: ' + to) self.next_track_op = 'return-by' if to == '': self.next_track_arg = '1' else: self.next_track_arg = to else: self.mon.log(self, 'hyperlink command - return to: ' + to) self.next_track_op = 'return-to' self.next_track_arg = to def decode_home(self): self.mon.log(self, 'hyperlink command - home') self.next_track_signal = True self.next_track_op = 'home' def do_first_track(self): index = self.medialist.index_of_track(self.first_track_ref) if index >= 0: self.continue_timeout = False # don't use select the track as not using selected_track in hyperlinkshow first_track = self.medialist.track(index) self.current_track_ref = first_track['track-ref'] self.path.append(first_track['track-ref']) if self.debug: print 'First Track: ' + first_track[ 'track-ref'] + self.path.pretty_path() self.start_load_show_loop(first_track) else: self.mon.err( self, "first-track not found in medialist: " + self.show_params['first-track-ref']) self.end( 'error', "first track not found in medialist: " + self.show_params['first-track-ref']) def start_load_show_loop(self, selected_track): # shuffle players Show.base_shuffle(self) self.mon.trace(self, '') self.display_eggtimer() # start the show timer when displaying the first track if self.current_track_ref == self.first_track_ref: if self.show_timeout_timer is not None: self.canvas.after_cancel(self.show_timeout_timer) self.show_timeout_timer = None if self.show_timeout != 0: self.show_timeout_timer = self.canvas.after( self.show_timeout * 1000, self.show_timeout_stop) # start timeout for the track if required ???? differnet to radiobuttonshow if self.continue_timeout is False: if self.track_timeout_timer is not None: self.canvas.after_cancel(self.track_timeout_timer) self.track_timeout_timer = None if self.current_track_ref != self.first_track_ref and self.track_timeout != 0: self.track_timeout_timer = self.canvas.after( self.track_timeout * 1000, self.track_timeout_callback) # get control bindings for this show # needs to be done for each track as track can override the show controls # read the show links. Track links will be added by track_ready_callback if self.show_params['disable-controls'] == 'yes': self.links = [] else: reason, message, self.links = self.path.parse_links( self.show_params['links'], self.allowed_links) if reason == 'error': self.mon.err(self, message + " in show") self.end('error', message + " in show") # load the track or show # params - track,, track loaded callback, end eshoer callback,enable_menu Show.base_load_track_or_show(self, selected_track, self.what_next_after_load, self.end_shower, False) # track has loaded so show it. def what_next_after_load(self, status, message): self.mon.trace( self, ' - load complete with status: ' + status + ' message: ' + message) if self.current_player.play_state == 'load-failed': self.mon.err(self, 'load failed') self.req_next = 'error' self.what_next_after_showing() else: if self.show_timeout_signal is True or self.terminate_signal is True or self.exit_signal is True or self.user_stop_signal is True: self.what_next_after_showing() else: self.mon.trace(self, ' - showing track') self.current_player.show(self.track_ready_callback, self.finished_showing, self.closed_after_showing) def finished_showing(self, reason, message): # showing has finished with 'pause at end'. Player is paused and track instance is alive for hiding the x_content # this will happen in track_ready_callback of next track or in end????? self.mon.trace(self, ' - pause at end') self.mon.log( self, "pause at end of showing track with reason: " + reason + ' and message: ' + message) self.sr.hide_click_areas(self.links) if self.current_player.play_state == 'show-failed': self.req_next = 'error' else: self.req_next = 'finished-player' self.what_next_after_showing() def closed_after_showing(self, reason, message): # showing has finished with closing of player. Track instance is alive for hiding the x_content # this will happen in track_ready_callback of next track or in end????? self.mon.trace(self, ' - closed after showing') self.mon.log( self, "Closed after showing track with reason: " + reason + ' and message: ' + message) self.sr.hide_click_areas(self.links) if self.current_player.play_state == 'show-failed': self.req_next = 'error' else: self.req_next = 'closed-player' self.what_next_after_showing() # subshow or child show has ended def end_shower(self, show_id, reason, message): self.mon.log( self, self.show_params['show-ref'] + ' ' + str(self.show_id) + ': Returned from shower with ' + reason + ' ' + message) self.sr.hide_click_areas(self.links) if reason == 'error': self.req_next = 'error' self.what_next_after_showing() else: Show.base_end_shower(self) self.next_track_signal = True self.next_track_op = 'return-by' self.next_track_arg = '1' self.what_next_after_showing() def what_next_after_showing(self): self.mon.trace(self, '') # need to terminate if self.terminate_signal is True: self.terminate_signal = False # what to do when closed or unloaded self.ending_reason = 'killed' Show.base_close_or_unload(self) elif self.req_next == 'error': self.req_next = '' # set what to do after closed or unloaded self.ending_reason = 'error' Show.base_close_or_unload(self) # show timeout elif self.show_timeout_signal is True: self.show_timeout_signal = False # what to do when closed or unloaded self.ending_reason = 'show-timeout' Show.base_close_or_unload(self) # used by exit for stopping show from other shows. elif self.exit_signal is True: self.exit_signal = False self.ending_reason = 'exit' Show.base_close_or_unload(self) # user wants to stop elif self.user_stop_signal is True: self.user_stop_signal = False self.ending_reason = 'user-stop' Show.base_close_or_unload(self) # user has selected another track elif self.next_track_signal is True: self.next_track_signal = False self.continue_timeout = False # home if self.next_track_op in ('home'): # back to 1 before home back_ref = self.path.back_to(self.home_track_ref) if back_ref == '': self.mon.err( self, "home - home track not in path: " + self.home_track_ref) self.end( 'error', "home - home track not in path: " + self.home_track_ref) # play home self.next_track_ref = self.home_track_ref self.path.append(self.next_track_ref) if self.debug: print 'Executed Home ' + self.path.pretty_path() # return-by elif self.next_track_op in ('return-by'): if self.current_track_ref != self.home_track_ref: # back n stopping at home # back one more and return it back_ref = self.path.back_by(self.home_track_ref, self.next_track_arg) # use returned track self.next_track_ref = back_ref self.path.append(self.next_track_ref) if self.debug: print 'Executed Return By' + self.next_track_arg + self.path.pretty_path( ) # repeat is return by 1 elif self.next_track_op in ('repeat'): # print 'current', self.current_track_ref # print 'home', self.home_track_ref self.path.pop_for_sibling() self.next_track_ref = self.current_track_ref self.path.append(self.current_track_ref) self.continue_timeout = True if self.debug: print 'Executed Repeat ' + self.path.pretty_path() # return-to elif self.next_track_op in ('return-to'): # back to one before return-to track back_ref = self.path.back_to(self.next_track_arg) if back_ref == '': self.mon.err( self, "return-to - track not in path: " + self.next_track_arg) self.end( 'error', "return-to - track not in path: " + self.next_track_arg) # and append the return to track self.next_track_ref = self.next_track_arg self.path.append(self.next_track_ref) if self.debug: print 'Executed Return To' + self.next_track_arg + self.path.pretty_path( ) # call elif self.next_track_op in ('call'): # append the required track self.path.append(self.next_track_arg) self.next_track_ref = self.next_track_arg if self.debug: print 'Executed Call ' + self.next_track_arg + self.path.pretty_path( ) # goto elif self.next_track_op in ('goto'): self.path.empty() # add the goto track self.next_track_ref = self.next_track_arg self.path.append(self.next_track_arg) if self.debug: print 'Executed Goto ' + self.next_track_arg + self.path.pretty_path( ) # jump elif self.next_track_op in ('jump'): # back to home and remove it back_ref = self.path.back_to(self.home_track_ref) if back_ref == '': self.mon.err( self, "jump - home track not in path: " + self.home_track_ref) self.end( 'error', "jump - track not in path: " + self.home_track_ref) # add back the home track without playing it self.path.append(self.home_track_ref) # append the jumped to track self.next_track_ref = self.next_track_arg self.path.append(self.next_track_ref) if self.debug: print 'Executed Jump ' + self.next_track_arg + self.path.pretty_path( ) else: self.mon.err( self, "unaddressed what next: " + self.next_track_op + ' ' + self.next_track_arg) self.end( 'error', "unaddressed what next: " + self.next_track_op + ' ' + self.next_track_arg) self.current_track_ref = self.next_track_ref index = self.medialist.index_of_track(self.next_track_ref) if index >= 0: Show.write_stats(self, self.next_track_op, self.show_params, self.medialist.track(index)) # don't use select the track as not using selected_track in hyperlinkshow self.start_load_show_loop(self.medialist.track(index)) else: self.mon.err( self, "next-track not found in medialist: " + self.next_track_ref) self.end( 'error', "next track not found in medialist: " + self.next_track_ref) else: # track ends naturally look to see if there is a pp-onend link found, link_op, link_arg = self.path.find_link( 'pp-onend', self.links) if found is True: if link_op == 'exit': self.user_stop_signal = True self.current_player.input_pressed('stop') self.what_next_after_showing() elif link_op == 'home': self.decode_home() self.what_next_after_showing() elif link_op == 'return': self.decode_return(link_arg) self.what_next_after_showing() elif link_op == 'call': self.decode_call(link_arg) self.what_next_after_showing() elif link_op == 'goto': self.decode_goto(link_arg) self.what_next_after_showing() elif link_op == 'jump': self.decode_jump(link_arg) self.what_next_after_showing() elif link_op == 'repeat': self.decode_repeat() self.what_next_after_showing() else: self.mon.err( self, "unknown link command for pp_onend: " + link_op) self.end('error', "unkown link command for pp-onend: " + link_op) else: if self.show_params['disable-controls'] != 'yes': self.mon.err( self, "pp-onend for this track not found: " + link_op) self.end('error', "pp-onend for this track not found: " + link_op) ## else: ## # returning from subshow or a track that does not have pp-onend ## self.next_track_op='return-by' ## self,next_track_arg='1' ## print 'subshow finishes or no on-end' ## self.what_next_after_showing() def track_ready_callback(self, enable_show_background): # called from a Player when ready to play, merge the links from the track with those from the show # and then enable the click areas self.delete_eggtimer() if self.show_params['disable-controls'] == 'yes': track_links = [] else: links_text = self.current_player.get_links() reason, message, track_links = self.path.parse_links( links_text, self.allowed_links) if reason == 'error': self.mon.err( self, message + " in track: " + self.current_player.track_params['track-ref']) self.req_next = 'error' self.what_next_after_showing() self.path.merge_links(self.links, track_links) # enable the click-area that are in the list of links self.sr.enable_click_areas(self.links) Show.base_track_ready_callback(self, enable_show_background) # callback from begining of a subshow, provide previous shower and player to called show def subshow_ready_callback(self): return Show.base_subshow_ready_callback(self) # ********************* # End the show # ********************* # finish the player for killing, error or normally # this may be called directly sub/child shows or players are not running # if they might be running then need to call terminate. def end(self, reason, message): self.mon.log(self, "Ending hyperlinkshow: " + self.show_params['show-ref']) self.stop_timers() Show.base_end(self, reason, message) def stop_timers(self): pass
class HyperlinkShow: """ Aimed at touchscreens but can be used for any purpose where the user is required to follow hyperlinks between tracks Profiles for media tracks (message, image, video, audio ) specify links to other tracks In a link a symbolic name of an input is associated with a track-reference The show begins at a special track specified in the profiile called the First Track and moves to other tracks - when a link is executed by a input event with a specified symbolic name - at the natural end of the track using the special pp-onend symbolic name If using the 'call' link command PP keeps a record of the tracks it has visited so the 'return' command can go back. Executes timeout-track if no user input is received (includes pp-onend but not repeat) There is a another special track with Home Track. The home command returns here and the 'return n' command will not go back past here. This was designed to allow the timeout to go back to First Track which would advertise the show. Once the user had been enticed and clicked a link to move to Home pressing home or return would not return him to First Track You can make the Home Track and the First Track the same track if you want. You may want a track, if it is a video or audio track, to repeat. You can use repeat for this and it will not cancel the timeout. Image and message tracks can have a zero duration so they never end naturally so repeat is not required. links are of the form: symbolic-name command [track-ref] link commands: call <track-ref> play track-ref and add it to the path return - return 1 back up the path removing the track from the path, stops at home-track. return n - return n tracks back up the path removing the track from the path, stops at home-track. return <track-ref> return to <track-ref> removing tracks from the path home - return to home-track removing tracks from the path jump <track-ref-> - play track-ref forgetting the path back to home-track goto <track-ref> - play track-ref, forget the path repeat - repeat the track exit - end the hyperlink show null - inhibits the link defined in the show with the same symbolic name. reserved symbolic names pp-onend command - pseudo symbolic name for end of a track interface: * play - selects the first track to play (first-track) * input_pressed, - receives user events passes them to a Shower/Player if a track is playing, otherwise actions them depending on the symbolic name supplied """ # ********************* # external interface # ******************** def __init__(self, show_params, root, canvas, showlist, pp_dir, pp_home, pp_profile): """ canvas - the canvas that the tracks of the event show are to be written on show_params - the name of the configuration dictionary section for the hyperlinkshow showlist - the showlist, to enable runningnof show type tracks. pp_home - Pi presents data_home directory pp_profile - Pi presents profile directory """ self.mon=Monitor() self.mon.on() self.debug=False # remove # to enable debugging trace #self.debug=True #instantiate arguments self.show_params=show_params self.root=root self.showlist=showlist self.canvas=canvas self.pp_dir=pp_dir self.pp_home=pp_home self.pp_profile=pp_profile # open resources self.rr=ResourceReader() #create a path stack self.path = PathManager() # init variables self.drawn = None self.player=None self.shower=None self.timeout_running=None self.error=False def play(self,show_id,end_callback,ready_callback,top=False,command='nil'): """ starts the hyperlink show at start-track end_callback - function to be called when the show exits ready_callback - callback when event-show is ready to display its forst track (not used?) top is True when the show is top level (run from [start] or from show control) command is not used """ #instantiate arguments self.show_id=show_id self.end_callback=end_callback self.ready_callback=ready_callback self.top=top self.command=command # check data files are available. self.medialist_file = self.pp_profile + "/" + self.show_params['medialist'] if not os.path.exists(self.medialist_file): self.mon.err(self,"Medialist file not found: "+ self.medialist_file) self.end('error',"Medialist file not found") #create a medialist object for the hyperlinkshow and read the file into it. self.medialist=MediaList() if self.medialist.open_list(self.medialist_file,self.showlist.sissue()) == False: self.mon.err(self,"Version of medialist different to Pi Presents") self.end('error',"Version of medialist different to Pi Presents") #get controls for this show if top level controlsmanager=ControlsManager() if self.top==True: self.controls_list=controlsmanager.default_controls() # and merge in controls from profile self.controls_list=controlsmanager.merge_show_controls(self.controls_list,self.show_params['controls']) # read show links and destinations self.first_track_ref=self.show_params['first-track-ref'] self.home_track_ref=self.show_params['home-track-ref'] self.timeout_track_ref=self.show_params['timeout-track-ref'] # state variables and signals self.end_hyperlinkshow_signal= False self.egg_timer=None self.next_track_signal=False self.next_track_ref='' self.current_track_ref='' self.current_track_type='' # ready callback for show if self.ready_callback<>None: self.ready_callback() self.canvas.delete('pp-content') self.canvas.config(bg='black') self.do_first_track() #stop received from another concurrent show via ShowManager def managed_stop(self): # set signal to stop the hyperlinkshow when all sub-shows and players have ended self.end_hyperlinkshow_signal=True # then stop and shows or tracks. if self.shower<>None: self.shower.managed_stop() elif self.player<>None: self.player.input_pressed('stop') else: self.end('normal','stopped by ShowManager') # kill or error def terminate(self,reason): self.end_hyperlinkshow_signal=True if self.shower<>None: self.shower.terminate(reason) elif self.player<>None: self.player.terminate(reason) else: self.end(reason,'terminated without terminating shower or player') # respond to inputs def input_pressed(self,symbol,edge,source): self.mon.log(self,"received symbol: " + symbol) #does the symbol match a link, if so execute it if self.is_link(symbol,edge,source)==True: return # controls are disabled so ignore anything else if self.show_params['disable-controls']=='yes': return # does it match a control # if at top convert symbolic name to operation otherwise lower down we have received an operatio # look through list of controls to find match if self.top==True: operation=self.lookup_control(symbol,self.controls_list) else: operation=symbol # print 'operation',operation if operation<>'': self.do_operation(operation,edge,source) def do_operation(self,operation,edge,source): if self.shower<>None: # if next lower show is running pass down to stop the show and lower level self.shower.input_pressed(operation,edge,source) else: # control this show and its tracks if operation=='stop': if self.player<>None: if self.current_track_ref==self.first_track_ref and self.top==False: self.end_radiobuttonshow_signal=True self.player.input_pressed('stop') elif operation == 'pause': if self.player<>None: self.player.input_pressed(operation) elif operation[0:4]=='omx-' or operation[0:6]=='mplay-'or operation[0:5]=='uzbl-': if self.player<>None: self.player.input_pressed(operation) def is_link(self,symbol,edge,source): # find the first entry in links that matches the symbol and execute its operation # print 'hyperlinkshow ',symbol found=False for link in self.links: #print link if symbol==link[0]: found=True if link[1]<>'null': # print 'match',link[0] link_operation=link[1] if link_operation=='home': self.do_home(edge,source) elif link_operation =='return': self.do_return(link[2],edge,source) elif link_operation =='call': self.do_call(link[2],edge,source) elif link_operation =='goto': self.do_goto(link[2],edge,source) elif link_operation =='jump': self.do_jump(link[2],edge,source) elif link_operation == 'repeat': self.do_repeat(edge,source) elif link_operation=='exit': self.end('normal','executed exit command') return found def lookup_control(self,symbol,controls_list): for control in controls_list: if symbol == control[0]: return control[1] return '' # ********************* # INTERNAL FUNCTIONS # ******************** # ********************* # Show Sequencer # ********************* def timeout_callback(self): if self.debug: print '\nTimeout Event - goto',self.timeout_track_ref self.do_goto(self.timeout_track_ref,'front','timeout') def do_call(self,track_ref,edge,source): if track_ref<>self.current_track_ref: self.mon.log(self, 'call: '+track_ref) self.next_track_signal=True self.next_track_op='call' self.next_track_arg=track_ref if self.shower<>None: self.shower.input_pressed('stop',edge,source) elif self.player<>None: self.player.input_pressed('stop') else: self.what_next() def do_goto(self,to,edge,source): #if to<>self.current_track_ref: self.mon.log(self,'goto: '+to) self.next_track_signal=True self.next_track_op='goto' self.next_track_arg=to if self.shower<>None: self.shower.input_pressed('stop',edge,source) elif self.player<>None: self.player.input_pressed('stop') else: self.what_next() def do_jump(self,to,edge,source): #if to<>self.current_track_ref: self.mon.log(self,'jump to: '+to) self.next_track_signal=True self.next_track_op='jump' self.next_track_arg=to if self.shower<>None: self.shower.input_pressed('stop',edge,source) elif self.player<>None: self.player.input_pressed('stop') else: self.what_next() def do_repeat(self,edge,source): self.mon.log(self,'repeat: ') self.next_track_signal=True self.next_track_op='repeat' if self.shower<>None: self.shower.input_pressed('stop',edge,source) elif self.player<>None: self.player.input_pressed('stop') else: self.what_next() def do_return(self,to,edge,source): self.next_track_signal=True if to.isdigit() or to=='': self.mon.log(self,'hyperlink command - return by: '+to) self.next_track_op='return-by' if to == '': self.next_track_arg='1' else: self.next_track_arg=to else: self.mon.log(self,'hyperlink command - return to: '+to) self.next_track_op='return-to' self.next_track_arg=to if self.shower<>None: self.shower.input_pressed('stop',edge,source) elif self.player<>None: self.player.input_pressed('stop') else: self.what_next() def do_home(self,edge,source): # if self.current_track_ref<>self.home_track_ref: self.mon.log(self,'hyperlink command - home') self.next_track_signal=True self.next_track_op='home' if self.shower<>None: self.shower.input_pressed('stop',edge,source) elif self.player<>None: self.player.input_pressed('stop') else: self.what_next() def do_first_track(self): index = self.medialist.index_of_track(self.first_track_ref) if index >=0: #don't use select the track as not using selected_track in hyperlinkshow first_track=self.medialist.track(index) self.current_track_ref=first_track['track-ref'] self.path.append(first_track['track-ref']) self.continue_timeout=False if self.debug: print '\nFirst Track',first_track['track-ref'] self.path.print_path() self.play_selected_track(first_track) else: self.mon.err(self,"first-track not found in medialist: "+ self.show_params['first-track-ref']) self.end('error',"first track not found in medialist") def what_next(self): # user wants to end the show if self.end_hyperlinkshow_signal==True: self.end_hyperlinkshow_signal=False self.end('normal',"show ended by user") # user has selected another track elif self.next_track_signal==True: self.next_track_signal=False self.continue_timeout=False # home if self.next_track_op in ('home'): # back to 1 before home back_ref=self.path.back_to(self.home_track_ref) if back_ref=='': self.mon.err(self,"home - home track not in path: "+self.home_track_ref) self.end('error',"home - home track not in path") # play home self.next_track_ref=self.home_track_ref self.path.append(self.next_track_ref) if self.debug: print '\nExecuted Home' self.path.print_path() # return-by elif self.next_track_op in ('return-by'): if self.current_track_ref<>self.home_track_ref: # back n stopping at home # back one more and return it back_ref=self.path.back_by(self.home_track_ref,self.next_track_arg) # use returned track self.next_track_ref=back_ref self.path.append(self.next_track_ref) if self.debug: print '\nExecuted Return',self.next_track_arg self.path.print_path() # repeat is return by 1 elif self.next_track_op in ('repeat'): #print 'current', self.current_track_ref #print 'home', self.home_track_ref #if self.current_track_ref<>self.home_track_ref: self.path.pop_for_sibling() self.next_track_ref=self.current_track_ref self.path.append(self.current_track_ref) self.continue_timeout=True if self.debug: print '\nExecuted Repeat' self.path.print_path() # return-to elif self.next_track_op in ('return-to'): #back to one before return-to track back_ref=self.path.back_to(self.next_track_arg) if back_ref=='': self.mon.err(self,"return-to - track not in path: "+self.next_track_arg) self.end('error',"return-to - track not in path") # and append the return to track self.next_track_ref=self.next_track_arg self.path.append(self.next_track_ref) if self.debug: print '\nExecuted Return',self.next_track_arg self.path.print_path() # call elif self.next_track_op in ('call'): # append the required track self.path.append(self.next_track_arg) self.next_track_ref=self.next_track_arg if self.debug: print '\nExecuted Call',self.next_track_arg self.path.print_path() # goto elif self.next_track_op in ('goto'): self.path.empty() #add the goto track self.next_track_ref=self.next_track_arg self.path.append(self.next_track_arg) if self.debug: print '\nExecuted Goto',self.next_track_arg self.path.print_path() # jump elif self.next_track_op in ('jump'): # back to home and remove it back_ref=self.path.back_to(self.home_track_ref) if back_ref=='': self.mon.err(self,"jump - home track not in path: "+self.home_track_ref) self.end('error',"jump - track not in path") # add back the home track without playing it self.path.append(self.home_track_ref) # append the jumped to track self.next_track_ref=self.next_track_arg self.path.append(self.next_track_ref) if self.debug: print '\nExecuted Jump',self.next_track_arg self.path.print_path() else: self.mon.err(self,"unaddressed what next: "+ self.next_track_op+ ' '+self.next_track_arg) self.end('error',"unaddressed what next") self.current_track_ref=self.next_track_ref index = self.medialist.index_of_track(self.next_track_ref) if index >=0: #don't use select the track as not using selected_track in hyperlinkshow next_track=self.medialist.track(index) self.play_selected_track(next_track) else: self.mon.err(self,"next-track not found in medialist: "+ self.next_track_ref) self.end('error',"next track not found in medialist") else: #track ends naturally #then input pp-onend symbolic name if self.debug: print '\nCreated pp-onend event' self.input_pressed('pp-onend','front','key') # ********************* # Dispatching to Players # ********************* def page_callback(self): # called from a Player when ready to play, merge the links from the track with those from the show # and then enable the click areas self.delete_eggtimer() links_text=self.player.get_links() reason,message,track_links=self.path.parse_links(links_text) if reason=='error': self.mon.err(self,message + " in page") self.end('error',message) self.path.merge_links(self.links,track_links) # enable the click-area that are in the list of links self.enable_click_areas() def enable_click_areas(self): for link in self.links: #print 'trying link ',link[0] if not('key-' in link[0]) and link[1]<>'null' and link[0]<>'pp-auto': # print 'enabling link ',link[0] self.canvas.itemconfig(link[0],state='normal') def play_selected_track(self,selected_track): """ selects the appropriate player from type field of the medialist and computes the parameters for that type selected track is a dictionary for the track/show """ if self.timeout_running<>None and self.continue_timeout==False: self.canvas.after_cancel(self.timeout_running) self.timeout_running=None # self.canvas.delete(ALL) self.display_eggtimer(self.resource('hyperlinkshow','m01')) self.current_track_type = selected_track['type'] #read the show links. Track links will be added by ready_callback links_text=self.show_params['links'] reason,message,self.links=self.path.parse_links(links_text) if reason=='error': self.mon.err(self,message + " in show") self.end('error',message) #start timeout for the track if required if self.continue_timeout==False and self.current_track_ref<>self.first_track_ref and int(self.show_params['timeout'])<>0: self.timeout_running=self.canvas.after(int(self.show_params['timeout'])*1000,self.timeout_callback) # dispatch track by type self.player=None self.shower=None track_type = selected_track['type'] self.mon.log(self,"Track type is: "+ track_type) if track_type=="video": # create a videoplayer track_file=self.complete_path(selected_track) self.player=VideoPlayer(self.show_id,self.root,self.canvas,self.show_params,selected_track,self.pp_dir,self.pp_home,self.pp_profile) self.player.play(track_file, self.showlist, self.end_player, self.page_callback, enable_menu=False) elif track_type=="audio": # create a audioplayer track_file=self.complete_path(selected_track) self.player=AudioPlayer(self.show_id,self.root,self.canvas,self.show_params,selected_track,self.pp_dir,self.pp_home,self.pp_profile) self.player.play(track_file, self.showlist, self.end_player, self.page_callback, enable_menu=False) elif track_type=="image": track_file=self.complete_path(selected_track) self.player=ImagePlayer(self.show_id,self.root,self.canvas,self.show_params,selected_track,self.pp_dir,self.pp_home,self.pp_profile) self.player.play(track_file, self.showlist, self.end_player, self.page_callback, enable_menu=False, ) elif track_type=="web": # create a browser track_file=self.complete_path(selected_track) self.player=BrowserPlayer(self.show_id,self.root,self.canvas,self.show_params,selected_track,self.pp_dir,self.pp_home,self.pp_profile) self.player.play(track_file, self.showlist, self.end_player, self.page_callback, enable_menu=False) elif track_type=="message": # bit odd because MessagePlayer is used internally to display text. text=selected_track['text'] self.player=MessagePlayer(self.show_id,self.root,self.canvas,self.show_params,selected_track,self.pp_dir,self.pp_home,self.pp_profile) self.player.play(text, self.showlist, self.end_player, self.page_callback, enable_menu=False ) elif track_type=="show": self.enable_click_areas() # get the show from the showlist index = self.showlist.index_of_show(selected_track['sub-show']) if index >=0: self.showlist.select(index) selected_show=self.showlist.selected_show() else: self.mon.err(self,"Show not found in showlist: "+ selected_track['sub-show']) self.end("Unknown show") if selected_show['type']=="mediashow": self.shower= MediaShow(selected_show, self.root, self.canvas, self.showlist, self.pp_dir, self.pp_home, self.pp_profile) self.shower.play(self.show_id,self.end_shower,self.ready_callback,top=False,command='nil') elif selected_show['type']=="liveshow": self.shower= LiveShow(selected_show, self.root, self.canvas, self.showlist, self.pp_dir, self.pp_home, self.pp_profile) self.shower.play(self.show_id,self.end_shower,self.ready_callback,top=False,command='nil') elif selected_show['type']=="radiobuttonshow": self.shower= RadioButtonShow(selected_show, self.root, self.canvas, self.showlist, self.pp_dir, self.pp_home, self.pp_profile) self.shower.play(self.show_id,self.end_shower,self.ready_callback,top=False,command='nil') elif selected_show['type']=="hyperlinkshow": self.shower= HyperlinkShow(selected_show, self.root, self.canvas, self.showlist, self,pp_dir, self.pp_home, self.pp_profile) self.shower.play(self.show_id,self.end_shower,self.ready_callback,top=False,command='nil') elif selected_show['type']=="menu": self.shower= MenuShow(selected_show, self.root, self.canvas, self.showlist, self.pp_dir, self.pp_home, self.pp_profile) self.shower.play(self.show_id,self.end_shower,self.ready_callback,top=False,command='nil') else: self.mon.err(self,"Unknown Show Type: "+ selected_show['type']) self.end("Unknown show type") else: self.mon.err(self,"Unknown Track Type: "+ track_type) self.end("Unknown track type") # callback from when player ends def end_player(self,reason,message): self.mon.log(self,"Returned from player with message: "+ message) self.player=None # this does not seem to change the colour of the polygon self.canvas.itemconfig('pp-click-area',state='hidden') self.canvas.update_idletasks( ) if reason in("killed","error"): self.end(reason,message) else: self.display_eggtimer(self.resource('hyperlinkshow','m02')) self.what_next() # callback from when shower ends def end_shower(self,show_id,reason,message): self.mon.log(self,"Returned from shower with message: "+ message) self.shower=None self.canvas.itemconfig('pp-click-area',state='hidden') self.canvas.update_idletasks( ) if reason in ("killed","error"): self.end(reason,message) else: self.display_eggtimer(self.resource('hyperlinkshow','m03')) self.what_next() # ********************* # End the show # ********************* # finish the player for killing, error or normally # this may be called directly sub/child shows or players are not running # if they might be running then need to call terminate. def end(self,reason,message): self.mon.log(self,"Ending hyperlinkshow: "+ self.show_params['show-ref']) self.end_callback(self.show_id,reason,message) self=None return # ********************* # displaying things # ********************* def display_eggtimer(self,text): #self.egg_timer=self.canvas.create_text(int(self.canvas['width'])/2, #int(self.canvas['height'])/2, #text= text, # fill='white', # font="Helvetica 20 bold") #self.canvas.update_idletasks( ) pass def delete_eggtimer(self): if self.egg_timer!=None: self.canvas.delete(self.egg_timer) # ********************* # utilities # ********************* def complete_path(self,selected_track): # complete path of the filename of the selected entry track_file = selected_track['location'] if track_file<>'' and track_file[0]=="+": track_file=self.pp_home+track_file[1:] self.mon.log(self,"Track to play is: "+ track_file) return track_file def resource(self,section,item): value=self.rr.get(section,item) if value==False: self.mon.err(self, "resource: "+section +': '+ item + " not found" ) # players or showers may be running so need terminate self.terminate("error") else: return value