next up previous 264
Next: AST_DSBSPECFRAME - Create a DSBSpecFrame
Up: AST Routine Descriptions
Previous: AST_DISTANCE - Calculate the distance between two points in a Frame


AST_DOWNSIZE - Reduce the number of vertices in a Polygon

Description:
This function returns a pointer to a new Polygon that contains a subset of the vertices in the supplied Polygon. The subset is chosen so that the returned Polygon is a good approximation to the supplied Polygon, within the limits specified by the supplied parameter values. That is, the density of points in the returned Polygon is greater at points where the curvature of the boundary of the supplied Polygon is greater.
Invocation:
RESULT = AST_DOWNSIZE( THIS, MAXERR, MAXVERT, STATUS )
Arguments:
THIS = INTEGER (Given)
Pointer to the Polygon.
MAXERR = DOUBLE PRECISION (Given)
The maximum allowed discrepancy between the supplied and returned Polygons, expressed as a geodesic distance within the Polygon's coordinate frame. If this is zero or less, the returned Polygon will have the number of vertices specified by MAXVERT.
MAXVERT = INTEGER (Given)
The maximum allowed number of vertices in the returned Polygon. If this is less than 3, the number of vertices in the returned Polygon will be the minimum needed to achieve the maximum discrepancy specified by MAXERR.
STATUS = INTEGER (Given and Returned)
The global status.
Returned Value:
AST_DOWNSIZE = INTEGER
Pointer to the new Polygon.
Notes:
  • A null Object pointer (AST__NULL) will be returned if this function is invoked with STATUS set to an error value, or if it should fail for any reason.


next up previous 264
Next: AST_DSBSPECFRAME - Create a DSBSpecFrame
Up: AST Routine Descriptions
Previous: AST_DISTANCE - Calculate the distance between two points in a Frame

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