In This Topic ▼

LTwain::GetImageEffects

Summary

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

Syntax

#include "ltwrappr.h"

L_INT LTwain::GetImageEffects (ulFlags, pBrightness, pContrast, pHighlight)

Parameters

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 the LTwain::SetImageEffects function.