AST_WINMAP

Create a WinMap

Description:

This function creates a new WinMap and optionally initialises its attributes.

A Winmap is a linear Mapping which transforms a rectangular window in one coordinate system into a similar window in another coordinate system by scaling and shifting each axis (the window edges being parallel to the coordinate axes).

A WinMap is specified by giving the coordinates of two opposite corners (A and B) of the window in both the input and output coordinate systems.

Invocation

RESULT = AST_WINMAP( NCOORD, INA, INB, OUTA, OUTB, OPTIONS, STATUS )

Arguments

NCOORD = INTEGER (Given)
The number of coordinate values for each point to be transformed (i.e. the number of dimensions of the space in which the points will reside). The same number is applicable to both input and output points.
INA( NCOORD ) = DOUBLE PRECISION (Given)
An array containing the coordinates of corner A of the window in the input coordinate system.
INB( NCOORD ) = DOUBLE PRECISION (Given)
An array containing the coordinates of corner B of the window in the input coordinate system.
OUTA( NCOORD ) = DOUBLE PRECISION (Given)
An array containing the coordinates of corner A of the window in the output coordinate system.
OUTB( NCOORD ) = DOUBLE PRECISION (Given)
An array containing the coordinates of corner B of the window in the output coordinate system.
OPTIONS = CHARACTER ( ) (Given)
A character string containing an optional comma-separated list of attribute assignments to be used for initialising the new WinMap. The syntax used is identical to that for the AST_SET routine.
STATUS = INTEGER (Given and Returned)
The global status.

Returned Value

AST_WINMAP = INTEGER
A pointer to the new WinMap.

Notes:

Status Handling

The protected interface to this function includes an extra parameter at the end of the parameter list descirbed above. This parameter is a pointer to the integer inherited status variable: " int status" .