-
nin
-
The number of input coordinates.
-
inperm
-
An optional array with "nin" elements which, for each input
coordinate, should contain the number of the output
coordinate whose value is to be used (note that this array
therefore defines the inverse coordinate transformation).
Coordinates are numbered starting from 1.
For details of additional special values that may be used in
this array, see the description of the "constant" parameter.
If a NULL pointer is supplied instead of an array, each input
coordinate will obtain its value from the corresponding
output coordinate (or will be assigned the value AST__BAD if
there is no corresponding output coordinate).
-
nout
-
The number of output coordinates.
-
outperm
-
An optional array with "nout" elements which, for each output
coordinate, should contain the number of the input coordinate
whose value is to be used (note that this array therefore
defines the forward coordinate transformation). Coordinates
are numbered starting from 1.
For details of additional special values that may be used in
this array, see the description of the "constant" parameter.
If a NULL pointer is supplied instead of an array, each output
coordinate will obtain its value from the corresponding
input coordinate (or will be assigned the value AST__BAD if
there is no corresponding input coordinate).
-
constant
-
An optional array containing values which may be assigned to
input and/or output coordinates instead of deriving them
from other coordinate values. If either of the "inperm" or
"outperm" arrays contains a negative value, it is used to
address this "constant" array (such that -1 addresses the
first element, -2 addresses the second element, etc.) and the
value obtained is used as the corresponding coordinate value.
Care should be taken to ensure that locations lying outside
the extent of this array are not accidentally addressed. The
array is not used if the "inperm" and "outperm" arrays do not
contain negative values.
If a NULL pointer is supplied instead of an array, the
behaviour is as if the array were of infinite length and
filled with the value AST__BAD.
-
options
-
Pointer to a null-terminated string containing an optional
comma-separated list of attribute assignments to be used for
initialising the new PermMap. The syntax used is identical to
that for the astSet function and may include "printf" format
specifiers identified by "%" symbols in the normal way.
-
...
-
If the "options" string contains "%" format specifiers, then
an optional list of additional arguments may follow it in
order to supply values to be substituted for these
specifiers. The rules for supplying these are identical to
those for the astSet function (and for the C "printf"
function).