1.1 Document Organization

The VICAR RTL (Run-Time Library) is a collection of subroutines for writing image processing software. We divide these subroutines into six packages, each of which is described in its own section:

• Image I/O: A set of subroutines to allow the input and output of image data to image files .
• Label I/O: A set of subroutines allowing access to information stored in the “VICAR label”. The VICAR label contains both information about the file and user supplied information .
• Parameter I/O: A set of subroutines which allow access to user supplied parameters, from both the command line and from files .
• Translation Routines: Subroutines to translate pixel formats .
• FORTRAN String Conversion Routines: Subroutines to convert from and to differing string representations .
• Utility Routines: Miscellaneous subroutines for terminal I/O, program termination, etc.

VICAR data formats are first discussed in detail to provide the basic knowledge needed. Next is an introduction to programming under VICAR. This includes general information, argument passing conventions and how to write your first program under VICAR.
Succeeding sections cover the six subroutine packages listed above, describing each subroutine call in detail. Subroutine descriptions are followed by notes on using the VICAR run-time library and examples of use. An appendix contains detailed descriptions of all the error messages and status codes from run-time library calls.
The VICAR Virtual Raster Display Interface (VRDI) provides device independent access to display devices. Use of the VRDI is deprecated and should not be used for new code It is described in a separate manual: “MIPL Virtual Raster Display Interface User's Reference Guide, JPL D-5100”, available in TeX dvi form:  /vrdi/vrdi.dvi.