This appendix contains a "quick reference" format of the procedure-calling
parameters for all of the Display List routines. This is presented
first for C, then Fortran, then Pascal. The references
are listed according to name in what is basically alphabetical order
— it is basically the same order as is used in the reference
section. For a list of Display List procedures listed according
to functional group, see Chapter 2.
For each routine, any predefined names appropriate for that
routine are listed. These predefined names come from the "include"
files, and are initialized thus:
- C:
- Fortran:
- 〈type〉
〈name〉
- PARAMETER
( 〈name〉 =
〈value〉
)
- Pascal:
Any types or constants that are needed are also supplied.
A Word on "Pseudo-Boolean" Parameters |
 |
Many of the Display List routines require (or return) "pseudo-boolean"
values; that is, integers of which a zero value indicates "false"
and a non-zero value indicates "true." The Starbase include files
for C and Fortran make these values more mnemonic
by the definition of tokens called FALSE
and TRUE, with
integer values of 0 and 1, respectively. In this Quick Reference,
these mnemonic tokens are used in place of the corresponding integer
values in order to make the information more intuitively understandable.
Pascal, on the other hand, unlike C and Fortran,
supports a true boolean
type — it is different from the integer type. Thus, attempting
to pass the boolean values TRUE
or FALSE to any
of the following routines results in a compile error; the routines
expect integers with appropriate values. However, to make clear
the boolean-like behavior that these integer parameters have, you
may want to define your own constants with intuitive names; e.g.,
YES/NO, or TRUE_/FALSE_ (note the trailing
underscores). The Pascal section of this Quick Reference uses integer
constants called TRUE_
and FALSE_ for
such "pseudo-boolean" parameters.
Printable version
