NAME

X11::FullScreen - Perl extension for creating a simple borderless window with X

SYNOPSIS

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);

DESCRIPTION

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.

METHODS

The primary class for this package is X11::FullScreen::Display.

new( $display_string )

Creates a new Display object. $display_string should be a valid display specifier, such as ':0.0'. Example:

my $display = X11::FullScreen::Display->new('localhost:0.1');

getDefaultScreenNumber()

Returns the number of the display's default screen.

getWidth( $screen_number )

Returns the width in pixels of the screen numbered $screen_number of the current display, or of the default screen if not specified.

getHeight( $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.

getPixelAspect( $screen_number )

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.

createWindow( $width, $height )

Creates a new X11 window on the display and returns its ID. If $width and $height are not specified, takes up the entire screen.

displayStill( $window, $image_file, [ $width, $height ] )

Displays a still image on the given display on the given window.

checkWindowEvent( $window, $event_mask )

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.

BUGS

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.

SEE ALSO

Video::Xine, Video::PlaybackMachine, Xlib

AUTHOR

Stephen Nelson, <stephen@cpan.org<gt>

COPYRIGHT AND LICENSE

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.