Resources

hippoSLIDESHOW User Guide


Welcome to hippoSLIDESHOW, an easy to use yet powerful picture presentation system with dozens of features including ...

These are just a few of the many features included. Now read on to discover how to use your hippoSLIDESHOW!


Here’s what this document describes for you ...

1. Quick Start Guide

2. Using the hippoSLIDESHOW Menu System

3. Advanced Configuration via the ‘.config’ Notecard

4. Slide-Specific Configuration Using _DATA Notecards

5. Using the HUD

6. Modifying a hippoSLIDESHOW Player

7. Giving Copies to Your Friends



1. Quick Start Guide

Getting started is remarkably simple! If you look inside your hippoSLIDESHOW folder in your inventory, you’ll find a “hippoSLIDESHOW Player”. Rez it anywhere in world. It will start loading its configuration, but while it does this you can begin adding some pictures.

To add pictures to your hippoSLIDESHOW, begin by right-clicking the player and choosing “Open” from the Second Life pie-menu that appears.

Second Life will open a window showing you the contents of the hippoSLIDESHOW Player’s inventory ...

... next, from your own inventory, drag some textures (or snapshots, or photographs you’ve uploaded etc.) to the contents window you’ve just opened. After a brief moment, your hippoSLIDESHOW player will display the first one you’ve added.

Once you’ve finished adding pictures, you can close the contents window by clicking on the icon at the top right.

Adding pictures really is that straightforward. (You can also drag pictures directly to a hippoSLIDESHOW Player whilst holding down the CTRL key on your keyboard to achieve the same result). Remember that Second Life doesn’t overwrite inventory — so if you add two identically named images, you’ll end up with a duplicate.


2. Using the hippoSLIDESHOW Menu System

Controlling your hippoSLIDESHOW Player is easily done using the built in menu system. Simply click it to see a menu, a bit like this one ...

This menu is contextually sensitive, so may change depending on what your hippoSLIDESHOW Player is doing (e.g. if it is paused, the “Pause” button above changes to “Play”.)

Each menu command is now briefly described for you ... (Please note that to avoid lag, your Player will stop waiting for menu commands after about a minute of inactivity; if this happens, you’ll find it ignores the button you push on the menu — simply click the Player to get a fresh menu).

Pause
Pauses the slideshow from playing. You can then advance through slides manually at your own speed.
Play
Starts a slideshow that is paused playing again.
< Previous
When a slideshow is paused, moves to the previous picture.
Next >
When a slideshow is paused, moves to the next picture.
Backward
Makes the slideshow run backwards.
Forward
Makes the slideshow run forwards.
Keyboard
If the slideshow is paused, you can enter keyboard mode. The Player will ask for permission to “Act on your controls” — answer ”Yes” and you’ll be able to move through slides using the left and right arrows on your keyboard. To exit keyboard control, click the button at the bottom of the Second Life window (or turn Slideshow mode back on again). Advanced users can adjust the keys used to control the Player, if they wish.
Go To
Jump to a specific slide. The hippoSLIDESHOW Player will ask you to type either a picture number (e.g. for the third picture, type 3 and press enter), or part of a picture name (e.g. to jump to a picture called “Lovely Sunset” you could type ‘lovely’, or ‘sun’ or even just ‘ly’ ... obviously without the quotemarks!).
List
Lists each picture held in the Player’s inventory.
Status
Reports all manner of useful status information about how your hippoSLIDESHOW Player is presently configured.
Options
Displays the Options menu (see below).
Tools
Displays the Tools menu (see below).
Turn Off
Turns your hippoSLIDESHOW Player off.
Turn On
Turns your hippoSLIDESHOW Player back on again.
Reset
Resets your hippoSLIDESHOW Player and reloads its “.config” notecard (more on this below).
Help
Gives you a copy of these instructions in Second Life notecard form.

As you can see above, there are also a couple of sub-menus that are very useful. Here is the Options menu:

