#ifndef __TTWAIN_UTIL_H__

#define __TTWAIN_UTIL_H__

#include "ttwain.h"

#undef TNZAPI

#ifdef TNZ_IS_DEVICELIB

#define TNZ_EXPORT_API

#else

#define TNZ_IMPORT_API

#endif

#ifdef __cplusplus

extern "C" {

#endif

int TTWAIN_IsAvailable(void);

void TTWAIN_SetAvailable(TWAINAVAILABLE status);

char *TTWAIN_GetLastError(TUINT32 *rc, TUINT32 *cc);

int TTWAIN_GetResolution(float *min, float *max, float *step, float *def);

int TTWAIN_GetOpticalResolution(float *min, float *max, float *step, float *def);

int TTWAIN_GetBrightness(float *min, float *max, float *step, float *def);

int TTWAIN_GetContrast(float *min, float *max, float *step, float *def);

int TTWAIN_GetThreshold(float *min, float *max, float *step, float *def);

int TTWAIN_GetPhysicalWidthWAdf(float *width);

int TTWAIN_GetPhysicalHeightWAdf(float *height);

int TTWAIN_GetMinimumWidthWAdf(float *width);

int TTWAIN_GetMinimumHeightWAdf(float *height);

int TTWAIN_GetPhysicalWidthWoAdf(float *width);

int TTWAIN_GetPhysicalHeightWoAdf(float *height);

int TTWAIN_GetMinimumWidthWoAdf(float *width);

int TTWAIN_GetMinimumHeightWoAdf(float *height);

int TTWAIN_SupportsPixelType(TTWAIN_PIXTYPE pix);

int TTWAIN_SupportsFeeder(void);

int TTWAIN_SupportsCompressionType(TW_UINT16 comprType);

int TTWAIN_GetSupportedCaps(void);

int TTWAIN_GetFeeder(void);

int TTWAIN_IsFeederLoaded(void);

/* this function should return the current value */

int TTWAIN_GetCurrentPixelType(TTWAIN_PIXTYPE *pixType);

/*                                          */

int TTWAIN_IsCapResolutionSupported(void);

int TTWAIN_IsCapOpticalResolutionSupported(void);

int TTWAIN_IsCapBrightnessSupported(void);

int TTWAIN_IsCapContrastSupported(void);

int TTWAIN_IsCapThresholdSupported(void);

int TTWAIN_IsCapPhysicalWidthSupported(void);

int TTWAIN_IsCapPhysicalHeightSupported(void);

int TTWAIN_IsCapMinimumWidthSupported(void);

int TTWAIN_IsCapMinimumHeightSupported(void);

int TTWAIN_IsCapPixelTypeSupported(void);

int TTWAIN_IsCapFeederSupported(void);

int TTWAIN_IsCapImageLayoutSupported(void);

int TTWAIN_IsCapOrientationSupported(void);

int TTWAIN_IsCapDeviceOnLineSupported(void);

int TTWAIN_IsCapBitDepthSupported(void);

int TTWAIN_IsCapBitOrderSupported(void);

int TTWAIN_IsCapCompressionSupported(void);

int TTWAIN_SetResolution(float resolution);

int TTWAIN_SetContrast(float contrast);

int TTWAIN_SetBrightness(float brightness);

int TTWAIN_SetThreshold(float threshold);

int TTWAIN_SetXScaling(float scale);

int TTWAIN_SetYScaling(float scale);

int TTWAIN_SetPixelType(TTWAIN_PIXTYPE pixtype);

int TTWAIN_SetBitDepth(USHORT bitDepth);

int TTWAIN_SetBitOrder(TTWAIN_BITORDER bitOrder);

int TTWAIN_SetImageLayout(float L, float T, float R, float B);

int TTWAIN_SetOrientation(USHORT orientation);

int TTWAIN_SetFeeder(int status); /* TRUE->enabled */

int TTWAIN_SetPage(void);

void TTWAIN_DumpCapabilities(void (*trace_fun)(const char *fmt, ...));

/*  USER INTERFACE */

int TTWAIN_HasControllableUI(void);

/* Return 1 if source claims UI can be hidden (see SetUIStatus above)

   Return 0 if source says UI *cannot* be hidden

   Return -1 if source (pre TWAIN 1.6) cannot answer the question. */

int TTWAIN_GetUIStatus(void);

void TTWAIN_SetUIStatus(int status);

int TTWAIN_IsDeviceOnLine(void); /* -1 unknown, 0 no, 1 yes      */

/* info about the twain driver              */

char *TTWAIN_GetManufacturer(void);  /*                              */

char *TTWAIN_GetProductFamily(void); /* return an internal static var*/

char *TTWAIN_GetProductName(void);   /* don't free ret. value        */

char *TTWAIN_GetVersion(void);		 /*                              */

char *TTWAIN_GetTwainVersion(void);  /*                              */

int TTWAIN_Native2Raster(void *handle, void *the_ras, int *lx, int *ly);

int TTWAIN_SetXferMech(TTWAIN_TRANSFER_MECH mech, void *ptr, TUINT32 size,

					   int preferredLx, int preferredLy, TUINT32 numberOfImages);

/*            NATIVE  BUFFERED	       FILE

mech          the transfer mechanism

ptr	       0       memory buffer      ?Not Impl.  filename ?

size	       0       size of the buffer ?Not Impl.?

preferredLx    lx      lx                 ?Not Impl.? lx?

preferredLy    ly      ly                 ?Not Impl.? ly?

numberOfImages 1,2,.... or -1 for all in the ADF

*/

#endif

#ifdef NOTES

here

/* The XScaling cap. should be negotiated before the YScaling, this is because

   some Sources may set the YScaling capability whenever XScaling capability 

   is set, to maintain a square aspect ratio for Applications that do not 

   bother to negotiate YScaling capability. (note from Twain Spec 1.9 draft)

*/

#endif

#ifdef __cplusplus

}

#endif