Previewing an image before uploading it using the FileReference class in Flash Player 10

by Peter deHaan on August 25, 2008

in FileFilter, FileReference, beta

The following example shows how you can browse for an image file from your local file system and preview the image before uploading it to a remote webserver by using the FileReference class’s new load() method in Flash Player 10. Once the user has browsed and selected an image from their local machine, you can call the load() method which dispatches a complete event when the image has successfully loaded, at which point you can display the image using a Flex Image control and setting the Image instance’s source property to the FileReference class’s data property (which is a ByteArray).

Full code after the jump.

The following example(s) require Flash Player 10 and the Adobe Flex 4 SDK. To download the Adobe Flash Builder 4 beta, check out the Adobe Flash Builder 4 page on the Adobe Labs site. To download the latest build of the Flex 4 SDK, see http://opensource.adobe.com/wiki/display/flexsdk/Download+Flex+4. For instructions on using the beta Flex 4 SDK in Flex Builder 3, see "Using the beta Flex 4 SDK in Flex Builder 3".

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/08/25/previewing-an-image-before-uploading-it-using-the-filereference-class-in-flash-player-10/ -->
<s:Application name="FileReference_load_test"
        xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/halo"
        xmlns:net="flash.net.*">
 
    <fx:Script>
        <![CDATA[
            import mx.controls.Alert;
            import mx.utils.ObjectUtil;
 
            private function btn_click(evt:MouseEvent):void {
                var arr:Array = [];
                arr.push(new FileFilter("Images", ".gif;*.jpeg;*.jpg;*.png"));
                fileReference.browse(arr);
            }
 
            private function fileReference_select(evt:Event):void {
                fileReference.load();
            }
 
            private function fileReference_complete(evt:Event):void {
                img.source = fileReference.data;
                Alert.show(ObjectUtil.toString(fileReference));
            }
        ]]>
    </fx:Script>
 
    <fx:Declarations>
        <net:FileReference id="fileReference"
                select="fileReference_select(event);"
                complete="fileReference_complete(event);" />
    </fx:Declarations>
 
    <mx:Panel id="panel"
            layout="absolute"
            horizontalCenter="0"
            verticalCenter="0"
            width="500"
            height="300">
        <mx:Image id="img"
                verticalCenter="0"
                horizontalCenter="0"
                maxWidth="200"
                maxHeight="200" />
        <mx:ControlBar>
            <mx:Button id="btn"
                    label="Browse and preview..."
                    click="btn_click(event);" />
            <mx:Button label="Upload..."
                    enabled="false" />
        </mx:ControlBar>
    </mx:Panel>
 
</s:Application>

View source is enabled in the following example.

For more information on the new FileReference capabilities in Flash Player 10, see the Flex Gumbo documentation at http://livedocs.adobe.com/flex/gumbo/langref/flash/net/FileReference.html.

This entry is based on a beta version of the Flex 4 SDK and therefore is very likely to change as development of the Flex SDK continues. The API can (and will) change causing examples to possibly not compile in newer versions of the Flex 4 SDK.

{ 45 comments… read them below or add one }

1 sergio August 26, 2008 at 12:56 am

thanks!
btw why don’t colorize code my Flex Builder 3 (with installed Gumbo SDK) in <Script/> block?
also code completion do not work too.
i gues is for sake of xmlns="http://ns.adobe.com/mxml/2009"
can i fix it some how?

Reply

2 Kevin Eleven August 26, 2008 at 10:31 am

Nice to not have to actually upload the images before displaying them! ( I had to do that using v9 )

Reply

3 Geert September 12, 2008 at 8:00 am

How would you do this in Flash player 9 exactly?

Reply

4 peterd September 12, 2008 at 8:10 am

Geert,

In Flash Player 9, you’d need to upgrade to Flash Player 10. (It’s a new feature in Flash Player 10)

Peter

Reply

5 Geert September 12, 2008 at 12:29 pm

Hi Peter,

Yes I understand. But my question was how you can preview the image an image before uploading it in Flash player 9 (not using the new Flash player 10). I’ve been looking for an example, but couldn’t find one up till now.

Reply

6 peterd September 12, 2008 at 4:06 pm

Geert,

As far as I know, this is not possible in Flash Player 9, it was a new API/feature added in Flash Player 10.

