NhlDataPolyline

The Fortran name of this function is NhlFDataPolyline.

Given arrays containing the X and Y coordinates of points in data coordinate space, this function outputs an immediate-mode polyline connecting each of the points.


C Synopsis

#include <ncarg/hlu/hlu.h>
#include <hfile for Transform class object>

NhlErrorTypes NhlDataPolyline(
		int	pid,
		float 	*x,
		float	*y,
		int	n,
		)

Fortran Synopsis

      subroutine NhlFDataPolyline(pid, x, y, n, ierr)
      integer pid, n, ierr
      real x(n), y(n)

Arguments

pid
Id of a Transform class plot object with an established data transformation.
x
Array of X-Axis coordinates values in data coordinate space.
y
Array of Y-Axis coordinates values in data coordinate space.
n
Number of elements in the coordinate arrays x and y.
ierr (Fortran only)
Error code.

Description

This function draws an immediate mode polyline in the current data coordinate space of the Transform class plot object specified by the parameter pid. An immediate mode polyline is a polyline that appears as soon as the low-level point buffer is flushed after the function is called. It is not connected with the plot object's Draw method.

V4.0 NOTE: There is currently no public interface for setting the line attributes of immediate mode polylines.


Return Values

The NhlDataPolyline C function returns a value of type NhlErrorTypes, and the NhlFDataPolyline Fortran subroutine returns the error in ierr. The following table indicates what the various return Error Values mean:
Value	|			Meaning
--------+-------------------------------------------------
NOERROR	|	function successful
--------+-------------------------------------------------
INFO	|	minor recoverable error
--------+-------------------------------------------------
WARNING	|	recoverable error
--------+-------------------------------------------------
FATAL	|	function failed; continuing the program
	|       may result in core dump


See Also


Copyright

Copyright 1987,1988,1989,1991,1993,1994,1995
University Corporation for Atmospheric Research
All Rights Reserved

Reference Manual Control Panel

NG4 Home, Index, Examples, Glossary, Feedback, Ref Contents, Ref WhereAmI?


$Revision: 1.7 $ $Date: 1995/07/26 23:27:31 $