L_TwainSetResolution

Summary

Sets the horizontal and vertical resolution used to transfer images from the current TWAIN source.

Syntax

L_LTTWN_API L_INT L_TwainSetResolution(hSession, pXRes, pYRes)

Parameters

HTWAINSESSION hSession

Handle to an existing TWAIN session. This handle is obtained by calling the L_TwainInitSession or L_TwainInitSession2 function.

pTW_FIX32 pXRes

The horizontal resolution value to set.

pTW_FIX32 pYRes

The vertical resolution value to set.

Returns

Comments

This function internally sets the horizontal and vertical resolution capabilities ICAP_XRESOLUTION and ICAP_YRESOLUTION. For more information on these capabilities, refer to the TWAIN specification.

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; 
}