xcall AUI, AUI_IMAGE, opcode, handle, status {,parameters...}

(Windows only) AUI_IMAGE allows you manage and manipulate images: scan, capture from screen, read from disk, display, convert, etc. Formats supported are BMP, PCX, JPG, TIF and PNG. The imaging operations require the use of external graphics library modules VIC32.DLL and VICTW32.DLL, which are included with the A-Shell installation package and reside in the \bin folder.

Unlike most subroutines, the parameters for AUI_IMAGE vary with the opcode. Here are the parameters that apply to all opcodes:

opcode  (Num)  [in]

Symbol	Value	Function
IMGOP_LOAD	1	Load image file from disk
IMGOP_CLOSE	2	Close image
IMGOP_DISPLAY	3	Display image
IMGOP_LOADDISP	4	Open and Display image
IMGOP_INFO	5	Retrieve Information about an image
IMGOP_HIDE	6	Remove from Display
IMGOP_ACQUIRE	7	Scan and save image (TWAIN Acquire)
IMGOP_SELECTSRC	8	Select Data Source
IMGOP_TWERR	9	Get TWAIN Error code
IMGOP_CAPTURE	10	Capture Screen
IMGOP_SAVEAS	11	Convert image

 

handle  (Num)  [in/out]

The Load operation returns this value to identify the image in subsequent calls.  It must be passed to the other operations.

status  (F,6)  [out]

is returned from every call, with 0 indicating success. It should be mapped as a floating point, since it can be negative or positive. Possible values of status are given in the Status Codes table below.

All of the other parameters are documented with they opcodes where they are used. Click on the links in the table above for specific opcodes and functions.