next up previous 264
Next: AST_PARAMETERNAME - Get the name of the global parameter at a given index within the Table
Up: AST Routine Descriptions
Previous: AST_OUTLINEX - Create a new Polygon outling values in a 2D data grid


AST_OVERLAP - Test if two regions overlap each other

Description:
This function returns an integer value indicating if the two supplied Regions overlap. The two Regions are converted to a commnon coordinate system before performing the check. If this conversion is not possible (for instance because the two Regions represent areas in different domains), then the check cannot be performed and a zero value is returned to indicate this.
Invocation:
RESULT = AST_OVERLAP( THIS, THAT, STATUS )
Arguments:
THIS = INTEGER (Given)
Pointer to the first Region.
THAT = INTEGER (Given)
Pointer to the second Region.
STATUS = INTEGER (Given and Returned)
The global status.
Returned Value:
AST_OVERLAP = INTEGER
A value indicating if there is any overlap between the two Regions. Possible values are:

0 - The check could not be performed because the second Region could not be mapped into the coordinate system of the first Region.

1 - There is no overlap between the two Regions.

2 - The first Region is completely inside the second Region.

3 - The second Region is completely inside the first Region.

4 - There is partial overlap between the two Regions.

5 - The Regions are identical to within their uncertainties.

6 - The second Region is the exact negation of the first Region to within their uncertainties.

Notes:
  • The returned values 5 and 6 do not check the value of the Closed attribute in the two Regions.

  • A value of zero will be returned if this function is invoked with the AST error status set, or if it should fail for any reason.


next up previous 264
Next: AST_PARAMETERNAME - Get the name of the global parameter at a given index within the Table
Up: AST Routine Descriptions
Previous: AST_OUTLINEX - Create a new Polygon outling values in a 2D data grid

AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 210
R.F. Warren-Smith & D.S. Berry
24th May 2011
E-mail:ussc@star.rl.ac.uk

Copyright (C) 2009 Science \& Technology Facilities Council