Chapter 19. The Specialized C/C++ API for PLplot

Table of Contents

plabort: Error abort
plAlloc2dGrid: Allocate a block of memory for use as a matrix of type PLFLT_MATRIX.
plClearOpts: Clear internal option table info structure.
plexit: Error exit
plFree2dGrid: Free the memory associated with a PLFLT matrix allocated using plAlloc2dGrid.
plfsurf3d: Plot shaded 3-d surface plot
plgfile: Get output file handle
plMergeOpts: Merge use option table into internal info structure.
plMinMax2dGrid: Find the minimum and maximum of a PLFLT matrix of type PLFLT_MATRIX allocated using plAlloc2dGrid.
plOptUsage: Print usage and syntax message.
plResetOpts: Reset internal option table info structure.
plsabort: Set abort handler
plSetUsage: Set the ascii character strings used in usage and syntax messages.
plsexit: Set exit handler
plsfile: Set output file handle
plshade1: Shade individual region on the basis of value
pltr0: Identity transformation for matrix index to world coordinate mapping
pltr1: Linear interpolation for matrix index to world coordinate mapping using singly dimensioned coordinate arrays
pltr2: Linear interpolation for grid to world mapping using doubly dimensioned coordinate arrays (row-major order as per normal C 2d arrays)
plTranslateCursor: Convert device to world coordinates
PLGraphicsIn: PLplot Graphics Input structure
PLOptionTable: PLplot command line options table structure

The purpose of this chapter is to document the PLplot C/C++ functions that are currently not part of the common API, either because they are C/C++ specific utility functions (e.g. plAlloc2dGrid, plFree2dGrid) or because they are not yet implemented in other languages (e.g., plMergeOpts). Some of these functions are used in the C or C++ examples and may be helpful to other C/C++ users of PLplot.

This chapter also documents some of the C/C++ structures defined by PLplot and used by these functions.