Peter

Reply

7 acidguy October 3, 2008 at 7:04 pm

possible to do with SDK3????…..

Reply

8 peterd October 3, 2008 at 8:54 pm

acidguy,

I do not think this is possible with the Flex 3 SDK. Although you could try downloading the latest Flex 3.2 SDK and running this with Flash Player 10.

Peter

Reply

9 Stormbreaker November 16, 2008 at 9:53 am

peterd,

this is possible in SDK 3.2 . I just had to do something like this and it works just fine!

Reply

10 Pushkar December 15, 2009 at 8:32 am

What exactly did you do to emulate this? Is there a way to create a thumbnail size preview this quick without having a thumbnail sized file along with a large file?

Reply

11 deenalex December 2, 2008 at 11:58 pm

Hi Everyone,

Can any one help me to convert any type of Video files into .flv format (i.e) flash video format.

I mean, if we browse and select any type of video, it (Flex Program) should convert it to .flv format.

Thanks in Advance……

Reply

12 Ryan Pieszak December 7, 2008 at 12:43 am

Hey Peter,

Is there anyway to get the width and height of the image that’s loaded?

Thanks,
Ryan

Reply

13 Peter deHaan December 7, 2008 at 1:45 am

Ryan Pieszak,

Sure. If you’re sure the user selected an image, you could display the loaded ByteArray object into an Image control or Loader and then get the width/height (or contentWidth/contentHeight) after the Image/Loader has finished loading.

Something like this if you’re using a Loader:

private function fileReference_complete(evt:Event):void {
    img.source = fileReference.data;
    var ldr:Loader = new Loader();
    ldr.contentLoaderInfo.addEventListener(Event.COMPLETE, ldr_complete);
    ldr.loadBytes(fileReference.data);
}

private function ldr_complete(evt:Event):void {
    trace(evt.currentTarget.width, evt.currentTarget.height);
}

If you’re using the Image tag in the big example above, you could try something like the following:

<Image id="img"
        verticalCenter="0"
        horizontalCenter="0"
        maxWidth="200"
        maxHeight="200"
        complete="trace(img.contentWidth, img.contentHeight);" />

Hope that helps, Happy Flexing!
Peter

Reply

14 Ryan Pieszak December 7, 2008 at 3:58 pm

Bingo! I was headed towards the second example, but trying to use img.width and img.height, and they weren’t giving me what I need. Thanks a lot for posting the examples!

Reply

15 johnny December 23, 2008 at 3:25 am

Hello. I followed all the steps above and everything seemed to go well until I copy-pasted your code. Whatever I do it gives me a few errors. The problem is that although I’ve been using Flash & as3 for a while this is my first Flex project. Any help would be greatly appreciated. The main three errors are that Flex can’t find mx: Button, Image and Panel.
The last error occurs when I click on the design tab. An error saying “An unknown item is declared as the root of your MXML document. Switch to source mode to correct it”.

I have Adobe Flex builder 3 installed and got the latest version of Gumbo Flex SDK (nightly build). Also I added manually the SDK, checked the export for flash player 10 and downloaded the ocx needed for that flash player (I had only Flash CS3 so flash player 9). :-)

I hope I was clear enough. :-)

Reply

16 Scarlet sail December 28, 2008 at 7:00 pm

Hi Peter,

I am having the same problem like johnny’s. I also followed those step but when I tried to run your code, it returned some errors in the problem window:
//——————–
Could not resolve to a component implementation.
Could not resolve to a component implementation.
Could not resolve to a component implementation.
//——————–

In addition, when I set the RUN mode to call SWF for previewing, it also prompted me the following errors:

//——————–
VerifyError: Error #1053: Illegal override of scaleZ in mx.core.UIComponent.

at flash.display::MovieClip/nextFrame()
at mx.managers::SystemManager/deferredNextFrame()[E:\dev\gumbo_alpha\frameworks\projects\framework\src\mx\managers\SystemManager.as:318]
at mx.managers::SystemManager/preloader_initProgressHandler()[E:\dev\gumbo_alpha\frameworks\projects\framework\src\mx\managers\SystemManager.as:2947]
at flash.events::EventDispatcher/dispatchEventFunction()
at flash.events::EventDispatcher/dispatchEvent()
at mx.preloaders::Preloader/timerHandler()[E:\dev\gumbo_alpha\frameworks\projects\framework\src\mx\preloaders\Preloader.as:398]
at flash.utils::Timer/_timerDispatch()
at flash.utils::Timer/tick()
//——————–

