File: plplot.doc

package info (click to toggle)
plplot 5.10.0%2Bdfsg2-0.4
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 25,792 kB
  • ctags: 13,517
  • sloc: ansic: 83,001; xml: 27,081; ada: 18,878; cpp: 15,966; tcl: 11,651; python: 7,075; f90: 7,058; ml: 6,974; java: 6,665; perl: 5,029; sh: 2,208; makefile: 210; lisp: 75; sed: 25; fortran: 7
file content (170 lines) | stat: -rw-r--r-- 10,101 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170

 C routines callable from stub routines come first

pladv	--  Advance to subpage "page", or to the next one if "page" = 0.  
plaxes	--  This functions similarly to plbox except that the origin of the axes  is placed at the user-specified point x0, y0  
plbin	--  Plot a histogram using x to store data values and y to store frequencies  
plbop	--  Start new page.  Should only be used with pleop.  
plbox	--  This draws a box around the current viewport.  
plbox3	--  This is the 3-d analogue of plbox.  
plcol0	--  Set color, map 0.  Argument is eger between 0 and 15.  
plcol1	--  Set color, map 1.  Argument is a float between 0. and 1.  
plcont	--  Draws a contour plot from data in f nx,ny.  Is just a front-end to plfcont, with a particular choice for f2eval and f2eval_data.  
plfcont	--  Draws a contour plot using the function evaluator f2eval and data stored by way of the f2eval_data pointer.  This allows arbitrary organizations of 2d array data to be used.   
plcpstrm	--  Copies state parameters from the reference stream to the current stream.  
pldid2pc	--  Converts input values from relative device coordinates to relative plot  coordinates.  
pldip2dc	--  Converts input values from relative plot coordinates to relative  device coordinates.  
plend	--  End a plotting session for all open streams.  
plend1	--  End a plotting session for the current stream only.  
plenv	--  Simple interface for defining viewport and window.  
pleop	--  End current page.  Should only be used with plbop.  
plerrx	--  Plot horizontal error bars xmin xi,yi to xmax xi,yi  
plerry	--  Plot vertical error bars x,ymini to xi,ymaxi  
plfamadv	--  Advance to the next family file on the next new page  
plfill	--  Pattern fills the polygon bounded by the input position.  
plflush	--  Flushes the output stream.  Use sparingly, if at all.  
plfont	--  Sets the global font flag to 'ifont'.  
plfontld	--  Load specified font set.  
plgchr	--  Get character default height and current -scaled- height  
plgcol0	--  Returns 8 bit RGB values for given color from color map 0  
plgcolbg	--  Returns the background color by 8 bit RGB value  
plgdidev	-- Retrieve current window into device space
plgdidev	--  Retrieve current window into device space  
plgdiori	--  Get plot orientation  
plgdiplt	--  Retrieve current window into plot space  
plgfam	--  Get family file parameters  
plgfnam	--  Get the -current- output file name.  Must be preallocated to >80 bytes  
plglevel	-- Get the (current) run level
plgpage	--  Get output device parameters.  
plgra	--  Switches to graphics screen.  
plgspa	--  Get subpage boundaries in absolute coordinates  
plgstrm	--  Get current stream number.  
plgver	--  Get the current library version number  
plgxax	--  Get x axis labeling parameters  
plgyax	--  Get y axis labeling parameters  
plgzax	--  Get z axis labeling parameters  
plhist	--  Draws a histogram of n values of a variable in array data[0..n-1]  
plhls	--  Set current color -map 0- by hue, lightness, and saturation.  
plinit	--  Initializes PLplot, using preset or default options  
pljoin	--  Draws a line segment from x1, y1 to x2, y2.  
pllab	--  Simple routine for labelling graphs.  
plline	--  Draws line segments connecting a series of points.  
plline3	--  Draws a line in 3 space.   
pllsty	--  Set line style.  
plmap	--  plot continental outline in world coordinates  
plmeridians	--  Plot the latitudes and longitudes on the background.  
plmesh	--  Plots a mesh representation of the function z[x][y].  
plmkstrm	--  Creates a new stream and makes it the default.   
plmtex	--  Prints out "text" at specified position relative to viewport  
plot3d	--  Plots a 3-d representation of the function z[x][y].  
plpat	--  Set fill pattern directly.  
plpoin	--  Plots array y against x for n points using ASCII code "code". 
plpoin3	--  Draws a series of points in 3 space.  
plpoly3	--  Draws a polygon in 3 space.   
plprec	--  Set the floating point precision -in number of places- in numeric labels.  
plpsty	--  Set fill pattern, using one of the predefined patterns. 
plptex	--  Prints out "text" at world cooordinate x,y.  
plreplot	--  Replays contents of plot buffer to current device/file.  
plrgb	--  Set line color by red, green, blue from  0. to 1.  
plrgb1	--  Set line color by 8 bit RGB values.  
plschr	--  Set character height.  
plscmap0n	--  Set number of colors in cmap 0  
plscmap1n	--  Set number of colors in cmap 1  
plscmap0	--  Set color map 0 colors by 8 bit RGB values  
plscmap1	--  Set color map 1 colors by 8 bit RGB values  
plscmap1l	--  Set color map 1 colors using a piece-wise linear relationship between  intensity [0,1] -cmap 1 index- and position in HLS or RGB color space.  
plscol0	--  Set a given color from color map 0 by 8 bit RGB value  
plscolbg	--  Set the background color by 8 bit RGB value  
plscolor	--  Used to globally turn color output on/off  
plsdev	--  Set the device -keyword- name  
plsdidev	--  Set window into device space using margin, aspect ratio, and  justification  
plsdimap	--  Set up transformation from metafile coordinates.  
plsdiori	--  Set plot orientation, specifying rotation in units of pi/2.  
plsdiplt	--  Set window into plot space  
plsdiplz	--  Set window into plot space incrementally -zoom-  
plsesc	--  Set the escape character for text strings.  
plsfam	--  Set family file parameters  
plsfnam	--  Set the output file name.  
plshade	--  Shade region.  
plshade1	--  Shade region.   
plfshade	--  Shade region.  
plsmaj	--  Set up lengths of major tick marks.  
plsmin	--  Set up lengths of minor tick marks.  
plsori	--  Set orientation.  Must be done before calling plinit.  
plspage	--  Set output device parameters.  Usually ignored by the driver.  
plspause	--  Set the pause -on end-of-page- status  
plsstrm	--  Set stream number.   
plssub	--  Set the number of subwindows in x and y  
plssym	--  Set symbol height.  
plstar	--  Initialize PLplot, passing in the windows/page settings.  
plstart	--  Initialize PLplot, passing the device name and windows/page settings.  
plstyl	--  Set up a new line style  
plsvpa	--  Sets the edges of the viewport to the specified absolute coordinates  
plsxax	--  Set x axis labeling parameters  
plsxwin	--  Set inferior X window  
plsyax	--  Set y axis labeling parameters  
plsym	--  Plots array y against x for n points using Hershey symbol "code"  
plszax	--  Set z axis labeling parameters  
pltext	--  Switches to text screen.  
plvasp	--  Sets the edges of the viewport with the given aspect ratio, leaving  room for labels.  
plvpas	--  Creates the largest viewport of the specified aspect ratio that fits  within the specified normalized subpage coordinates.  
plvpor	--  Creates a viewport with the specified normalized subpage coordinates.  
plvsta	--  Defines a "standard" viewport with seven character heights for  the left margin and four character heights everywhere else.  
plw3d	--  Set up a window for three-dimensional plotting.  
plwidth	--  Set pen width.  
plwind	--  Set up world coordinates of the viewport boundaries -2d plots-.  

 Functions for use from C or C++ only

