L_TwainSetResolution

#include "lttwn.h"

L_LTTWN_API L_INT L_TwainSetResolution(hSession, pXRes, pYRes)

HTWAINSESSION hSession;

handle to an existing TWAIN session

pTW_FIX32 pXRes;

pointer to a variable

pTW_FIX32 pYRes;

pointer to a variable

Sets the horizontal and vertical resolution 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 or L_TwainInitSession2 function.

pXRes

The horizontal resolution value to set.

pYRes

The vertical resolution value to set.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

This function internally sets the horizontal and vertical resolution capabilities ICAP_XRESOLUTION and ICAP_YRESOLUTION. For more information on these capabilities, refer to http://www.twain.org/ and click the TWAIN Specification (Version 1.9).

To obtain the current resolution value, call the L_TwainGetResolution 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_TwainGetResolution, L_TwainSetImageFrame, L_TwainGetImageFrame, L_TwainSetImageUnit, 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, L_TwainFloatToFix32

Topics:

Getting and Setting Capabilities

 

TWAIN Functionality: Capability Functions

Example

L_INT TwainSetResolutionExample(HTWAINSESSION hSession) 
{ 
   L_INT nRet = SUCCESS; 
   nRet = L_TwainStartCapsNeg (hSession); 
   if(nRet != SUCCESS) 
      return nRet; 
   TW_FIX32 XRes, YRes; 
   nRet = L_TwainGetResolution (hSession, &XRes, &YRes); 
   if (nRet == SUCCESS) 
   { 
      if (L_TwainFix32ToFloat(&XRes) != 300.0f) 
      { 
         XRes = L_TwainFloatToFix32(300.0f); 
         YRes = L_TwainFloatToFix32(300.0f); 
         nRet = L_TwainSetResolution(hSession, &XRes, &YRes); 
         if(nRet != SUCCESS) 
            return nRet; 
      } 
   } 
   else 
      return nRet; 
   nRet = L_TwainEndCapsNeg (hSession); 
   if(nRet != SUCCESS) 
      return nRet; 
   return SUCCESS; 
} 

Help Version 19.0.2017.10.18
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS TWAIN C API Help