xcall AUI, AUI_IMAGE, IMGOP_CAPTURE, handle, status, fspec, comp, winid
IMGOP_CAPTURE captures the screen or a window to a file. The concept is similar to that for IMGOP_ACQUIRE, except that the source of the image is the screen/monitor rather than a scanner.
The parameter sequence and interpretation is also nearly identical to IMGOP_CAPTURE. The main exception is the last parameter (which in IMGOP_CAPTURE specifies the title to put on the scan dialog). Here it identifies the screen option to capture:
Parameters
winid (String) [in]
indicates the image source:
Symbol |
Value |
Meaning |
---|---|---|
IMGCWF_CURWIN |
-2 |
current A-Shell window or modal dialog (if applicable) |
IMGCWF_SCREEN |
-1 |
entire screen (primary monitor only) |
IMGCWF_MAIN |
0 |
main A-Shell window |
|
0### |
arbitrary window or control handle ### |
|
### |
id of the AUI control to capture |
|
name |
name of the AUI control to capture |
Note that options -2 and 0 capture the target window/dialog and anything above it.
comp [in]
In addition to the values shown in Acquire, comp in this context (screen capture) supports these additional flags:
Flag |
Value |
Meaning |
---|---|---|
IMGCF_CLIENT |
&h00080000 |
Capture just the client area of the target window. Else include window border, title bar, menu, etc. |
IMGCF_GRAY |
&h00100000 |
Convert captured image to grayscale |
All of the following imply grayscale |
||
IMGCF_BI_SCATTER |
&h00200000 |
Convert to bi-level using scatter method |
IMGCF_BI_DITHER |
&h00400000 |
Convert to bi-level using dither method |
IMGCF_BI_THRESH |
&h00800000 |
Convert to bi-level using threshold method |
IMGCF_NEGATE |
&h01000000 |
Negative image (useful with black window bg) |
IMGCF_INKSAVER |
&h02000000 |
Save ink by converting most common color to white* |
*The "ink saver" option attempts to address the common complaint about graphic screen images using up too much printer ink or toner. It analyzes the image to identify the color responsible for the most ink, then converts that color to white (requiring no ink). Any pixels that were originally white are changed to a light-gray so as to not completely disappear into the background.
History
2011 May, A-Shell 5.1.1215: function added to A-Shell