Introduction

This chapter tells you what you need to know to get started with APGetInfo. You will learn:

  • The basic structure of APGetInfo commands
  • How to get product information about your installation of APGetInfo

APGetInfo Command Basics

All APGetInfo commands that you run from the command line start with the apgetinfo command name. The command name is followed by one or more options, which begin with a dash. Commands that you use to obtain information about a PDF document must also include an input file specification. For example, the following command instructs APGetInfo to display font information about myfile.pdf:

$apgetinfo -font  pathname\myfile.pdf

Note: $ represents the command prompt. Two command options that do not require any PDF input, and therefore do not include an input file specification, are -v and -h. For example:

$apgetinfo -v

and

$apgetinfo -h

These options display information about the APGetInfo product—version number and usage (help) information—and are described in detail in this chapter. The remaining options, which are used to retrieve information from PDF files and perform related tasks, are discussed in subsequent chapters.

Displaying the Product Version Number

It is a good idea to test your installation of APGetInfo by displaying the product version number. You will also need this number if you ever contact Appligent’s Customer Support with a question.

Command

$apgetinfo -v

Result

The following listing is typical of the output you would receive. In addition to the product version number, it contains the release date and registration number.  It also indicates that the registration number is valid.

Typical listing produced by -v option

# APGetInfo Version X.X Build Date XXXX, Library Version X.X.X
# Registration Number XXXX-XXXX-XXXX-XXXX-XXXX-XXXX
# License is valid.

Displaying Product Usage Information

If you have a question about the command syntax or a command option, you can get help by displaying product usage information.

Command

$apgetinfo -h

Typical listing produced by -h option or -help option

APGetInfo Usage