FullScreen API For Processing v 0.97 (changes)

Download!

Hey there! I am a library for Processing for better fullscreen support. Download me now! → all versions
p.s. i do crash sometimes. if you think you can help just send me a message in the processing discourse section.

Javadocs

Online javadoc reference here.

Short Reference

fs = new FullScreen(this)

Creates a new fullscreen object.

fs = new SoftFullScreen(this)

Will create a big window without frames that overlays the screen. This will allow you create a sketch that is dual screen. However, be aware that you'll have to disable screensaver, app notifications and active corners yourself! Also you won't be able to change the resolution.

fs.enter() / fs.leave()

Enters / leaves fullscreen mode.

fs.setResolution(x, y)

Changes the resolution if you are in fullscreen mode. If not it memorizes the resolution and sets it the next time you enter fullscreen mode. By default it will try to use the sketch size as resolution.

fs.setShortcutsEnabled(true/false)

Enables/disables keyboard shortcuts.

To enter/leave fullscreen mode
Windows: Alt+Enter, Ctrl+F
Linux: Ctrl+F
OS X: ⌘+F
ESC: leave fullscreen / exit application

Shortcuts are enabled by default!

Install

Download the file fullscreen.zip and extract it to <processing-sketches>/libraries/.

You can also download fullscreen-src.zip if you wanna take a look at the sourcecode. Remember: It's GPL, if you make usefull changes let the world know about it!

Example Usage

import fullscreen.*; 

FullScreen fs; 

void setup(){
  // set size to 640x480
  size(640, 480);
  
  // 5 fps
  frameRate(5);

  // Create the fullscreen object
  fs = new FullScreen(this); 
  
  // enter fullscreen mode
  fs.enter(); 
}


void draw(){
  background(0);
  
  // Do your fancy drawing here...
  for(int i = 0; i < 10; i++){
    fill(
      random(255),
      random(255),
      random(255)
    );

    rect(
      i*10, i*10,
      width - i*20, height - i*20
    ); 
  }
}

Feedback

Does the fullscreen api sometimes make your sketch crash? Do you wish it'd be easier to use? Any other annoying things you noticed? Suggestions? Or are you just happy? Leave a message!

→ Wanna read comments of previous versions?

25 Oct 2007, 16:39 Hansi I'll go first... OpenGL support is still horrible. It works best on OsX where I haven't seen any problems. On windows it sometimes makes the colors crazy. On linux... no idea.

27 Oct 2007, 03:24 Decinoge Hi. I'm a discourse user myself and I've been using your API for quite some time, and thank god it exists.

You ask to report any kind of error, specialy with OpenGL.
Well, i actualy NEED to use OpenGL and i've noticed since the early versions about the blank images/font problem.

I have to report that i'm still having that error. Still just when changing modes. This might not sound wierd to you, but i only get that problem in certain images. imagine i have 10 images. on the first change 3 get blank, and on the next change, tree more get blank again, never changing back again.

You have a good thing goin on in there, and i wich you the best of luck with it.
Stay cool.

27 Oct 2007, 03:27 Decinoge Hi. I've been using your API for quite some time, and thank god it exists. You ask to report any kind of error, specialy with OpenGL. Well, i actualy NEED to use OpenGL and i've noticed since the early versions about the blank images/font problem. I have to report that i'm still having that error. Still just when changing modes. This might not sound wierd to you, but i only get that problem in certain images. imagine i have 10 images. on the first change 3 get blank, and on the next change, tree more get blank again, never changing back again. You have a good thing goin on in there, and i wich you the best of luck with it. Stay cool. [PS]sorry the double posting, but i got some kind of error.

27 Oct 2007, 17:33 Equinoxe I can't get the API to load in my sketches. I am sure I have placed the fullscreen.jar file in the correct lib folder and processing still says: /tmp/build14130.tmp/Temporary_8930_6710.java:1:118:1:127: Semantic Error: You need to modify your classpath, sourcepath, bootclasspath, and/or extdirs setup. Jikes could not find package "fullscreen" in:

Any idea?

28 Oct 2007, 16:51 Hansi @equinoxe
Hey, hope you could already fix your problems. If not just mail me to hui-ui-ui@superduper.org and we'll hopefully find a cause for this ...

2 Nov 2007, 12:50 test test

21 Nov 2007, 12:37 kim, http://www.kaubonschen.com hi hansi,

i am working on an application with 2 windows. i used the code from smallfly in this thread:

http://processing.org/discourse/yabb_beta/YaBB.cgi?board=OpenGL;action=display;num=1184689730

