NAME
    Image::WordCloud - Create word cloud images

VERSION
    Version 0.01_01

SYNOPSIS
    Create "word cloud" images out of a set of specified words. Font size
    indicates the frequency with which a word is used. Colors are generated
    randomly. Fonts can be specified or chosen randomly.

    Perhaps a little code snippet.

        use Image::WordCloud;

        my $wc = Image::WordCloud->new();
    
        # Add the Gettysburg Address
        $wc->words([qw/
                    Four score and seven years ago our fathers brought forth on this continent a new nation conceived in Liberty and dedicated to the proposition that all men are created equal
                                    Now we are engaged in a great civil war testing whether that nation or any nation so conceived and so dedicated can long endure We are met on a great battle field of that
                                    war We have come to dedicate a portion of that field as a final resting place for those who here gave their lives that that nation might live It is altogether fitting and
                                    proper that we should do this But in a larger sense we can not dedicatewe can not consecratewe can not hallowthis ground The brave men living and dead who struggled
                                    here have consecrated it far above our poor power to add or detract The world will little note nor long remember what we say here but it can never forget what they did here
                                    It is for us the living rather to be dedicated here to the unfinished work which they who fought here have thus far so nobly advanced It is rather for us to be here dedicated
                                    to the great task remaining before usthat from these honored dead we take increased devotion to that cause for which they here gave the last full measure of devotionthat we
                                    here highly resolve that these dead shall not have died in vainthat this nation under God shall have a new birth of freedomand that government of the people by the people
                                    for the people shall not perish from the earth
                    /]);
                
                    # Create the word cloud as a GD image
                    my $gd = $wc->cloud();
                
                    open(my $fh, '>', 'gettysburg.png');
                            binmode $fh;
                            print $fh $gd->png();
                    close($fh);
                
                    # See examples/gettysburg.png for how the created image looks. script/gettysburg.pl will create it

SUBROUTINES/METHODS
  new()
  words(\%words_to_use | \@words | @words_to_use)
    Set up hashref \%words_to_use as the words we build the word cloud from.

    Keys are the words, values are their count.

  cloud()
    Make the word cloud. Returns a GD image object

  add_stop_words(@words)
    Add new stop words onto the list. Automatically puts words in lowercase.

AUTHOR
    Brian Hann, `<brian.hann at gmail.com>'

BUGS
    Please report any bugs or feature requests to `bug-image-wordcloud at
    rt.cpan.org', or through the web interface at
    http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Image-WordCloud. I will
    be notified, and then you'll automatically be notified of progress on
    your bug as I make changes.

SUPPORT
    You can find documentation for this module with the perldoc command.

        perldoc Image::WordCloud

    You can also look for information at:

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

    * AnnoCPAN: Annotated CPAN documentation
        http://annocpan.org/dist/Image-WordCloud

    * CPAN Ratings
        http://cpanratings.perl.org/d/Image-WordCloud

    * Search CPAN
        http://search.cpan.org/dist/Image-WordCloud/

ACKNOWLEDGEMENTS
LICENSE AND COPYRIGHT
    Copyright 2012 Brian Hann.

    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.

