AST_GETREGIONPOINTS

Returns the positions that define the given Region

Description:

This routine returns the axis values at the points that define the supplied Region. The particular meaning of these points will depend on the type of class supplied, as listed below under " Applicability:" .

Invocation

CALL AST_GETREGIONPOINTS( THIS, MAXPOINT, MAXCOORD, NPOINT, POINTS, STATUS )

Arguments

THIS = INTEGER (Given)
Pointer to the Region.
MAXPOINT = INTEGER (Given)
If zero, the number of points needed to define the Region is returned in NPOINT, but no axis values are returned and all other parameters are ignored. If not zero, the supplied value should be the length of the first dimension of the POINTS array. An error is reported if the number of points needed to define the Region exceeds this number.
MAXCOORD = INTEGER (Given)
The length of the second dimension of the POINTS array. An error is reported if the number of axes in the supplied Region exceeds this number.
NPOINT = INTEGER (Returned)
The number of points defining the Region.
POINTS( MAXPOINT, MAXCOORD ) = DOUBLE PRECISION (Returned)
An array in which to return the coordinates values at the positions that define the Region. These are stored such that the value of coordinate number COORD for point number POINT is found in element POINTS(POINT,COORD).
STATUS = INTEGER (Given and Returned)
The global status.

Applicability

Region
All Regions have this attribute.
Box
The first returned position is the Box centre, and the second is a Box corner.
Circle
The first returned position is the Circle centre, and the second is a point on the circumference.
CmpRegion
Returns a value of zero for NPOINT and leaves the supplied array contents unchanged. To find the points defining a CmpRegion, use this method on the component Regions, which can be accessed by invoking AST_DECOMPOSE on the CmpRegion.
Ellipse
The first returned position is the Ellipse centre. The second is the end of one of the axes of the ellipse. The third is some other point on the circumference of the ellipse, distinct from the second point.
Interval
The first point corresponds to the lower bounds position, and the second point corresponds to the upper bounds position. These are reversed to indicate an extcluded interval rather than an included interval. See the Interval constructor for more information.
NullRegion
Returns a value of zero for NPOINT and leaves the supplied array contents unchanged.
PointList
The positions returned are those that were supplied when the PointList was constructed.
Polygon
The positions returned are the vertex positions that were supplied when the Polygon was constructed.
Prism
Returns a value of zero for NPOINT and leaves the supplied array contents unchanged. To find the points defining a Prism, use this method on the component Regions, which can be accessed by invoking AST_DECOMPOSE on the CmpRegion.

Notes: