The Displayable Creator

You have a big image and you want to see it on your iPhone or iPod Touch in its full glory ? Create a Displayable using this convenient application on your Desktop or Laptop computer, and use the Displayator iPhone app to see it on your mobile device.

A Displayable is a special file that stores a transformed copy of image in an manner that allows the Displayator app on an iPhone or iPad to display the image at its original resolution while allowing fast zooming and scrolling. This has been tested with up to 21000x10800 pixels images. Details about the implementation can be found in the Displayables page.

The Displayable Creator is a Java Application, thus it runs on Windows, Linux and Mac OS X (provided the Java is already installed).

Learn more about :

• Launching the Displayable Creator
• Creating Displayables
• Viewing Displayables
• Transfering Displayables to your iPhone
• Sharing Displayables on the internet
• Credits and License

---

Launching the Displayable Creator

If Java is installed on this computer, you can start it by clicking on the launch button bellow. Otherwise, please install Java

The first time you will run the application, you will have to:

• accept an unverified certificate from this website (www.displayator.com).
• you might have to allow the application to accept incoming network connections.

Installing Java

On an Apple Mac

• Running Mac OS X Leopard or Snow Leopard : It is already there.
• Running Mac OS X Lion & Mountain Lion : if it is not alreay installed, please refer to these instruction from apple for installing Java on Mac OS X Lion.

On a Windows PC

• Please refer to these instruction from Oracle.

On a Linux or Free BSD computer

• Your distribution has a package called something like jre, java, java6 or j2re (or java7). Please install it using your usual package manager.

Creating Displayables

• Launch the Displayator Creator
• Drop the image you want to transform into a Displayable onto the “Drop Images Here” part of the application’s main window. The displayable creation will start immediately.

Done !

By default the displayables are created in temporary files that are removed when you quit the program.

If you want, you can save it to a permanent location on your computer. The following optional steps can be taken :

• You can choose the title of the Displayable as it will appear in the iPhone app.
• You can choose the name and location of the file that will be saved (but not the extension).
• You can add a description to the Displayable, which will be shown in the app before the user decides to download the Displayable on his iPhone or iPod Touch.

Viewing Displayables

You can of course use the Displayator iPhone app.

If you want to see the Displayables on your computer, you can use the Displayable Creator.

1. Click on “Choose Displayable”
2. Browse to your Displayables
3. Select “open”
4. Click on the magnifier in the “View” column.

If you want to see the displayable full screen, click on the button with the 4 arrows extending outward in the toolbar. When in full screen mode, this button will change to four arrows pointing inward, and clicking on it will allow you to leave fullscreen mode.

Transfering Displayables to your iPhone

You can transfer a Displayable from your computer to your iPhone or iPod Touch. in these ways:

• Using iTunes file sharing
• Using the Displayable Creator application

Loading Displayables using iTunes file sharing

Warning: this only work on devices with iOS 3.2 installed or newer (it can’t work on the original iPhone or iPod Touch).

In iTunes:

• Synchronize your iPhone/iPod Touch.
• Select your device in the list on the left.
• Select the apps section to see those installed on your device.
• Bellow the list of apps, in the list of apps that use file sharing select “Displayator”
• Drag and drop you Displayable onto the list of “Displayator Documents”.

On your iPhone / iPod Touch:

• Restart Displayator.

The Displayable(s) should now be visible in the list of Displayable on your device.

Loading Displayables using the Displayable Creator application

For this method to work, your computer and your iPhone need to be connected to the same Wifi network.

On your computer:

• Open the Displayable Creator application.
• Click on the “Choose Displayable” button.
• Navigate to your Displayable or its parent directory, select it and click “Choose”.

On your iPhone/ iPod Touch:

• Launch Displayator.
• On the start screen, tap on the “Download Displayables” item.
• The list of Displayable shared by your computers on your wifi network should appear.
• Tap on the one you want and then tap on the “Download” button.

Once the download is completed, you can view the Displayable on your device.

Sharing Displayables on the internet

You can export your Displayables as a web page and allow anyone to download them on their iPhone. The web page will display a list of your Displayables, their thumbnails as well as links to see their miniature and links which can launch the Displayator app to open the list in-app. The web page will be similar to this one.

The directory you selected will then contains all the Dispayables you want to share, as well as their miniature and thumbnail. It also contains an html file, a json file and a css file. The html which list the Displayables, for viewing in a web browser. It needs the CSS file to not be too ugly. The json file is for the Displayator app. The html file contains links with special prefixes (displayator-list: & displayator-image). If the html page is opened on an iPhone, the user taps on these links and they have the Displayator app installed on their device, the Displayator app will launch and offer the user :

• if the user taps on the list link, she will be presented with the list of all the Displayables availables on the list.
• if the user taps on the image link, he will be presented with the option to download this particular displayable.

Here is how to generate the web page and associated files for th displayables loaded in the Displayable Creator:

1. Select “open”
2. Click on the “Export…” button at the bottom of the application.
3. Select the directory in which all your displayables will be copied.
4. Click save.

You can then upload this directory to a website and share the link with your friends :-)

Credits and License

This app is licensed under the GPL v3. The source code is available on github.

It depends on the following libraries, which have their own licenses:

• Jetty, a web server and servlet container.
• SQLite-JDBC, a pure java driver for SQLite.
• JmDNS, a Bonjour/multicast DNS java implementation.
• Maven-Artifact, a Java library used to compare the version numbers.
• Google-gson, a Java library to convert JSON to Java objects and vice-versa.

It also uses icons from multiple icon sets, packaged into a single font file using icomoon.io. Here is a list of the used icons and their origin.

• IcoMoon: hourglass, edit, delete, expand & contract – Free CC BY 3.0
• Entypo: export, dash & help – CC BY-SA 3.0
• WPZOOM Developer Icon Set: eye, zoom in & zoom out – CC BY-SA 3.0
• Silkcons: broadcast & list – CC0
• Broccolidry: save & warning – Arbitrary
• Iconic: preferences – CC BY-SA 3.0