barcode::zbar(3pm) [debian man page]

ZBar(3pm)						User Contributed Perl Documentation						 ZBar(3pm)

NAME

       Barcode::ZBar - Perl interface to the ZBar Barcode Reader

SYNOPSIS

       setup:

	   use Barcode::ZBar;

	   my $reader = Barcode::ZBar::Processor->new();
	   $reader->init();
	   $reader->set_data_handler(&my_handler);

       scan an image:

	   my $image = Barcode::ZBar::Image->new();
	   $image->set_format('422P');
	   $image->set_size(114, 80);
	   $image->set_data($raw_bits);
	   $reader->process_image($image);

       scan from video:

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

       collect results:

	   my @symbols = $image->get_symbols();
	   foreach my $sym (@symbols) {
	       print("decoded: " . $sym->get_type() . ":" . $sym->get_data());
	   }

DESCRIPTION

       The ZBar Bar Code Reader is a library for scanning and decoding bar codes from various sources such as video streams, image files or raw
       intensity sensors.  It supports EAN, UPC, Code 128, Code 39 and Interleaved 2 of 5.

       These are the bindings for interacting directly with the library from Perl.

REFERENCE

   Functions
       version()
	   Returns the version of the zbar library as "major.minor".

       increase_verbosity()
	   Increases global library debug by one level.

       set_verbosity(level)
	   Sets global library debug to the indicated level.  Higher numbers give more verbosity.

       parse_config(configstr)
	   Parse a decoder configuration setting into a list containing the symbology constant, config constant, and value to set.  See the
	   documentation for "zbarcam"/"zbarimg" for available configuration options.

   Constants
       Width stream "color" constants:

       SPACE
	   Light area or space between bars.

       BAR Dark area or colored bar segment.

SEE ALSO

       Barcode::ZBar::Processor, Barcode::ZBar::ImageScanner, Barcode::ZBar::Image, Barcode::ZBar::Symbol, Barcode::ZBar::Scanner,
       Barcode::ZBar::Decoder

       zbarimg(1), zbarcam(1)

       http://zbar.sf.net

AUTHOR

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

COPYRIGHT AND LICENSE

       Copyright 2008-2009 (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.

perl v5.14.2							    2009-10-23								 ZBar(3pm)

ZBar::Image(3pm)					User Contributed Perl Documentation					  ZBar::Image(3pm)

NAME

       Barcode::ZBar::Image - image object to scan for bar codes

SYNOPSIS

	   use Barcode::ZBar;

	   my $image = Barcode::ZBar::Image->new();
	   $image->set_format('422P');
	   $image->set_size(114, 80);
	   $image->set_data($raw_bits);

	   my @symbols = $image->get_symbols();

DESCRIPTION

       Barcode::ZBar::Image is used to pass images to the bar code scanner.  It wraps raw image data with the meta-data required to interpret it
       (size, pixel format, etc)

   Image Formats
       Image data formats are represented by (relatively) standard "Four Character Codes" (fourcc), represented by four character strings in Perl.
       A list of supported formats is available on the project wiki.

       Examples:

       o 'GREY' - single 8bpp intensity plane

       o 'BGR3' - 24bpp packed RGB component format

       o 'YUYV' - 12bpp packed luminance/chrominance (YCbCr) format

REFERENCE

   Methods
       new()
	   Create a new Barcode::ZBar::Image object.  The size, pixel format and data must be defined before the object may be used.

       get_format()
       set_format(format)
	   Return/specify the fourcc code corresponding to the image pixel format.

       get_sequence()
       set_sequence(seq_num)
	   Return/specify the video frame or page number associated with the image.

       get_size()
       set_size(width, height)
	   Return/specify the (width, height) image size tuple.

       get_data()
       set_data(raw)
	   Return/specify the raw image data as a binary string.

       get_symbols()
	   Return a list of scanned Barcode::ZBar::Symbol results attached to this image.

       convert(format)
	   Return a new Barcode::ZBar::Image object converted to the indicated fourcc format.  Returns "undef" if the conversion is not supported.
	   Conversion complexity ranges from CPU intensive to trivial depending on the formats involved.  Note that only a few conversions retain
	   color information.

SEE ALSO

       Barcode::ZBar, Barcode::ZBar::Image, Barcode::ZBar::Symbol

       zbarimg(1), zbarcam(1)

       http://zbar.sf.net

AUTHOR

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

COPYRIGHT AND LICENSE

       Copyright 2008-2009 (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.

perl v5.14.2							    2009-10-23							  ZBar::Image(3pm)