# Create a Nifty Polaroid Photo Viewer With Flash and Photoshop

Ever wanted to make a manageable and beautiful photo viewer app? In this tutorial, I'll show you how to design and code a nifty Polaroid photo viewer, focusing on the design and tweening.

## Final Result Preview

Let's take a look at the final result we will be working towards:

## Section 1: Organization

In this section we'll discuss our folder structure, also we'll acquire our stock imagery.

## Step 1: Creating Our Folders

First let's create a folder in which our project will be located. We'll name it "Polaroid Viewer".

Afterwards just copy this folder structure:

## Step 2: Understanding Our Folder Structure

When creating very visual projects, it's very important to first really know what you want to design. Inside the Design folder I always have my visual concepts and also in the Design folder I edit the images I'll need for a project.

After I've finished working on my concept I proceed to making a working product, I do this inside the Project folder. Inside the Project folder is the very known bin, lib and src folder structure:

• bin: Everything which is being exported and is needed to launch the final product, including data assets.
• lib: Our Flash documents.
• src: All our code, our own classes, as well as other frameworks.

## Step 3: Acquire Stock Imagery

Now that we've created our folders, let's proceed to the images. In this tutorial we'll need at least two images:

You'll need a Stock Xchange account to download these images, if you don't yet have one, you should sign up! It's a website filled with free stock imagery!

Also we'll need images to place inside the polaroid frames. Here's a list of images which I've used, but feel free to use your own images.

## Section 2: Design

In this section we're going to edit our stock images. After doing so, we'll import these images inside our Flash document, which we'll create later.

We're going to edit our images with Photoshop, I'll be using CS5, however you can always use older versions. If you're not so confident in your Photoshop skills, you can download the images which I've already edited. Just download the source files from this tutorial, and you can find the images inside the Edited Images folder.

## Step 4: Preparing Our Wooden Floor

In the final example all our polaroid pictures lie on a wooden floor. We're now going to create this background.

Create a New Document in Photoshop with the dimensions 600x600px.

Add the wooden texture image to the document. Scale it so you're pleased with the final result.

I've also added a Gradient Map, setting the colors to black and white.

Lastly I've changed the gradient map's transition to 80%. To do so, click on one of the lower arrows, and afterwards click on the dot in the middle of the gradient. Drag this dot to 80%.

And voila! We've created our wooden background! Save it as a Photoshop Document (.psd) in our Design folder, and name it Background.psd.

## Step 5: Preparing the Polaroid Frame

We want to place our own images inside the polaroid frame. We must do two things, we'll first need to remove the polaroid frame from its (white) background, and also we'll need to cut the "photo" part away.

To do this, we'll first create a new 600x600px Photoshop document. Paste the polaroid picture inside the document, scale it down till it fits.

Why do we scale the image down? Because we're creating a 600x600px Flash document, and it's unnecessary to have and load a huge image if we won't even scale it larger than 600 px.

## Step 6: Isolating the Polaroid Frame

Select the pen tool (P) and click around the polaroid frame's outer edge. When working with the Pen tool, be sure to set the Pen tool in its Paths mode.

Press Control + Enter (Windows) or Cmd + Enter (Mac) to select your current path.

With your path selected click on the "Add Layer Mask" button. We've now isolated the polaroid from its background!

## Step 7: Cutting the Photo Part Away From the Polaroid Frame

This step is very similar to Design Step 4. Again select the pen tool, and click around the inner area of the polaroid's frame. Afterwards select the current path with Ctrl + Enter/Cmd + Enter.

Now Alt-click on the mask in the Layers Panel. You're now editing the mask directly.

Select the Marquee tool (M). Right-click your selection and select Fill > Black.

Alt-click again on the mask icon, to return back to our "normal" Layer view. We've successfully edited our mask and now our polaroid is ready for use. Let's save the image as a Photoshop document (.psd), I've named my document Polaroid.psd.

## Section 3: Flash

In this section we're (finally) going to use Flash. We're going to set our Flash document to use the folder bin for exporting, and the folder src for our code. Time to open Flash!

