Windowed & Fullscreen Mode

After creating a Screen, you must add it's Canvas to a Frame and then either keep the Frame in Windowed Mode or set it to use Full-Screen Exclusive Mode. Due to VTerminal's complex rendering code, as well as the number of steps required to properly set up a Frame and Canvas for both modes, the Screen class includes two functions that handle creation of the Frame and setting it to use the mode of your choice.

I do not recommend writing your own code to replace the addCanvasToFrame() and addCanvasToFullScreenFrame(GraphicsDevice) functions, unless you have a solid grasp of how VTerminal works and of Java's AWT & Swing APIs.

Links

• JavaDoc documentation for the Canvas class.
• JavaDoc documentation for the Frame class.
• JavaDoc documentation for the GraphicsDevice class.
• JavaDoc documentation for the addCanvasToFrame() function.
• JavaDoc documentation for the addCanvasToFullScreenFrame(GraphicsDevice)function .
• Oracle's tutorial for Full-Screen Exclusive Mode.
• A guide on how to create a Screen.

addCanvasToFrame()

This function adds a Screen to a Frame that's in Windowed Mode.

addCanvasToFullScreenFrame(GraphicsDevice)

When enabling Full-Screen Exclusive Mode, you must specify the GraphicsDevice (aka Monitor) on which the full-screened Frame will be displayed.

The following example shows how to display the full-screened Frame on the user's primary monitor.

The following example shows how to retrieve an array, containing an entry for each of the user's monitors, and how to display the full-screened Frame on the user's secondary monitor.