//SETOPTION, option {,boolean}
This GDI printing directive is used to selectively enable various options affecting GDI printing:
Parameters
EMBEDDED-ENTITY-REFERENCES
enables the interpretation of the symbol entities via their UNICODE values. The default is to treat them as plain text, thus eliminating the remote chance that a semi-random string of data/text will be misinterpreted as containing embedded symbol entities.
IGNORE-ESCAPE-ERRORS
causes A-Shell to ignore errors occurring during the processing of the //ESCAPE directive. Normally, when such errors occur, the GDI directive itself is printed to the target device, to make it easier to spot the fact that the directive contained an error. But in the case of //ESCAPE, if you redirect the output to a device incompatible with the one for which the //ESCAPE sequence was intended, an error may be "normal", hence you wouldn't want it to appear in the output. For example, if you use //ESCAPE to embed some special PCL command into a document, but then send it to a PDF generator instead, you would probably want the fact that the PDF driver didn't support the ESCAPE to be ignored.
Example
//SETOPTION,EMBEDDED-ENTITY-REFERENCES
Symbol: Ω Code: \
//SETOPTION,EMBEDDED-ENTITY-REFERENCES,0
Ω
Comments
The booleans (default = TRUE) can be:
FALSE: FALSE, F, 0, N, OFF
TRUE: TRUE, T, 1, Y, ON (or anything else)
Since the options are all initialized to FALSE at the start of each print request, you must specify the enable the options of interest at the start of each print file. But since the default Boolean switch is TRUE, you generally don't need to specify that argument, except when you need to turn an option back off again, after having first enabled it earlier in same file.
Note: All parts of this directive are case insensitive.
