Graphics-Framebuffer

This module REQUIRES access to the video framebuffer, usually
"/dev/fb0".  You must be using a video device and driver that exposes this
device to software.  In order to achieve its "magic", the framebuffer must
be allowed to be mapped to a variable.  Video cards with their proprietary
drivers are not likely to work.  However, most open-sourced drivers,
seem to work fine.  VirtualBox drivers work too.

INSTALLATION

To install this module, run the following commands:

    perl Build.PL && ./Build && clear && ./Build test
    ./Build install
    
OR...

	perl Makefile.PL && make && clear && make test
	make install

NOTE:  The install step may require sudo.

The reason for the 'clear' is so the test log doesn't start scrolling the
screen, as graphics are being drawn during the testing.

FURTHER TEST SCRIPTS

To test the installation properly.  Log into the text console (not X).
Go to the 'examples' directory and run 'frtest.pl' or 'primitives.pl'.  They
basically call most of the features of the module.  'frtest.pl', as a bonus,
also demonstrates how to use threads with this module.  You can pass a number
in on the command line to the "frtest.pl" script, and it will use that many
threads.  The default is the number of cores you have.

The script 'frtest.pl' requires 'Sys::CPU'.  It is not listed as a
prerequisite for this module (as it isn't), but if you want to run this
one script, then this is a required module.  'primitites.pl' has no such
requirement.

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the
perldoc command.

    perldoc Graphics::Framebuffer

You can also look for information at:

    RT, CPAN's request tracker (report bugs here)
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=Graphics-Framebuffer

    AnnoCPAN, Annotated CPAN documentation
        http://annocpan.org/dist/Graphics-Framebuffer

    CPAN Ratings
        http://cpanratings.perl.org/d/Graphics-Framebuffer

    Search CPAN
        http://search.cpan.org/dist/Graphics-Framebuffer/


LICENSE AND COPYRIGHT

Copyright (C) 2013-2015 Richard Kelsch

This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.