|
ZBar Bar Code Reader Library
version 0.10
|
|
|
ZBar Bar Code Reader Library
version 0.10
|
|
C++ namespace for library interfaces. More...
Classes | |
| class | BusyError |
| all resources busy. More... | |
| class | ClosedError |
| output window is closed. More... | |
| class | Decoder |
| low-level bar width stream decoder interface. More... | |
| class | Exception |
| base class for exceptions defined by this API. More... | |
| class | FormatError |
| image format error More... | |
| class | Image |
| stores image data samples along with associated format and size metadata More... | |
| class | ImageScanner |
| mid-level image scanner interface. More... | |
| class | InternalError |
| internal library error. More... | |
| class | InvalidError |
| invalid request. More... | |
| class | LockingError |
| locking error. More... | |
| class | Processor |
| high-level self-contained image processor. More... | |
| class | QZBar |
| barcode reader Qt4 widget. More... | |
| class | QZBarImage |
| wrap a QImage and convert into a format suitable for scanning. More... | |
| class | QZBarThread |
| class | Scanner |
| low-level linear intensity sample stream scanner interface. More... | |
| class | Symbol |
| decoded barcode symbol result object. More... | |
| class | SymbolIterator |
| iteration over Symbol result objects in a scanned Image or SymbolSet. More... | |
| class | SymbolSet |
| container for decoded result symbols associated with an image or a composite symbol. More... | |
| class | SystemError |
| failed system call. More... | |
| class | UnsupportedError |
| unsupported request. More... | |
| class | Video |
| mid-level video source abstraction. More... | |
| class | Window |
| mid-level output window abstraction. More... | |
| class | XDisplayError |
| X11 display error. More... | |
| class | XProtoError |
| X11 protocol error. More... | |
Functions | |
| static void | negotiate_format (Video &video, Window &window) |
| select a compatible format between video input and output window. More... | |
| static std::exception | throw_exception (const void *obj) |
| extract error information and create exception. More... | |
Symbol interface | |
decoded barcode symbol result object. stores type, data, and image location of decoded symbol. all memory is owned by the library | |
| typedef struct zbar_symbol_s | zbar_symbol_t |
| opaque decoded symbol object. More... | |
| void | zbar_symbol_ref (const zbar_symbol_t *symbol, int refs) |
| symbol reference count manipulation. More... | |
| zbar_symbol_type_t | zbar_symbol_get_type (const zbar_symbol_t *symbol) |
| retrieve type of decoded symbol. More... | |
| const char * | zbar_symbol_get_data (const zbar_symbol_t *symbol) |
| retrieve data decoded from symbol. More... | |
| unsigned int | zbar_symbol_get_data_length (const zbar_symbol_t *symbol) |
| retrieve length of binary data. More... | |
| int | zbar_symbol_get_quality (const zbar_symbol_t *symbol) |
| retrieve a symbol confidence metric. More... | |
| int | zbar_symbol_get_count (const zbar_symbol_t *symbol) |
| retrieve current cache count. More... | |
| unsigned | zbar_symbol_get_loc_size (const zbar_symbol_t *symbol) |
| retrieve the number of points in the location polygon. More... | |
| int | zbar_symbol_get_loc_x (const zbar_symbol_t *symbol, unsigned index) |
| retrieve location polygon x-coordinates. More... | |
| int | zbar_symbol_get_loc_y (const zbar_symbol_t *symbol, unsigned index) |
| retrieve location polygon y-coordinates. More... | |
| const zbar_symbol_t * | zbar_symbol_next (const zbar_symbol_t *symbol) |
| iterate the set to which this symbol belongs (there can be only one). More... | |
| const zbar_symbol_set_t * | zbar_symbol_get_components (const zbar_symbol_t *symbol) |
| retrieve components of a composite result. More... | |
| const zbar_symbol_t * | zbar_symbol_first_component (const zbar_symbol_t *symbol) |
| iterate components of a composite result. More... | |
| char * | zbar_symbol_xml (const zbar_symbol_t *symbol, char **buffer, unsigned *buflen) |
| print XML symbol element representation to user result buffer. More... | |
Symbol Set interface | |
container for decoded result symbols associated with an image or a composite symbol.
| |
| typedef struct zbar_symbol_set_s | zbar_symbol_set_t |
| opaque symbol iterator object. More... | |
| void | zbar_symbol_set_ref (const zbar_symbol_set_t *symbols, int refs) |
| reference count manipulation. More... | |
| int | zbar_symbol_set_get_size (const zbar_symbol_set_t *symbols) |
| retrieve set size. More... | |
| const zbar_symbol_t * | zbar_symbol_set_first_symbol (const zbar_symbol_set_t *symbols) |
| set iterator. More... | |
Image interface | |
stores image data samples along with associated format and size metadata | |
| typedef struct zbar_image_s | zbar_image_t |
| opaque image object. More... | |
| typedef void( | zbar_image_cleanup_handler_t) (zbar_image_t *image) |
| cleanup handler callback function. More... | |
| typedef void( | zbar_image_data_handler_t) (zbar_image_t *image, const void *userdata) |
| data handler callback function. More... | |
| zbar_image_t * | zbar_image_create (void) |
| new image constructor. More... | |
| void | zbar_image_destroy (zbar_image_t *image) |
| image destructor. More... | |
| void | zbar_image_ref (zbar_image_t *image, int refs) |
| image reference count manipulation. More... | |
| zbar_image_t * | zbar_image_convert (const zbar_image_t *image, unsigned long format) |
| image format conversion. More... | |
| zbar_image_t * | zbar_image_convert_resize (const zbar_image_t *image, unsigned long format, unsigned width, unsigned height) |
| image format conversion with crop/pad. More... | |
| unsigned long | zbar_image_get_format (const zbar_image_t *image) |
| retrieve the image format. More... | |
| unsigned | zbar_image_get_sequence (const zbar_image_t *image) |
| retrieve a "sequence" (page/frame) number associated with this image. More... | |
| unsigned | zbar_image_get_width (const zbar_image_t *image) |
| retrieve the width of the image. More... | |
| unsigned | zbar_image_get_height (const zbar_image_t *image) |
| retrieve the height of the image. More... | |
| const void * | zbar_image_get_data (const zbar_image_t *image) |
| return the image sample data. More... | |
| unsigned long | zbar_image_get_data_length (const zbar_image_t *img) |
| return the size of image data. More... | |
| const zbar_symbol_set_t * | zbar_image_get_symbols (const zbar_image_t *image) |
| retrieve the decoded results. More... | |
| void | zbar_image_set_symbols (zbar_image_t *image, const zbar_symbol_set_t *symbols) |
| associate the specified symbol set with the image, replacing any existing results. More... | |
| const zbar_symbol_t * | zbar_image_first_symbol (const zbar_image_t *image) |
| image_scanner decode result iterator. More... | |
| void | zbar_image_set_format (zbar_image_t *image, unsigned long format) |
| specify the fourcc image format code for image sample data. More... | |
| void | zbar_image_set_sequence (zbar_image_t *image, unsigned sequence_num) |
| associate a "sequence" (page/frame) number with this image. More... | |
| void | zbar_image_set_size (zbar_image_t *image, unsigned width, unsigned height) |
| specify the pixel size of the image. More... | |
| void | zbar_image_set_data (zbar_image_t *image, const void *data, unsigned long data_byte_length, zbar_image_cleanup_handler_t *cleanup_hndlr) |
| specify image sample data. More... | |
| void | zbar_image_free_data (zbar_image_t *image) |
| built-in cleanup handler. More... | |
| void | zbar_image_set_userdata (zbar_image_t *image, void *userdata) |
| associate user specified data value with an image. More... | |
| void * | zbar_image_get_userdata (const zbar_image_t *image) |
| return user specified data value associated with the image. More... | |
| int | zbar_image_write (const zbar_image_t *image, const char *filebase) |
| dump raw image data to a file for debug. More... | |
| zbar_image_t * | zbar_image_read (char *filename) |
| read back an image in the format written by zbar_image_write() More... | |
Processor interface | |
high-level self-contained image processor. processes video and images for barcodes, optionally displaying images to a library owned output window | |
| typedef struct zbar_processor_s | zbar_processor_t |
| opaque standalone processor object. More... | |
| zbar_processor_t * | zbar_processor_create (int threaded) |
| constructor. More... | |
| void | zbar_processor_destroy (zbar_processor_t *processor) |
| destructor. More... | |
| int | zbar_processor_init (zbar_processor_t *processor, const char *video_device, int enable_display) |
| (re)initialization. More... | |
| int | zbar_processor_request_size (zbar_processor_t *processor, unsigned width, unsigned height) |
| request a preferred size for the video image from the device. More... | |
| int | zbar_processor_request_interface (zbar_processor_t *processor, int version) |
| request a preferred video driver interface version for debug/testing. More... | |
| int | zbar_processor_request_iomode (zbar_processor_t *video, int iomode) |
| request a preferred video I/O mode for debug/testing. More... | |
| int | zbar_processor_force_format (zbar_processor_t *processor, unsigned long input_format, unsigned long output_format) |
| force specific input and output formats for debug/testing. More... | |
| zbar_image_data_handler_t * | zbar_processor_set_data_handler (zbar_processor_t *processor, zbar_image_data_handler_t *handler, const void *userdata) |
| setup result handler callback. More... | |
| void | zbar_processor_set_userdata (zbar_processor_t *processor, void *userdata) |
| associate user specified data value with the processor. More... | |
| void * | zbar_processor_get_userdata (const zbar_processor_t *processor) |
| return user specified data value associated with the processor. More... | |
| int | zbar_processor_set_config (zbar_processor_t *processor, zbar_symbol_type_t symbology, zbar_config_t config, int value) |
| set config for indicated symbology (0 for all) to specified value. More... | |
| static int | zbar_processor_parse_config (zbar_processor_t *processor, const char *config_string) |
| parse configuration string using zbar_parse_config() and apply to processor using zbar_processor_set_config(). More... | |
| int | zbar_processor_is_visible (zbar_processor_t *processor) |
| retrieve the current state of the ouput window. More... | |
| int | zbar_processor_set_visible (zbar_processor_t *processor, int visible) |
| show or hide the display window owned by the library. More... | |
| int | zbar_processor_set_active (zbar_processor_t *processor, int active) |
| control the processor in free running video mode. More... | |
| const zbar_symbol_set_t * | zbar_processor_get_results (const zbar_processor_t *processor) |
| retrieve decode results for last scanned image/frame. More... | |
| int | zbar_processor_user_wait (zbar_processor_t *processor, int timeout) |
| wait for input to the display window from the user (via mouse or keyboard). More... | |
| int | zbar_process_one (zbar_processor_t *processor, int timeout) |
| process from the video stream until a result is available, or the timeout (in milliseconds) expires. More... | |
| int | zbar_process_image (zbar_processor_t *processor, zbar_image_t *image) |
| process the provided image for barcodes. More... | |
| static int | zbar_processor_error_spew (const zbar_processor_t *processor, int verbosity) |
| display detail for last processor error to stderr. More... | |
| static const char * | zbar_processor_error_string (const zbar_processor_t *processor, int verbosity) |
| retrieve the detail string for the last processor error. More... | |
| static zbar_error_t | zbar_processor_get_error_code (const zbar_processor_t *processor) |
| retrieve the type code for the last processor error. More... | |
Video interface | |
mid-level video source abstraction. captures images from a video device | |
| typedef struct zbar_video_s | zbar_video_t |
| opaque video object. More... | |
| zbar_video_t * | zbar_video_create (void) |
| constructor. More... | |
| void | zbar_video_destroy (zbar_video_t *video) |
| destructor. More... | |
| int | zbar_video_open (zbar_video_t *video, const char *device) |
| open and probe a video device. More... | |
| int | zbar_video_get_fd (const zbar_video_t *video) |
| retrieve file descriptor associated with open *nix video device useful for using select()/poll() to tell when new images are available (NB v4l2 only!!). More... | |
| int | zbar_video_request_size (zbar_video_t *video, unsigned width, unsigned height) |
| request a preferred size for the video image from the device. More... | |
| int | zbar_video_request_interface (zbar_video_t *video, int version) |
| request a preferred driver interface version for debug/testing. More... | |
| int | zbar_video_request_iomode (zbar_video_t *video, int iomode) |
| request a preferred I/O mode for debug/testing. More... | |
| int | zbar_video_get_width (const zbar_video_t *video) |
| retrieve current output image width. More... | |
| int | zbar_video_get_height (const zbar_video_t *video) |
| retrieve current output image height. More... | |
| int | zbar_video_init (zbar_video_t *video, unsigned long format) |
| initialize video using a specific format for debug. More... | |
| int | zbar_video_enable (zbar_video_t *video, int enable) |
| start/stop video capture. More... | |
| zbar_image_t * | zbar_video_next_image (zbar_video_t *video) |
| retrieve next captured image. More... | |
| static int | zbar_video_error_spew (const zbar_video_t *video, int verbosity) |
| display detail for last video error to stderr. More... | |
| static const char * | zbar_video_error_string (const zbar_video_t *video, int verbosity) |
| retrieve the detail string for the last video error. More... | |
| static zbar_error_t | zbar_video_get_error_code (const zbar_video_t *video) |
| retrieve the type code for the last video error. More... | |
Window interface | |
mid-level output window abstraction. displays images to user-specified platform specific output window | |
| typedef struct zbar_window_s | zbar_window_t |
| opaque window object. More... | |
| zbar_window_t * | zbar_window_create (void) |
| constructor. More... | |
| void | zbar_window_destroy (zbar_window_t *window) |
| destructor. More... | |
| int | zbar_window_attach (zbar_window_t *window, void *x11_display_w32_hwnd, unsigned long x11_drawable) |
| associate reader with an existing platform window. More... | |
| void | zbar_window_set_overlay (zbar_window_t *window, int level) |
| control content level of the reader overlay. More... | |
| int | zbar_window_get_overlay (const zbar_window_t *window) |
| retrieve current content level of reader overlay. More... | |
| int | zbar_window_draw (zbar_window_t *window, zbar_image_t *image) |
| draw a new image into the output window. More... | |
| int | zbar_window_redraw (zbar_window_t *window) |
| redraw the last image (exposure handler). More... | |
| int | zbar_window_resize (zbar_window_t *window, unsigned width, unsigned height) |
| resize the image window (reconfigure handler). More... | |
| static int | zbar_window_error_spew (const zbar_window_t *window, int verbosity) |
| display detail for last window error to stderr. More... | |
| static const char * | zbar_window_error_string (const zbar_window_t *window, int verbosity) |
| retrieve the detail string for the last window error. More... | |
| static zbar_error_t | zbar_window_get_error_code (const zbar_window_t *window) |
| retrieve the type code for the last window error. More... | |
| int | zbar_negotiate_format (zbar_video_t *video, zbar_window_t *window) |
| select a compatible format between video input and output window. More... | |
Decoder interface | |
low-level bar width stream decoder interface. identifies symbols and extracts encoded data | |
| typedef struct zbar_decoder_s | zbar_decoder_t |
| opaque decoder object. More... | |
| typedef void( | zbar_decoder_handler_t) (zbar_decoder_t *decoder) |
| decoder data handler callback function. More... | |
| zbar_decoder_t * | zbar_decoder_create (void) |
| constructor. More... | |
| void | zbar_decoder_destroy (zbar_decoder_t *decoder) |
| destructor. More... | |
| int | zbar_decoder_set_config (zbar_decoder_t *decoder, zbar_symbol_type_t symbology, zbar_config_t config, int value) |
| set config for indicated symbology (0 for all) to specified value. More... | |
| static int | zbar_decoder_parse_config (zbar_decoder_t *decoder, const char *config_string) |
| parse configuration string using zbar_parse_config() and apply to decoder using zbar_decoder_set_config(). More... | |
| void | zbar_decoder_reset (zbar_decoder_t *decoder) |
| clear all decoder state. More... | |
| void | zbar_decoder_new_scan (zbar_decoder_t *decoder) |
| mark start of a new scan pass. More... | |
| zbar_symbol_type_t | zbar_decode_width (zbar_decoder_t *decoder, unsigned width) |
| process next bar/space width from input stream. More... | |
| zbar_color_t | zbar_decoder_get_color (const zbar_decoder_t *decoder) |
| retrieve color of next element passed to zbar_decode_width(). More... | |
| const char * | zbar_decoder_get_data (const zbar_decoder_t *decoder) |
| retrieve last decoded data. More... | |
| unsigned int | zbar_decoder_get_data_length (const zbar_decoder_t *decoder) |
| retrieve length of binary data. More... | |
| zbar_symbol_type_t | zbar_decoder_get_type (const zbar_decoder_t *decoder) |
| retrieve last decoded symbol type. More... | |
| zbar_decoder_handler_t * | zbar_decoder_set_handler (zbar_decoder_t *decoder, zbar_decoder_handler_t *handler) |
| setup data handler callback. More... | |
| void | zbar_decoder_set_userdata (zbar_decoder_t *decoder, void *userdata) |
| associate user specified data value with the decoder. More... | |
| void * | zbar_decoder_get_userdata (const zbar_decoder_t *decoder) |
| return user specified data value associated with the decoder. More... | |
Scanner interface | |
low-level linear intensity sample stream scanner interface. identifies "bar" edges and measures width between them. optionally passes to bar width decoder | |
| typedef struct zbar_scanner_s | zbar_scanner_t |
| opaque scanner object. More... | |
| zbar_scanner_t * | zbar_scanner_create (zbar_decoder_t *decoder) |
| constructor. More... | |
| void | zbar_scanner_destroy (zbar_scanner_t *scanner) |
| destructor. More... | |
| zbar_symbol_type_t | zbar_scanner_reset (zbar_scanner_t *scanner) |
| clear all scanner state. More... | |
| zbar_symbol_type_t | zbar_scanner_new_scan (zbar_scanner_t *scanner) |
| mark start of a new scan pass. More... | |
| zbar_symbol_type_t | zbar_scanner_flush (zbar_scanner_t *scanner) |
| flush scanner processing pipeline. More... | |
| zbar_symbol_type_t | zbar_scan_y (zbar_scanner_t *scanner, int y) |
| process next sample intensity value. More... | |
| static zbar_symbol_type_t | zbar_scan_rgb24 (zbar_scanner_t *scanner, unsigned char *rgb) |
| process next sample from RGB (or BGR) triple. More... | |
| unsigned | zbar_scanner_get_width (const zbar_scanner_t *scanner) |
| retrieve last scanned width. More... | |
| unsigned | zbar_scanner_get_edge (const zbar_scanner_t *scn, unsigned offset, int prec) |
| retrieve sample position of last edge. More... | |
| zbar_color_t | zbar_scanner_get_color (const zbar_scanner_t *scanner) |
| retrieve last scanned color. More... | |
C++ namespace for library interfaces.
| typedef enum zbar::zbar_color_e zbar::zbar_color_t |
"color" of element: bar or space.
| typedef enum zbar::zbar_config_e zbar::zbar_config_t |
decoder configuration options.
| typedef void( zbar::zbar_decoder_handler_t) (zbar_decoder_t *decoder) |
decoder data handler callback function.
called by decoder when new data has just been decoded
| typedef struct zbar_decoder_s zbar::zbar_decoder_t |
opaque decoder object.
| typedef enum zbar::zbar_error_e zbar::zbar_error_t |
error codes.
| typedef void( zbar::zbar_image_cleanup_handler_t) (zbar_image_t *image) |
cleanup handler callback function.
called to free sample data when an image is destroyed.
| typedef void( zbar::zbar_image_data_handler_t) (zbar_image_t *image, const void *userdata) |
data handler callback function.
called when decoded symbol results are available for an image
| typedef struct zbar_image_scanner_s zbar::zbar_image_scanner_t |
opaque image scanner object.
| typedef struct zbar_image_s zbar::zbar_image_t |
opaque image object.
| typedef struct zbar_processor_s zbar::zbar_processor_t |
opaque standalone processor object.
| typedef struct zbar_scanner_s zbar::zbar_scanner_t |
opaque scanner object.
opaque symbol iterator object.
opaque decoded symbol object.
| typedef enum zbar::zbar_symbol_type_e zbar::zbar_symbol_type_t |
decoded symbol type.
| typedef struct zbar_video_s zbar::zbar_video_t |
opaque video object.
| typedef struct zbar_window_s zbar::zbar_window_t |
opaque window object.
| enum zbar::zbar_color_e |
| enum zbar::zbar_config_e |
decoder configuration options.
| enum zbar::zbar_error_e |
error codes.
decoded symbol type.
| int zbar::_zbar_error_spew | ( | const void * | object, |
| int | verbosity | ||
| ) |
type unsafe error API (don't use)
References _zbar_error_string(), ERRINFO_MAGIC, fprintf(), errinfo_s::magic, and errinfo_s::sev.
Referenced by err_capture(), zbar_processor_error_spew(), zbar_video_error_spew(), and zbar_window_error_spew().
| const char* zbar::_zbar_error_string | ( | const void * | object, |
| int | verbosity | ||
| ) |
References errinfo_s::arg_int, errinfo_s::arg_str, errinfo_s::buf, errinfo_s::detail, ERR_MAX, err_str, ERRINFO_MAGIC, errinfo_s::errnum, errinfo_s::func, len, errinfo_s::magic, MOD_MAX, mod_str, errinfo_s::module, errinfo_s::sev, SEV_FATAL, SEV_MAX, SEV_NOTE, sev_str, errinfo_s::type, ZBAR_ERR_NUM, ZBAR_ERR_SYSTEM, ZBAR_ERR_WINAPI, ZBAR_MOD_PROCESSOR, and ZBAR_MOD_UNKNOWN.
Referenced by _zbar_error_spew(), exc_get_message(), zbar::Exception::what(), zbar_processor_error_string(), zbar_video_error_string(), and zbar_window_error_string().
| zbar_error_t zbar::_zbar_get_error_code | ( | const void * | object | ) |
References ERRINFO_MAGIC, errinfo_s::magic, and errinfo_s::type.
Referenced by throw_exception(), zbar_processor_get_error_code(), zbar_video_get_error_code(), zbar_window_get_error_code(), and zbarErr_Set().
select a compatible format between video input and output window.
References throw_exception(), and zbar_negotiate_format().
Referenced by zbar::QZBarThread::openVideo().
|
inlinestatic |
extract error information and create exception.
References _zbar_get_error_code(), zbar::Exception::Exception(), ZBAR_ERR_BUSY, ZBAR_ERR_CLOSED, ZBAR_ERR_INTERNAL, ZBAR_ERR_INVALID, ZBAR_ERR_LOCKING, ZBAR_ERR_NOMEM, ZBAR_ERR_SYSTEM, ZBAR_ERR_UNSUPPORTED, ZBAR_ERR_XDISPLAY, and ZBAR_ERR_XPROTO.
Referenced by zbar::Window::attach(), zbar::Window::clear(), zbar::Video::close(), zbar::Window::draw(), zbar::Video::enable(), zbar::Processor::force_format(), zbar::Processor::init(), zbar::Video::init(), zbar::Processor::is_visible(), negotiate_format(), zbar::Video::next_image(), zbar::Video::open(), zbar::Processor::process_image(), zbar::Processor::process_one(), zbar::Window::redraw(), zbar::Video::request_iomode(), zbar::Processor::request_iomode(), zbar::Window::resize(), zbar::Processor::set_active(), zbar::Processor::set_visible(), and zbar::Processor::user_wait().
| zbar_symbol_type_t zbar::zbar_decode_width | ( | zbar_decoder_t * | decoder, |
| unsigned | width | ||
| ) |
process next bar/space width from input stream.
the width is in arbitrary relative units. first value of a scan is ZBAR_SPACE width, alternating from there.
Referenced by zbar::Decoder::decode_width(), zbar::Decoder::operator<<(), and zbar_decoder_parse_config().
| zbar_decoder_t* zbar::zbar_decoder_create | ( | void | ) |
constructor.
References BUFFER_MIN, CFG, ZBAR_CFG_EMIT_CHECK, ZBAR_CFG_ENABLE, ZBAR_CFG_MIN_LEN, and zbar_decoder_reset().
Referenced by zbar::Decoder::Decoder(), decoder_new(), main(), and zbar_image_scanner_create().
| void zbar::zbar_decoder_destroy | ( | zbar_decoder_t * | decoder | ) |
| zbar_color_t zbar::zbar_decoder_get_color | ( | const zbar_decoder_t * | decoder | ) |
retrieve color of next element passed to zbar_decode_width().
Referenced by zbar::Decoder::get_color(), and zbar_decoder_parse_config().
| const char* zbar::zbar_decoder_get_data | ( | const zbar_decoder_t * | decoder | ) |
retrieve last decoded data.
Referenced by zbar::Decoder::get_data_chars(), zbar::Decoder::get_data_string(), and zbar_decoder_parse_config().
| unsigned int zbar::zbar_decoder_get_data_length | ( | const zbar_decoder_t * | decoder | ) |
retrieve length of binary data.
Referenced by zbar::Decoder::get_data_length(), zbar::Decoder::get_data_string(), and zbar_decoder_parse_config().
| zbar_symbol_type_t zbar::zbar_decoder_get_type | ( | const zbar_decoder_t * | decoder | ) |
retrieve last decoded symbol type.
Referenced by zbar::Decoder::get_addon_name(), zbar::Decoder::get_symbol_name(), zbar::Decoder::get_type(), and zbar_decoder_parse_config().
| void* zbar::zbar_decoder_get_userdata | ( | const zbar_decoder_t * | decoder | ) |
return user specified data value associated with the decoder.
Referenced by zbar::Decoder::_cb(), and zbar_decoder_parse_config().
| void zbar::zbar_decoder_new_scan | ( | zbar_decoder_t * | decoder | ) |
mark start of a new scan pass.
clears any intra-symbol state and resets color to ZBAR_SPACE. any partially decoded symbol state is retained
Referenced by zbar::Decoder::new_scan(), and zbar_decoder_parse_config().
|
inlinestatic |
parse configuration string using zbar_parse_config() and apply to decoder using zbar_decoder_set_config().
References decoder, zbar_decoder_s::handler, userdata, scan_image::width, zbar_decode_width(), zbar_decoder_get_color(), zbar_decoder_get_data(), zbar_decoder_get_data_length(), zbar_decoder_get_type(), zbar_decoder_get_userdata(), zbar_decoder_new_scan(), zbar_decoder_reset(), zbar_decoder_set_config(), zbar_decoder_set_handler(), zbar_decoder_set_userdata(), and zbar_parse_config().
Referenced by decoder_parse_config(), and zbar::Decoder::set_config().
| void zbar::zbar_decoder_reset | ( | zbar_decoder_t * | decoder | ) |
clear all decoder state.
any partial symbols are flushed
Referenced by zbar::Decoder::reset(), and zbar_decoder_parse_config().
| int zbar::zbar_decoder_set_config | ( | zbar_decoder_t * | decoder, |
| zbar_symbol_type_t | symbology, | ||
| zbar_config_t | config, | ||
| int | value | ||
| ) |
set config for indicated symbology (0 for all) to specified value.
Referenced by zbar::Decoder::set_config(), and zbar_decoder_parse_config().
| zbar_decoder_handler_t* zbar::zbar_decoder_set_handler | ( | zbar_decoder_t * | decoder, |
| zbar_decoder_handler_t * | handler | ||
| ) |
setup data handler callback.
the registered function will be called by the decoder just before zbar_decode_width() returns a non-zero value. pass a NULL value to disable callbacks.
Referenced by zbar::Decoder::set_handler(), and zbar_decoder_parse_config().
| void zbar::zbar_decoder_set_userdata | ( | zbar_decoder_t * | decoder, |
| void * | userdata | ||
| ) |
associate user specified data value with the decoder.
Referenced by zbar::Decoder::set_handler(), and zbar_decoder_parse_config().
| const char* zbar::zbar_get_addon_name | ( | zbar_symbol_type_t | sym | ) |
retrieve string name for addon encoding.
| sym | symbol type encoding |
Referenced by zbar::Decoder::get_addon_name(), and zbar::Symbol::get_addon_name().
| const char* zbar::zbar_get_symbol_name | ( | zbar_symbol_type_t | sym | ) |
retrieve string name for symbol encoding.
| sym | symbol type encoding |
Referenced by zbar::Decoder::get_symbol_name(), and zbar::Symbol::get_type_name().
| zbar_image_t* zbar::zbar_image_convert | ( | const zbar_image_t * | image, |
| unsigned long | format | ||
| ) |
image format conversion.
refer to the documentation for supported image formats
Referenced by zbar::Image::convert().
| zbar_image_t* zbar::zbar_image_convert_resize | ( | const zbar_image_t * | image, |
| unsigned long | format, | ||
| unsigned | width, | ||
| unsigned | height | ||
| ) |
image format conversion with crop/pad.
if the requested size is larger than the image, the last row/column are duplicated to cover the difference. if the requested size is smaller than the image, the extra rows/columns are dropped from the right/bottom.
Referenced by zbar::Image::convert().
| zbar_image_t* zbar::zbar_image_create | ( | void | ) |
new image constructor.
References _zbar_image_refcnt(), and _zbar_refcnt_init().
Referenced by _zbar_format_lookup(), image_new(), main(), scan_image(), zbar_gtk_processing_thread(), zbar_image_convert_resize(), zbar_image_copy(), zbar_image_free_data(), zbar_video_create(), zbar_video_init(), and zbar_video_next_image().
| void zbar::zbar_image_destroy | ( | zbar_image_t * | image | ) |
image destructor.
all images created by or returned to the application should be destroyed using this function. when an image is destroyed, the associated data cleanup handler will be invoked if available
| const zbar_symbol_t* zbar::zbar_image_first_symbol | ( | const zbar_image_t * | image | ) |
image_scanner decode result iterator.
| void zbar::zbar_image_free_data | ( | zbar_image_t * | image | ) |
built-in cleanup handler.
passes the image data buffer to free()
| const void* zbar::zbar_image_get_data | ( | const zbar_image_t * | image | ) |
return the image sample data.
the returned data buffer is only valid until zbar_image_destroy() is called
Referenced by zbar::Image::get_data().
| unsigned long zbar::zbar_image_get_data_length | ( | const zbar_image_t * | img | ) |
return the size of image data.
Referenced by zbar::Image::get_data_length().
| unsigned long zbar::zbar_image_get_format | ( | const zbar_image_t * | image | ) |
retrieve the image format.
Referenced by zbar::Image::get_format().
| unsigned zbar::zbar_image_get_height | ( | const zbar_image_t * | image | ) |
retrieve the height of the image.
Referenced by zbar::Image::get_height().
| unsigned zbar::zbar_image_get_sequence | ( | const zbar_image_t * | image | ) |
retrieve a "sequence" (page/frame) number associated with this image.
Referenced by zbar::Image::get_sequence().
| const zbar_symbol_set_t* zbar::zbar_image_get_symbols | ( | const zbar_image_t * | image | ) |
retrieve the decoded results.
Referenced by zbar::Image::get_symbols().
| void* zbar::zbar_image_get_userdata | ( | const zbar_image_t * | image | ) |
return user specified data value associated with the image.
Referenced by zbar::Image::Handler::_cb(), and zbar::Image::_cleanup().
| unsigned zbar::zbar_image_get_width | ( | const zbar_image_t * | image | ) |
retrieve the width of the image.
Referenced by zbar::Image::get_width().
| zbar_image_t* zbar::zbar_image_read | ( | char * | filename | ) |
read back an image in the format written by zbar_image_write()
| void zbar::zbar_image_ref | ( | zbar_image_t * | image, |
| int | refs | ||
| ) |
image reference count manipulation.
increment the reference count when you store a new reference to the image. decrement when the reference is no longer used. do not refer to the image any longer once the count is decremented. zbar_image_ref(image, -1) is the same as zbar_image_destroy(image)
Referenced by zbar::Image::Image(), and zbar::Image::~Image().
| zbar_image_scanner_t* zbar::zbar_image_scanner_create | ( | void | ) |
constructor.
References _zbar_qr_create(), CFG, symbol_handler(), ZBAR_CFG_POSITION, ZBAR_CFG_X_DENSITY, ZBAR_CFG_Y_DENSITY, zbar_decoder_create(), zbar_decoder_set_handler(), zbar_decoder_set_userdata(), zbar_image_scanner_destroy(), zbar_image_scanner_set_config(), and zbar_scanner_create().
Referenced by zbar::ImageScanner::ImageScanner(), imagescanner_new(), main(), zbar_gtk_processing_thread(), and zbar_processor_create().
| void zbar::zbar_image_scanner_destroy | ( | zbar_image_scanner_t * | scanner | ) |
destructor.
Referenced by zbar::ImageScanner::~ImageScanner().
| void zbar::zbar_image_scanner_enable_cache | ( | zbar_image_scanner_t * | scanner, |
| int | enable | ||
| ) |
enable or disable the inter-image result cache (default disabled).
mostly useful for scanning video frames, the cache filters duplicate results from consecutive images, while adding some consistency checking and hysteresis to the results. this interface also clears the cache
Referenced by zbar::ImageScanner::enable_cache(), and zbar_image_scanner_parse_config().
| const zbar_symbol_set_t* zbar::zbar_image_scanner_get_results | ( | const zbar_image_scanner_t * | scanner | ) |
retrieve decode results for last scanned image.
Referenced by zbar::ImageScanner::get_results(), and zbar_image_scanner_parse_config().
|
inlinestatic |
parse configuration string using zbar_parse_config() and apply to image scanner using zbar_image_scanner_set_config().
References scanner, zbar_image_scanner_enable_cache(), zbar_image_scanner_get_results(), zbar_image_scanner_recycle_image(), zbar_image_scanner_set_config(), zbar_parse_config(), and zbar_scan_image().
Referenced by imagescanner_parse_config(), and zbar::ImageScanner::set_config().
| void zbar::zbar_image_scanner_recycle_image | ( | zbar_image_scanner_t * | scanner, |
| zbar_image_t * | image | ||
| ) |
remove any previously decoded results from the image scanner and the specified image.
somewhat more efficient version of zbar_image_set_symbols(image, NULL) which may retain memory for subsequent decodes
Referenced by zbar::ImageScanner::recycle_image(), and zbar_image_scanner_parse_config().
| int zbar::zbar_image_scanner_set_config | ( | zbar_image_scanner_t * | scanner, |
| zbar_symbol_type_t | symbology, | ||
| zbar_config_t | config, | ||
| int | value | ||
| ) |
set config for indicated symbology (0 for all) to specified value.
Referenced by zbar::ImageScanner::set_config(), and zbar_image_scanner_parse_config().
| zbar_image_data_handler_t* zbar::zbar_image_scanner_set_data_handler | ( | zbar_image_scanner_t * | scanner, |
| zbar_image_data_handler_t * | handler, | ||
| const void * | userdata | ||
| ) |
setup result handler callback.
the specified function will be called by the scanner whenever new results are available from a decoded image. pass a NULL value to disable callbacks.
Referenced by zbar::ImageScanner::set_handler().
| void zbar::zbar_image_set_data | ( | zbar_image_t * | image, |
| const void * | data, | ||
| unsigned long | data_byte_length, | ||
| zbar_image_cleanup_handler_t * | cleanup_hndlr | ||
| ) |
specify image sample data.
when image data is no longer needed by the library the specific data cleanup handler will be called (unless NULL)
Referenced by zbar::Image::set_data().
| void zbar::zbar_image_set_format | ( | zbar_image_t * | image, |
| unsigned long | format | ||
| ) |
specify the fourcc image format code for image sample data.
refer to the documentation for supported formats.
Referenced by zbar::Image::set_format().
| void zbar::zbar_image_set_sequence | ( | zbar_image_t * | image, |
| unsigned | sequence_num | ||
| ) |
associate a "sequence" (page/frame) number with this image.
Referenced by zbar::Image::set_sequence().
| void zbar::zbar_image_set_size | ( | zbar_image_t * | image, |
| unsigned | width, | ||
| unsigned | height | ||
| ) |
specify the pixel size of the image.
Referenced by zbar::Image::set_size().
| void zbar::zbar_image_set_symbols | ( | zbar_image_t * | image, |
| const zbar_symbol_set_t * | symbols | ||
| ) |
associate the specified symbol set with the image, replacing any existing results.
use NULL to release the current results from the image.
Referenced by zbar::Image::set_symbols().
| void zbar::zbar_image_set_userdata | ( | zbar_image_t * | image, |
| void * | userdata | ||
| ) |
associate user specified data value with an image.
Referenced by zbar::Image::Image().
| int zbar::zbar_image_write | ( | const zbar_image_t * | image, |
| const char * | filebase | ||
| ) |
dump raw image data to a file for debug.
the data will be prefixed with a 16 byte header consisting of:
od -Ax -tx1z -N16 -w4 [file]for some formats the image can be displayed/converted using ImageMagick, eg:
display -size 640x480+16 [-depth ?] [-sampling-factor ?x?] \
{GRAY,RGB,UYVY,YUV}:[file]
| image | the image object to dump |
| filebase | base filename, appended with ".XXXX.zimg" where XXXX is the format fourcc |
increase global library debug level.
eg, for -vvvv
References _zbar_verbosity.
Referenced by increase_verbosity(), and main().
| int zbar::zbar_negotiate_format | ( | zbar_video_t * | video, |
| zbar_window_t * | window | ||
| ) |
select a compatible format between video input and output window.
the selection algorithm attempts to use a format shared by video input and window output which is also most useful for barcode scanning. if a format conversion is necessary, it will heuristically attempt to minimize the cost of the conversion
Referenced by negotiate_format(), and zbar_window_get_error_code().
| int zbar::zbar_parse_config | ( | const char * | config_string, |
| zbar_symbol_type_t * | symbology, | ||
| zbar_config_t * | config, | ||
| int * | value | ||
| ) |
parse a configuration string of the form "[symbology.]config[=value]".
the config must match one of the recognized names. the symbology, if present, must match one of the recognized names. if symbology is unspecified, it will be set to 0. if value is unspecified it will be set to 1.
Referenced by zbar_decoder_parse_config(), zbar_image_scanner_parse_config(), and zbar_processor_parse_config().
| int zbar::zbar_process_image | ( | zbar_processor_t * | processor, |
| zbar_image_t * | image | ||
| ) |
process the provided image for barcodes.
if the library window is visible, the image will be displayed.
Referenced by zbar::Processor::process_image(), and zbar_processor_parse_config().
| int zbar::zbar_process_one | ( | zbar_processor_t * | processor, |
| int | timeout | ||
| ) |
process from the video stream until a result is available, or the timeout (in milliseconds) expires.
specify a timeout of -1 to scan indefinitely (zbar_processor_set_active() may still be used to abort the scan from another thread). if the library window is visible, video display will be enabled.
Referenced by zbar::Processor::process_one(), and zbar_processor_parse_config().
| zbar_processor_t* zbar::zbar_processor_create | ( | int | threaded | ) |
constructor.
if threaded is set and threading is available the processor will spawn threads where appropriate to avoid blocking and improve responsiveness
References _zbar_mutex_init, _zbar_processor_init(), err_init(), proc, zbar_image_scanner_create(), and ZBAR_MOD_PROCESSOR.
Referenced by main(), zbar::Processor::Processor(), and processor_new().
| void zbar::zbar_processor_destroy | ( | zbar_processor_t * | processor | ) |
destructor.
cleans up all resources associated with the processor
Referenced by zbar::Processor::~Processor().
|
inlinestatic |
display detail for last processor error to stderr.
References _zbar_error_spew().
Referenced by main().
|
inlinestatic |
retrieve the detail string for the last processor error.
References _zbar_error_string().
| int zbar::zbar_processor_force_format | ( | zbar_processor_t * | processor, |
| unsigned long | input_format, | ||
| unsigned long | output_format | ||
| ) |
force specific input and output formats for debug/testing.
Referenced by zbar::Processor::force_format().
|
inlinestatic |
retrieve the type code for the last processor error.
References _zbar_get_error_code().
Referenced by input_wait(), and main().
| const zbar_symbol_set_t* zbar::zbar_processor_get_results | ( | const zbar_processor_t * | processor | ) |
retrieve decode results for last scanned image/frame.
Referenced by zbar::Processor::get_results(), and zbar_processor_parse_config().
| void* zbar::zbar_processor_get_userdata | ( | const zbar_processor_t * | processor | ) |
return user specified data value associated with the processor.
| int zbar::zbar_processor_init | ( | zbar_processor_t * | processor, |
| const char * | video_device, | ||
| int | enable_display | ||
| ) |
(re)initialization.
opens a video input device and/or prepares to display output
Referenced by zbar::Processor::init().
| int zbar::zbar_processor_is_visible | ( | zbar_processor_t * | processor | ) |
retrieve the current state of the ouput window.
Referenced by zbar::Processor::is_visible(), and zbar_processor_parse_config().
|
inlinestatic |
parse configuration string using zbar_parse_config() and apply to processor using zbar_processor_set_config().
References read_one::visible, zbar_parse_config(), zbar_process_image(), zbar_process_one(), zbar_processor_get_results(), zbar_processor_is_visible(), zbar_processor_set_active(), zbar_processor_set_config(), zbar_processor_set_visible(), and zbar_processor_user_wait().
Referenced by parse_config(), processor_parse_config(), and zbar::Processor::set_config().
| int zbar::zbar_processor_request_interface | ( | zbar_processor_t * | processor, |
| int | version | ||
| ) |
request a preferred video driver interface version for debug/testing.
Referenced by zbar::Processor::request_interface().
| int zbar::zbar_processor_request_iomode | ( | zbar_processor_t * | video, |
| int | iomode | ||
| ) |
request a preferred video I/O mode for debug/testing.
You will get errors if the driver does not support the specified mode.
0 = auto-detect
1 = force I/O using read()
2 = force memory mapped I/O using mmap()
3 = force USERPTR I/O (v4l2 only)
Referenced by zbar::Processor::request_iomode().
| int zbar::zbar_processor_request_size | ( | zbar_processor_t * | processor, |
| unsigned | width, | ||
| unsigned | height | ||
| ) |
request a preferred size for the video image from the device.
the request may be adjusted or completely ignored by the driver.
Referenced by zbar::Processor::request_size().
| int zbar::zbar_processor_set_active | ( | zbar_processor_t * | processor, |
| int | active | ||
| ) |
control the processor in free running video mode.
only works if video input is initialized. if threading is in use, scanning will occur in the background, otherwise this is only useful wrapping calls to zbar_processor_user_wait(). if the library output window is visible, video display will be enabled.
Referenced by zbar::Processor::set_active(), and zbar_processor_parse_config().
| int zbar::zbar_processor_set_config | ( | zbar_processor_t * | processor, |
| zbar_symbol_type_t | symbology, | ||
| zbar_config_t | config, | ||
| int | value | ||
| ) |
set config for indicated symbology (0 for all) to specified value.
Referenced by zbar::Processor::set_config(), and zbar_processor_parse_config().
| zbar_image_data_handler_t* zbar::zbar_processor_set_data_handler | ( | zbar_processor_t * | processor, |
| zbar_image_data_handler_t * | handler, | ||
| const void * | userdata | ||
| ) |
setup result handler callback.
the specified function will be called by the processor whenever new results are available from the video stream or a static image. pass a NULL value to disable callbacks.
| processor | the object on which to set the handler. |
| handler | the function to call when new results are available. |
| userdata | is set as with zbar_processor_set_userdata(). |
Referenced by zbar::Processor::set_handler().
| void zbar::zbar_processor_set_userdata | ( | zbar_processor_t * | processor, |
| void * | userdata | ||
| ) |
associate user specified data value with the processor.
| int zbar::zbar_processor_set_visible | ( | zbar_processor_t * | processor, |
| int | visible | ||
| ) |
show or hide the display window owned by the library.
the size will be adjusted to the input size
Referenced by zbar::Processor::set_visible(), and zbar_processor_parse_config().
| int zbar::zbar_processor_user_wait | ( | zbar_processor_t * | processor, |
| int | timeout | ||
| ) |
wait for input to the display window from the user (via mouse or keyboard).
Referenced by zbar::Processor::user_wait(), and zbar_processor_parse_config().
| int zbar::zbar_scan_image | ( | zbar_image_scanner_t * | scanner, |
| zbar_image_t * | image | ||
| ) |
scan for symbols in provided image.
The image format must be "Y800" or "GRAY".
Referenced by zbar::ImageScanner::scan(), and zbar_image_scanner_parse_config().
|
inlinestatic |
process next sample from RGB (or BGR) triple.
References zbar_scan_y(), zbar_scanner_get_color(), zbar_scanner_get_edge(), and zbar_scanner_get_width().
Referenced by zbar::Scanner::operator<<(), and zbar::Scanner::scan_rgb24().
| zbar_symbol_type_t zbar::zbar_scan_y | ( | zbar_scanner_t * | scanner, |
| int | y | ||
| ) |
process next sample intensity value.
intensity (y) is in arbitrary relative units.
Referenced by zbar::Scanner::operator<<(), zbar::Scanner::scan_y(), and zbar_scan_rgb24().
| zbar_scanner_t* zbar::zbar_scanner_create | ( | zbar_decoder_t * | decoder | ) |
constructor.
if decoder is non-NULL it will be attached to scanner and called automatically at each new edge current color is initialized to ZBAR_SPACE (so an initial BAR->SPACE transition may be discarded)
Referenced by zbar::Scanner::Scanner().
| void zbar::zbar_scanner_destroy | ( | zbar_scanner_t * | scanner | ) |
| zbar_symbol_type_t zbar::zbar_scanner_flush | ( | zbar_scanner_t * | scanner | ) |
flush scanner processing pipeline.
forces current scanner position to be a scan boundary. call multiple times (max 3) to completely flush decoder.
Referenced by zbar::Scanner::flush().
| zbar_color_t zbar::zbar_scanner_get_color | ( | const zbar_scanner_t * | scanner | ) |
retrieve last scanned color.
Referenced by zbar::Scanner::get_color(), and zbar_scan_rgb24().
| unsigned zbar::zbar_scanner_get_edge | ( | const zbar_scanner_t * | scn, |
| unsigned | offset, | ||
| int | prec | ||
| ) |
retrieve sample position of last edge.
Referenced by zbar_scan_rgb24().
| unsigned zbar::zbar_scanner_get_width | ( | const zbar_scanner_t * | scanner | ) |
retrieve last scanned width.
Referenced by zbar::Scanner::get_width(), and zbar_scan_rgb24().
| zbar_symbol_type_t zbar::zbar_scanner_new_scan | ( | zbar_scanner_t * | scanner | ) |
mark start of a new scan pass.
resets color to ZBAR_SPACE. also updates an associated decoder.
Referenced by zbar::Scanner::new_scan().
| zbar_symbol_type_t zbar::zbar_scanner_reset | ( | zbar_scanner_t * | scanner | ) |
clear all scanner state.
also resets an associated decoder
Referenced by zbar::Scanner::reset().
| void zbar::zbar_set_verbosity | ( | int | verbosity | ) |
set global library debug level.
| verbosity | desired debug level. higher values create more spew |
References _zbar_verbosity.
Referenced by main(), and set_verbosity().
| const zbar_symbol_t* zbar::zbar_symbol_first_component | ( | const zbar_symbol_t * | symbol | ) |
iterate components of a composite result.
| const zbar_symbol_set_t* zbar::zbar_symbol_get_components | ( | const zbar_symbol_t * | symbol | ) |
retrieve components of a composite result.
Referenced by zbar::Symbol::get_components().
| int zbar::zbar_symbol_get_count | ( | const zbar_symbol_t * | symbol | ) |
retrieve current cache count.
when the cache is enabled for the image_scanner this provides inter-frame reliability and redundancy information for video streams.
Referenced by zbar::Symbol::get_count().
| const char* zbar::zbar_symbol_get_data | ( | const zbar_symbol_t * | symbol | ) |
retrieve data decoded from symbol.
Referenced by zbar::Symbol::init().
| unsigned int zbar::zbar_symbol_get_data_length | ( | const zbar_symbol_t * | symbol | ) |
retrieve length of binary data.
Referenced by zbar::Symbol::get_data_length(), and zbar::Symbol::init().
| unsigned zbar::zbar_symbol_get_loc_size | ( | const zbar_symbol_t * | symbol | ) |
retrieve the number of points in the location polygon.
the location polygon defines the image area that the symbol was extracted from.
Referenced by zbar::Symbol::get_location_size(), zbar::Symbol::PointIterator::operator++(), and zbar::Symbol::PointIterator::PointIterator().
| int zbar::zbar_symbol_get_loc_x | ( | const zbar_symbol_t * | symbol, |
| unsigned | index | ||
| ) |
retrieve location polygon x-coordinates.
points are specified by 0-based index.
Referenced by zbar::Symbol::get_location_x(), and zbar::Symbol::PointIterator::operator*().
| int zbar::zbar_symbol_get_loc_y | ( | const zbar_symbol_t * | symbol, |
| unsigned | index | ||
| ) |
retrieve location polygon y-coordinates.
points are specified by 0-based index.
Referenced by zbar::Symbol::get_location_y(), and zbar::Symbol::PointIterator::operator*().
| int zbar::zbar_symbol_get_quality | ( | const zbar_symbol_t * | symbol | ) |
retrieve a symbol confidence metric.
| zbar_symbol_type_t zbar::zbar_symbol_get_type | ( | const zbar_symbol_t * | symbol | ) |
retrieve type of decoded symbol.
Referenced by zbar::Symbol::init().
| const zbar_symbol_t* zbar::zbar_symbol_next | ( | const zbar_symbol_t * | symbol | ) |
iterate the set to which this symbol belongs (there can be only one).
Referenced by zbar::SymbolIterator::operator++().
| void zbar::zbar_symbol_ref | ( | const zbar_symbol_t * | symbol, |
| int | refs | ||
| ) |
symbol reference count manipulation.
increment the reference count when you store a new reference to the symbol. decrement when the reference is no longer used. do not refer to the symbol once the count is decremented and the containing image has been recycled or destroyed.
Referenced by zbar::Symbol::ref().
| const zbar_symbol_t* zbar::zbar_symbol_set_first_symbol | ( | const zbar_symbol_set_t * | symbols | ) |
set iterator.
Referenced by zbar::SymbolIterator::operator++(), and zbar::SymbolIterator::SymbolIterator().
| int zbar::zbar_symbol_set_get_size | ( | const zbar_symbol_set_t * | symbols | ) |
retrieve set size.
Referenced by zbar::SymbolSet::get_size().
| void zbar::zbar_symbol_set_ref | ( | const zbar_symbol_set_t * | symbols, |
| int | refs | ||
| ) |
reference count manipulation.
increment the reference count when you store a new reference. decrement when the reference is no longer used. do not refer to the object any longer once references have been released.
Referenced by zbar::SymbolSet::ref().
| char* zbar::zbar_symbol_xml | ( | const zbar_symbol_t * | symbol, |
| char ** | buffer, | ||
| unsigned * | buflen | ||
| ) |
print XML symbol element representation to user result buffer.
| symbol | is the symbol to print |
| buffer | is the inout result pointer, it will be reallocated with a larger size if necessary. |
| buflen | is inout length of the result buffer. |
Referenced by zbar::Symbol::xml().
| int zbar::zbar_version | ( | unsigned * | major, |
| unsigned * | minor | ||
| ) |
retrieve runtime library version information.
| major | set to the running major version (unless NULL) |
| minor | set to the running minor version (unless NULL) |
References ZBAR_VERSION_MAJOR, and ZBAR_VERSION_MINOR.
Referenced by version().
| zbar_video_t* zbar::zbar_video_create | ( | void | ) |
constructor.
References _zbar_mutex_init, _zbar_video_recycle_image(), err_init(), void, zbar_image_create(), ZBAR_MOD_VIDEO, zbar_video_destroy(), and ZBAR_VIDEO_IMAGES_MAX.
Referenced by main(), zbar::Video::Video(), zbar_gtk_video_open(), and zbar_processor_init().
| void zbar::zbar_video_destroy | ( | zbar_video_t * | video | ) |
| int zbar::zbar_video_enable | ( | zbar_video_t * | video, |
| int | enable | ||
| ) |
start/stop video capture.
all buffered images are retired when capture is disabled.
Referenced by zbar::Video::enable().
|
inlinestatic |
display detail for last video error to stderr.
References _zbar_error_spew().
Referenced by main(), zbar_gtk_processing_thread(), and zbar_gtk_video_open().
|
inlinestatic |
retrieve the detail string for the last video error.
References _zbar_error_string().
|
inlinestatic |
retrieve the type code for the last video error.
References _zbar_get_error_code().
| int zbar::zbar_video_get_fd | ( | const zbar_video_t * | video | ) |
retrieve file descriptor associated with open *nix video device useful for using select()/poll() to tell when new images are available (NB v4l2 only!!).
Referenced by zbar::Video::get_fd().
| int zbar::zbar_video_get_height | ( | const zbar_video_t * | video | ) |
retrieve current output image height.
Referenced by zbar::Video::get_height().
| int zbar::zbar_video_get_width | ( | const zbar_video_t * | video | ) |
retrieve current output image width.
Referenced by zbar::Video::get_width().
| int zbar::zbar_video_init | ( | zbar_video_t * | video, |
| unsigned long | format | ||
| ) |
initialize video using a specific format for debug.
use zbar_negotiate_format() to automatically select and initialize the best available format
Referenced by zbar::Video::init().
| zbar_image_t* zbar::zbar_video_next_image | ( | zbar_video_t * | video | ) |
retrieve next captured image.
blocks until an image is available.
Referenced by zbar::Video::next_image().
| int zbar::zbar_video_open | ( | zbar_video_t * | video, |
| const char * | device | ||
| ) |
open and probe a video device.
the device specified by platform specific unique name (v4l device node path in *nix eg "/dev/video", DirectShow DevicePath property in windows).
Referenced by zbar::Video::close(), and zbar::Video::open().
| int zbar::zbar_video_request_interface | ( | zbar_video_t * | video, |
| int | version | ||
| ) |
request a preferred driver interface version for debug/testing.
Referenced by zbar::Video::request_interface().
| int zbar::zbar_video_request_iomode | ( | zbar_video_t * | video, |
| int | iomode | ||
| ) |
request a preferred I/O mode for debug/testing.
You will get errors if the driver does not support the specified mode.
0 = auto-detect
1 = force I/O using read()
2 = force memory mapped I/O using mmap()
3 = force USERPTR I/O (v4l2 only)
Referenced by zbar::Video::request_iomode().
| int zbar::zbar_video_request_size | ( | zbar_video_t * | video, |
| unsigned | width, | ||
| unsigned | height | ||
| ) |
request a preferred size for the video image from the device.
the request may be adjusted or completely ignored by the driver.
Referenced by zbar::Video::request_size().
| int zbar::zbar_window_attach | ( | zbar_window_t * | window, |
| void * | x11_display_w32_hwnd, | ||
| unsigned long | x11_drawable | ||
| ) |
associate reader with an existing platform window.
This can be any "Drawable" for X Windows or a "HWND" for windows. input images will be scaled into the output window. pass NULL to detach from the resource, further input will be ignored
Referenced by zbar::Window::attach().
| zbar_window_t* zbar::zbar_window_create | ( | void | ) |
constructor.
References _zbar_mutex_init, err_init(), void, and ZBAR_MOD_WINDOW.
Referenced by zbar::Window::Window(), zbar_gtk_init(), and zbar_processor_init().
| void zbar::zbar_window_destroy | ( | zbar_window_t * | window | ) |
| int zbar::zbar_window_draw | ( | zbar_window_t * | window, |
| zbar_image_t * | image | ||
| ) |
draw a new image into the output window.
Referenced by zbar::Window::clear(), and zbar::Window::draw().
|
inlinestatic |
display detail for last window error to stderr.
References _zbar_error_spew().
Referenced by zbar_gtk_realize().
|
inlinestatic |
retrieve the detail string for the last window error.
References _zbar_error_string().
|
inlinestatic |
retrieve the type code for the last window error.
References _zbar_get_error_code(), video, window, and zbar_negotiate_format().
| int zbar::zbar_window_get_overlay | ( | const zbar_window_t * | window | ) |
| int zbar::zbar_window_redraw | ( | zbar_window_t * | window | ) |
redraw the last image (exposure handler).
Referenced by zbar::Window::redraw().
| int zbar::zbar_window_resize | ( | zbar_window_t * | window, |
| unsigned | width, | ||
| unsigned | height | ||
| ) |
resize the image window (reconfigure handler).
this does not update the contents of the window
Referenced by zbar::Window::resize().
| void zbar::zbar_window_set_overlay | ( | zbar_window_t * | window, |
| int | level | ||
| ) |
control content level of the reader overlay.
the overlay displays graphical data for informational or debug purposes. higher values increase the level of annotation (possibly decreasing performance).
0 = disable overlay
1 = outline decoded symbols (default)
2 = also track and display input frame rate
Referenced by zbar::Window::set_overlay().
1.8.11