LTwain::SetResolution

#include "ltwrappr.h"

L_INT LTwain::SetResolution (pXRes, pYRes)

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

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 on TWAIN Specification (Version 1.9).

To obtain the current resolution value, call the LTwain::GetResolution 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::GetResolution, LTwain::SetImageFrame, LTwain::GetImageFrame, LTwain::SetImageUnit, LTwain::GetImageUnit, LTwain::SetImageBitsPerPixel, LTwain::GetImageBitsPerPixel, LTwain::SetImageEffects, LTwain::GetImageEffects, 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

L_INT LTwain__SetResolutionExample(LTwain * plTwain) 
{
   L_INT       nRet = SUCCESS; 
   TW_FIX32    XRes, YRes; 
   nRet = plTwain->GetResolution (&XRes, &YRes); 
   if (nRet == SUCCESS) 
   {
      if (XRes.Whole != 300) 
         XRes.Whole = YRes.Whole = 300; 
      nRet = plTwain->SetResolution(&XRes, &YRes); 
      if(nRet != SUCCESS)
         return nRet;
   }
   return SUCCESS;
}