plgFileDevs	--  Returns a list of file-oriented device names and their menu strings  
plgDevs	-- Returns a list of all device names and their menu strings
plsKeyEH	--  Set the function pointer for the keyboard event handler  
plsButtonEH	--  Set the function pointer for the -mouse- button event handler  
plsError	--  Set the variables to be used for storing error info
plsexit	--  Sets an optional user exit handler.  

 Transformation routines

pltr0	--  Identity transformation.  
pltr1	--  Does linear interpolation from singly dimensioned coord arrays.  
pltr2	--  Does linear interpolation from doubly dimensioned coord arrays  -column dominant, as per normal C 2d arrays-.  
pltr2p	--  Just like pltr2 but uses pointer arithmetic to get coordinates from  2d grid tables.   
pltr0f	--  Identity transformation for plots from Fortran.  
pltr2f	--  Does linear interpolation from doubly dimensioned coord arrays  -row dominant, i.e. Fortran ordering-.  
xform	--  Example linear transformation function for contour plotter.  

 Function evaluators

plf2eval2	--  Does a lookup from a 2d function array.  Array is of type -PLFLT **-,  and is column dominant -normal C ordering-.  
plf2eval	--  Does a lookup from a 2d function array.  Array is of type -PLFLT *-,  and is column dominant -normal C ordering-.  
plf2evalr	--  Does a lookup from a 2d function array.  Array is of type -PLFLT *-,  and is row dominant -Fortran ordering-.  

 Command line parsing utilities

plClearOpts	--  Clear external option table info structure.  
plResetOpts	--  Reset external option table info structure.  
plMergeOpts	--  Merge user option table into external info structure.  
plSetUsage	--  Set the strings used in usage and syntax messages.  
plSetOpt	--  Process input strings, treating them as an option and argument pair.  
plparseopts	--  Process options list using current options info.  
plOptUsage	--  Print usage & syntax message.  

 Miscellaneous

plgfile	--  Set the output file pointer  
plsfile	--  Get the output file pointer  
plgesc	--  Get the escape character for text strings.  
pl_cmd	--  Front-end to driver escape function.  
plFindName	--  Return full pathname for given file if executable  
plFindCommand	--  Looks for the specified executable file according to usual search path.  
plGetName	--  Gets search name for file by concatenating the dir, subdir, and file  name, allocating memory as needed.   
plGet	--  Prompts human to input an integer in response to given message.  
plGetFlt	--  Prompts human to input a float in response to given message.  

 Nice way to allocate space for a vectored 2d grid

plAlloc2dGrid	--  Allocates a block of memory for use as a 2-d grid of PLFLT's.   
plFree2dGrid	--  Frees a block of memory allocated with plAlloc2dGrid.  
plGetCursor	--  Wait for graphics input event and translate to world coordinates  
plTranslateCursor	--  Translates relative device coordinates to world coordinates.