X11::FullScreen - Perl extension for creating a simple borderless window with X
use X11::FullScreen; # Open a handle to the X display 0.0 my $display = X11::Fullscreen::Display->new(":0.0"); # Create a full-screen window my $window = $display->createWindow(); # Sync the X display $display->sync(); # Display a still image $display->displayStill($window, "/path/to/my.png"); # Return any new expose events my @events = $display->checkWindowEvent($window);
Companion to Video::Xine, this module is used for creating simple borderless X windows. In addition, it uses Imlib2 to display still images.
It was primarily developed to provide a no-frills interface to X for use with Video::Xine, as part of the Video::PlaybackMachine project.
The primary class for this package is X11::FullScreen::Display.
Creates a new Display object. $display_string should be a valid display specifier, such as ':0.0'. Example:
$display_string
my $display = X11::FullScreen::Display->new('localhost:0.1');
Returns the number of the display's default screen.
Returns the width in pixels of the screen numbered $screen_number of the current display, or of the default screen if not specified.
$screen_number
Returns the height in pixels of the screen numbered $screen_number of the current display, or of the default screen if not specified.
Returns the pixel aspect of the screen numbered $screen_number of the current display, or of the default screen if not specified. The pixel aspect is calculated by dividing the screen's vertical resolution by its horizontal resolution.
Creates a new X11 window on the display and returns its ID. If $width and $height are not specified, takes up the entire screen.
Displays a still image on the given display on the given window.
Checks for any new event which has occurred to $window. If $event_mask is not specified, defaults to ( ExposureMask | VisibilityChangeMask). This package does not yet have constants for the various event masks available; if you wish to use different masks you are on your own.
$window
$event_mask
Undoubtably. This code is still in alpha state.
The checkWindowEvent() method is currently only useful for checking for expose events, since the method does not provide useful constants for passing event masks to it.
Video::Xine, Video::PlaybackMachine, Xlib
Stephen Nelson, <stephen@cpan.org<gt>
Copyright (C) 2005 by Stephen Nelson
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.5 or, at your option, any later version of Perl 5 you may have available.
To install X11::FullScreen, copy and paste the appropriate command in to your terminal.
cpanm
cpanm X11::FullScreen
CPAN shell
perl -MCPAN -e shell install X11::FullScreen
For more information on module installation, please visit the detailed CPAN module installation guide.