## Step 8: Creating Our Flash Document

Create a new Flash Document (ActionScript 3.0) with Flash Professional. Set the dimensions to 600x600px and the framerate to 24 fps. Set the Document Class to Main. Also change the background to black (#000000). Save it as "Polaroid.fla", inside the lib folder.

## Step 9: Changing Our Publish Settings

Afterwards go to File > Publish Settings, change Polaroid.swf to ../bin/Polaroid.swf, you can uncheck the HTML option. Now everything we export (only a SWF) will be in the bin folder. Do not close the Publish Settings window.

## Step 10: Changing Our Source Path

Click the Flash tab. Afterwards click on the Settings button next to Script: ActionScript 3.0.

Now we can change the source path. You'll see a folder icon with the text ".", change that to "../src".

Flash will use the src folder for all its classes.

## Step 11: Importing Our Graphics to Flash

It's now time to start importing our graphics in to our Flash Document. If you had any trouble with the images, you can always download the source files from this tutorial at the top. There'll be a folder named "Edited Images", inside there'll be the edited images which you can use.

Create a new Flash Document (ActionScript 3.0) with Flash Professional. Set the dimensions to 600x600px and the framerate to 24 fps. Also change the background to black (#000000).

We've saved our images as .psd files because they work so greatly with other Adobe products, like Flash. After creating our document, select File > Import to Library and select Polaroid.psd and Background.psd. After doing so our library looks like this:

## Step 12: Creating Our Background Sprite

Drag Background.psd from the Library to our stage, afterwards convert it to a movie clip. Name it Background, and check the box "Export for ActionScript". Set the base class to flash.display.Sprite. After doing so, you can remove the background again from the stage.

Why did I set Background's base class to Sprite instead of the default base class MovieClip? Because the only difference between a MovieClip and a Sprite is that MovieClips can contain multiple frames, and Sprites cannot. We don't need multiple frames for our Background, so let's set the base class of Background to Sprite.

## Step 13: Creating and Our Polaroid Movie Clip

Just like we did with our background, drag polaroid.psd from the Libary to our stage. Convert it to a movie clip and name it Polaroid, again check the Export for ActionScript box. Set the base class to flash.display.Sprite.

## Step 14: Creating Our Polaroid's Layers

Our Polaroid is still on the stage, double-click it, so we can edit it. So far Polaroid only has one layer, rename this layer to Polaroid Frame.

Create two new Layers, naming them Mask and Image Holder.

## Step 15: Creating the Image Holder

Our Polaroid will contain an image, this image must be displayed somewhere, this will be done in a movie clip named "Image Holder".

Draw a rectangle of approximately the size as the "photo area" of the polaroid, do this in the Image Holder layer. It doesn't matter which color the rectangle will be. After creating this rectangle, convert it to a movie clip, name it "Image Holder".

Give Image Holder an instance name of imageHolder.

Image Holder will contain the images which we will load. Sometimes these images are too big -- take for example a 400x100px image; this image is much too wide, and its edges would extend out of the polaroid. We want to prevent this. Therefore we must hide all imagery which extends outside of the Image Holder's area.

To do this, we must create a mask. A mask tells a layer which part should be displayed, and which part should be hidden.

If we want every image to be displayed inside Image Holder, without any edges protruding, we should set the mask's size to the same dimensions as Image Holder itself.

Copy Image Holder, and paste it in place with Ctrl + Shift + V (Windows) / Cmd + Shift + V (Mac) on the layer Mask. Afterwards break the copied Image Holder with Ctrl + B (Windows) / Cmd + B (Mac).

## Section 4: Code

It's time to start coding, if you had any trouble with the Flash Section, you can just copy the folder Flash Section Completed. Inside that folder is everything you need to start following these steps.

## Step 17: Creating an XML File

To load our images, we'll use an XML file. The XML file will tell our product where the images are located.

Open a text editor and type the following:

You should change IMAGE_1.jpg, IMAGE_2.jpg, etc. to real filenames, which refer to images located inside the bin folder. If you don't have any images, download the images that I mentioned in Step 3.

Save this XML file as images.xml, inside the bin folder.

## Step 18: Which Classes Do We Need?

Before we start coding, it's important to know which tasks our project must do:

• We must load our images from an XML file.
• We must display these images inside a Polaroid.
• We must prevent other Polaroids from zooming in when we are already zoomed in on a Polaroid.

To code all these functionalities in one class would make that class extremely complex, it's better to seperate each task to a different class.

• ImageLoader: Will load the XML file and pass the images to PolaroidHolder.
• PolaroidHolder: When it receives the images, it will create a Polaroid for every image, so it also makes sure that only one Polaroid is zoomed in at a time.
• Polaroid: The image will be displayed inside this class.

## Step 19: Creating Our Main Class

The Main class is the class which Polaroid.fla calls when it gets initiated.

Create a new ActionScript file and name it "Main.as", save it inside the src folder. The Main class looks as follows.

It's so empty because we first need to create our other classes, while we're busy we're going to keep on adding code to the Main class.

## Step 20: Explaining Absolute and Relative File Paths

In this project we're loading several assets: an xml file and various images. We can use relative file paths or absolute paths. Let me explain the difference with an example; we have the following folder structure:

So how do you load image1.jpg, regardless of where Loader.swf is located? This is done with absolute file path loading. The file path starts from the upper core, from the root. If it's on a computer, its root is a hard drive. We're deploying our project online, so the root would be the site server.

## Step 21: Why We Need Absolute File Paths

When our project is done, we'd like to deploy it. Most probably it would be embedded inside an HTML page. There's one small problem. If Loader.swf wants to load, it will load from its current location, from the location of the HTML page. We don't want this, and therefore we must use absolute file path loading.

Now comes the biggest problem, we won't know the location of the HTML file. We need to find the absolute path to the .swf file, and edit that path so we can load our imagery.

We can get the absolute path to the .swf file with root.loaderInfo.url.

It's time to create our ImageLoader class.

## Step 22: Creating Our ImageLoader Class

Create a new ActionScript file and name it ImageLoader.as, save it inside the .src folder. The class looks like this, it has been thoroughly commented:

## Step 23: Improving Our Main Class

Now that we have our ImageLoader class, we can improve our Main class.

## Step 24: Creating Our PolaroidHolder Class

The PolaroidHolder will receive the images as a Vector. After receiving the images, it will create a Polaroid for each image. Let's create our PolaroidHolder class:

In lines 50 and 62, we call the functions mute() and unmute(). Mute makes the Polaroid numb to all events, it won't respond to mouse overs, or clicks. This is precisely what we want when we're zoomed in. We don't want other Polaroids to do anything. After we're zooming out, we want the Polaroids to respond to events; by calling unmute, the Polaroids will respond again to mouse overs and clicks.

## Step 25: Creating Our Polaroid Class

Now it's time to create our most interesting class, our Polaroid class! For this class we'll need the popular tweening library tweener. Download it, and save the library inside the src folder (see this guide for more details).

## Step 26: Adding Our PolaroidHolder to Our Main Class

Make the changes as seen in the code below.

## Step 27: The Result So Far

It seems to work, but it's not very interesting. When zooming in, the user is not "pulled in", our product is not immersive enough. What we need is a background! By chance we created one in Step 4. Time to add our background!

## Step 28: Adding Our Background

We had exported our background with the class Background.

Not only will we add Background as a child of Main, we'll also make Background darken when we're zoomed in, and lighten when we're zoomed out. How do we do this? Whenever a Polaroid is clicked, it dispatches a custom event, zoomIn or zoomOut. We can trace this event, just add event listeners to our Main class, they'll pick up the zoomIn and zoomOut events, and whenever they're picked up, we can tell our Background to lighten or darken:

## Step 29: Looking Back

Tada! We're done, this was quite a tutorial! I hope you guys had fun following this tutorial, and also learnt something from it. Why not play around with the code? You could try adding text fields and somehow display the title of the image. Or use several types of Polaroids. Thanks, and feel free to comment if you have any questions or comments. Keep an eye out for my next tutorial!