L_TwainGetImageEffects

Summary

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

Syntax

#include "lttwn.h"

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

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

See Also

Functions

Topics

Example

For an example, refer to L_TwainSetImageEffects.

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

LEADTOOLS TWAIN C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.