Games::Bingo::Print - a PDF Generation Class for Games::Bingo
use Games::Bingo::Print; my $bp = Games::Bingo::Print-E<gt>new(); $bp-E<gt>print_pages(2); my $bp = Games::Bingo::Print->new( heading => 'Jimmys bingohalle', text => 'its all in the game!' filename => 'jimmys.pdf );
This documentation describes version 0.03 of Games::Bingo::Print
This is that actual printing class. It generates a PDF file with pages containing bingo cards.
The page contains space for 3 bingo cards, each consisting of 3 rows and 10 columns like this:
So a filled out example card could look like this:
+--+--+--+--+--+--+--+--+--+ | 4|13| |30| | |62| | | +--+--+--+--+--+--+--+--+--+ | | |22| |41|53| |78| | +--+--+--+--+--+--+--+--+--+ | |14|27| | | |65| |80| +--+--+--+--+--+--+--+--+--+
The constructor
The constructor can take several options, all these are optional.
heading
The heading on the generated bingo card PDF.
text
The smaller text on the generated bingo card PDF, the default is the authors name (SEE AUTHOR section below).
filename
The name of the file containing the generated bingo card PDF, the default is 'bingo.pdf'
If it is not possible to create an object the constructor dies with the diagnostic 'Unable to construct object' and some additional diagnostic depending on the problem, which might relate to third party components used. See DEPENDENCIES.
The print_pages is the main method it takes two arguments, the number of pages you want to print and optionally the number of cards you want to print on a page.
The default is 3 cards on a page which also is the maximum.
The print_pages method returns 1 on success and 0 on failure, failure issues a warning.
print_pages calls _print_card.
This is the method used to print the actual card, it calls _print_row 3 times.
y_start_cordinate
The Y start cordinate (we print botton up for now, please see the TODO file).
y_end_cordinate
The Y end cordinate (we print botton up for now, please see the TODO file).
x_start_cordinate
The X start cordinate (we print botton up for now, please see the TODO file).
size
The pixel size of the box containg the number,
This method prints a single row.
x_end_cordinate
The X end cordinate (we print botton up for now, please see the TODO file),
The pixel size of the box containg the number.
numbers
The numbers to be inserted into the row as an reference to an array.
'Unable to construct object', a dianostic from the constructor (new) and some additional diagnostic depending on the problem, which might relate to third party components used. See DEPENDENCIES.
Games::Bingo::Print requires no special configuration or environment apart from what is listed in the DEPENDENCIES section.
Games::Bingo
Games::Bingo::Card
PDFLib
There are no known incompatibilities.
The PDF generator only works with Games::Bingo
Please report issues via CPAN RT:
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Business-DK-CPR
or by sending mail to
bug-Business-DK-CPR@rt.cpan.org
You can find documentation for this module with the perldoc command.
perldoc Games::Bingo::Print
You can also look for information at:
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/Games-Bingo-Print
CPAN Ratings
http://cpanratings.perl.org/d/Games-Bingo-Print
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Games-Bingo-Print
Search CPAN
http://search.cpan.org/dist/Games-Bingo-Print
I am currently not able to generate a test coverage report for Games::Bingo::Print.
Perl::Critic tests (t/critic) are enable by settting the environment variable TEST_AUTHOR.
Kwalitee tests (t
bin/bingo_print.pl
The TODO file contains a complete list for the Games::Bingo::Print class.
Jonas B. Nielsen, (jonasbn) <jonasbn@cpan.org>
<jonasbn@cpan.org>
Thanks to Matt Sergeant for suggesting using PDFLib.
Games::Bingo::Print and related modules are free software and is released under the Artistic License. See <http://www.perl.com/language/misc/Artistic.html> for details.
Games::Bingo::Print is (C) 2003-2007 Jonas B. Nielsen (jonasbn) <jonasbn@cpan.org>
To install Games::Bingo::Print, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Games::Bingo::Print
CPAN shell
perl -MCPAN -e shell install Games::Bingo::Print
For more information on module installation, please visit the detailed CPAN module installation guide.