I don’t know how to solve this, please help. Thank you so much!

Reply

17 Scarlet sail December 28, 2008 at 7:03 pm

Oh what happened with “, ,” tags, they didn’t display…I mean the first 3 error messages were about those.

Reply

18 pao January 4, 2009 at 9:00 am

there’s an error..it wont compile due to the application..could you please check why this is..i already copied the mxml and installed the gumbo sdk

Reply

19 randygland January 7, 2009 at 8:46 am

then how do u upload the user’s selected JPG!!?

Reply

20 gotjosh January 9, 2009 at 4:09 am

Are there known issues with this on Mac??

Reply

21 aap January 26, 2009 at 9:54 pm

Hi,
Can we use the bytearray from File reference object and use the thumbnail information in the JPEG to show preview of image of size>50MB.

Reply

22 suresh February 6, 2009 at 12:33 am

Please Help

Me i wanted to upload a jpeg file from the server crop it to the restricted size, user can keep the cropping size any where on the picture so that the particular thing is saved when we save it

I am planning to do the above, i am a great fan of urs, i learn things from your site, but i am into trouble tried googling, various things but could not found out, so finally ended up beliving you can help me.

Please suggest me something, i am facing issues with the above eg, even though i have flex builder 3.02, flashplayer 10 and flex sdk flex_sdk_4.0.0.4845

i am facing the following errors

A unknown item is declared as the root of your MXML document.Switch to source mode to correct it

The prefix “net” for element “net:FileReference” is not bound.

Reply

23 suresh February 8, 2009 at 11:15 pm

Dear Peter,

I was checking the site from Friday night more than 10 times , I know you ll be busy.
Please let me know the solution once you are done :-) i am facing the bug.
Thanks in advance

Suresh

Reply

24 Ibrahim Ersoy February 13, 2009 at 7:25 pm

hey Thanks for the source code.But how can i convert it to Flex 2? i have a project and cant upgrade to flex 3 right now. Any option how can i do this in Flex 2?

Thank u so much

Reply

25 Craig February 20, 2009 at 9:09 am

Really nice

Reply

26 Garth Braithwaite February 20, 2009 at 6:40 pm

Very nice. I’ll be playing around with it.

Reply

27 ropo February 27, 2009 at 7:02 am

If Flex Builder tells you that .load() is undefined you have to select the correct SDK

!AND!

check “Require flash player version 10.0.0″

Reply

28 Jasen Burkett April 5, 2009 at 7:45 pm

is there any app out there or tutorial for as3? and flash? not flex?

thanks

here is a good one for you.

I have used countless flash as3 uploaders. they all work.
however, when flash goes to retrieve the image and show it in
a photo gallery, or news slider, flash for some reason can not
see that the image is there, and so it throws a error.

if I upload the images by hand using ftp, flash has no problems
seeing the images on the server. why is that?

Reply

29 denns April 14, 2009 at 4:12 am

hi, i tried this using a filereferencelist for uploading multiple files, but now there is the problem that if i take bigger files (like from a digital camera) the browser will use about 1GB of RAM. Is there any possibility to reduce the ram usage somehow?? any different kind of loading the picture or downscale it somehow??

Reply

30 kamrul April 19, 2009 at 1:00 pm

i am very bigenner in flex. i am trying to load image using your reference but it showes some error when i complile it. pls can someone help me how can i do it……

Reply

31 Ady Levy June 7, 2009 at 2:33 pm

i’ve released a source code for image preview and manipulation before upload + php script for image reciving in server.

check out : http://www.adylevy.com/index.php/2009/06/07/client-side-image-resize-flash-cs4-filereferencedata/

Ady.

Reply

32 Gilbert July 2, 2009 at 1:44 pm

Peter,

I tested it on Flex 3.3 and it works fine for images.

Is it possible to load a video with a similar method?
If so, how can be done?

I tried, but the fileReference.data is a ByteArray and the video.source expects a String.

Thanks,

