Leo Charre > PDF-OCR-1.09 > PDF::OCR

Download:
PDF-OCR-1.09.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
Report a bug
Module Version: 1.09   Source   Latest Release: PDF-OCR-1.11

NAME ^

PDF::OCR - get ocr and images out of a pdf file

SYNOPSIS ^

        use PDF::OCR;

        my $p = new PDF::OCR('/path/to/file.pdf');
   
   my $text = $p->get_ocr;

EXAMPLE 2

        use PDF::OCR;

        my $p = new PDF::OCR('/path/to/file.pdf');

        my $images = $p->abs_images; # extract images, get list of paths
        
        for( @{$p->abs_images} ){ # get ocr content for each
        
                my $content = $p->get_ocr($_);          
                print "image $_ had content: $content\n\n";
        }


        my $ocrs = $p->get_ocr; # get ocr content for all as one scalar with pagebreaks 
   print "$abs_pdf had [$ocrs]\n";

        # get all content of all images as array ref, each element is one image text content
        my @ocrs = @{ $p->get_ocr_arrayref };
   print "$abs_pdf had [@ocrs]\n";

DESCRIPTION ^

Lets you get text out of pages in pdf documents.

The whole process does not change your original pdf in any way.

Please note this is only to get text out of images inside the pdf file, it does not check for genuine text inside the file- if any. For that please see PDF::OCR::Thorough

If you scan in paper documents into PDFs, like 'modern' office environments, then these modules are useful to you.

METHODS ^

new()

Argument is pdf file you want to run ocr on.

        my $o = new PDF::OCR('/path/to/file.pdf');

This will copy the file to a tmp file.

abs_images()

Returns array ref with images extracted from the pdf.

get_ocr()

Optional argument is abs path of image extracted from pdf. Returns ocr content.

If no argument is given, all image ocr contents are concatenated and returned as scalar (with pagebreak chars, can be regexed with \f).

get_ocr_arrayref()

Get all ocr images content as array ref. This is the text.

cleanup()

Erase temp file and all image files extracted. Called by DESTROY, unless DEBUG flag is on.

DEBUG ^

   $PDF::OCR::DEBUG = 1;

BUGS ^

Please notify the AUTHOR if you find any bugs.

CAVEATS ^

This module is for Unix type systems. It is not intended to run on other "systems" and no support for such will be added in the future. Attempting to install on an unsupported OS will throw an exception.

This module is in development, please notify the AUTHOR with any feedback.

INSTALL ^

Please see INSTALL help notes.

SEE ALSO ^

PDF::GetImages Image::OCR::Tesseract PDF::API2 http://code.google.com/p/tesseract-ocr/

AUTHOR ^

Leo Charre leocharre at cpan dot org

COPYRIGHT ^

Copyright (c) 2008 Leo Charre. All rights reserved.

LICENSE ^

This package is free software; you can redistribute it and/or modify it under the same terms as Perl itself, i.e., under the terms of the "Artistic License" or the "GNU General Public License".

DISCLAIMER ^

This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

See the "GNU General Public License" for more details.