# AG\_IMAGE

> [HTML Version](ag_image.htm)

_Reviewed and revised December 2023_

**tab(-10, AG\_IMAGE); opcode, <parameters>; chr(127);**     [Tab(-10,x) Syntax Notes](ag_xxx_syntax-notes.htm.md)

**Note**: as with most other AG\_xxx functions, the subroutine front-end is preferable if available. In this case, that would be [AUI\_IMAGE](aui_image.htm.md), which see for definitions of the parameters—including _status_—referenced below.

AG\_IMAGE (35) provides access to A-Shell's image processing functions. Use the following syntax:

tab(-10,AG\_IMAGE); IMGOP\_LOAD, handle, fspec; chr(127);

tab(-10,AG\_IMAGE); IMGOP\_CLOSE, handle; chr(127);

tab(-10,AG\_IMAGE); IMGOP\_DISPLAY, handle, srow, scol, erow, ecol, flags; chr(127);

tab(-10,AG\_IMAGE); IMGOP\_LOADDISP, handle, srow, scol, erow, ecol, flags, fspec; chr(127);

tab(-10,AG\_IMAGE); IMGOP\_INFO, handle, fspec; chr(127);

tab(-10,AG\_IMAGE); IMGOP\_HIDE, handle; chr(127);

tab(-10,AG\_IMAGE); IMGOP\_ACQUIRE, handle, fspec, compfactor, appname, pages, scanflags; chr(127);

tab(-10,AG\_IMAGE); IMGOP\_SELECTSRC, handle, srcname; chr(127);

tab(-10,AG\_IMAGE); IMGOP\_TWERR, handle; chr(127);

tab(-10,AG\_IMAGE); IMGOP\_CAPTURE, handle, fspec, compfactor, winid; chr(127);

tab(-10,AG\_IMAGE); IMGOP\_SAVEAS, handle, fspec, compfactor; chr(127);

tab(-10,AG\_IMAGE); IMGOP\_PAGEINFO, handle, fspec; chr(127);



**Response**

For IMGOP\_INFO:

_status, handle, owidth, olength, dwidth, dlength, bpp_ CR

For IMGOP\_ACQUIRE:

_stspages_ <CR>  (a composite two byte value, with the status in the lower byte and the number of pages scanned in the upper byte). 

For IMGOP\_PAGEINFO:

_pages_ <CR>  (number of pages in the specified file)

For all other opcodes:

_status, handle_ CR

**Example**

map1 status, i, 4

map1 handle, i, 4

map1 imgspec\$,s,160

writecd tab(-10,AG\_IMGOP\_LOAD); handle, imgspec\$; chr(127);

input "", status ,handle



**See Also**

•	[AUI\_IMAGE](aui_image.htm.md)[xs](keyword-types.htm.md)