do you think it is possible to add the fullscreen mode to the second window???

king regards kim

1 Dec 2007, 17:03 JustNick Hi, this is a fairly simple thing however would you be able to add a simple method to disable the shortcuts within your library. There are times when I don't want my program to close from simply pressing the ESC key.

11 Dec 2007, 21:49 MikeMcC, http://www.mike-mccracken.com/ Thanks so much or this library. I thought I should report that on my MacBook fs.leave() (as well as pressing Esc) does not exit fullscreen mode gracefully. It just goes black and remains at the fs resolution. The mouse is present, but otherwise you can't really do anything. Cmd-Alt-Esc will get you out of that, though.

Also, have you considered putting this on sourceforge? You might enlist some free help debugging or writing javadocs or what not.

11 Dec 2007, 21:53 MikeMcC, http://www.mike-mccracken.com/ My bad - leave() / Esc actually does work in my application, but in the demo code above it does the behavior I described.

17 Dec 2007, 12:09 liquid, http://www.interactive-china.net thank you for this library,but still doesn't support Opengl very well(under xp),i'm using opengl quit often.

again,thank you so much for this great library!

20 Dec 2007, 09:39 eric, http://www.sigma6.ch Hey, I've just discovered your app few minutes ago, it's nice as the trick from processing doesn't work for me (http://processing.org/learning/3d/fullscreenapp.html)
I was wondering if it would be possible to choose wich videocard to use for fullscreen in the case of a macbookpro with a second screen or macpro with several videocards?!

Thanks again for you library, it's really helpful!

31 Jan 2008, 12:32 asd asd

13 Feb 2008, 21:17 Ollie, http://ollieglass.com Thanks for the library, it's working fine for me on an iBook with OS X 10.4.

Would be great to have a method to hide the mouse pointer, any chance of adding this?

17 Feb 2008, 12:36 Mouse Cursor Processing already has built in functionality for showing/hiding the cursor. Something like noCursor().

26 Feb 2008, 22:13 Kevin Cannon, http://www.multiblah.com Got this working well with OpenGL on my Macbook and my Windows XP PC.

Getting problems whem I'm running it with network code though later on. I think maybe the delay it takes to switch into FS mode conflicts somehow with the socket connections stuff. Seems to work is I switch into FS in the setup() function, but I can't toggle between fullscreen and windowed without it crashing. FYI, this is the error I get:
java.lang.reflect.InvocationTargetException
at sun.reflect.GeneratedMethodAccessor2.invoke(Unknown Source)

Thanks for working on this as it really is invaluable! :)

16 Mar 2008, 04:37 Robert, http://www.heavyobjects.com Thanks for releasing the source, it is a good learning tool.

