-@

-@ filename

Use command file specified by filename -- all other command line options are ignored.  The file must have one command per line.

For example, assume there is a file called COMMANDS.TXT.  The file may have the following commands:

-area "0 0 10 10 inch"

-R 300

-U inch

-F tif7

-f "mytif.tif"

-noui

-sd

Then the command line:

DTWAIN_TwainSave("-@ commands.txt");

is equivalent to the following:

-area "0 0 10 10 inch" -R 300 -U inch -F tif7 -f "mytif.tif" -noui -sd

The name of the file can be a full path name.  An error is generated if the file cannot be found or opened.  If the file path contains spaces, the filename argument must be enclosed in double quotes:

DTWAIN_TwainSave("-@ \"c:\\My Response Files\\response.txt\"");

The number of commands that can be specified in the file is unlimited.  You can use the -@ option to bypass the limitation that the Microsoft Windows operating system has placed on the maximum allowable characters specified at the command prompt.  On computers running Microsoft Windows XP or later, the maximum length of the string that you can use at the command prompt is 8,191 characters. On computers running Microsoft Windows 2000 or Windows NT 4.0, the maximum length of the string that you can use at the command prompt is 2,047 characters.

Note that in the example above, C/C++ escape sequences are used to embed double quotes and backslashes in the string.  Please consult your language as to the proper way to insert double quotes and backslashes within quoted strings.

Default Setting:

No command file is used.