View source for E4/UI/Running the photo demo

[[Image:E4-m1-photo-demo.PNG|thumb|300px|A screenshot of the e4 photo demo.]]
:''The instructions provided on this page were last updated for the e4 1.0M4 milestone.

The '''e4 photo demo''' showcases an e4-based RCP application that allows the user to browse images in their workspace.

==Prerequisites==
*[[E4/Install|e4 SDK installation]]

==Features==
*Shows how [[E4/CSS|CSS]] can be used to skin an application (note that the CSS engine does not have any particular dependencies on e4 technologies and '''can''' be reused in an Eclipse 3.x-based application)

==Setup steps==
[[Image:LaunchPhoto.png|thumb|300px]]
#Download an e4 SDK [http://download.eclipse.org/e4/downloads/ here].
#Unzip/Untar the file as you would with a regular Eclipse SDK download.
#Start up Eclipse.
##If you downloaded the eclipse e4 SDK you can quickly load the demo projects by generating a PSF project, using the menu '''e4>Generate e4 Example Project'''
##Then select the ''/org.eclipse.e4.examples.psf/e4-examples.psf'' file and '''Import PSF Project''' from the context menu.
##skip to step 11
# Start Eclipse with an empty workspace directory.
# Select <i>File > Import...</i> and select <i>CVS > Projects from CVS</i>, click <i>Next</i>.
# Copy the CVS repository location and paste it into the "Host" field to populate the wizard page: <i>:pserver:anonymous@dev.eclipse.org:/cvsroot/eclipse</i>
# You should see "Host: dev.eclipse.org, Repository path: /cvsroot/eclipse, User: anonymous, Connection type: pserver".
# Click Next and select the second option <i>Use an existing module</i>.
# Drill down as follows: <i>e4 > org.eclipse.e4.ui > examples</i> and select <i>org.eclipse.e4.demo.e4photo</i>. Click <b><i>Next</i></b>.
# <b>Important:</b> Do not click Finish just yet. Advance to the last wizard page using Next, then click on <i>Refresh Tags</i>. Select the tag appropriate for your installation (e.g. <i>M3</i>, <i>I20100112-0800</i>, <i>R0_9</i> ... you can find your installation's build tag in the Help > About Eclipse SDK dialog) and click <i>Finish</i>.
# This will check out a project into your workspace. Expand the project in the Package Explorer and open the <i>e4photo.product</i> file.
# Click on the link <i>Launch an Eclipse Application</i> at the bottom left of the <i>e4photo.product</i> file editor. An error will show up.
#Run > Run Configurations...
#Now launch the product from the dialog, it should open.

Click on the <i>Create Album</i> toolbar button or select <i>File > Create Album</i>. The new album location on disk will be printed to your Eclipse console. Just drop a couple (not too many!) of JPEG photos in that directory, then play with the application. Make sure you find a photo with embedded GPS coordinates - when you select it in the <i>Exif</i> view, the <i>Location</i> view will show where the photo was taken using Google Maps. You can find an example photo with GPS coordinates on [https://bugs.eclipse.org/bugs/show_bug.cgi?id=263898 bug 263898].

Then, have a look at the <code>Application.e4xmi</code> file to see how the demo application is configured, and/or look at the source files for the individual pieces (views and command handlers).

==Known issues==
*You may see some syserr output in the console like the following. It is safe to ignore them.

<pre>Unable to find parent with ID "{0}"

Unable to find parent with ID "{0}"</pre>

*When switching between perspectives, the window may become blank. If you switch it back to the previous one and then again, the contents should render.

*The 'Exif' view may not react to selection changes if it is rendered, see {{bugstrike|299755}} for more details.

*On Windows, you may see errors if you have a browser rendered in the 'Location' view. See {{bug|303978}} for more details.

*Contact demo fails to launch from the .product file.  Open the Run Configuration dialog and hit Run, see {{bug|303973}}.