You are here: Start » Function Reference » Computer Vision » Barcodes » RecognizeBarcode_Deprecated

RecognizeBarcode_Deprecated

Header:	FIL.h
Namespace:	fil
Module:	Barcodes

Extracts information from a barcode located on the input image at a given position.

Applications: Most often used after a barcode detection filter.

Syntax

void fil::RecognizeBarcode_Deprecated
(
	const fil::Image& inImage,
	const fil::Rectangle2D& inBarcodePosition,
	ftl::Optional<const fil::CoordinateSystem2D&> inBarcodePositionAlignment,
	ftl::Optional<fil::BarcodeFormat::Type> inBarcodeFormat,
	const int inScanCount,
	const int inScanWidth,
	const float inMinStrength,
	const float inSmoothingStdDev,
	fil::Polarity::Type inPolarity,
	ftl::Conditional<ftl::String>& outDecodedText,
	ftl::Conditional<fil::BarcodeFormat::Type>& outBarcodeFormat,
	ftl::Optional<ftl::Conditional<fil::Polarity::Type>&> outBarcodePolarity = ftl::NIL,
	ftl::Optional<fil::Rectangle2D&> outAlignedBarcodePosition = ftl::NIL,
	ftl::Array<fil::Segment2D>& diagScheduledScanSegments
)

Parameters

Name	Type	Range	Default	Description
inImage	const Image&			Input image
inBarcodePosition	const Rectangle2D&			Position of the input image in which the barcode is located
inBarcodePositionAlignment	Optional<const CoordinateSystem2D&>		NIL	Adjusts the barcode rectangle to the position of the inspected object
inBarcodeFormat	Optional<BarcodeFormat::Type>		EAN13	Format of the barcode
inScanCount	const int	1 -	5	Number of parallel scans run until first successful read
inScanWidth	const int	1 -	5	Width of the single scan
inMinStrength	const float	0.0 -	5.0f	Minimal strength of an extracted edge
inSmoothingStdDev	const float	0.0 -	0.25f	Standard deviation of the gaussian smoothing applied to the profile extracted in each scan
inPolarity	Polarity::Type		Dark	Specifies whether code is darker or brighter than the background
outDecodedText	Conditional<String>&			Decoded barcode text or nothing if all of the scans failed
outBarcodeFormat	Conditional<BarcodeFormat::Type>&			Decoded barcode format or nothing if all of the scans failed
outBarcodePolarity	Optional<Conditional<Polarity::Type>&>		NIL	Decoded barcode polarity or nothing if all of the scans failed
outAlignedBarcodePosition	Optional<Rectangle2D&>		NIL
diagScheduledScanSegments	Array<Segment2D>&			Scheduled scan segments

Optional Outputs

The computation of following outputs can be switched off by passing value ftl::NIL to these parameters: outBarcodePolarity, outAlignedBarcodePosition.