Web Demos

BARCODE READER SDK DEMO

Explore the flexibe barcode reading settings to optimize for your specific usage scenario.

WEB TWAIN SDK DEMO

Try the most popular web scanner features: scan images, import local images and PDF files, edit, save to local, upload to database, and etc.

BARCODE READER JAVASCRIPT DEMO

Transform any camera-equipped devices into real-time, browser-based barcode and QR code scanners.

MRZ SCANNER WEB DEMO

Detects the machine-readable zone of a passport, scans the text, and parses into human-readable data.

APP STORE DEMOS

BARCODE READER SDK FOR IOS

BARCODE READER SDK FOR ANDROID

VIEW MORE DEMOS >
Dev Center
Table of contents

Thanks for downloading Dynamsoft Barcode Reader Package!

Your download will start shortly. If your download does not begin, click here to retry.

BarcodeColourModes

BarcodeColourModes defines the barcode colour modes. It consists of one or more modes, with each representing a different colour environment.

Value Type Value Range Default Value Template Structure Type
int / EnumBarcodeColourMode N/A BICM_DARK_ON_LIGHT ImageParameter

Candidate Mode List

  • BICM_DARK_ON_LIGHT
  • BICM_LIGHT_ON_DARK
  • BICM_DARK_ON_DARK
  • BICM_LIGHT_ON_LIGHT
  • BICM_DARK_LIGHT_MIXED
  • BICM_DARK_ON_LIGHT_DARK_SURROUNDING

BICM_DARK_ON_LIGHT

The target barcode is a dark item on a light background. This mode has the following arguments for further customizing.

BICM_DARK_ON_LIGHT_DARK_SURROUNDING

The target barcode is a dark item on a light background surrounded by dark. This mode has the following arguments for further customizing.

BICM_LIGHT_ON_DARK

The target barcode is a light item on a dark background. Not supported yet.

BICM_DARK_ON_DARK

The target barcode is a dark item on a dark background. Not supported yet.

BICM_LIGHT_ON_LIGHT

The target barcode is a light item on a light background. Not supported yet.

BICM_DARK_LIGHT_MIXED

The target barcode is on background which is mixed by dark and light. Not supported yet.

Setting Methods

As PublicRuntimeSettings Member

BarcodeColourModes can be set dynamically during runtime as a member of FurtherModes, which is a member of PublicRuntimeSettings struct, it is an array with 8 BarcodeColourMode Enumeration items.

Code Snippet in C++

//...other codes
PublicRuntimeSettings* pSettings = new PublicRuntimeSettings;
int errorCode = reader->GetRuntimeSettings(pSettings);
pSettings->barcodeColourModes[0] = BICM_DARK_ON_LIGHT;
reader->UpdateRuntimeSettings(pSettings);
reader->SetModeArgument("BarcodeColourModes", 0, "LightReflection", "1");
delete pSettings;
//...other codes

Remarks
GetModeArgument and SetModeArgument need to be called for getting and setting Arguments.

See Also

As JSON Parameter

BarcodeColourModes as a JSON parameter is a JSON Object array. Each JSON object is defined as below.

Key Name Key Value Description
Mode Any one in Candidate Mode List as string (Required) Specifies a target barcode colour mode.
LightReflection A number from value range of LightReflection (Optional) Sets the Argument LightReflection.
LibraryFileName A string from value range of LibraryFileName (Optional) Sets the Argument LibraryFileName.
LibraryParameters A string from value range of LibraryFileName (Optional) Sets the Argument LibraryFileName.

JSON Parameter Example

{
    "BarcodeColourModes": [
        {
            "Mode": "BICM_DARK_ON_LIGHT", 
            "LightReflection": 1
        },
        {
            "Mode": "BICM_DARK_ON_LIGHT", 
            "LightReflection": 0
        }
    ]
}

Candidate Argument List

LightReflection

Sets if there is light reflection on the barcode zone.

Value Type Value Range Default Value Valid For
int [0, 1] 1 BICM_DARK_ON_LIGHT
BICM_DARK_ON_LIGHT_DARK_SURROUNDING

Remarks

  • 0: no light reflection.
  • 1: has light reflection.

LibraryFileName

Sets the file name of the library to load dynamically.

Value Type Value Range Default Value Valid For
string A string value representing file name. ”” All modes

Remarks
The library must be in the same place with Dynamsoft Barcode Reader Library.

LibraryParameters

Sets the parameters passed to the library to load dynamically.

Value Type Value Range Default Value Valid For
string A string value representing parameters. ”” All modes

This page is compatible for:

Version 7.5.0

Is this page helpful?

YesYes NoNo

In this article:

latest version

    • Latest version
    • Version 9.x
      • Version 9.2.0
      • Version 9.0.0
    • Version 8.x
      • Version 8.8.0
      • Version 8.6.0
      • Version 8.4.0
      • Version 8.2.0
      • Version 8.1.2
      • Version 8.1.0
      • Version 8.0.0
    • Version 7.x
      • Version 7.6.0
      • Version 7.5.0
    Change +
    © 2003–2022 Dynamsoft. All rights reserved.
    Privacy Statement / Site Map / Home / Purchase / Support