Command Line Interface: ecview

The information provided below applies to the UNIX versions of EasyCopy.

You can also use the image viewer used in EasyCopy through a command line interface as described below.

Here is shown an example of an image displayed by ecview.

The window closes automatically if you have specified a non-zero value to the -timer option; otherwise, just use the explicit system procedures to close the window.

The syntax for the ecview command is as follows:
 

$ ecview [options] [input-file]

 
The program uses right-to-left precedence: if an option is duplicated, the value supplied with the one that is last specified (rightmost) 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 to -h.

Options and parameters (apart from path and host names) may be entered with uppercase and lowercase letters and with underscores between "words". Letters are converted to lowercase and underscores are removed during parsing. For example, -C_map and -cmap are treated the same.

Input file

Environment Options

-sysdir sysdir

Specifies the path name of the system directory directory. If the -sysdir option is not supplied, the directory pointed to by the SYSDIR variable is used. The system directory directory must be available to ecview; the normal installation procedure sets the correct value of the SYSDIR variable in the ecview script. If the path name is not available the program terminates with an error message.
 

-tmp tempdir

Specifies the directory for the temporary files. 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 ecview invocation script.
 

-display hostname:server.screen

Specifies the display on which the image is wanted. 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.

Informational Options

-help

Displays help and usage of the ecview command. The program terminates after displaying the help information.
 

-version

Displays the version and release date of ecview, and the name and version of the operating system. The program terminates after displaying the version information.

Display Window Options

-bartitle text

Specifies the title in the title bar of the window. By default the image file name is displayed.
 

-size heightxwidth

These two options specify the dimensions of the window (exclusive of frame). The default is the dimension of the input image, unless this exceeds the screen size in which case the window is made as large as possible within the screen. The image is scaled to fit the specified window size.
 

-timer secs

Specifies a time interval (secs seconds) after which the window is closed automatically.

-pageno page

Speciefies a page number of a multi-page image. The default is the first page.

 

-rotate { 0 | 90 | 180 | 270 }

Specifies a rotation of the image.

 

-mirror { none | horizontal | vertical | both }

Specify that the output image is mirrored (-mirror both is the same as -rotate 180).

 

-interpolation { anti-aliasing | bilinear | replication }

Specifies the interpolation method to apply if the image is resized; refer to the topic  Image Scaling.

 

-crop widthxheight+xoffset+yoffset

Specifies that the output image is obtained by cropping a rectangular area within the input image. The width and height of the cropped area are measured from specified xoffset and yoffset. The offsets are relative to the top-left corner of the input image:

 

 

All values are in pixel units. width+xoffset must not exceed the width of the input image, and height+yoffset must not exceed the height of the input image.

Color Options

-output { color | gray | bw | eightcolor }

This option specifies a mode that applies before -colormode is used. It corresponds to the setting you can make in the  Color Options dialog.

 

-reversal { none | color | bw | gray }

Color reversal mode. It corresponds to the setting you can make in the  Color Options dialog.

 

-removebgs n

Remove n background colors. It corresponds to the setting you can make in the  Color Options dialog, except that command line parameter supports removal of 0-255 colors, where the dialog is limited to a maximum of 5.

 

-brightness v

-contrast v

-chrominance v

These options correspond to the three color adjustment sliders in the  Color Options dialog.

These command line options are specified in the range -1.0 - +1.0 whereas the slider settings are in range -100 - +100. A specification like -brightness 0.37 is thus the same as a slider setting of 37.

 

-redtint v

-greentint v

-bluetint v

These options correspond to the three tint balance sliders in the  Color Options dialog.

These command line options are specified in the range -1.0 - +1.0 whereas the slider settings are in range -100 - +100. A specification like -redtint -0.09 is thus the same as a slider setting of -9.