Command Line Interface: easycopy

Use the easycopy command to start the Graphical User Interface of EasyCopy.

The command line syntax is as follows:

  easycopy (or ecx on UNIX)[options] [input-file] [&]  

Use the & character to start EasyCopy as a background task.

The easycopy program uses right-to-left precedence: if an option is duplicated the value supplied with the one that is last specified (right most) is used.

Options and parameters (apart from path and host names) can be abbreviated as long as they can be unambiguously identified. For example, -help can be abbreviated -h.

Input File
If an input file is supplied it becomes the current file, when the graphical user interface is opened.

Otherwise, there is no current file, until you open or capture an image.

stdin (-)

Input data can also be supplied on standard input (stdin). Supplying - as an option (a hyphen with no keyword) indicates data on standard input. In this case EasyCopy opens in a special print mode: The main window and menu is not shown, instead the Print dialog is entered directly, and EasyCopy terminates after you press Print or Cancel.

This feature is particularly useful for system integration. It allows you to call EasyCopy from another application and use it to control output of PostScript or image files in a way similar to printer drivers in Microsoft Windows.

If there are no data on standard input, or an input file is supplied explicitly, the graphical user interface opens normally.

-remove

The -remove option can be used together with an input file. If an input file is supplied on the command line, the -remove option causes the file to be deleted at exit time, but only if the file has been printed. If another file has been opened during the session, the -remove option is ignored.

-sysdir sysdir

Specifies the path name of the easycopy/system directory, where EPD and PPD files are located. If the -sysdir option is not supplied, the directory pointed to by the SYSDIR variable is used. The -sys option overrides the SYSDIR variable. The easycopy/system directory must be available to easycopy; the normal installation procedure sets the correct value of the SYSDIR variable in the easycopy script. If the path name is not available the program terminates with an error message.

-display hostname:server.screen

Ths option only applies to UNIX versions of EasyCopy.

Specifies the display on which EasyCopy is opened. If the display is not specified, the DISPLAY variable is used. If the DISPLAY variable is not set, the local screen (hostname:0.0) is the default display. The -display option overrides the DISPLAY variable.

You need a license for the display on which you open EasyCopy.

-tmpdir tempdir

Specifies the directory for the temporary files. Normally, you do not need this option; it is intended for test purposes, for example if you occasionally run a print job that requires more temporary space than is available in the default location. If the -tmp option is not supplied the value of the TMPDIR environment variable is used. The normal installation procedure sets the correct value in the easycopy invocation script.

-help

Displays help and usage information about easycopy, including a list of available options and their defaults.

-version

Displays version information, release date, operating system, and the system's primary key (used for registration).

-imagewindow { fitdialog | fullsize }

Specifies the preference for the Main Window. You may later change this setting with the View menu.

-geometry width x height + xoffset + yoffset

Specifies the size and position of the Main Window. Refer to your X Window System documentation.