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()

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.