AST_GETMAPPING

Obtain a Mapping that converts between two Frames in a FrameSet

Description:

This function returns a pointer to a Mapping that will convert coordinates between the coordinate systems represented by two Frames in a FrameSet.

Invocation

RESULT = AST_GETMAPPING( THIS, IFRAME1, IFRAME2, STATUS )

Arguments

THIS = INTEGER (Given)
Pointer to the FrameSet.
IFRAME1 = INTEGER (Given)
The index of the first Frame in the FrameSet. This Frame describes the coordinate system for the " input" end of the Mapping.
IFRAME2 = INTEGER (Given)
The index of the second Frame in the FrameSet. This Frame describes the coordinate system for the " output" end of the Mapping.
STATUS = INTEGER (Given and Returned)
The global status.

Returned Value

AST_GETMAPPING = INTEGER
Pointer to a Mapping whose forward transformation converts coordinates from the first coordinate system to the second one, and whose inverse transformation converts coordinates in the opposite direction.

Notes: