UMP (Unified Media Platform)

7.1 Viewing Images

 

Viewing images is another function supported by a large number of devices, though generally in less versatile ways than the UMP. Not only does the device offer support for a wide variety of image formats, but also retrieves online images on demand via a few simply button presses in the OSD.

 

To view images open the Image Menu from the Main Menu in the OSD. Here you will see a number folders and icons, depending on your configuration, although this manual assumes the defaults are active. Highlight an image file and press Enter on the remote control (UMP-R-XXX) to open the file.

 

A feature found in the Images Menu, but not in most other sections of the device is the Display Toggle function, which allows you alter the display mode on the fly by pressing the Display button on the remote control (UMP-R-1XX) or ‘d’ on the keyboard (UMP-R-2XX, UMP-R-3XX). This can be helpful when you wish to navigate faster, as thumbnails are generated for all supported images by default, which can slow the OSD down, depending on the resolution and compression of the image files. Note that in the List View thumbnails will only be generated for the items that are or become highlighted, as opposed to the default (Thumbnail View).

 

When you select an image it is opened in fullscreen by default, while preserving the original aspect ration of the file. The image will be displayed for 5 seconds by default, before the OSD opens either the next file sequentially (if available) or exits back to the previous menu.

 

While viewing images in fullscreen, a number of controls provide the same functionality as with Music or Video playback, such as Play, Pause, Exit and the directional Up and Down keys which navigate forwards and backwards between images. Additionally, you can also press the Left and Right directional buttons on the remote control (UMP-R-XXX) to rotate the image in either direction.

 

When viewing large images on a small display or just extremely detailed pictures you may want to zoom in to get a better look. The UMP doesn’t feature the classical zoom function which many other provide, but maps each image that is opened in sections to the numeric keys. The layout of the physical buttons on the remote control corresponds to the image layout (UMP-R-1XX), though this may be inversed on other devices like a keyboard (UMP-R-3XX).


 

7.1 Viewing Images (continued)

 

As described on the previous page, the numeric keys are mapped to areas in the image selected. To zoom in on one of these areas, open an image in fullscreen and press 1, 2, 3, 4, 5, 6, 7, 8 or 9 on the remote control or keyboard (UMP-R-XXX). The areas are mapped as follows:

 

Numeric Keys:

 

1

2

3

4

5

6

7

8

9

 

0

 

 

Functions:

 

top left

top center

top right

left

center

right

bottom left

bottom center

bottom right

 

full view

 

 

 

Note that the 0 key will zoom out again, presenting the entire picture. After you selected one of the digits 1 – 9 on the remote control, you can adjust the placement of the ‘window’ by using the four directional keys. This allows you to navigate over an entire image while minimizing the amount of key presses required for this.

 

Please note that even though transparency is supported for some file formats, such as PNG, it will not be visible in fullscreen viewing – a neutral black background is used for the transparent sections.

 

Like most other media sections of the UMP-OSD, the Clipboard function is available, which allows you to move or copy files and directories locally or to and from the network.

 

Note that you can select Play all files in directory or Random play all items for any directory in the Images Menu although the virtual directories provided by some plugins, such as the Garfield or APOD plugins, do not support these actions.

7.2 Creating a Playlist or Slideshow

 

Playlists

 

As mentioned previously, playlists can be used for images as well as audio and video files. Creating a playlist of images is however not as intuitive as with the other types of media. You cannot create either a playlist or a slideshow from the OSD itself, though this can be performed in the Text Editor in the Desktop Mode.

 

Playlists in the M3U format are supported as with the audio and video sections, though PLS files are NOT supported. To create a playlist or slideshow, you will need to create a text file, and rename it to .m3u afterwards. You can use the format applied in the following example which makes use of some of the sample pictures:

 

[…]

/mnt/data/Images/Astronomy/catseye2_not_big.jpg

/mnt/data/Images/Astronomy/catspaw_dss2_big.jpg

/mnt/data/Images/Astronomy/equinoxp1_orman_big.jpg

/mnt/data/Images/Various/mactvsplash.png

[…]

 

Please note that blank lines can cause the OSD to refuse to load the playlist or even exit. When editing playlists manually, it is recommended to check the paths on the device itself, as they are case sensitive and some operating systems or Samba, NFS or FTP clients may represent upper and lower case usage incorrectly.

 

 

 

Slideshows

 

Slideshows are slightly different, in the sense that you can combine background music with a sequence of images. The Detach function of the Audio Player can be used while viewing a slideshow, though if background music is defined, it will override and cancel the currently playing music.

 

An example XML FXD file is shown on the next page, demonstrating an image directory and a background audio file with explanations of the individual XML fields.

 


 

