Saving macros

EscapeE not only enables you to save any macros which have been downloaded with a document, but also enables you to create new macros from the pages of the document - see Saving as a macro, below.

To save any macros found in a file, select Save downloaded macros in the library from the 'File' menu. The Console window will confirm that the macro has been created (no conventional output stream will be produced because it is stored in the Macro library).

Alternatively, choose Export... from the 'File' menu then select the Macros format.

Macros are stored in the folder in the following search order:

1.	A /MACROS option on the command line or in the PCLVIEW section of an INI file.

2.	The RTPCLMACROS environment symbol if it exists.

3.	A folder called MACROS in the library root folder. The library root folder is determined as follows: a. The RTLIBROOT symbol if it exists b. The INSTALLROOTDIR symbol if it exists c. The parent folder of the software folder.

Saving as a macro

In the general case, the best way to create new macro(s) is by exporting the page(s) to be saved in HP PCL format. See the 'Save as a macro' option on the 'PCL options...' dialogue: To set options for PCL export.

In the simple case, when there is only a single page to be made into a macro that does not use downloaded resources, you may:

1.	Select Save page as macro... from the 'File' menu.

2.	Enter a number for the macro (the default starting number is 100).

3.	Click Save.

The Console window will confirm that the macro has been created, e.g.

Saving page as macro 100

Using macros on the command-line

The macro number defaults to 100 but may be specified in the command line e.g.

escapee test.prn /macro 999

It may be invoked in a command such as

{escape}&f999Y{escape}&f3X

To include it in the EscapeE macro library it would need to be copied to the appropriate folder with the name 999.mcr