astGetRegionFrameastGetRegionFrame - Obtain a pointer to the encapsulated Frame within a Region

Description:
This function returns a pointer to the FrameFrame represented by a RegionRegion.
Synopsis:
AstFrame $*$astGetRegionFrame( AstRegion $*$this )
Parameters:
this
Pointer to the Region.
Returned Value:
astGetRegionFrame()
A pointer to a deep copy of the Frame represented by the Region. Using this pointer to modify the Frame will have no effect on the Region. To modify the Region, use the Region pointer directly.
Notes:
  • A null ObjectObject pointer (AST__NULL) will be returned if this function is invoked with the AST error status set, or if it should fail for any reason.