Effects
Allows you to choose which effect you want to use to transition between slides. You’ll be offered yet another menu with a choice of transitions ...
  • Switch: the two pictures are simply switched with no transition effect
  • Cross Fade: the Player will fade between the two pictures
  • Via Black: the first picture will fade to black and then the next picture will fade in
  • Reveal: a “hole” grows in the middle of the first picture, revealing the new picture
  • Wipe L/R: a horizontal “wipe” effect reveals the new picture
  • Wipe U/D: a vertical “wipe” effect reveals the new picture
  • Zoom: the display zooms in huge detail onto the first picture, then zooms out to reveal the new
  • Clock: a clockwise wipe reveals the new picture
  • Glow: A glowing lighting effect wipes one picture and reveals the next. (Please note: if using the HUD (see below), Second Life currently has a bug whereby "glow" effects won't show on HUD attachments). (Glow is available version 1.5 of hippoSLIDESHOW and above only).
  • Random: a new effect is chosen at random for each slide change

There is a video demo of the different transition types available.

IMPORTANT NOTE: Your hippoSLIDESHOW Player can show pictures for which you have a variety of Second Life permissions. But only those for which you have +copy permissions can be shown using the reveal, wipe, cross fade, or clock transitions (as they need to be applied to the hidden prim the Player uses to achieve this effects). You can mix and match pictures with different permissions in the one Player and it will simply use an alternate transition effect when it needs to.
Times
Allows you to edit the delay (the time, in seconds, between slides) and/or the speed (how long, in seconds, a transition takes to complete).

TIP: We don’t recommend setting the delay or speed settings to less than 2 seconds, due to Second Life script timing limits. You may also end up with odd effects if you set the speed to less than the transition time; feel free to experiment to see what works best for your taste!
Hovertext
Leads to a further menu that allows you to turn the text captions or on off (e.g. floating the picture/texture name over the Player) and to change the text colour if you wish. Note that by using the advanced “.config” settings (see below) you can customise what appears in the hovertext.
Shuffle On
Turns shuffle mode on. The next slide will be chosen at random.
Shuffle Off
Turns shuffle mode off. The next slide will follow in sequence, as normal.
Lighting
Will let you choose full brightness or regular brightness for your textures. Which you prefer is largely a matter of taste.
<- Back
Returns to the main menu.


And the tools menu ...

Network
Allows you to choose to wipe the inventory of any networked “slave” hippoSLIDESHOW Players (see below for notes on how to configure networking) or to copy inventory across to them.
Test Touch
Makes the Player behave as if a stranger had touched it. Useful for testing any inventory gives that you have set up (see below). If you haven’t configured the giving of any inventory items, the Player will chat this fact as a confirmation.
Delete Inv
Allows you to delete inventory. You’ll be asked to type either a picture number (e.g. 4), or a range (e.g. 2-8) or text to find in the names of pictures.

USEFUL TRICK: If you type duplicates as the delete range, your Player will search for any duplicate images and delete them. (It will treat a duplicate as a picture with a different name but the same Second Life key as another). Only pictures for which you have full permissions can be removed using this method.
Inv Drop
Will let the Player accept inventory from strangers for 60 seconds (or until you touch it again). Your friends can then just add pictures by holding down CTRL and dragging the textures from their Second Life inventory windows to the Player.
<- Back
Returns to the main menu.


3. Advanced Configuration via the ‘.config’ Notecard

Inside each hippoSLIDESHOW Player exists a Second Life notecard called “.config”. If you wish to use some of your Player’s advanced settings — or configure very detailed aspects of its behaviour — you need to edit settings in here. This is also fairly simple — but if you’re happy with just the basic functionality, ignore this section for now!

Begin by right-clicking your hippoSLIDESHOW Player and choose ‘Edit’ from the Second Life pie menu.

(Then if the “More >>>” button is showing, click that.)

Next, click on the tab labelled “Content” to see a list of the Player’s inventory.

Finally, double-click on the “.config” notecard to open it. Change the settings you wish to (each is described below — remember, don’t alter command words in capital letters, just values after colons) and when done, close and save the notecard.

OBVIOUS BUT IMPORTANT NOTE: Click your hippoSLIDESHOW Player and choose “Reset” from the menu to reload the “.config” notecard after making any changes to it!

Each command is now described, along with an example, to show you how to use it.


DEFAULT HOVERTEXT DISPLAY: <On/Off>
e.g. DEFAULT HOVERTEXT DISPLAY: Off
- Determines whether hovertext picture captions are turned on by default.

DEFAULT HOVERTEXT COLOUR: <colour name or vector>
e.g. DEFAULT HOVERTEXT COLOUR: Yellow
- Specifies the default hovertext picture caption colour. You can use the colour names "red", "blue", "green", "yellow", "pink", "white", or "black" whilst advanced users can choose to specify a colour vector if preferred (e.g. <1, 0.5, 0.2>).


DEFAULT SLIDESHOW RUNNING: <Yes/No>
e.g. DEFAULT SLIDESHOW RUNNING: Yes
- Determines whether the Player is in slideshow mode by default.

DEFAULT DELAY TIME: <time in seconds>
e.g. DEFAULT DELAY TIME: 5
- Specifies the default time in seconds between slides.


DEFAULT TRANSITION: <transition name>
e.g. DEFAULT TRANSITION: Cross Fade
- Determines which transition should be used by default. You can specify Cross Fade, Via Black, Switch, Reveal, Wipe L/R, Wipe U/D, Zoom, Clock or Random.

DEFAULT TRANSITION SPEED: <time in seconds>
e.g. DEFAULT TRANSITION SPEED: 2
- Specifies the default time a transition will take to complete.


DEFAULT SHUFFLE MODE: <On/Off>
e.g. DEFAULT SHUFFLE MODE: Off
- Determines whether shuffle mode is on or off by default?


DEFAULT FULL BRIGHTNESS: <Yes/No>
e.g. DEFAULT FULL BRIGHTNESS: Yes
- Specifies whether textures are shown with their lighting set to full brightness or not by default.


OTHER USERS: <list of names, separated by commas>
e.g. OTHER USERS: Darth Vader, Han Solo, Princess Leia
- Names of other people who you wish to be able to control your Player (via the menus). Note that if you include “Group” as one of the names, then anybody wearing the same group tag as the Player will be able to control it, too.


1ST INVENTORY ITEM TO GIVE: <name of inventory item>
e.g. 1ST INVENTORY ITEM TO GIVE: My Store Landmark
- If you’d like people who click your hippoSLIDESHOW Player to be given an item, e.g. a landmark, add it to the Player’s inventory, as you would a picture, then edit this setting. You can test inventory giving is working correctly by using the “Test Touch” menu command.

2ND INVENTORY ITEM TO GIVE and 3RD INVENTORY ITEM TO GIVE ... work in exactly the same way, allowing you to give up to three pieces of inventory if you wish.

ADVANCED TIP #1: You can also link specific inventory items to specific slides. When somebody touches your Player, as well as look at the settings above, the Player will also give any inventory items that have the same name as the current picture, but that end either _LM, _OB or _NC. (These don’t have to be specifically a landmark, object or notecard, they can be anything). So if the texture file is called “Sunset Over My Sim”, you could have a notecard called “Sunset Over My Sim_NC” be given on touch. Important: the naming must be exactly correct and is case-sensitive.

ADVANCED TIP #2: As well as giving inventory, slides can also trigger sounds. Just add a sound file to your Player’s inventory with the same name as the slide that should trigger it, but with _SOUND appended to the end; e.g. “View from the Sea_SOUND”. It will play when that slide loads.

ADVANCED TIP #3: If you name the sound file with a _SOUNDLOOP ending, then that sound won’t just play once, it will loop until the Player moves to the next slide. Really useful if you want to have environmental sounds play alongside a picture (e.g. running water, blowing wind, crashing waves etc.)


LINK URL: <website address>
e.g. LINK URL: http://news.bbc.co.uk/
- If you would like people who touch the Player to be directed to a website, supply its URL here (be sure it starts with http or https, or Second Life will refuse it). Note: you can specify a URL on a slide-specific basis using the advanced _DATA notecard method, see below.

NETWORKING STATUS: <Master, Slave or Off>
e.g. NETWORKING STATUS: Master
- Networking allows you to have one Player control another in the same sim. For example, you can wipe the inventory of a slave or copy pictures to slaves from a master using the network menu commands. And many menu commands (e.g. moving to the next or previous slide, changing transition types etc.) will be transmitted from masters to slaves. To set up networking, simply:

  • Use NETWORKING STATUS: Master ... in the master Player’s “.config” notecard

  • Use NETWORKING STATUS: Slave ... in each slave Player’s “.config” notecard

  • Ensure the description of each Player is identical (right-click a Player and choose “Edit” to see/change this. Clever use of this feature means you can run multiple networks in the same sim.

  • Note that both master and slave Players should have the same set of pictures in them.

  • Note that if running in slideshow mode, masters and slaves may not necessarily display the same picture at exactly the same time — simply because Second Life timers are not entirely accurate. You can re-synchronise slideshows by using the “Go To” menu option on the master, which will of course move the slaves to the same picture.

KEYBOARD MODE PREVIOUS SLIDE: <key code>
e.g. KEYBOARD MODE PREVIOUS SLIDE: ROT_LEFT
- If you wish, you can change the keyboard key that moves to the previous slide in keyboard mode. Valid keyboard codes are ROT_LEFT, ROT_RIGHT, FWD, BACK, LEFT, RIGHT, UP or DOWN.

KEYBOARD MODE NEXT SLIDE: <key code>_RIGHT
e.g. KEYBOARD MODE NEXT SLIDE: ROT_RIGHT
- If you wish, you can change the keyboard key that moves to the next slide in keyboard mode. Use one of the keyboard codes listed immediately above.

MOUSE CLICK ADVANCE: <Yes/No>
e.g. MOUSE CLICK ADVANCE: No
- If you set this to “Yes”, then anybody clicking the Player will advance to the next slide. Useful for stand-alone Players in, for example, a store location — customers can then move through the display at their leisure.

REVEAL TRANSITION SHAPE: Square
e.g. REVEAL TRANSITION SHAPE: Square
- If you don’t like the default hole shape used by the Reveal transition, you can change it. Specify either Square, Circle or Triangle.

SENSOR TIME: <time in seconds, or 0 for off>
e.g. SENSOR TIME: 10
- Player’s can be told to scan their immediate vicinity at a time interval you supply and turn slideshow mode off if nobody is there. (If people are found, the slideshow will start running again). This can be used to marginally reduce lag by only having pictures cycle when people are there to see them (the Player is very low lag anyway, but it’s still a neat feature!)

SENSOR RANGE: <radius to check, in metres>
e.g. SENSOR RANGE: 5
- If you’re using a sensor, as described above, specify the range to scan here. The maximum value is 96 metres.

TEXTURE WHEN TURNED OFF: <texture key>
e.g. TEXTURE WHEN TURNED OFF: 4eca6f5f-adfe-c6a7-e0c1-c4c5fa0fa284
- You can replace the default texture used when the Player is turned off by changing this value. (To find a texture’s key, right-click it in your inventory and choose “Copy Asset UUID”. This only works, of course, for textures you have full permissions for).

HOVERTEXT FORMAT: <string>
e.g. HOVERTEXT FORMAT: (<C> of <T>) <N>
- You can specify precisely what should appear in hovertext captions and where. The Player will replace the tags <C>, <T> and <N> with the current picture number, total picture count and picture name, respectively. You can also use the pipe symbol (|) to insert a line break. And if using the advanced _DATA notecard facility (see below), then use <D> as a tag to be replaced by the description field from a picture’s data card.

VOLUME: <whisper/say/shout/ownersay> Version 1.6 and higher only
e.g. VOLUME: Whisper
- Specifies how “loudly” a hud or player unit should chat any feedback.
(Be careful about using VOLUME: OwnerSay ... if you wish for friends to be able to use your player, or customers to listen to the captions it chats, for example, then setting this to ‘ownersay’ would prevent them hearing it).


4. Slide-Specific Configuration Using _DATA Notecards

As well as many global settings, hippoSLIDESHOW Players can have some settings configured on a per slide basis (you’ve seen one example above, with inventory giving and sounds). But you can also configure specific text for the Player to chat, extra hovertext/caption text, a specific URL to direct people who click the Player to and a specific slide delay for any slide you choose — it doesn’t take much imagination to see that this allows you to create some very powerful presentations that run on their own and are very interactive.

To create a set of slide specific settings ...

  • Add a notecard to the Player’s inventory with the same name as the slide it should effect, but with _DATA appended to the name. So a slide texture called “Our Company HQ” would have a notecard called “Our Company HQ_DATA". (This is, remember, optional. When a slide is loaded, the Player looks for the _DATA card to read. If it is found, it is loaded and applied; if not, no special settings are used).

  • In that card you can use the following commands ...

    • LINK URL: <website address>
      e.g. LINK URL: http://news.bbc.co.uk/
      - If you would like people who touch the Player to be directed to a website, supply its URL here (be sure it starts with http or https, or Second Life will refuse it).

    • DESCRIPTION: <text>
      e.g. DESCRIPTION: Click me for a website link!
      - An extra line of description for the hovertext caption; it will replace the <D> tag in your hovertext configuration.

    • DELAY: <time in seconds>
      e.g. DELAY: 5
      - Specifies the delay time (how long this slide will stay on screen before the next appears). This will override the global delay time set on this Player.

    • CHAT: <text>
      e.g. CHAT: Hello, passerby!
      - Any text you would like the Player to chat when this slide is loaded. (You can prefix it with ! to shout the text, or % to whisper it; otherwise it will be spoken.)

  • Save the notecard. Next time the slide loads, any settings you have made will be applied.



5. Using the HUD

Your hippoSLIDESHOW system also comes with a simple HUD that you can use to control your slideshows. Basically this uses the networking techology described above; so any Players that are set to run in Slave mode and have the same description as the HUD will be controlled by it. The idea behind the HUD is that if you wish to run a presentation whilst giving a talk — perhaps in a business or educational context — the HUD makes this very easy to do.

To use the HUD ...

  • Right-click it in your inventory and choose Attach to HUD and then pick a location. We’ve set it up so it works nicely at the top left of the screen; anywhere else, you may need to adjust its position (right click it, then choose Edit, and move it using the regular Second Life tools).

  • Add the same set of images to the HUD as in your slave Players (or start with the HUD and then use the Network menu to copy images to the slaves).

  • Make sure your slave Player has the same description as the HUD (by default, the HUD’s description is “HUD”.

  • Once the HUD has loaded its configuration, you’ll see it works just like a mini Player — with one important difference; two smaller panels either side of the main frame show you which slide is coming next and which was before.


    Not only does this help see where you are in your presentation, but you can click these mini-slides to move forward or backwards.


  • When providing input via chat to the HUD (e.g. a slide number to go to, a slide to delete), you can also use chat channel 8 so that people around don’t hear you; simply prefix your input with /8 .... e.g. /8 1-2

  • In every other way, the HUD is a Player; so click it to get a menu just like the ones described above for the regular hippoSLIDESHOW Player.


6. Modifying a hippoSLIDESHOW Player

Your hippoSLIDESHOW Player is fully modifiable. So, for example, to resize it, just select it and hold down CTRL and SHIFT while dragging on one of the white control points on each corner.

There’s another useful trick, too. If you’re an avid tinkerer and want to resize the panels, you only need resize the outer panel (using the normal Second Life tools that let you edit linked prims). Once that’s the size you’d like, just reset the Player from its menu and the rear “hidden” panel will automatically djust to the same size as its parter in front. Note: it only adjusts its size, not its position, so some tinkering may still be needed.

USEFUL TIP: If you unlink the prims in your Player, it doesn’t matter, just relink them — simply ensure that the prim with all the major scripts in (and your textures) remains the root prim in the linkset.

BASIC API: Thinking of adding navigation buttons to a customised slideshow player? If you’re using hippoSLIDESHOW version 1.6 or higher, then it’s easy using the built in API. To move to the previous slide, a script in your arrow button can use ...

llMessageLinked(LINK_ROOT, 401, "", "");

... and to move to the next slide, the script should use ..

llMessageLinked(LINK_ROOT, 402, "", "");



7. Giving Copies to Your Friends

Generous types that we are, you’ll find two hippoSLIDESHOW Players in your carton that have +transfer -copy rights on them. This means that you can load them with your photos and pass them out to your friends ... they make great presents! Just remember to ensure that any textures you load in them have next-owner copy permissions if you want your friends to enjoy all the various slide transitions available! (No-copy textures will still work, but only a few of the transitions can be used with them).

USEFUL TIP #1: Carefully set up the defaults you’d like in the “.config” card before passing the Player to your friends; they may not be familiar with hippoSLIDESHOW and to get the best from your images, this will enable them to simply rez it and go!

USEFUL TIP #2: After rezzing, editing and taking a no-copy Player back into your inventory, it may be wrongly listed by Second Life as “no-modify”. Just ignore this — when you rez it again inworld, you should still be able to make changes (e.g. resize it, add inventory to it, etc.)

If you would like to resell or distribute hippoSLIDESHOW Players en masse preloaded with images — perhaps you’re an artist and think it would be a great format to showcase your work — then please contact us. We sell a +copy +transfer version of the player (hard-coded so it will only show your work) for a higher price and we can discuss this with you.


We hope that you enjoy using your hippoSLIDESHOW system.

We recommend to all customers that they join the Hippo Technologies Users Group in Second Life. It’s a friendly community and lots of advice, tips and support can often be found by asking nicely!

<< Back