IrregularPlot class

The IrregularPlot class draws immediate mode lines and may be used to map overlay plots into an irregular rectangular coordinate space.

Synopsis

Header file:		ncarg/hlu/IrregularPlot.h
Class name:		irregularPlotClass
Class pointer:		NhlirregularPlotClass
Fortran class function:	NHLFIRREGULARPLOTCLASS
Superclass:		Transform
Composite classes:	IrregularTransObj,PlotManager

Resources

Local resources

The IrregularPlot object has no local resources.

Composite resources

IrregularTransObj resources

You can access all IrregularTransObj resources. These resources define a mapping from a regular grid to the irregular coordinate system for each coordinate axis.

Assuming tfPlotManagerOn is True when a IrregularPlot object is created, you can access all PlotManager resources. You can also access resources for any of the PlotManager's composite class members. However, the PlotManager object modifies the access and behavior of some of the resources belonging to these objects, as follows:

Superclass resources

You can access all resources defined by the superclasses of the IrregularPlot object class, including:

Description

The IrregularPlot object has no Draw method of its own. Its primary function is to act as a base plot over which other plot objects may be overlaid transforming their coordinates into an irregular coordinate space. Although it has no Draw method, the IrregularPlot object does allow you to draw immediate mode polylines, using the Transform class DataPolyline functions.

You can transform a plot object into an irregularly-gridded coordinate space by overlaying it on a IrregularPlot acting as a base plot. This irregularly-gridded space may encompass the data space of any number of regularly or irregularly gridded plot objects with partially or completely disjoint data coordinate extents. With such a space defined for an IrregularPlot base plot, you can combine into a single plot many disjoint plot objects.

You define the irregular mapping, as well as the coordinate axis extents and directions, using the resources of the IrregularTransObj composite class member. Note that the IrregularTransObj allows you to define an irregular transformation for one axis and a linear or logarithmic transformation for the other axis.

Assuming tfPlotManagerOn is True when you create a IrregularPlot object, the IrregularPlot object has the same plot management capabilities as any other plot object. The IrregularPlot object does not intercept any resources belonging to its PlotManager or the PlotManager's composite class members. Therefore, you access these resources just as described for the PlotManager object itself.

The immediate mode lines draw into the Workstation object as soon as you call the DataPolyline function. They are not part of the object because they do not appear when you execute the Draw method for the IrregularPlot object. At the present time there is no way to save these lines into a segment.

Support functions

The IrregularPlot object does not define any support functions, but inherits all the support functions available to its superclass.

Status

1:The status of the immediate mode drawing functions (DataPolyline) is not yet resolved.

2: The resources of the IrregularTransObj used to set the irregular coordinate transformation need to be updated to use GenArrays.

Copyright

Reference Manual Control Panel

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

$Revision: 1.13 $ $Date: 1995/07/26 23:29:45 $