L_TwainSetImageUnit

#include "lttw2.h"

L_INT EXT_FUNCTION L_TwainSetImageUnit(hSession, nUnit)

HTWAINSESSION hSession;	/* handle to an existing TWAIN session */
L_INT nUnit;	/* image unit */

Sets the image unit value used to transfer images from the current TWAIN source.

Parameter	Description
hSession	Handle to an existing TWAIN session. This handle is obtained by calling the L_TwainInitSession function.
nUnit	Specifies the unit value to set. For more information on possible values, refer to www.twain.org/download.htm 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 internally sets the image unit capability ICAP_UNITS. For more information on this capability, refer to www.twain.org/download.htm and click on TWAIN Specification (Version 1.9).

To obtain the current image unit value, call the L_TwainGetImageUnit function

This function should be called after calling the L_TwainStartCapsNeg function and before calling the L_TwainEndCapsNeg 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:	L_TwainSetTransferOptions, L_TwainGetTransferOptions, L_TwainGetSupportedTransferMode, L_TwainSetResolution, L_TwainGetResolution, L_TwainSetImageFrame, L_TwainGetImageFrame, L_TwainGetImageUnit, L_TwainSetImageBitsPerPixel, L_TwainGetImageBitsPerPixel, L_TwainSetImageEffects, L_TwainGetImageEffects, L_TwainSetAcquirePageOptions, L_TwainGetAcquirePageOptions, L_TwainSetRGBResponse, L_TwainShowProgress, L_TwainEnableDuplex, L_TwainGetDuplexOptions, L_TwainSetMaxXferCount, L_TwainGetMaxXferCount
Topics:	Getting and Setting Capabilities
	TWAIN Functionality: Capability Functions

Example

void TestImageOptions(HTWAINSESSION hSession)
{
   L_INT nRet = SUCCESS;

   L_TwainStartCapsNeg (hSession);

   L_INT nUnit;
   nRet = L_TwainGetImageUnit (hSession, &nUnit);
   if (nRet == SUCCESS)
   {
      if (nUnit != TWUN_INCHES)
         L_TwainSetImageUnit(hSession, TWUN_INCHES);
   }

   L_INT nBPP;
   nRet = L_TwainGetImageBitsPerPixel (hSession, &nBPP);
   if (nRet == SUCCESS)
   {
      if (nBPP != 24)
         L_TwainSetImageBitsPerPixel (hSession, 24);
   }

   L_TwainEndCapsNeg (hSession);
}