You are here: Programmers Reference > Programmer's Reference > SessionInfo Object > LightSource

SessionInfo.LightSource property

Read-Write Property.

Type: L_LIGHT_SOURCE_ENUM

For Image Scanners Only - 5000i and iNSIGHT scanners.

Determines which scanner light source is used for all documents in the current scanning session. The solution program should change this property only before the call for ScanningManager.Scan method.

If a ScanTools Plus user exit is used with the solution program, the SessionInfo.LightSource property setting always overrides any setting in the user exit.

Note: This property does NOT affect the light source for ScanningManager.Diagnose method, because Diagnose does not use SessionInfo.

IDL

propget, HRESULT LightSource([out, retval] L_LIGHT_SOURCE_ENUM *pVal);

propput, HRESULT LightSource([in] L_LIGHT_SOURCE_ENUM newVal);

Values

L_LIGHT_SOURCE_USE_CURRENT (Default)

Use the value from one of the following sources:

  • ScanTools Plus application definition file; was set using the Application Settings dialog or during migration of an older ScanTools application.

Note: You may need to double-check the value currently in the application; especially if the application was from an older version of ScanTools/Image ScanTools software. If your application requires migrating, and you do not perform migration and saving in ScanTools Plus software, it will be silently migrated by ScanTools Plus Link Runtime, and may not have all the appropriate settings for your needs. Light Source is a setting that is affected by migrating applications. Make sure you read the ScanTools Plus help about Migrating Applications and the Set Light Source dialog.

  • ScanTools Plus user exit point INIT; this can change what was in the application definition.

L_LIGHT_SOURCE_IR

Use the Infrared light (pencil read) source on the scanner. Infrared is designed for Number 2 pencil marks. Any ink marks are typically NOT detected.

L_LIGHT_SOURCE_RED

Use the Red light (ink read) source on the scanner. Red is designed for black or blue ink pen, and Number 2 pencil marks.

Exceptions

Scanning Services Exceptions

See also

How to Implement Event Driven Scanning

 

 

See Help on Help for additional information on using this help file.

See Scantron Technical Support for additional information on technical support and training options.

See the ScanTools Suite System Requirements for further details on hardware and software requirements.

ScanTools is a suite of products; the specific information you want may appear in the help for a different module. If you don't find what you're looking for here, try one of the following:

  

Scantron Corporation

Customer Service (forms, products, and services):

1-800-SCANTRON (722-6876)

www.scantron.com

Technical Support:

1-800-445-3141

[email protected]

Copyright © 1998-2012 Scantron Corporation. All rights reserved. Use permitted only under license. www.scantron.com. No part of the Help or user guides may be reproduced in any form, or by any means, without express permission from Scantron Corporation.

LINKS TO THIRD PARTY SITES

This help system may contain links to third party websites ("Linked Sites"). The Linked Sites are not under the control of Scantron and Scantron is not responsible for the content of any Linked Site, including without limitation any link contained in a Linked Site or any changes or modifications to a Linked Site. Scantron is not responsible for web casting or any other form of transmission received from any Linked Site. Scantron provides Users with the ability to link the Assessment System to the Linked Sites as a convenience to you, and the inclusion of any link does not imply endorsement by Scantron of the Linked Site or any association with its operators.