31 Mar 2008, 20:28 Paul The noCursor() function works great in windowed mode, but as soon as my program enters full screen the cursor pops back up :(

Does anyone know if this is a fullscreen bug? or am I probably just doing something wrong?

2 Apr 2008, 16:03 Cursor issue You can add this at the end of setup() to hide the mouse cursor

//
try {
Robot robot = new Robot();
robot.mouseMove(int(width),int(height));
}
catch (AWTException e) {
}
//

3 Apr 2008, 04:36 Paul That'd be excellent if I weren't already using that exact code but with "width/2" and "height/2" :P

I have found that if I move the mouse fast enough to get to the top of the screen before it resets to the center then it will disappear... but not normally :/

3 Apr 2008, 04:36 Paul Not to sound snippy, I do appreciate your help
Thank you

10 Apr 2008, 22:16 Peter is ther a way to have it "top aligned" meaning not in the dead center if the size is smaller than the screen resolution ? thanks for this library !

18 Apr 2008, 05:35 Steve Great library! Thanks for creating this! I'm also having trouble hiding the cursor. I manually set the screen resolution and then noCursor() stopped working. I tried the Robot() code above, but that didn't resolve the problem. Any ideas?

18 Apr 2008, 06:37 Steve Ok. This will work, but placing noCursor() anywhere else does not seem to work:

fs = new FullScreen(this);
noCursor();
fs.setResolution(1024,768);

I used setResolution() so that the image is drawn properly on the screen. Otherwise it's drawn on the bottom right of the screen.

21 Apr 2008, 13:39 Mark I have noticed a bug when using OpenGL on OS X (not tested on win/linux).

If you switch to fullscreen when your Desktop resolution is the same or lower than your sketch/app resolution, the top of the screen has a black strip that is exactly the same size as the finder menu bar.

21 Apr 2008, 13:42 Mark Another bug:

Can't use both FasterMovie Class and Fullscreen API at the same time.

Semantic Error: Type "FullScreen" is imported on demand from package "fullscreen" and package "quicktime.std.movies".

21 Apr 2008, 13:58 Mark Found a way to wrokaround the problem of FasterMovie Class and Fullscreen

Just remove this line:

import quicktime.std.movies.*;

and add these two lines:

import quicktime.std.movies.MovieDrawingComplete;
import quicktime.std.movies.MovieController;
.

13 May 2008, 23:32 Hansi, http://www.superduper.org @mark thanks for the note on the FasterMovie class,
unfortunately i won't be able to fix this without having to rename the base class... :(

@steve i know this is a nasty solution, but have you tried adding noCursor() to the draw method?

13 May 2008, 23:45 Hansi Uh, we have a new version.

8 Oct 2008, 03:10 hansi, http://www.superduper.org I hate fighting spam bots.

9 Oct 2008, 20:07 blausand, http://www.silvertree.de Fine Done!
How far is the implementation of the parameter for setting the correct Adapter#?
I have one monitor switcheing the resolution while the other one is displaying the app...

[OT] Do you prefer to discuss this on the processing forum?

12 Oct 2008, 15:00 Karl Hi!

Is there any chance you could upload the JNI hide_menu native library code to the repository? I've been searching for a way to hide the Mac menu bar in Java for the longest time!

Thanks in advance!

Karl

13 Oct 2008, 15:39 Hansi, http://www.superduper.org @blausand: there is an option to specify the screen number
fs = new FullScreen( this, screenNr );

however, there are a bunch of problems with this: first the code isn't tested, cause i'm on a single screen environment. second afaik most operating systems make the second screen go blank if one of them switches to fullscreen. you might be able to get around this by using two fullscreen-windows instead of just one, something like

FullScreen fs1, fs2;

void setup(){
size( ... );
fs1 = new FullScreen( this, 0 ); // use monitor 0
new ExampleFrame(); // create second sketch
}

void draw(){ ... }

void displayChanged(){
fs2.setFullScreen( fs1.isFullScreen() );
}

// code for the second applet
public class ExampleFrame extends Frame {

public ExampleFrame() {
super("Embedded PApplet");

setLayout(new BorderLayout());
PApplet embed = new Embedded();
add(embed, BorderLayout.CENTER);

embed.init();
}
}

public class Embedded extends PApplet {
public void setup() {
size(..);
fs2 = new FullScreen( this, 1 ); // 1
}

public void draw() {
}

public void displayChanged(){
fs1.setFullScreen( fs2.isFullScreen() );
}
}

this is a nasty workaround, but it *might* work.

13 Oct 2008, 15:47 Hansi, http://www.superduper.org @Karl:
Hey! I never managed to get it to work in eclipse, but download the xcode source from here:
http://www.superduper.org/processing/fullscreen_api/versions/hide_menubar.zip

hope it compiles :)

10 Nov 2008, 20:33 Celine I am running a fullscreen sketch and using the noCursor() command in my Draw() routine, but I still occasionally get a system cursor showing up. Help!

More info: I am using Processing 0135 Beta, the FullScreen .96 library and the ProControll library. I have 6 USB mice attached and am getting multiple spatial input streams through ProControll.

Thanks to anyone who can help...

10 Nov 2008, 21:03 Celine To add to above message, I am also getting the following when I run my sketch:
FullScreen API: Display mode not supported: 1440x980
Although 1440x980 is the resolution of my MacBook Pro display.

13 Nov 2008, 21:41 Hansi, http://www.superduper.org @Celine
Hey there!

For the cursor, try this code from here to create a transparent cursor.
http://www.rgagnon.com/javadetails/java-0440.html
Then do a setCursor( transparentCursor ) inside draw.
I haven't looked into why this happens with processing's noCursor(), but I remember having the same issues.

For the display mode: My macbook pro has 1440x900, but assuming you're have one with a different resolution this is odd. Does it work for you to change to other resolutions? (Say 800x600)

all the best,
hansi.

14 Nov 2008, 07:13 Mike The cursor problem occurs when the mouse is at the very top of the screen. It seems that there are a few pixels of space above the active java window that reveal the cursor again. Is there a way to use some of the osx-java scripts to help this?
http://developer.apple.com/documentation/Java/Conceptual/JavaPropVMInfoRef/Articles/JavaSystemProperties.html
ex: apple.awt.fullscreenhidecursor

