Switch driver options INI files when using different check scanner models?

Switch driver options INI files when using different check scanner models?

Question: Can I switch Ranger driver options files based on the scanner model?  I would like to use one file when connected to a Digital Check TS 230 or TS 240 scanner, and a different driver options file when connected to a TS 4120.

Answer:
"Ranger for Digital Check TS-series" supports the following check scanner models:
TS200, TS210, TS215, TS220, TS230, TS240, TS300, TS350, TS400, TS500, TS4120, CX30, and BX7200

You can tell Ranger to switch driver options file by calling:
Ranger.SetDriverOptionsFileName(<file\path>)

With this in mind, I would take the following approach:
  1. Save a copy of the "DigitalCheck-TSSeries.ini" file, that you would like to use with TS 230/240 scanners, and rename it to something like "DriverOptions_TS230_TS240.ini". Then copy the new INI file to one of your application folders.
  2. On Windows 10 and later, the default location of is:
    1. C:\ProgramData\Silver Bullet Technology\Ranger\Scanner Plug-ins\DigitalCheck-TSSeries\DigitalCheck-TSSeries.ini
  3. Repeat this step for the TS-4120.  Make another copy of "DigitalCheck-TSSeries.ini" and rename it to something like "DriverOptions_TS4120.ini". Then copy the new INI file to one of your application folders.
  4. After calling Ranger.Startup(), wait until Ranger reaches the "ChangeOptions" state.
  5. In your application code, obtain the scanner model by calling:
    1. ModelName = Ranger.GetTransportInfo("General", "Model")
  6. Then tell Ranger which driver options INI file you would like to use, based on the model name, by calling:
  1. Ranger.SetGenericOptionsFileName(ini file path)
Please note: Ranger only reads from its INI files when you call:
Ranger.EnableOptions()

When multiple check scanning applications are installed on the same workstation, and they both write to the same default Ranger INI files, you can never be sure which options the other application set.

Because of this possibility, it is best to make and use a private copy of Ranger's default INI files. Use the following calls to point Ranger to your private files:
  1. Ranger.SetGenericOptionsFileName(<file\path>)
  2. Ranger.SetDriverOptionsFileName(<file\path>)

Copyright © 2023 Silver Bullet Technology
 www.sbullet.com

    • Related Articles

    • Where are the Ranger INI files located?

      Where are the Ranger configuration files located on Windows? Ranger configuration file names include: "GenericOptions.ini" "[Driver]Options.ini" (CR180Options.ini, MVXOptions.ini, etc.) "TransportInfo.ini" Filepath for Configuration files: Ranger ...

    • How can I set CAPI Ini file options through Ranger?

      The application can set the following values with the call to "SetDriverOption". After calling "EnableOptions" these options will be copied to the corresponding CAPI ini files. Use caution when setting these vales as they will overwrite the options ...

    • Where are the Ranger INI files located at on Mac?

      On Mac, INI files should be located in a hidden folder in the user's Home directory: "Users/[User's Name]/.Silver Bullet Technology/Ranger/[Scanner Name]" If the ".Silver Bullet Technology" folder is not found in the user's Home directory, hidden ...

    • Logging Ranger 4.5+ to Disk via INI files

      As of version 4.5, Ranger can log to disk via options set in the 'C:\ProgramData\Silver Bullet Technology\Logging\Ranger\Ranger.ini' file. In order to enable logging to disk automatically, ensure the following values are set in the Ranger.ini ...

    • What are the page options for the SmartSource Adaptive scanner?

      Below are the page options available for the SmartSource Adaptive. An example of a page is an item that is 8.5"x11". These settings should be modified through the Ranger CapiOptions.ini as linked below. Do not directly change CapiImage.ini. ...