NAME

       Barcode::ZBar::Processor - self-contained bar code reader

SYNOPSIS

       setup:

           use Barcode::ZBar;

           my $reader = Barcode::ZBar::Processor->new();
           $reader->init("/dev/video1", 1);
           $reader->parse_config('code39.disable');
           $reader->set_data_handler(\&my_handler);

       scan an image:

           $reader->process_image($image);

       scan from video:

           $reader->set_visible();
           $reader->set_active();
           $reader->user_wait();

DESCRIPTION

       A Barcode::ZBar::Processor may be used to quickly create stand-alone bar code scanning applications.  It
       has interfaces to scan images or video and to optionally display a video/image preview to a window.

       This interface is not well suited for integration with an existing GUI, as the library manages the
       optional preview window and any user interaction.  Use a Barcode::ZBar::ImageScanner or Investigate the
       available widget interfaces for GUI applications.

REFERENCE

   Methods
       new()
           Create a new bar code reader instance.

       init([video_device], [enable_display])
           Open a video input device and/or prepare to display output.

       set_data_handler([handler], [closure])
           Setup a callback to process results whenever new results are available from the video stream or a
           static image.  The specified callable will be invoked with the associated Barcode::ZBar::Processor
           object and closure as arguments.  Closure may be achieved either using standard Perl closure or by
           manually passing a scalar via closure.

       is_visible()
       set_visible([visible])
           Test/set visibility of the output window.

       set_active([active])
           Enable/disable video streaming and scanning for bar codes.

       get_results()
           Return a list of Barcode::ZBar::Symbol results from the last scanned image or video frame.

       user_wait([timeout])
           Wait for the user to press a key/button or close the window.  Bar codes will continue to be processed
           if video is active.

       process_one([timeout])
           Enable video and scan until at least one barcode is found.  Note that multiple results may still be
           returned.

       process_image([image])
           Scan a Barcode::ZBar::Image for bar codes.

       parse_config(configstr)
           Apply a decoder configuration setting.  See the documentation for "zbarcam"/"zbarimg" for available
           configuration options.

       request_size(width, height)
           Request a preferred size for the video image from the device.  The request may be adjusted or
           completely ignored by the driver.  Must be called before init()

       force_format(input, output)
           force specific input and output formats for debug/testing.

       set_config(symbology, config, value)
           Set config for indicated symbology (0 for all) to specified value.  @returns 0 for success, non-0 for
           failure (config does not apply to specified symbology, or value out of range)

SEE ALSO

       Barcode::ZBar, Barcode::ZBar::Image, Barcode::ZBar::ImageScanner

       zbarimg(1), zbarcam(1)

       http://zbar.sf.net

AUTHOR

       Jeff Brown, <spadix@users.sourceforge.net>

COPYRIGHT AND LICENSE

       Copyright 2008-2010 (c) Jeff Brown <spadix@users.sourceforge.net>

       The ZBar Bar Code Reader is free software; you can redistribute it and/or modify it under the terms of
       the GNU Lesser Public License as published by the Free Software Foundation; either version 2.1 of the
       License, or (at your option) any later version.