NCL Website header
[an error occurred while processing this directive]

NhlAddOverlay

The Fortran name of this function is NhlFAddOverlay.

This function adds an overlay plot member to a base plot.


C Synopsis

#include <ncarg/hlu/hlu.h>
#include <hfile for Base Plot Object>

NhlErrorTypes NhlAddOverlay(
	        int		base_id,
		int		transform_id,
		int		after_id
		)

Fortran Synopsis

      subroutine NhlFAddOverlay(base_id, transform_id, after_id, ierr)
      integer base_id, transform_id, after_id, ierr

Arguments

base_id (input)
Identifies the plot object to be used as the base plot.
transform_id (input)
Identifies the Transform object to be overlaid on the base plot.
after_id (input)
If the base plot already contains one or more overlays, identifies the existing overlay that the new overlay is to follow in the overlay sequence. A value less than 0 specifies that the new overlay is to be added to the end of the sequence. If the value is the id of the base plot itself, the new overlay is placed just behind the base plot in the sequence.
ierr (output, Fortran only)
Error code.

Types

Type name:		NhlTErrorTypes
Definition:
typedef enum _NhlErrType{
	NhlFATAL	= -4,	/* "FATAL"	*/
	NhlWARNING	= -3,	/* "WARNING"	*/
	NhlINFO		= -2,	/* "INFO"	*/
	NhlNOERROR	= -1	/* "NOERROR"	*/
} NhlErrorTypes;