NhlNDCPolyline

The Fortran name of this function is NhlFNDCPolyline.

Given arrays containing the X and Y coordinates of points in NDC 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 NhlNDCPolyline(
		int	pid,
		float 	*x,
		float	*y,
		int	n,
		)

Fortran Synopsis

      subroutine NhlFNDCPolyline(pid, x, y, n, ierr)
      integer pid, n, ierr
      float 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 NDC space.
y: Array of Y-Axis coordinates values in NDC 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 NDC space. 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 NhlNDCPolyline C function returns a value of type NhlErrorTypes, and the NhlFNDCPolyline 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

Copyright

Reference Manual Control Panel

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

$Revision: 1.7 $ $Date: 1995/07/26 23:28:08 $