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 $