detector.h File Reference

Detector header. More...

Go to the source code of this file.

Classes
struct	jab_finder_pattern
	Finder pattern. More...
struct	jab_alignment_pattern
	Alignment pattern. More...
struct	jab_perspective_transform
	Perspective transform. More...

Macros
#define	TEST_MODE   1
#define	MAX_MODULES   145
#define	MAX_SYMBOL_ROWS   3
#define	MAX_SYMBOL_COLUMNS   3
#define	MAX_FINDER_PATTERNS   200
#define	PI   3.14159265
#define	CROSS_AREA_WIDTH   14
#define	DIST(x1, y1, x2, y2)   (jab_float)(sqrt((x1-x2)*(x1-x2) + (y1-y2)*(y1-y2)))

Enumerations
enum	jab_detect_mode { QUICK_DETECT = 0, NORMAL_DETECT, INTENSIVE_DETECT }

Functions
jab_bitmap *	binarizer (jab_bitmap *bitmap, jab_int32 channel)
	Binarize a color channel of a bitmap using local binarization algorithm. More...
jab_bitmap *	binarizerHist (jab_bitmap *bitmap, jab_int32 channel)
	Binarize a color channel of a bitmap using histogram binarization algorithm. More...
jab_bitmap *	binarizerHard (jab_bitmap *bitmap, jab_int32 channel, jab_int32 threshold)
	Binarize a color channel of a bitmap using a given threshold. More...
jab_perspective_transform *	getPerspectiveTransform (jab_point p0, jab_point p1, jab_point p2, jab_point p3, jab_vector2d side_size)
	Get perspetive transformation matrix. More...
jab_perspective_transform *	perspectiveTransform (jab_float x0, jab_float y0, jab_float x1, jab_float y1, jab_float x2, jab_float y2, jab_float x3, jab_float y3, jab_float x0p, jab_float y0p, jab_float x1p, jab_float y1p, jab_float x2p, jab_float y2p, jab_float x3p, jab_float y3p)
	Calculate transformation matrix of quadrilateral to quadrilateral. More...
void	warpPoints (jab_perspective_transform *pt, jab_point *points, jab_int32 length)
	Warp points from source image to destination image in place. More...
jab_bitmap *	sampleSymbol (jab_bitmap *bitmap, jab_perspective_transform *pt, jab_vector2d side_size)
	Sample a symbol. More...
jab_bitmap *	sampleSymbolwithNc (jab_bitmap *bitmap, jab_perspective_transform *pt, jab_vector2d side_size, jab_int32 symbol_type, jab_bitmap *ch[])
	Sample a symbol. More...
jab_bitmap *	sampleCrossArea (jab_bitmap *bitmap, jab_perspective_transform *pt)
	Sample a cross area between the host and slave symbols. More...

Variables
jab_bitmap *	test_mode_bitmap

Detailed Description

Detector header.

libjabcode - JABCode Encoding/Decoding Library

Copyright 2016 by Fraunhofer SIT. All rights reserved. See LICENSE file for full terms of use and distribution.

Contact: Huajian Liu liu@s.nosp@m.it.f.nosp@m.raunh.nosp@m.ofer.nosp@m..de Waldemar Berchtold walde.nosp@m.mar..nosp@m.berch.nosp@m.told.nosp@m.@sit..nosp@m.frau.nosp@m.nhofe.nosp@m.r.de

Function Documentation

jab_bitmap* binarizer	(	jab_bitmap *	bitmap,
		jab_int32	channel
	)

Binarize a color channel of a bitmap using local binarization algorithm.

Parameters

bitmap	the input bitmap
channel	the color channel

Returns

binarized bitmap | NULL if failed

jab_bitmap* binarizerHard	(	jab_bitmap *	bitmap,
		jab_int32	channel,
		jab_int32	threshold
	)

Binarize a color channel of a bitmap using a given threshold.

Parameters

bitmap	the input bitmap
channel	the color channel
threshold	the threshold

Returns

binarized bitmap | NULL if failed

jab_bitmap* binarizerHist	(	jab_bitmap *	bitmap,
		jab_int32	channel
	)

Binarize a color channel of a bitmap using histogram binarization algorithm.

Parameters

bitmap	the input bitmap
channel	the color channel

Returns

binarized bitmap | NULL if failed

jab_perspective_transform* getPerspectiveTransform	(	jab_point	p0,
		jab_point	p1,
		jab_point	p2,
		jab_point	p3,
		jab_vector2d	side_size
	)

Get perspetive transformation matrix.

Parameters

p0	the coordinate of the 1st finder/alignment pattern
p1	the coordinate of the 2nd finder/alignment pattern
p2	the coordinate of the 3rd finder/alignment pattern
p3	the coordinate of the 4th finder/alignment pattern
side_size	the side size of the symbol

Returns

the transformation matrix

jab_perspective_transform* perspectiveTransform	(	jab_float	x0,
		jab_float	y0,
		jab_float	x1,
		jab_float	y1,
		jab_float	x2,
		jab_float	y2,
		jab_float	x3,
		jab_float	y3,
		jab_float	x0p,
		jab_float	y0p,
		jab_float	x1p,
		jab_float	y1p,
		jab_float	x2p,
		jab_float	y2p,
		jab_float	x3p,
		jab_float	y3p
	)

Calculate transformation matrix of quadrilateral to quadrilateral.

Parameters

x0	the x coordinate of the 1st source point
y0	the y coordinate of the 1st source point
x1	the x coordinate of the 2nd source point
y1	the y coordinate of the 2nd source point
x2	the x coordinate of the 3rd source point
y2	the y coordinate of the 3rd source point
x3	the x coordinate of the 4th source point
y3	the y coordinate of the 4th source point
x0p	the x coordinate of the 1st destination point
y0p	the y coordinate of the 1st destination point
x1p	the x coordinate of the 2nd destination point
y1p	the y coordinate of the 2nd destination point
x2p	the x coordinate of the 3rd destination point
y2p	the y coordinate of the 3rd destination point
x3p	the x coordinate of the 4th destination point
y3p	the y coordinate of the 4th destination point

Returns

the transformation matrix

jab_bitmap* sampleCrossArea	(	jab_bitmap *	bitmap,
		jab_perspective_transform *	pt
	)

Sample a cross area between the host and slave symbols.

Parameters

bitmap	the image bitmap
pt	the transformation matrix

Returns

the sampled area matrix

jab_bitmap* sampleSymbol	(	jab_bitmap *	bitmap,
		jab_perspective_transform *	pt,
		jab_vector2d	side_size
	)

Sample a symbol.

Parameters

bitmap	the image bitmap
pt	the transformation matrix
side_size	the symbol size in module

Returns

the sampled symbol matrix

jab_bitmap* sampleSymbolwithNc	(	jab_bitmap *	bitmap,
		jab_perspective_transform *	pt,
		jab_vector2d	side_size,
		jab_int32	symbol_type,
		jab_bitmap *	ch[]
	)

Sample a symbol.

Parameters

bitmap	the image bitmap
pt	the transformation matrix
side_size	the symbol size in module
symbol_type	the symbol type (0,2,3,4,5: metadata for Nc will be sampled as black/white)
ch	the binarized color channels of the bitmap

Returns

the sampled symbol matrix

void warpPoints	(	jab_perspective_transform *	pt,
		jab_point *	points,
		jab_int32	length
	)

Warp points from source image to destination image in place.

Parameters

pt	the transformation matrix
points	the source points
length	the number of source points