Gilbert

Reply

33 Mike July 8, 2009 at 11:07 am

Thank you for the post.

BTW. This method works just fine for Flex 3.3. Just make sure you change your ‘Requires Flash Player Version’ to at least 10.0.0.

Reply

34 Tina September 6, 2009 at 10:12 am

Hi,
I have Flex builder 3 and I also installed Adobe Flash Builder Beta SDK Command Prompt to get SDK 4.0, and I hoped that than I will be able to run this example. But there’s an error

Unknown Flex SDK: “Flex 4.0.0.2968″ FileReference_load_test Unknown 1252256102796 5

What’s wrong? Can anybody help me?

Tina

Reply

35 Peter deHaan September 6, 2009 at 3:41 pm

@Tina,

Flex 4.0.0.2968 is a fairly old SDK. I’d recommend downloading a recent build from http://opensource.adobe.com/wiki/display/flexsdk/Download+Flex+4 and adding the SDK to Flex Builder 3 or Flash Builder 4 beta with Flex 4.0.0.10008 or higher.

For more information, see “Using the beta Flex 4 SDK in Flex Builder 3″, or to download the Adobe Flash Builder 4 beta, see http://labs.adobe.com/technologies/flashbuilder4/ (and newer versions of the Flex 4 SDK can be found at http://opensource.adobe.com/wiki/display/flexsdk/Download+Flex+4.

Peter

Reply

36 Bragadeesh September 16, 2009 at 3:13 am

Hey buddy,

This is a cool article. Thanks!
Cant I load Bitmap .bmp images??! I tried using a loader, but I got the following error

Error #2044: Unhandled IOErrorEvent:. text=Error #2124: Loaded file is an unknown type.

Thanks,
Bragadeesh.

Reply

37 Peter deHaan September 16, 2009 at 7:59 am

@Bragadeesh,

I don’t believe that .BMP is supported by Flash Player. I think it only loads .GIF, .JPEG, and .PNG files directly.

Peter

Reply

38 Bragadeesh September 16, 2009 at 11:51 am

Oh.. Can you suggest a workaround to make them(.bmp .tiff) support as well?
Any hint is greatly appreciated Peter.

Thanks,
Braga

39 Scott F. November 17, 2009 at 9:30 am

Hey guys,
I was curious about the same thing as Bragadeesh. Has anyone found a quick way to load .bmp images directly? An example or a link to a description would be great.
Thanks,
Scott

40 suganya October 5, 2009 at 10:24 pm

Hi,
Ur code is very nice.
when i copy and paste ur code it shows error- what i have to change in code
Could not resolve to a component implementation.

Thanks in advance..

Reply

41 Peter deHaan October 6, 2009 at 9:01 am

@suganya,

I updated the example to work with the latest Flex 4.0 beta SDK.

Peter

Reply

42 Insane User November 5, 2009 at 6:55 am

I am using Ubuntu with Eclipse, how could I experiment with Flex 4.0 SDK?

Reply

43 Peter deHaan November 5, 2009 at 8:11 am

@Insane User,

I believe you can download an Adobe Flex Builder Linux Alpha from http://labs.adobe.com/downloads/flexbuilder_linux.html, then you could try downloading the latest Flex 4.0 beta SDK from http://opensource.adobe.com/wiki/display/flexsdk/Download+Flex+4 and try to add it to Flex Builder. I’ve never tried Linux so I cannot comment on whether that would work or not though, but it may be enough to get you started. Otherwise, you could download the Flex 4.0 beta SDK from the previous URL and try compiling via the command line using MXMLC.

Peter

Reply

44 Rafal December 2, 2009 at 7:21 am

How to load *.SWF file without getting error:

SecurityError: Error #3015: Loader.loadBytes() is not permitted to load content with executable code.

Thanks for any help.

Reply

45 neenu February 7, 2010 at 8:34 pm

how to resize the image and then upload the modified image to server finally?

Reply

Leave a Comment

Sorry, this blog is terrible at eating HTML comments.
If you're pasting any HTML/XML/MXML code, you need to convert your < characters to &lt; and your > characters to &gt; .

You can use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong> <pre lang="" line="" escaped="">

Anti-Spam Protection by WP-SpamFree

Previous post:

Next post: