LTwain::GetImageEffects

Show in webframe

#include "ltwrappr.h"

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

L_UINT32 ulFlags;	/* optional flags */
pTW_FIX32 pBrightness;	/* pointer to a variable */
pTW_FIX32 pContrast;	/* pointer to a variable */
pTW_FIX32 pHighlight;	/* pointer to a variable */

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

Parameter	Description
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.
pBrightness	Pointer to a variable to be updated with the current brightness capability value. For more information on possible values, refer to http://www.twain.org/ and click on TWAIN Specification (Version 1.9).
pContrast	Pointer to a variable to be updated with the current contrast capability value. For more information on possible values, refer to http://www.twain.org/ and click on TWAIN Specification (Version 1.9).
pHighlight	Pointer to a variable to be updated with the current highlight capability value. For more information on possible values, refer to http://www.twain.org/ and click on TWAIN Specification (Version 1.9).

Returns

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 http://www.twain.org/ and click on TWAIN Specification (Version 1.9).

To set these capabilities, call the LTwain::SetImageEffects function.

Required DLLs and Libraries

LTTWN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:	LTwain::SetTransferOptions, LTwain::GetTransferOptions, LTwain::GetSupportedTransferMode, LTwain::SetResolution, LTwain::GetResolution, LTwain::SetImageFrame, LTwain::GetImageFrame, LTwain::SetImageUnit, LTwain::GetImageUnit, LTwain::SetImageBitsPerPixel, LTwain::GetImageBitsPerPixel, LTwain::SetImageEffects, LTwain::SetAcquirePageOptions, LTwain::GetAcquirePageOptions, LTwain::SetRGBResponse, LTwain::ShowProgress, LTwain::EnableDuplex, LTwain::GetDuplexOptions, LTwain::SetMaxXferCount, LTwain::GetMaxXferCount
Topics:	Getting and Setting Capabilities
	TWAIN Functionality: Capability Functions

Example

For an example, refer to LTwain::SetImageEffects.