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 first-track and then uses events (GPIO, keypresses etc.) to link to other tracks via their symbolic names
If using 'call' 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.
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 trck-ref forgetting the path back to home-track
goto <track-ref> - play track-ref, forget the path
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()
#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 == '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):
self.do_call(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_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.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
# 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)
# 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)
# 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)
# 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
# goto
elif self.next_track_op in ('goto'):
self.path.pop_for_sibling()
## #back to first track and remove it
## back_ref=self.path.back_to(self.first_track_ref)
## if back_ref=='':
## self.mon.err(self,"goto - first track not in path: "+self.first_track_ref)
## self.end('error',"goto - first track not in path")
#add the goto track
self.next_track_ref = self.next_track_arg
self.path.append(self.next_track_arg)
# 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)
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
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:
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.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 first-track and then uses events (GPIO, keypresses etc.) to link to other tracks via their symbolic names
If using 'call' 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.
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 trck-ref forgetting the path back to home-track
goto <track-ref> - play track-ref, forget the path
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()
#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=='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):
self.do_call(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_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.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
# 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)
# 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)
# 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)
# 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
# goto
elif self.next_track_op in ('goto'):
self.path.pop_for_sibling()
## #back to first track and remove it
## back_ref=self.path.back_to(self.first_track_ref)
## if back_ref=='':
## self.mon.err(self,"goto - first track not in path: "+self.first_track_ref)
## self.end('error',"goto - first track not in path")
#add the goto track
self.next_track_ref=self.next_track_arg
self.path.append(self.next_track_arg)
# 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)
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
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:
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.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