7.2 Creating a Playlist or Slideshow (continued)

 
 
An example XML FXD file for a slideshow using a background audio file and two image files to display:  
<?xml version="1.0" ?>
  <ump>
   <slideshow title="TITLE" random="1|0" repeat="1|0">
    <cover-img>COVER.jpg</cover-img>
     <background-music random="1|0">
      <directory recursive="1|0">PATH1</directory>
      <file>FILENAME1</file>
     </background-music>
     <files>
      <directory recursive="1|0" duration="10">PATH2</directory>
      <file duration="0">FILENAME2</file>
     </files>
     <info>
      <description>DESCRIPTION</description>
     </info>
    </slideshow>
   </ump>

 

 

Where the value “1|0” is displayed, you can choose either ‘0’ (false) or ‘1’ (true). The terms printed in all cursive capitals are explained below:

 

 

TITLE

Here you can specify a title for the slideshow which will be displayed in the OSD

COVER

This should be the full path and filename of the cover image (optional)

PATH1

Here you can specify the directory which contains the background music (optional)

FILENAME1

Here you can specify the filename of the audio file to be played (optional)

PATH2

Here you can specify the directory from which to display the images

FILENAME2

Here you can specify a certain image a to be displayed (optional)

DESCRIPTION

Here you can enter a description for the slideshow

7.3 Playing a Slideshow

 

When you highlight a slideshow in the Images Menu or one of its submenus, a number of the default action like Play and Delete are listed in the button bar with the corresponding color button on the remote control (UMP-R-1XX). To test the playback of a slideshow, take the previously shown example, modify the relevant parts, and save it somewhere accessible to the UMP. Now you should be able to select it in the OSD under Images Menu or one of its submenus. Note that when playing a slideshow, any instances of the Audio Player will be exited, applications running in the Desktop Mode will not be affected though.

 

When you highlight a slideshow in the Images Menu or one of its submenus, a number of the default action like Play and Delete are listed in the button bar with the corresponding color button on the remote control (UMP-R-1XX).

 

It is recommended to perform all manual editing of either the configuration files, or FXD/XML playlists or slideshows in a text editor which supports syntax highlighting, like the Text Editor in the Desktop Mode or ‘Vim’ if you prefer to use the console. The exact usage of Vim is however beyond the scope of this document.

7.4 Viewing Images while listening to Music

 

As explained in the chapter Music in this manual, the Audio Player features a Detach function, which allows the music playback to continue in the background, while you are free to navigate around other parts of the OSD.

 

Viewing Images is one of the tasks that you can perform, when the Audio Player is detached, which allows for similar behavior as playing a slideshow. Note that a slideshow will take precedence over a detached Audio Player, and that instance will be forced to exit.

 

Note that a regular Image Playlist may only contain image items, whereas a slideshow can contain background music.

7.5 Screenshots

 

Yet another function of the UMP, which is seldom seen in comparable devices, is the ability to take a screenshot at any time in the OSD. Originally, this functionality was implemented to ease the support for the device, by eliminating the necessity to describe the visual representation of the situation in words.

 

To take a screenshot, navigate to any part of the OSD, or simply remain in the Main Menu and press the Screenshot button on your remote control (UMP-R-1XX) or ‘F10’ on the keyboard (UMP-R-3XX). So as not to interfere with the image being taken, no visual confirmation is displayed regarding whether the screenshot was saved.

 

All screenshots are saved as 24bit bitmap files in the directory ‘screens’ in the Images share (/mnt/data/Images). This format was chosen to ensure the correct representation of the original screen, without using compression typically found in other formats. Obviously, these files take up more space than necessary, and because the default output format cannot be changed, a Helper script is provided, which converts all bitmap images in the ‘screens’ directory to Portable Network Graphic (PNG) files. The original BMP files are not deleted by default.

 

To convert the screenshots to the PNG format, access the Web Interface of the device, either locally or from a networked computer, and navigate to Plugins -> Helpers. Here you should see a list of Helper scripts. Click on ‘screenshots’ near the bottom of the list.

 

Please note that because the OSD doesn’t display file extensions by default, you will be unable to tell the difference between the originals and the resulting PNG files when navigating through the ‘screens’ directory in the Images Menu. To do so, open the File Manager from the Commands Menu in the OSD or access the Web Interface and navigate to Files -> Advanced Media Library -> Images -> Images -> Screen.

 

Alternatively, you can open the Images share from a networked computer, and delete the unnecessary files that way. Please note that it is recommended to rebuild the Media Cache after deleting the old files. This can be done by selecting Rebuild UMP Media Cache from the Commands menu, or by selecting the cache Helper script under Plugins -> Helpers -> Cache in the Web Interface.