You are here: Start » AVL.NET » AVS.ReadSingleBarcode Method

AVS.ReadSingleBarcode Method

Detects and recognizes a single barcode on the input image.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

public static void ReadSingleBarcode
(
	AvlNet.Image inImage,
	AvlNet.Rectangle2D? inRoi,
	AvlNet.CoordinateSystem2D? inRoiAlignment,
	AvlNet.BarcodeFormat? inBarcodeFormat,
	float inMinGradientLength,
	int inBaseBarWidth,
	int inDetectionScanCount,
	int inReadingScanCount,
	int inScanWidth,
	float inMinStrength,
	float inSmoothingStdDev,
	AvlNet.Polarity inPolarity,
	out AvlNet.Rectangle2D? outBarcodePosition,
	INullable<string> outDecodedText,
	out AvlNet.BarcodeFormat? outBarcodeFormat,
	NullableRef<NullableValue<AvlNet.Polarity>> outBarcodePolarity,
	NullableValue<AvlNet.Rectangle2D> outAlignedRoi,
	NullableRef<List<AvlNet.Rectangle2D>> outBarcodeCandidates
)

Parameters

Name Type Range Default Description
inImageAvlNet.ImageInput image.
inRoiAvlNet.Rectangle2D?Region of interest. Default value: atl::NIL.
inRoiAlignmentAvlNet.CoordinateSystem2D?Adjusts the region of interest to the position of the inspected object. Default value: atl::NIL.
inBarcodeFormatAvlNet.BarcodeFormat?EAN13Format of the barcode. Default value: EAN13.
inMinGradientLengthfloat<0.0f, INF>8.0fMinimal gradient length of edge pixels used for detecting barcodes. Default value: 8.0f.
inBaseBarWidthint<1, INF>3Estimated width of the thinnest bar. Default value: 3.
inDetectionScanCountint<1, INF>5Number of scan lines used in detecting barcode. Default value: 5.
inReadingScanCountint<1, INF>5Number of parallel scans run until first successful read. Default value: 5.
inScanWidthint<1, INF>5Width of the single scan. Default value: 5.
inMinStrengthfloat<0.0f, INF>5.0fMinimal strength of an extracted edge. Default value: 5.0f.
inSmoothingStdDevfloat<0.0f, INF>0.25fStandard deviation of the gaussian smoothing applied to the profile extracted in each scan. Default value: 0.25f.
inPolarityAvlNet.PolarityDarkSpecifies whether code is darker or brighter than the background. Default value: Dark.
outBarcodePositionAvlNet.Rectangle2D?Position of the found barcode.
outDecodedTextAvlNet.INullable<string>Decoded barcode content or nothing if all of the scans failed. This parameter cannot be null.
outBarcodeFormatAvlNet.BarcodeFormat?Decoded barcode format or nothing if all of the scans failed.
outBarcodePolarityAvlNet.NullableRef<AvlNet.NullableValue<AvlNet.Polarity>>Decoded barcode polarity or nothing if all of the scans failed. Can be null to skip this parameter calculation.
outAlignedRoiAvlNet.NullableValue<AvlNet.Rectangle2D>Input ROI after transformation (in the image coordinates). Can be null to skip this parameter calculation.
outBarcodeCandidatesAvlNet.NullableRef<System.Collections.Generic.List<AvlNet.Rectangle2D>>Places with high gradient values that are further investigated. Can be null to skip this parameter calculation.

Function Overrides

See also