Version 1.3.1a, 3 May 2015 +Track changes base is 1.2.3d Pi Presents A Multi-media Interactive Display and Animation Toolkit for Museums, Visitor Centres and more….. Running on the Raspberry Pi Ken Thompson http://pipresents.wordpress.com Page 1 Version 1.3.1a, 3 May 2015 Contents 1 Introduction ...................................................................................................... 6 1.1 Acknowledgements ..................................................................................... 8 2 Installation ........................................................................................................ 8 3 Try Some Examples ......................................................................................... 8 3.1 Terminating Pi Presents ............................................................................ 13 4 The Pi Presents Profile Editor ....................................................................... 13 4.1 Using the Editor......................................................................................... 13 4.1.1 The Displays ...................................................................................... 13 4.1.2 Profile Menu ....................................................................................... 14 4.1.3 Show Menu ........................................................................................ 14 4.1.4 Medialist Menu ................................................................................... 14 4.1.5 Track Menu ........................................................................................ 14 4.1.6 OSC Menu ......................................................................................... 15 4.1.7 Tools Menu ........................................................................................ 15 4.1.8 Options Menu ..................................................................................... 15 4.1.9 Editor Command Line Options ........................................................... 16 4.2 Making Profiles ......................................................................................... 16 4.2.1 Making Profiles Portable .................................................................... 16 4.2.2 Using the SD Card for Profiles ........................................................... 17 4.2.3 Using the Editor on a Windows PC .................................................... 17 4.2.4 Using a USB Stick for Profiles ............................................................ 18 4.2.5 Developing Profiles using a Monitor with Different Pixel Dimensions.. 18 5 The Components of Pi Presents ................................................................... 19 5.1 Introduction ............................................................................................... 19 5.2 Shows ....................................................................................................... 21 5.2.1 Mediashow and Artmediashow ........................................................... 21 5.2.1.1 Controls and Commands............................................................. 22 5.2.1.2 Triggers ....................................................................................... 24 5.2.1.3 Fields .......................................................................................... 25 5.2.2 Menu .................................................................................................. 31 5.2.2.1 Controls and Commands............................................................. 31 5.2.2.2 Fields .......................................................................................... 31 5.2.3 Liveshow and Artliveshow .................................................................. 32 5.2.4 Radiobuttonshow ............................................................................... 33 5.2.4.1 Controls and Commands............................................................. 33 5.2.4.2 Fields .......................................................................................... 34 5.2.5 Hyperlinkshow .................................................................................... 35 5.2.5.1 Controls and Commands............................................................. 36 5.2.5.2 Touchscreens and Soft Buttons .................................................. 37 Fields ..................................................................................................... 38 5.2.5.3 .......................................................................................................... 38 5.2.6 Start Show ......................................................................................... 39 5.3 Medialists .................................................................................................. 40 5.4 Tracks ....................................................................................................... 40 5.4.1 Track Location Names ....................................................................... 41 5.4.2 Anonymous and Labelled tracks ........................................................ 41 5.4.3 Show Track ........................................................................................ 41 Page 2 Version 1.3.1a, 3 May 2015 5.4.4 Image Track ....................................................................................... 41 5.4.4.1 Image Window ............................................................................ 43 5.4.5 Video Track ........................................................................................ 44 5.4.6 Audio Track ........................................................................................ 46 5.4.7 Web Tracks ........................................................................................ 48 5.4.7.1 Browser Commands .................................................................... 50 5.4.7.2 Full screen Integrated Browser Displays ..................................... 51 5.4.8 Message Tracks ................................................................................. 52 5.4.9 Show Track ........................................................................................ 53 5.4.10 Menu Track ........................................................................................ 54 6 Black Box Operation ...................................................................................... 58 6.1 Command Line Options ............................................................................. 58 6.2 Specify a Profile ........................................................................................ 59 6.3 Specify a Home Directory .......................................................................... 59 6.4 Using GPIO to Control Pi Presents............................................................ 60 6.5 Disable Screen Blanking ........................................................................... 61 6.6 Start Pi Presents when Power is applied to the Pi ..................................... 61 6.7 Shutdown the Raspberry Pi from the GPIO ............................................... 61 7 Exiting Pi Presents and Shutdown of the RPi .............................................. 61 8 Controlling Shows.......................................................................................... 62 8.1 Controlling Track Movement in Individual Shows ...................................... 62 8.2 Opening and Closing Shows and Show Control ....................................... 63 8.3 Time Of Day Scheduler ............................................................................. 64 8.4 Concurrent Shows ..................................................................................... 65 Control with Concurrent Shows ................................................................. 66 8.4.1 ................................................................................................................. 66 8.4.2 Limitations on Concurrency ................................................................ 66 9 Touchscreens and Soft Buttons ................................................................... 67 9.1 Controlling Shows with a Touchscreen ...................................................... 67 9.2 Click Areas ................................................................................................ 67 9.3 Soft Buttons .............................................................................................. 67 10 Run-Time Commands ................................................................................. 68 11 Providing Dynamic Content in a Liveshow ............................................... 69 12 Animation Control ...................................................................................... 69 13 Input/Output Drivers ................................................................................... 71 13.1 Enabling an I/O Device .......................................................................... 71 13.2 Configuring Inputs and Output Drivers ................................................... 71 13.2.1 Configuring GPIO Pins ....................................................................... 72 13.2.2 Configuring Touch/Click Areas ........................................................... 73 13.2.3 Configuring Keyboard Keys ................................................................ 74 14 Remote Control using OSC (very beta) ..................................................... 74 14.1 OSC Messages