Parameters

gif2afp behavior is governed by many parameters. The parameters are set by this hierarchy (least significant first):

  • Internal defaults
  • Environment variables
  • Configuration file
  • Command-line arguments

Command line arguments

Remember these points about the command line arguments for the gif2afp transform:
  • Options and input file names can appear on the command line in any order.
  • When you run gif2afp as a standalone transform, the blank between option and value is optional (for example, both -inkblack and -ink black are valid).
  • When you use the -o flag of the enq, lp, qprt, or lprafp commands to pass options to gif2afp, no blank is permitted between option and value is optional (for example, -o-inkblack is valid, but -o -ink black is not).
  • When you use the other-transform-options attribute on the pdpr command to pass options to gif2afp, any string containing a blank must be surrounded by single quotes (for example, both other-transform-options=-inkblack and other-transform-options='-ink black' are valid).
  • All values except file names are case-insensitive.
  • If an option is specified multiple times, the last specification remains in force.
  • If multiple configuration file names are given, they are processed in order.

Configuration file

The configuration file has entries of the form option=value, where each pair must be in on a separate line. Options and other syntax are the same as for the command line arguments and the option names are the same. Input files and configuration files cannot be specified in the configuration file (that is, nested configuration files are not supported). In the case of options without values (for example, -inv), the equals sign must be present.

Some command line options cannot be used in the configuration file or as environment variables. Options available only on the command line are noted as such in their descriptions.

If you do not specify a configuration file on the command line with the -C option, the transform checks for the existence of the default configuration file, /usr/lpp/psf/gif2afp/gif2afp.cfg with InfoPrint Manager for AIX or InfoPrint Manager for Linux and install_path\gif2afp\gif2afp.cfg with InfoPrint Manager for Windows. If this file exists, the transform uses it as the configuration file.

Here is an example of a valid configuration file:

scale = letter
r= 300
o = -
inv=
alg=afp
Note: The spaces around the equals sign (=) are optional. In this example, the option-value pair o = - means that the default output file is the standard output. Output file name computation has been disabled.

Environment variables

Environment variables have the form GIF2AFP_option, where option is the same as on the command line and the configuration file.

Some command line options cannot be used in the configuration file or as environment variables. Options available only on the command line are noted as such in their descriptions.

For example, to achieve the same effect as the configuration file in the last example, these statements have to be executed in the calling shell:

export GIF2AFP_scale=letter
export GIF2AFP_r=300
export GIF2AFP_o=-
export GIF2AFP_inv=" "
export GIF2AFP_alg=afp
There must be some value set for each desired option. For options that do not take a value, specify a blank surrounded by double quotes, for example:
export GIF2AFP_inv=" "    correct
export GIF2AFP_inv=       has no effect