Dashpack(3) a set of routines allowing you to draw curves using dashed-line

SYNOPSIS

DPCURV - draws a complete curve with a single call.

DPDRAW - called to just draw the curve by connecting a given sequence of points.

DPFRST - does a "pen-up" move to the first in a sequence of points defining a curve.

DPGETC - called with the name of an internal parameter of type CHARACTER and a character variable in which the value of that parameter is to be returned.

DPGETI - called with the name of an internal parameter of type INTEGER or REAL and an integer variable in which the integer equivalent of the value of that parameter is to be returned.

DPGETR - called with the name of an internal parameter of type INTEGER or REAL and a real variable in which the real equivalent of the value of that parameter is to be returned.

DPLAST - called to say that the latest call to DPVECT was the last one in the sequence, that drawing of the curve should be completed, and that buffers should be flushed.

DPLINE - draws the straight line joining two points. (No smoothing takes place, even if smoothing is turned on.)

DPSETC - called with the name of an internal parameter of type CHARACTER and a character variable or constant that is to supply the new value of that parameter.

DPSETI - called with the name of an internal parameter of type INTEGER or REAL and an integer expression that is to become the new value of that parameter.

DPSETR - called with the name of an internal parameter of type INTEGER or REAL and a real expression that is to become the new value of that parameter.

DPSMTH - called to create a smooth curve passing through a sequence of points and then to interpolate points along that smoothed curve and pass them on to DPDRAW.

DPVECT - does a "pen-down" move to the next in a sequence of points defining a curve.

C-BINDING SYNOPSIS

#include <ncarg/ncargC.h>

c_dpcurv
c_dpdraw
c_dpfrst
c_dpgetc
c_dpgeti
c_dpgetr
c_dplast
c_dpline
c_dpsetc
c_dpseti
c_dpsetr
c_dpsmth
c_dpvect

ACCESS

To use the Dashpack C or Fortran routines, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

MESSAGES

When error conditions are detected, the support routine SETER is called. By default, SETER writes a message to the standard error file (as defined by I1MACH(4)) and then terminates execution. It is possible to put SETER into recovery mode and regain control after a recoverable error (which includes all of the possible errors).

The possible error messages are listed below. All errors are recoverable in the sense that a user program which has called ENTSR to set recovery mode will get control back after one of these errors occurs.

DPCURV - UNCLEARED PRIOR ERROR

This error message indicates that, at the time DPCURV was called, there was an unrecovered outstanding error. In this case, DPCURV cannot continue; it forces the error message for the outstanding error to be printed and then substitutes this one for it.

DPDRAW - IMPLEMENTATION ERROR - SEE SPECIALIST

An internal error has occurred which indicates that DASHPACK has not been correctly installed. See a specialist.

DPDRAW - UNCLEARED PRIOR ERROR

This error message indicates that, at the time DPDRAW was called, there was an unrecovered outstanding error. In this case, DPDRAW cannot continue; it forces the error message for the outstanding error to be printed and then substitutes this one for it.

DPFRST - UNCLEARED PRIOR ERROR

This error message indicates that, at the time DPFRST was called, there was an unrecovered outstanding error. In this case, DPFRST cannot continue; it forces the error message for the outstanding error to be printed and then substitutes this one for it.

DPGETC - PARAMETER NAME NOT KNOWN - X

The first argument in a call to DPGETC is not one of the legal internal parameter names of DASHPACK. "X" is the value of the offending first argument.

DPGETC - PARAMETER NAME TOO SHORT - X

The given parameter name is only one or two characters long. All DASHPACK parameter names are at least three characters long, so there is something wrong. "X" is the value of the offending first argument.

DPGETC - UNCLEARED PRIOR ERROR

This error message indicates that, at the time DPGETC was called, there was an unrecovered outstanding error. In this case, DPGETC cannot continue; it forces the error message for the outstanding error to be printed and then substitutes this one for it.

DPGETI - UNCLEARED PRIOR ERROR

This error message indicates that, at the time DPGETI was called, there was an unrecovered outstanding error. In this case, DPGETI cannot continue; it forces the error message for the outstanding error to be printed and then substitutes this one for it.

DPGETR - PARAMETER NAME NOT KNOWN - X

The first argument in a call to DPGETR is not one of the legal internal parameter names of DASHPACK. "X" is the value of the offending first argument.

DPGETR - PARAMETER NAME TOO SHORT - X

The given parameter name is only one or two characters long. All DASHPACK parameter names are at least three characters long, so there is something wrong. "X" is the value of the offending first argument.

DPGETR - UNCLEARED PRIOR ERROR

This error message indicates that, at the time DPGETR was called, there was an unrecovered outstanding error. In this case, DPGETR cannot continue; it forces the error message for the outstanding error to be printed and then substitutes this one for it.

DPLAST - UNCLEARED PRIOR ERROR

This error message indicates that, at the time DPLAST was called, there was an unrecovered outstanding error. In this case, DPLAST cannot continue; it forces the error message for the outstanding error to be printed and then substitutes this one for it.

DPLINE - UNCLEARED PRIOR ERROR

This error message indicates that, at the time DPLINE was called, there was an unrecovered outstanding error. In this case, DPLINE cannot continue; it forces the error message for the outstanding error to be printed and then substitutes this one for it.

DPSETC - PARAMETER NAME NOT KNOWN - X

The first argument in a call to DPSETC is not one of the legal internal parameter names of DASHPACK. "X" is the value of the offending first argument.

DPSETC - PARAMETER NAME TOO SHORT - X

The given parameter name is only one or two characters long. All DASHPACK parameter names are at least three characters long, so there is something wrong. "X" is the value of the offending first argument.

DPSETC - UNCLEARED PRIOR ERROR

This error message indicates that, at the time DPSETC was called, there was an unrecovered outstanding error. In this case, DPSETC cannot continue; it forces the error message for the outstanding error to be printed and then substitutes this one for it.

DPSETI - UNCLEARED PRIOR ERROR

This error message indicates that, at the time DPSETI was called, there was an unrecovered outstanding error. In this case, DPSETI cannot continue; it forces the error message for the outstanding error to be printed and then substitutes this one for it.

DPSETR - PARAMETER NAME NOT KNOWN - X

The first argument in a call to DPSETR is not one of the legal internal parameter names of DASHPACK. "X" is the value of the offending first argument.

DPSETR - PARAMETER NAME TOO SHORT - X

The given parameter name is only one or two characters long. All DASHPACK parameter names are at least three characters long, so there is something wrong. "X" is the value of the offending first argument.

DPSETR - UNCLEARED PRIOR ERROR

This error message indicates that, at the time DPSETR was called, there was an unrecovered outstanding error. In this case, DPSETR cannot continue; it forces the error message for the outstanding error to be printed and then substitutes this one for it.

DPSMTH - UNCLEARED PRIOR ERROR

This error message indicates that, at the time DPSMTH was called, there was an unrecovered outstanding error. In this case, DPSMTH cannot continue; it forces the error message for the outstanding error to be printed and then substitutes this one for it.

DPVECT - UNCLEARED PRIOR ERROR

This error message indicates that, at the time DPVECT was called, there was an unrecovered outstanding error. In this case, DPVECT cannot continue; it forces the error message for the outstanding error to be printed and then substitutes this one for it.

COPYRIGHT

Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.