DTWAIN_GetLightPath

Top  Previous  Next

The DTWAIN_GetLightPath retrieves the current light path (reflective or transmissive).

 

DTWAIN_BOOL DTWAIN_GetLightPath (

DTWAIN_SOURCE

Source,

LPLONG

pLightPath );

 

Parameters

Source

An open TWAIN Source.

 

pLightPath

Pointer to the light path currently in use.

 

 

Return Values

The return value is TRUE if successful.  Otherwise FALSE is returned.

 

Comments

The DTWAIN_GetLightPath function gets the current setting of the scanner's light path.  On return pLightPath contains the current light path setting (either DTWAIN_LP_REFLECTIVE or DTWAIN_LP_TRANSMISSIVE).  If the device does not have TWAIN support for light path's, FALSE is returned.

 

Transmissive scanning is required if scanning films or transparencies.  Reflective scanning is used for normal (paper) scanning. To set the light path, call DTWAIN_IsLightPathSupported.  To determine if the device supports setting the light path, call DTWAIN_IsLightPathSupported.  To set the current light path, call DTWAIN_SetLightPath.

 

TWAIN State Transitions

The Source must be in State 4. or higher

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

 

DTWAIN Source Selection Function

 

 

See Also

Films and Transparencies