14 Nov 2008, 18:27 Mike It seems that the java commands for removing decorations and going full screen leave an invisible space at the top of the screen when running. I changed the background color to gray and noticed a slightly darker gray area at the top. When I rolled over it the mouse would appear and then disappear when brought back into the active space. So, is there a way to completely get rid of the phantom app bar at the top. I've looked at alot of documentation regarding frame.setLocation and frame.setUndecorated. Any help would be great.

23 Nov 2008, 13:24 Hansi, http://www.superduper.org @Mike:

Sorry, still don't have time to look into this, hopefuly next week...

2 Feb 2009, 21:57 Mtf Hi there. Great API, thanks for your hard work!

Unfortunately, I'm also having trouble displaying a particular resolution, 1366x768. I get this error:

FullScreen API: Display mode not supported: 1366x768

Other resolutions seem to work fine though. (640x480, 1680x1050 for example.) Any ideas?

Thanks!

18 Feb 2009, 17:24 hansi, http://www.superduper.org @mtf - can you run the "list_resolutions" examples included in the download and post the console output here? (open processing, then from the menu choose file > sketchbook > libraries > fullscreen > examples > d_list_resolutions)

2 Apr 2009, 17:05 Akito Hi Hansi,

I am trying to set up fullscreen under eclipse environment and I am keep getting this error message:

Exception in thread "Animation Thread" java.lang.NullPointerException
at fullscreen.FullScreen.(Unknown Source)
at fullscreen.FullScreen.(Unknown Source)

I read one of the threads here:
http://processing.org/discourse/yabb2/YaBB.pl?num=1150213949/53

and you suggest that fullscreen needs to be up-to-date corresponding to processing version. But I don't think the error I am getting is related to the version because fullscreen runs fine within processing application. When I try to use fullscreen in eclipse environment then I get this problem.

So my question is, is there a specific set up I need to have in order to use fullscreen under eclipse? Are there any jar files that needs to be included with fullscreen? Any suggestion is appreciated. Thank you for your time.

~Akito

3 Apr 2009, 04:51 Akito Sorry for the ealier post. I didn't read the limitations carefully. But now I understand that fullscreen only works for applications (not for applets).

5 Apr 2009, 23:13 hansi Hey Akito!

I'm very interessted in tracking down this error...
Can you email me? (my address is at the bottom of the page)...

best, hansi,-

30 Apr 2009, 15:50 Jan, http://www.freeduino.de i know it's a very noob question, but i can't get it installed. don't understand the folder logic? can anyone point me to some help how to better unterstand how to place the library file in the folder structure.

10 May 2009, 18:26 Hansi Raber @Jan

Download the fullscreen.zip file from above, when you extract it you should get a folder "fullscreen".

Now locate your sketchbook folder (usually $home/Documents/Processing). Inside that folder you should find a folder called "libraries". If it doesn't exist just create it. Then drop the fullscreen folder from above inside the libraries folder. Done :)
It's basically the same for any library you want to install....

8 Jun 2009, 05:03 Keston, http://audiocookbook.org/ Hi Hansi. Great API, thanks! One question, on OSX Is there a way for SoftFullScreen(this) to display the window on a second monitor that is not the primary monitor (does not have the menu bar and dock active)? When I enter full screen using this method it reverts to the primary monitor regardless of where the application window was active. Thanks!

9 Jun 2009, 18:26 Iching, http://tao.xs4all.nl Hi Hansi, the fullscreen library is giving trouble in P5 1.0.4. and 1.0.5. When installed it gives 'no jogl in java.library.path' errors. Even in code where you don't use the library at all ( not imported ). Remove it from the libraries directory and everything works fine again. No problem with P5 1.0.3.
Thnx

Warnings & Limitations

Only works for applications (not for applets)
This package conflicts with processings "present" option
The ESC key exists the application, not fullscreen mode
This size of the sketch can not be scaled to screen size in fullscreen mode
Requires Java 1.4 to work
It seems not every implementation of Java on Linux gives you proper fullscreen support, you might not be able to switch resolution
Some people report random crashes, if you get on of those please get in touch with me!

Thanks!

Thanks to gna.org for hosting for this project and a big thanks to everybody who sent problems and suggestions to me!

Developers welcome!

If you're interrested in helping develop this api further or you wanna help testing new experimental versions please visit the gna project page at https://gna.org/projects/fullscreen-p5/. You'll also find svn access there.

hansi raber, www.superduper.org Last change: mar 13, 2009.