Print Screen detection in AIR

Loading ...

Print Screen detection in AIR

Posted by James - 17/04/09 at 09:04:06 am

Here’s a little something I’ve been working on recently – Print Screen support in AIR. It has to be AIR because only AIR allows you to access the OS clipboard, and only AIR seems to have access to the full keyboard. There’s a few things I’ve looked at and various snippets of code, so I’ll cover them in roughly the order I figured it all out…

Print Screen Monitor

Getting your Print Screen data.

This is actually easy enough – use the Clipboard class (available in AIR) .

import flash.desktop.Clipboard; import flash.desktop.ClipboardFormats; import flash.display.BitmapData;

Clipboard.generalClipboard.getData(ClipboardFormats.BITMAP_ FORMAT) as BitmapData;

If we want to use that on the stage, wrap the BitmapData in Bitmap:

new Bitmap(Clipboard.generalClipboard.getData(ClipboardFormats.BITMAP_
FORMAT) as BitmapData);

That’s easy enough, isn’t it? Create a button or whatnot and you can grab your screenshot data. But what if there’s no BitmapData in the clipboard? That’s easy too – use the hasFormat function of the Clipboard class: Clipboard.generalClipboard.hasFormat(ClipboardFormats. BITMAP_FORMAT) returns a boolean value – you’d never guess.

Detecting Print Screen keypresses?

So, how about updating automatically? Well, how about detecting keypresses – if we go have a little look in the AIR documentation [link] you’ll see references to Keyboard.KEYNAME_PRINTSCREEN. Sounds perfect, yes? Just make a key listener?

Well no luck with that – AIR can’t detect all non-glyph printing characters – it detects things like the Ctrl, Alt, Shift keys – but not the Print Screen key. Those events just don’t fire. Makes you wonder what on earth the static constants are in the documentation and the classes for, because as far as I can tell, nothing is ever going to use those events…

Detecting changes to the Clipboard

Ok, so how about this for a solution: We can’t detect the keypress of the Print Screen key – but we could poll the clipboard and watch for changes to it. Mike Chambers’ Volume Monitor class does something similar [link] with watching the local storage drives, so I’ve stolen that idea. I’m not going to go into full explainations of the code, but I’ve put together a PrintScreenMonitor class. It watches the clipboard - dispatching an event when a new screenshot is added to the clipboard, another event when the screenshot changes, and another when the screenshot is removed from the clipboard.

Here’s a look at the implementation;

import couk.psyked.air.printscreen.events.PrintScreenMonitorEvent;
import couk.psyked.air.printscreen.PrintScreenMonitor;

private var monitor:PrintScreenMonitor

private function init():void {
	monitor = new PrintScreenMonitor(100);
	monitor.addEventListener(PrintScreenMonitorEvent.ADD_SCREENSHOT,
updateImage);
	monitor.addEventListener(PrintScreenMonitorEvent.CHANGE_SCREENSHOT,
updateImage);
	monitor.addEventListener(PrintScreenMonitorEvent.REMOVE_SCREENSHOT,
removeImage);
	monitor.watch();
}

private function updateImage(e:PrintScreenMonitorEvent):void {
	image.data = e.bitmap;
}

private function removeImage(e:PrintScreenMonitorEvent):void {
	image.data = "";
}

So, there’s 3 events – the PrintScreenMonitorEvent is the same as a normal event with an additional bitmap parameter and contains a Bitmap object.
Unless of course the event type is a REMOVE_SCREENSHOT event! The only other problematic thing I’ve encountered is scope with the PrintScreenMonitor.
The above example works, and there’s a couple of downloadable examples here.

Downloads / Samples.

Posted by James Ford

Full profile: http://www.psyked.co.uk/about

About the author: James is a Senior New Media Developer at MMT Digital, and has BA(Hons) in Design for Interactive Media from the University of Gloucestershire. He loves designing and producing all sorts of website and Flash-related things, as well as prattling on about technologies. Day-to-day he works with Flash, Dreamweaver, Director, Microsoft Office Sharepoint Server 2007 (MOSS) and in his spare time he mucks about in Flex and Wordpress. Follow James on Twitter.

April 17, 2009 | In Air | 3 Comments

3 Comments »

The PrintScreenMonitor actually works for all types of BITMAP_FORMAT’s. Try copying selections from Photoshop or Paint and you’ll see it appear in the sample application.

It’s a shame there isn’t the functionality to allow developers to detect Print Screen presses, or even capture the screen from within AIR without the use of java [http://blog.everythingflex.com/2008/04/24/do-a-screen-capture-with-adobe-air/].

Comment by Mark — 17 April 2009 #
Hi James,

These events also fires if a user copy’s image data from Photoshop or paint, right? You could check if the bitmap in the clipboard matches the screen size of the user.

Although on Mac you could capture a region, so the logic above won’t work (maybe it should be an option).

Cheers,

Ferdi Koomen
Lead Developer @ De Monsters

Comment by Ferdi Koomen — 20 April 2009 #
That’s a good idea, Ferdi – I think it should be an option yes. You can capture regions in Windows too – or at least you can only capture active windows.

Something to have as an option yes.

Comment by James — 22 April 2009 #