L_TwainGetImageEffects

#include "lttwn.h"

L_LTTWN_API L_INT L_TwainGetImageEffects(hSession, ulFlags, pBrightness, pContrast, pHighlight)

Gets the current brightness, highlight, and contrast values used when transferring images from the current TWAIN source.

Parameters

HTWAINSESSION hSession

Handle to an existing TWAIN session. This handle is obtained by calling L_TwainInitSession or L_TwainInitSession2.

L_UINT32 ulFlags

Flags that indicate which capability values to get. Possible values are:

Value Meaning
TWAIN_NEGOTIATE_BRIGHTNESS [0x0010] Gets the brightness capability value.
TWAIN_NEGOTIATE_CONTRAST [0x0020] Gets the contrast capability value.
TWAIN_NEGOTIATE_HIGHLIGHT [0x0040] Gets the highlight capability value.

pTW_FIX32 pBrightness

Pointer to a variable to be updated with the current brightness capability value. For more information on possible values, refer to the TWAIN specification.

pTW_FIX32 pContrast

Pointer to a variable to be updated with the current contrast capability value. For more information on possible values, refer to the TWAIN specification.

pTW_FIX32 pHighlight

Pointer to a variable to be updated with the current highlight capability value. For more information on possible values, refer to the TWAIN specification.

Returns

Value Meaning
SUCCESS The function was successful.
< 1 An error occurred. Refer to Return Codes.

Comments

This function gets the current brightness capability ICAP_BRIGHTNESS, highlight capability ICAP_HIGHLIGHT, and contrast capability ICAP_CONTRAST values. For more information on these capabilities, refer to the TWAIN specification.

To set these capabilities, call L_TwainSetImageEffects function.

This function should be called after calling the L_TwainStartCapsNeg function and before calling the L_TwainEndCapsNeg function.

Required DLLs and Libraries

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS TWAIN C API Help