ScaleUpModes

Parameter ScaleUpModes is for controlling the scale-up process when targets in the image are too small.

Example

{
    "ScaleUpModes": 
    [
        {
            "Mode": "SUM_LINEAR_INTERPOLATION", 
            "ModuleSizeThreshold": 4,
            "TargetModuleSize": 8
        },
        {
            "Mode": "SUM_NEAREST_NEIGHBOUR_INTERPOLATION", 
            "ModuleSizeThreshold": 4,
            "TargetModuleSize": 6
        },
        {
            "Mode": "SUM_LINEAR_INTERPOLATION",
            "LetterHeightThreshold": 10,
            "TargetLetterHeight": 50
        }
    ]
}

Parameter Summary

Parameter ScaleUpModes consist of a group of scale up mode objects. Each scale up mode object includes a candidate mode and a series of mode arguments. The mode arguments of the scale up mode object is shown as follow:

Mode Arguments

Mode Argument Name	Mode Argument Summary
Mode (Required)	Description Any one in Candidate Mode List as string
	Type String
	Candidate Mode List SUM_LINEAR_INTERPOLATION SUM_NEAREST_NEIGHBOUR_INTERPOLATION SUM_AUTO SUM_SKIP
	Default Value SUM_AUTO
AcuteAngleWithXThreshold (Optional)	Description Sets the acute angle threshold for barcode scale-up. -1: means automatically set by the library. If the module size of the barcode is smaller than the ModuleSizeThreshold and the acute angle with X of the barcode is larger than the AcuteAngleWithXThreshold, the barcode will be enlarged by a scale factor of N (the value of N is a power of 2) till N * modulesize >= TargetModuleSize.
	Type int
	Range [-1, 90]
	Default Value -1
	Valid For SUM_LINEAR_INTERPOLATION SUM_NEAREST_NEIGHBOUR_INTERPOLATION
ModuleSizeThreshold (Optional)	Description Sets the module size threshold for barcode scale-up. 0: means automatically set by the library. If the module size of the barcode is smaller than the ModuleSizeThreshold and the acute angle with X of the barcode is larger than the AcuteAngleWithXThreshold, the barcode will be enlarged by a scale factor of N (the value of N is a power of 2) till N * modulesize >= TargetModuleSize.
	Type int
	Range [1, 0x7fffffff]
	Default Value 0
	Valid For SUM_LINEAR_INTERPOLATION SUM_NEAREST_NEIGHBOUR_INTERPOLATION
TargetModuleSize (Optional)	Description Sets the module size threshold for barcode scale-up. 0: means automatically set by the library. If the module size of the barcode is smaller than the ModuleSizeThreshold and the acute angle with X of the barcode is larger than the AcuteAngleWithXThreshold, the barcode will be enlarged by a scale factor of N (the value of N is a power of 2) till N * modulesize >= TargetModuleSize.
	Type int
	Range [0, 0x7fffffff]
	Default Value 0
	Valid For SUM_LINEAR_INTERPOLATION SUM_NEAREST_NEIGHBOUR_INTERPOLATION
LetterHeightThreshold (Optional)	Description Sets the letter height threshold for character scale-up. 0 : means automatically set by the library. If the average letter height of a text line is smaller than the LetterHeightThreshold, the image will be enlarged to N times (N=2,4,8…) till N * LetterHeight >= TargetLetterHeight.
	Type int
	Range [0, 0x7fffffff]
	Default Value 0
	Valid For SUM_LINEAR_INTERPOLATION SUM_NEAREST_NEIGHBOUR_INTERPOLATION
TargetLetterHeight (Optional)	Description Sets the target letter height for character scale-up. 0 : means automatically set by the library.
	Type int
	Range [0, 0x7fffffff]
	Default Value 0
	Valid For SUM_LINEAR_INTERPOLATION SUM_NEAREST_NEIGHBOUR_INTERPOLATION
LibraryFileName (Optional)	Description Sets the file name of the library to load dynamically.
	Type String
	Range A string value representing file name.
	Default Value ""
	Valid For All modes.
LibraryParameters (Optional)	Description The library must be in the same place with Dynamsoft Barcode Reader Library.
	Type String
	Range A string value representing parameters.
	Default Value ""
	Valid For All modes.

Default Setting

If the ScaleUpModes is not configured in your template file, the following setting will be used as the default setting.

{
    "ScaleUpModes" : 
    [
        {
            "AcuteAngleWithXThreshold" : -1,
            "LetterHeightThreshold" : 0,
            "Mode" : "SUM_AUTO",
            "ModuleSizeThreshold" : 0,
            "TargetLetterHeight" : 0,
            "TargetModuleSize" : 0
        }
    ]
}

Candidate Modes Introduction

SUM_LINEAR_INTERPOLATION

Scales up using the linear interpolation method. This mode has the following arguments for further customizing:

AcuteAngleWithXThreshold
ModuleSizeThreshold
TargetModuleSize
LetterHeightThreshold
TargetLetterHeight
LibraryFileName
LibraryParameters

SUM_NEAREST_NEIGHBOUR_INTERPOLATION

Scales up using the nearest neighbour method. This mode has the following arguments for further customizing:

AcuteAngleWithXThreshold
ModuleSizeThreshold
TargetModuleSize
LetterHeightThreshold
TargetLetterHeight
LibraryFileName
LibraryParameters

SUM_AUTO

Lets the library choose a mode automatically.