Menu
▾
▴
[Plplot-cvs] SF.net SVN: plplot:[11684] trunk
|
From: <ai...@us...> - 2011-03-31 04:15:41
|
Revision: 11684
http://plplot.svn.sourceforge.net/plplot/?rev=11684&view=rev
Author: airwin
Date: 2011-03-31 04:15:32 +0000 (Thu, 31 Mar 2011)
Log Message:
-----------
Move to the "//" style of commentary for D as well. This change
brings our D commentary style into line with the commentary style of
our C and C++ code.
For a few of the D examples (e.g., x24d.d) I had to remove "\" escapes
at the end of commentary lines in order to get
scripts/convert_comment.py (called by scripts/style_source.sh) to
convert the comments correctly.
Modified Paths:
--------------
trunk/bindings/d/plplot.d
trunk/examples/d/x01d.d
trunk/examples/d/x02d.d
trunk/examples/d/x03d.d
trunk/examples/d/x04d.d
trunk/examples/d/x05d.d
trunk/examples/d/x06d.d
trunk/examples/d/x07d.d
trunk/examples/d/x08d.d
trunk/examples/d/x09d.d
trunk/examples/d/x10d.d
trunk/examples/d/x11d.d
trunk/examples/d/x12d.d
trunk/examples/d/x13d.d
trunk/examples/d/x14d.d
trunk/examples/d/x15d.d
trunk/examples/d/x16d.d
trunk/examples/d/x17d.d
trunk/examples/d/x18d.d
trunk/examples/d/x19d.d
trunk/examples/d/x20d.d
trunk/examples/d/x21d.d
trunk/examples/d/x22d.d
trunk/examples/d/x23d.d
trunk/examples/d/x24d.d
trunk/examples/d/x25d.d
trunk/examples/d/x26d.d
trunk/examples/d/x27d.d
trunk/examples/d/x28d.d
trunk/examples/d/x29d.d
trunk/examples/d/x30d.d
trunk/examples/d/x31d.d
trunk/scripts/style_source.sh
Modified: trunk/bindings/d/plplot.d
===================================================================
--- trunk/bindings/d/plplot.d 2011-03-31 03:51:26 UTC (rev 11683)
+++ trunk/bindings/d/plplot.d 2011-03-31 04:15:32 UTC (rev 11684)
@@ -1,4 +1,4 @@
-/* Converted to D from plplot_d.h by htod */
+// Converted to D from plplot_d.h by htod
module plplot;
private import std.string;
@@ -47,7 +47,7 @@
return c_a;
}
-/* Process options list using current options info. */
+// Process options list using current options info.
int plparseopts( char[][] args, PLINT mode )
{
char*[] c_args = new char*[args.length];
@@ -57,7 +57,7 @@
return c_plparseopts( &argc, cast(char**) c_args, mode );
}
-/* simple arrow plotter. */
+// simple arrow plotter.
void plvect( PLFLT[][] u, PLFLT[][] v, PLFLT scale, pltr_func pltr = null, PLPointer pltr_data = null )
{
PLINT nx = u.length;
@@ -120,15 +120,15 @@
c_plsvect( arrowx.ptr, arrowy.ptr, npts, fill );
}
-/* This functions similarly to plbox() except that the origin of the axes */
-/* is placed at the user-specified point (x0, y0). */
+// This functions similarly to plbox() except that the origin of the axes
+// is placed at the user-specified point (x0, y0).
void plaxes( PLFLT x0, PLFLT y0, string xopt, PLFLT xtick, PLINT nxsub,
string yopt, PLFLT ytick, PLINT nysub )
{
c_plaxes( x0, y0, toStringz( xopt ), xtick, nxsub, toStringz( yopt ), ytick, nysub );
}
-/* Plot a histogram using x to store data values and y to store frequencies */
+// Plot a histogram using x to store data values and y to store frequencies
void plbin( PLFLT[] x, PLFLT[] y, PLINT opt )
{
PLINT nbin = x.length;
@@ -136,13 +136,13 @@
c_plbin( nbin, x.ptr, y.ptr, opt );
}
-/* This draws a box around the current viewport. */
+// This draws a box around the current viewport.
void plbox( string xopt, PLFLT xtick, PLINT nxsub, string yopt, PLFLT ytick, PLINT nysub )
{
c_plbox( toStringz( xopt ), xtick, nxsub, toStringz( yopt ), ytick, nysub );
}
-/* This is the 3-d analogue of plbox(). */
+// This is the 3-d analogue of plbox().
void plbox3( string xopt, string xlabel, PLFLT xtick, PLINT nsubx,
string yopt, string ylabel, PLFLT ytick, PLINT nsuby,
string zopt, string zlabel, PLFLT ztick, PLINT nsubz )
@@ -152,9 +152,9 @@
toStringz( zopt ), toStringz( zlabel ), ztick, nsubz );
}
-/* 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.
- */
+// 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.
+//
void plcont( PLFLT[][] f, PLINT kx, PLINT lx, PLINT ky, PLINT ly, PLFLT[] clevel,
pltr_func pltr, PLPointer pltr_data = null )
{
@@ -210,13 +210,13 @@
&pltr2, &c2 );
}
-/* 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.
- */
+// 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.
+//
//void plfcont(PLFLT function(PLINT , PLINT , PLPointer )f2eval, PLPointer f2eval_data, PLINT nx, PLINT ny, PLINT kx, PLINT lx, PLINT ky, PLINT ly, PLFLT *clevel, PLINT nlevel, void function(PLFLT , PLFLT , PLFLT *, PLFLT *, PLPointer )pltr, PLPointer pltr_data);
-/* Plot horizontal error bars (xmin(i),y(i)) to (xmax(i),y(i)) */
+// Plot horizontal error bars (xmin(i),y(i)) to (xmax(i),y(i))
void plerrx( PLFLT[] xmin, PLFLT[] xmax, PLFLT[] y )
{
PLINT n = y.length;
@@ -225,7 +225,7 @@
c_plerrx( n, xmin.ptr, xmax.ptr, y.ptr );
}
-/* Plot vertical error bars (x,ymin(i)) to (x(i),ymax(i)) */
+// Plot vertical error bars (x,ymin(i)) to (x(i),ymax(i))
void plerry( PLFLT[] x, PLFLT[] ymin, PLFLT[] ymax )
{
PLINT n = x.length;
@@ -234,7 +234,7 @@
c_plerry( n, x.ptr, ymin.ptr, ymax.ptr );
}
-/* Pattern fills the polygon bounded by the input points. */
+// Pattern fills the polygon bounded by the input points.
void plfill( PLFLT[] x, PLFLT[] y )
{
PLINT n = x.length;
@@ -242,7 +242,7 @@
c_plfill( n, x.ptr, y.ptr );
}
-/* Pattern fills the 3d polygon bounded by the input points. */
+// Pattern fills the 3d polygon bounded by the input points.
void plfill3( PLFLT[] x, PLFLT[] y, PLFLT[] z )
{
PLINT n = x.length;
@@ -251,7 +251,7 @@
c_plfill3( n, x.ptr, y.ptr, z.ptr );
}
-/* Get the current device (keyword) name */
+// Get the current device (keyword) name
void plgdev( out string p_dev )
{
p_dev.length = 1024;
@@ -259,7 +259,7 @@
p_dev = toString( p_dev.ptr );
}
-/* Get the (current) output file name. Must be preallocated to >80 bytes */
+// Get the (current) output file name. Must be preallocated to >80 bytes
void plgfnam( out string fnam )
{
fnam.length = 1024;
@@ -267,7 +267,7 @@
fnam = toString( fnam.ptr );
}
-/* Draw gradient in polygon. */
+// Draw gradient in polygon.
void plgradient( PLFLT[] x, PLFLT[] y, PLFLT angle )
{
PLINT n = x.length;
@@ -275,7 +275,7 @@
c_plgradient( n, x.ptr, y.ptr, angle );
}
-/* grid irregularly sampled data */
+// grid irregularly sampled data
void plgriddata( PLFLT[] x, PLFLT[] y, PLFLT[] z, PLFLT[] xg, PLFLT[] yg, PLFLT[][] zg, PLINT type, PLFLT data )
{
PLINT npts = x.length;
@@ -290,7 +290,7 @@
c_plgriddata( x.ptr, y.ptr, z.ptr, npts, xg.ptr, nxg, yg.ptr, nyg, convert_array( zg ), type, data );
}
-/* Get the current library version number */
+// Get the current library version number
void plgver( out string p_ver )
{
p_ver.length = 1024;
@@ -298,13 +298,13 @@
p_ver = toString( p_ver.ptr );
}
-/* Draws a histogram of n values of a variable in array data[0..n-1] */
+// Draws a histogram of n values of a variable in array data[0..n-1]
void plhist( PLFLT[] data, PLFLT datmin, PLFLT datmax, PLINT nbin, PLINT opt )
{
c_plhist( data.length, data.ptr, datmin, datmax, nbin, opt );
}
-/* Simple routine for labelling graphs. */
+// Simple routine for labelling graphs.
void pllab( string xlabel, string ylabel, string tlabel )
{
c_pllab( toStringz( xlabel ), toStringz( ylabel ), toStringz( tlabel ) );
@@ -364,7 +364,7 @@
symbol_numbers.ptr, symbolsz.ptr );
}
-/* Draws line segments connecting a series of points. */
+// Draws line segments connecting a series of points.
void plline( PLFLT[] x, PLFLT[] y )
{
PLINT n = x.length;
@@ -372,7 +372,7 @@
c_plline( n, x.ptr, y.ptr );
}
-/* Draws a line in 3 space. */
+// Draws a line in 3 space.
void plline3( PLFLT[] x, PLFLT[] y, PLFLT[] z )
{
PLINT n = x.length;
@@ -381,14 +381,14 @@
c_plline3( n, x.ptr, y.ptr, z.ptr );
}
-/* plot continental outline in world coordinates */
+// plot continental outline in world coordinates
void plmap( mapform_func mapform, string type, PLFLT minlong, PLFLT maxlong,
PLFLT minlat, PLFLT maxlat )
{
c_plmap( mapform, toStringz( type ), minlong, maxlong, minlat, maxlat );
}
-/* Plots a mesh representation of the function z[x][y]. */
+// Plots a mesh representation of the function z[x][y].
void plmesh( PLFLT[] x, PLFLT[] y, PLFLT[][] z, PLINT opt )
{
PLINT nx = z.length;
@@ -400,7 +400,7 @@
c_plmesh( x.ptr, y.ptr, convert_array( z ), nx, ny, opt );
}
-/* Plots a mesh representation of the function z[x][y] with contour */
+// Plots a mesh representation of the function z[x][y] with contour
void plmeshc( PLFLT[] x, PLFLT[] y, PLFLT[][] z, PLINT opt, PLFLT[] clevel )
{
PLINT nx = z.length;
@@ -412,19 +412,19 @@
c_plmeshc( x.ptr, y.ptr, convert_array( z ), nx, ny, opt, clevel.ptr, clevel.length );
}
-/* Prints out "text" at specified position relative to viewport */
+// Prints out "text" at specified position relative to viewport
void plmtex( string side, PLFLT disp, PLFLT pos, PLFLT just, string text )
{
c_plmtex( toStringz( side ), disp, pos, just, toStringz( text ) );
}
-/* Prints out "text" at specified position relative to viewport (3D)*/
+// Prints out "text" at specified position relative to viewport (3D)
void plmtex3( string side, PLFLT disp, PLFLT pos, PLFLT just, string text )
{
c_plmtex3( toStringz( side ), disp, pos, just, toStringz( text ) );
}
-/* Plots a 3-d representation of the function z[x][y]. */
+// Plots a 3-d representation of the function z[x][y].
void plot3d( PLFLT[] x, PLFLT[] y, PLFLT[][] z, PLINT opt, PLBOOL side )
{
PLINT nx = z.length;
@@ -436,7 +436,7 @@
c_plot3d( x.ptr, y.ptr, convert_array( z ), nx, ny, opt, side );
}
-/* Plots a 3-d representation of the function z[x][y] with contour. */
+// Plots a 3-d representation of the function z[x][y] with contour.
void plot3dc( PLFLT[] x, PLFLT[] y, PLFLT[][] z, PLINT opt, PLFLT[] clevel )
{
PLINT nx = z.length;
@@ -448,8 +448,8 @@
c_plot3dc( x.ptr, y.ptr, convert_array( z ), nx, ny, opt, clevel.ptr, clevel.length );
}
-/* Plots a 3-d representation of the function z[x][y] with contour and
- * y index limits. */
+// Plots a 3-d representation of the function z[x][y] with contour and
+// y index limits.
void plot3dcl( PLFLT[] x, PLFLT[] y, PLFLT[][] z, PLINT opt, PLFLT[] clevel,
PLINT ixstart, PLINT ixn, PLINT[] indexymin, PLINT[] indexymax )
{
@@ -463,7 +463,7 @@
ixstart, ixn, indexymin.ptr, indexymax.ptr );
}
-/* Set fill pattern directly. */
+// Set fill pattern directly.
void plpat( PLINT[] inc, PLINT[] del )
{
PLINT nlin = inc.length;
@@ -471,7 +471,7 @@
c_plpat( nlin, inc.ptr, del.ptr );
}
-/* Plots array y against x for n points using ASCII code "code".*/
+// Plots array y against x for n points using ASCII code "code".
void plpoin( PLFLT[] x, PLFLT[] y, PLINT code )
{
PLINT n = x.length;
@@ -479,7 +479,7 @@
c_plpoin( n, x.ptr, y.ptr, code );
}
-/* Draws a series of points in 3 space. */
+// Draws a series of points in 3 space.
void plpoin3( PLFLT[] x, PLFLT[] y, PLFLT[] z, PLINT code )
{
PLINT n = x.length;
@@ -488,7 +488,7 @@
c_plpoin3( n, x.ptr, y.ptr, z.ptr, code );
}
-/* Plots array y against x for n points using (UTF-8) text string*/
+// Plots array y against x for n points using (UTF-8) text string
void plstring( PLFLT[] x, PLFLT[] y, string text )
{
PLINT n = x.length;
@@ -496,7 +496,7 @@
c_plstring( n, x.ptr, y.ptr, toStringz( text ) );
}
-/* Draws a series of points (described by [UTF8] text string) in 3 space. */
+// Draws a series of points (described by [UTF8] text string) in 3 space.
void plstring3( PLFLT[] x, PLFLT[] y, PLFLT[] z, string text )
{
PLINT n = x.length;
@@ -505,7 +505,7 @@
c_plstring3( n, x.ptr, y.ptr, z.ptr, toStringz( text ) );
}
-/* Draws a polygon in 3 space. */
+// Draws a polygon in 3 space.
void plpoly3( PLFLT[] x, PLFLT[] y, PLFLT[] z, PLBOOL[] draw, PLBOOL ifcc )
{
PLINT n = x.length;
@@ -515,32 +515,32 @@
c_plpoly3( n, x.ptr, y.ptr, z.ptr, draw.ptr, ifcc );
}
-/* Prints out "text" at world cooordinate (x,y). */
+// Prints out "text" at world cooordinate (x,y).
void plptex( PLFLT x, PLFLT y, PLFLT dx, PLFLT dy, PLFLT just, string text )
{
c_plptex( x, y, dx, dy, just, toStringz( text ) );
}
-/* Prints out "text" at world cooordinate (x,y,z). */
+// Prints out "text" at world cooordinate (x,y,z).
void plptex3( PLFLT wx, PLFLT wy, PLFLT wz, PLFLT dx, PLFLT dy, PLFLT dz,
PLFLT sx, PLFLT sy, PLFLT sz, PLFLT just, string text )
{
c_plptex3( wx, wy, wz, dx, dy, dz, sx, sy, sz, just, toStringz( text ) );
}
-/* Set the colors for color table 0 from a cmap0 file */
+// Set the colors for color table 0 from a cmap0 file
void plspal0( string filename )
{
c_plspal0( toStringz( filename ) );
}
-/* Set the colors for color table 1 from a cmap1 file */
+// Set the colors for color table 1 from a cmap1 file
void plspal1( string filename, PLBOOL interpolate )
{
c_plspal1( toStringz( filename ), interpolate );
}
-/* Set color map 0 colors by 8 bit RGB values */
+// Set color map 0 colors by 8 bit RGB values
void plscmap0( PLINT[] r, PLINT[] g, PLINT[] b )
{
PLINT ncol0 = r.length;
@@ -549,7 +549,7 @@
c_plscmap0( r.ptr, g.ptr, b.ptr, ncol0 );
}
-/* Set color map 0 colors by 8 bit RGB values and alpha values */
+// Set color map 0 colors by 8 bit RGB values and alpha values
void plscmap0a( PLINT[] r, PLINT[] g, PLINT[] b, PLFLT[] a )
{
PLINT ncol0 = r.length;
@@ -559,7 +559,7 @@
c_plscmap0a( r.ptr, g.ptr, b.ptr, a.ptr, ncol0 );
}
-/* Set color map 1 colors by 8 bit RGB values */
+// Set color map 1 colors by 8 bit RGB values
void plscmap1( PLINT[] r, PLINT[] g, PLINT[] b )
{
PLINT ncol1 = r.length;
@@ -568,7 +568,7 @@
c_plscmap1( r.ptr, g.ptr, b.ptr, ncol1 );
}
-/* Set color map 1 colors by 8 bit RGB and alpha values */
+// Set color map 1 colors by 8 bit RGB and alpha values
void plscmap1a( PLINT[] r, PLINT[] g, PLINT[] b, PLFLT[] a )
{
PLINT ncol1 = r.length;
@@ -578,8 +578,8 @@
c_plscmap1a( r.ptr, g.ptr, b.ptr, a.ptr, ncol1 );
}
-/* 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. */
+// 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.
void plscmap1l( PLBOOL itype, PLFLT[] intensity, PLFLT[] coord1,
PLFLT[] coord2, PLFLT[] coord3, PLBOOL[] rev = null )
{
@@ -597,9 +597,9 @@
}
-/* 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. */
-/* Will also linear interpolate alpha values. */
+// 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.
+// Will also linear interpolate alpha values.
void plscmap1la( PLBOOL itype, PLFLT[] intensity, PLFLT[] coord1,
PLFLT[] coord2, PLFLT[] coord3, PLFLT[] a, PLBOOL[] rev = null )
{
@@ -617,19 +617,19 @@
c_plscmap1la( itype, npts, intensity.ptr, coord1.ptr, coord2.ptr, coord3.ptr, a.ptr, null );
}
-/* Set the device (keyword) name */
+// Set the device (keyword) name
void plsdev( string devname )
{
c_plsdev( toStringz( devname ) );
}
-/* Set the output file name. */
+// Set the output file name.
void plsfnam( string fnam )
{
c_plsfnam( toStringz( fnam ) );
}
-/* Shade region. */
+// Shade region.
void plshade( PLFLT[][] a, def_func defined, PLFLT left, PLFLT right,
PLFLT bottom, PLFLT top, PLFLT shade_min, PLFLT shade_max, PLINT sh_cmap,
PLFLT sh_color, PLINT sh_width, PLINT min_color, PLINT min_width, PLINT max_color,
@@ -702,13 +702,13 @@
fill_width, cont_color, cont_width, &c_plfill, rectangular, &pltr2, &c2 );
}
-/* Initialize PLplot, passing the device name and windows/page settings. */
+// Initialize PLplot, passing the device name and windows/page settings.
void plstart( string devname, PLINT nx, PLINT ny )
{
c_plstart( toStringz( devname ), nx, ny );
}
-/* Create 1d stripchart */
+// Create 1d stripchart
void plstripc( PLINT* id, string xspec, string yspec, PLFLT xmin, PLFLT xmax, PLFLT xjump,
PLFLT ymin, PLFLT ymax, PLFLT xlpos, PLFLT ylpos, PLBOOL y_ascl, PLBOOL acc,
PLINT colbox, PLINT collab, PLINT[] colline, PLINT[] styline, string[] legline,
@@ -729,7 +729,7 @@
toStringz( labx ), toStringz( laby ), toStringz( labtop ) );
}
-/* plots a 2d image (or a matrix too large for plshade() ) */
+// plots a 2d image (or a matrix too large for plshade() )
void plimagefr( PLFLT[][] idata, PLFLT xmin, PLFLT xmax, PLFLT ymin, PLFLT ymax,
PLFLT zmin, PLFLT zmax, PLFLT valuemin, PLFLT valuemax,
pltr_func pltr = null, PLPointer pltr_data = null )
@@ -741,7 +741,7 @@
valuemin, valuemax, pltr, pltr_data );
}
-/* plots a 2d image (or a matrix too large for plshade() ) */
+// plots a 2d image (or a matrix too large for plshade() )
void plimagefr( PLFLT[][] idata, PLFLT xmin, PLFLT xmax, PLFLT ymin, PLFLT ymax,
PLFLT zmin, PLFLT zmax, PLFLT valuemin, PLFLT valuemax, PLcGrid cgrid )
{
@@ -760,7 +760,7 @@
valuemin, valuemax, &pltr1, &c );
}
-/* plots a 2d image (or a matrix too large for plshade() ) */
+// plots a 2d image (or a matrix too large for plshade() )
void plimagefr( PLFLT[][] idata, PLFLT xmin, PLFLT xmax, PLFLT ymin, PLFLT ymax,
PLFLT zmin, PLFLT zmax, PLFLT valuemin, PLFLT valuemax, PLcGrid2 cgrid2 )
{
@@ -788,8 +788,8 @@
valuemin, valuemax, &pltr2, &c2 );
}
-/* plots a 2d image (or a matrix too large for plshade() ) - colors
- * automatically scaled */
+// plots a 2d image (or a matrix too large for plshade() ) - colors
+// automatically scaled
void plimage( PLFLT[][] idata, PLFLT xmin, PLFLT xmax, PLFLT ymin, PLFLT ymax,
PLFLT zmin, PLFLT zmax, PLFLT Dxmin, PLFLT Dxmax, PLFLT Dymin, PLFLT Dymax )
{
@@ -800,7 +800,7 @@
Dymin, Dymax );
}
-/* Set up a new line style */
+// Set up a new line style
void plstyl( PLINT[] mark, PLINT[] space )
{
PLINT nms = mark.length;
@@ -808,7 +808,7 @@
c_plstyl( nms, mark.ptr, space.ptr );
}
-/* Plots the 3d surface representation of the function z[x][y]. */
+// Plots the 3d surface representation of the function z[x][y].
void plsurf3d( PLFLT[] x, PLFLT[] y, PLFLT[][] z, PLINT opt, PLFLT[] clevel = null )
{
PLINT nx = z.length;
@@ -822,8 +822,8 @@
c_plsurf3d( x.ptr, y.ptr, convert_array( z ), nx, ny, opt, null, 0 );
}
-/* Plots the 3d surface representation of the function z[x][y] with y
- * index limits. */
+// Plots the 3d surface representation of the function z[x][y] with y
+// index limits.
void plsurf3dl( PLFLT[] x, PLFLT[] y, PLFLT[][] z, PLINT opt, PLFLT[] clevel,
PLINT ixstart, PLINT ixn, PLINT[] indexymin, PLINT[] indexymax )
{
@@ -836,7 +836,7 @@
ixstart, ixn, indexymin.ptr, indexymax.ptr );
}
-/* Plots array y against x for n points using Hershey symbol "code" */
+// Plots array y against x for n points using Hershey symbol "code"
void plsym( PLFLT[] x, PLFLT[] y, PLINT code )
{
PLINT n = x.length;
@@ -844,109 +844,109 @@
c_plsym( n, x.ptr, y.ptr, code );
}
-/* Set the format for date / time labels */
+// Set the format for date / time labels
void pltimefmt( string fmt )
{
c_pltimefmt( toStringz( fmt ) );
}
-/*--------------------------------------------------------------------------*
- * Functions for use from C or C++ only
- \*--------------------------------------------------------------------------*/
+//--------------------------------------------------------------------------
+// Functions for use from C or C++ only
+//--------------------------------------------------------------------------
-/* Returns a list of file-oriented device names and their menu strings */
+// Returns a list of file-oriented device names and their menu strings
//void plgFileDevs(char ***p_menustr, char ***p_devname, int *p_ndev);
-/* Returns a list of all device names and their menu strings */
+// Returns a list of all device names and their menu strings
//void plgDevs(char ***p_menustr, char ***p_devname, int *p_ndev);
-/* Set the function pointer for the keyboard event handler */
+// Set the function pointer for the keyboard event handler
//void plsKeyEH(void function(PLGraphicsIn *, void *, int *)KeyEH, void *KeyEH_data);
-/* Set the function pointer for the (mouse) button event handler */
+// Set the function pointer for the (mouse) button event handler
//void plsButtonEH(void function(PLGraphicsIn *, void *, int *)ButtonEH, void *ButtonEH_data);
-/* Sets an optional user bop handler */
+// Sets an optional user bop handler
//void plsbopH(void function(void *, int *)handler, void *handler_data);
-/* Sets an optional user eop handler */
+// Sets an optional user eop handler
//void plseopH(void function(void *, int *)handler, void *handler_data);
-/* Set the variables to be used for storing error info */
+// Set the variables to be used for storing error info
//void plsError(PLINT *errcode, char *errmsg)
//{
//}
-/* Sets an optional user exit handler. */
+// Sets an optional user exit handler.
//void plsexit(int function(char *)handler);
-/* Sets an optional user abort handler. */
+// Sets an optional user abort handler.
//void plsabort(void function(char *)handler);
-/* Function evaluators */
+// Function evaluators
-/* Does a lookup from a 2d function array. Array is of type (PLFLT **), */
-/* and is column dominant (normal C ordering). */
+// Does a lookup from a 2d function array. Array is of type (PLFLT **),
+// and is column dominant (normal C ordering).
//PLFLT plf2eval2(PLINT ix, PLINT iy, PLPointer plf2eval_data);
-/* Does a lookup from a 2d function array. Array is of type (PLFLT *), */
-/* and is column dominant (normal C ordering). */
+// Does a lookup from a 2d function array. Array is of type (PLFLT *),
+// and is column dominant (normal C ordering).
//PLFLT plf2eval(PLINT ix, PLINT iy, PLPointer plf2eval_data);
-/* Does a lookup from a 2d function array. Array is of type (PLFLT *), */
-/* and is row dominant (Fortran ordering). */
+// Does a lookup from a 2d function array. Array is of type (PLFLT *),
+// and is row dominant (Fortran ordering).
//PLFLT plf2evalr(PLINT ix, PLINT iy, PLPointer plf2eval_data);
-/* Command line parsing utilities */
+// Command line parsing utilities
-/* Merge user option table into internal info structure. */
+// Merge user option table into internal info structure.
//int plMergeOpts(PLOptionTable *options, char *name, char **notes);
-/* Set the strings used in usage and syntax messages. */
+// Set the strings used in usage and syntax messages.
//void plSetUsage(char *program_string, char *usage_string);
-/* Process input strings, treating them as an option and argument pair. */
-/* The first is for the external API, the second the work routine declared
- * here for backward compatibilty. */
+// Process input strings, treating them as an option and argument pair.
+// The first is for the external API, the second the work routine declared
+// here for backward compatibilty.
int plsetopt( string opt, string optarg )
{
return c_plsetopt( toStringz( opt ), toStringz( optarg ) );
}
-/* Miscellaneous */
+// Miscellaneous
-/* Get the escape character for text strings. */
+// Get the escape character for text strings.
//void plgesc(char *p_esc);
-/* Front-end to driver escape function. */
+// Front-end to driver escape function.
//void pl_cmd(PLINT op, void *ptr);
-/* Return full pathname for given file if executable */
+// Return full pathname for given file if executable
//int plFindName(char *p);
-/* Looks for the specified executable file according to usual search path. */
+// Looks for the specified executable file according to usual search path.
//char * plFindCommand(char *fn);
-/* Gets search name for file by concatenating the dir, subdir, and file */
-/* name, allocating memory as needed. */
+// Gets search name for file by concatenating the dir, subdir, and file
+// name, allocating memory as needed.
//void plGetName(char *dir, char *subdir, char *filename, char **filespec);
-/* Prompts human to input an integer in response to given message. */
+// Prompts human to input an integer in response to given message.
//PLINT plGetInt(char *s);
-/* Prompts human to input a float in response to given message. */
+// Prompts human to input a float in response to given message.
//PLFLT plGetFlt(char *s);
-/* Find the maximum and minimum of a 2d matrix allocated with plAllc2dGrid(). */
+// Find the maximum and minimum of a 2d matrix allocated with plAllc2dGrid().
void plMinMax2dGrid( PLFLT[][] f, out PLFLT fmax, out PLFLT fmin )
{
plMinMax2dGrid( convert_array( f ), f.length, f[0].length, &fmax, &fmin );
}
-/* Wait for graphics input event and translate to world coordinates */
+// Wait for graphics input event and translate to world coordinates
//int plGetCursor(PLGraphicsIn *gin);
-/* Translates relative device coordinates to world coordinates. */
+// Translates relative device coordinates to world coordinates.
//int plTranslateCursor(PLGraphicsIn *gin);
@@ -955,24 +955,24 @@
alias double PLFLT;
-/* This is apparently portable if stdint.h exists. */
-/* A reasonable back-up in case stdint.h does not exist on the platform. */
+// This is apparently portable if stdint.h exists.
+// A reasonable back-up in case stdint.h does not exist on the platform.
alias uint PLUNICODE;
alias int PLINT;
-/* For identifying logical (boolean) arguments */
+// For identifying logical (boolean) arguments
alias PLINT PLBOOL;
-/* For passing user data, as with X's XtPointer */
+// For passing user data, as with X's XtPointer
alias void* PLPointer;
-/*--------------------------------------------------------------------------*
- * Complex data types and other good stuff
- \*--------------------------------------------------------------------------*/
+//--------------------------------------------------------------------------
+// Complex data types and other good stuff
+//--------------------------------------------------------------------------
-/* Switches for escape function call. */
-/* Some of these are obsolete but are retained in order to process
- * old metafiles. */
+// Switches for escape function call.
+// Some of these are obsolete but are retained in order to process
+// old metafiles.
const PLESC_SET_RGB = 1;
const PLESC_ALLOC_NCOL = 2;
@@ -1001,44 +1001,44 @@
const PLESC_SETBGFG = 25;
const PLESC_DEVINIT = 26;
-/* image operations */
+// image operations
const ZEROW2B = 1;
const ZEROW2D = 2;
const ONEW2B = 3;
const ONEW2D = 4;
-/* Window parameter tags */
+// Window parameter tags
const PLSWIN_DEVICE = 1;
const PLSWIN_WORLD = 2;
-/* Axis label tags */
-const PL_X_AXIS = 1; /* The x-axis */
-const PL_Y_AXIS = 2; /* The y-axis */
-const PL_Z_AXIS = 3; /* The z-axis */
+// Axis label tags
+const PL_X_AXIS = 1; // The x-axis
+const PL_Y_AXIS = 2; // The y-axis
+const PL_Z_AXIS = 3; // The z-axis
-/* PLplot Option table & support constants */
+// PLplot Option table & support constants
-/* Option-specific settings */
+// Option-specific settings
const PL_OPT_ENABLED = 0x0001;
const PL_OPT_ARG = 0x0002;
const PL_OPT_NODELETE = 0x0004;
const PL_OPT_INVISIBLE = 0x0008;
const PL_OPT_DISABLED = 0x0010;
-/* Option-processing settings -- mutually exclusive */
+// Option-processing settings -- mutually exclusive
const PL_OPT_FUNC = 0x0100;
const PL_OPT_BOOL = 0x0200;
const PL_OPT_INT = 0x0400;
const PL_OPT_FLOAT = 0x0800;
const PL_OPT_STRING = 0x1000;
-/* Global mode settings */
-/* These override per-option settings */
+// Global mode settings
+// These override per-option settings
const PL_PARSE_PARTIAL = 0x0000;
const PL_PARSE_FULL = 0x0001;
const PL_PARSE_QUIET = 0x0002;
-/* processing */
+// processing
const PL_PARSE_NODELETE = 0x0004;
const PL_PARSE_SHOWALL = 0x0008;
const PL_PARSE_OVERRIDE = 0x0010;
@@ -1046,37 +1046,37 @@
const PL_PARSE_NODASH = 0x0040;
const PL_PARSE_SKIP = 0x0080;
-/* FCI (font characterization integer) related constants. */
+// FCI (font characterization integer) related constants.
const PL_FCI_MARK = 0x80000000;
const PL_FCI_IMPOSSIBLE = 0x00000000;
const PL_FCI_HEXDIGIT_MASK = 0xf;
const PL_FCI_HEXPOWER_MASK = 0x7;
-/* These define hexpower values corresponding to each font attribute. */
+// These define hexpower values corresponding to each font attribute.
const PL_FCI_HEXPOWER_IMPOSSIBLE = 0xf;
const PL_FCI_FAMILY = 0x0;
const PL_FCI_STYLE = 0x1;
-/* These are legal values for font family attribute */
+// These are legal values for font family attribute
const PL_FCI_WEIGHT = 0x2;
const PL_FCI_SANS = 0x0;
const PL_FCI_SERIF = 0x1;
const PL_FCI_MONO = 0x2;
const PL_FCI_SCRIPT = 0x3;
-/* These are legal values for font style attribute */
+// These are legal values for font style attribute
const PL_FCI_SYMBOL = 0x4;
const PL_FCI_UPRIGHT = 0x0;
const PL_FCI_ITALIC = 0x1;
-/* These are legal values for font weight attribute */
+// These are legal values for font weight attribute
const PL_FCI_MEDIUM = 0x0;
const PL_FCI_BOLD = 0x1;
const PL_FCI_OBLIQUE = 0x2;
-/* Obsolete names */
+// Obsolete names
-/* Option table definition */
+// Option table definition
struct _N1
{
@@ -1090,7 +1090,7 @@
}
alias _N1 PLOptionTable;
-/* PLplot Graphics Input structure */
+// PLplot Graphics Input structure
const PL_MAXKEY = 16;
@@ -1111,7 +1111,7 @@
}
alias _N2 PLGraphicsIn;
-/* Structure for describing the plot window */
+// Structure for describing the plot window
const PL_MAXWINDOWS = 64;
@@ -1128,8 +1128,8 @@
}
alias _N3 PLWindow;
-/* Structure for doing display-oriented operations via escape commands */
-/* May add other attributes in time */
+// Structure for doing display-oriented operations via escape commands
+// May add other attributes in time
struct _N4
{
@@ -1140,18 +1140,18 @@
}
alias _N4 PLDisplay;
-/* Macro used (in some cases) to ignore value of argument */
-/* I don't plan on changing the value so you can hard-code it */
+// Macro used (in some cases) to ignore value of argument
+// I don't plan on changing the value so you can hard-code it
const int PL_NOTSET = -42;
-/* See plcont.c for examples of the following */
+// See plcont.c for examples of the following
-/*
- * PLfGrid is for passing (as a pointer to the first element) an arbitrarily
- * dimensioned array. The grid dimensions MUST be stored, with a maximum of 3
- * dimensions assumed for now.
- */
+//
+// PLfGrid is for passing (as a pointer to the first element) an arbitrarily
+// dimensioned array. The grid dimensions MUST be stored, with a maximum of 3
+// dimensions assumed for now.
+//
struct _N5
{
@@ -1162,10 +1162,10 @@
}
alias _N5 PLfGrid;
-/*
- * PLfGrid2 is for passing (as an array of pointers) a 2d function array. The
- * grid dimensions are passed for possible bounds checking.
- */
+//
+// PLfGrid2 is for passing (as an array of pointers) a 2d function array. The
+// grid dimensions are passed for possible bounds checking.
+//
struct _N6
{
@@ -1175,16 +1175,16 @@
}
alias _N6 PLfGrid2;
-/*
- * NOTE: a PLfGrid3 is a good idea here but there is no way to exploit it yet
- * so I'll leave it out for now.
- */
+//
+// NOTE: a PLfGrid3 is a good idea here but there is no way to exploit it yet
+// so I'll leave it out for now.
+//
-/*
- * PLcGrid is for passing (as a pointer to the first element) arbitrarily
- * dimensioned coordinate transformation arrays. The grid dimensions MUST be
- * stored, with a maximum of 3 dimensions assumed for now.
- */
+//
+// PLcGrid is for passing (as a pointer to the first element) arbitrarily
+// dimensioned coordinate transformation arrays. The grid dimensions MUST be
+// stored, with a maximum of 3 dimensions assumed for now.
+//
struct _N7
{
@@ -1197,11 +1197,11 @@
}
alias _N7 c_PLcGrid;
-/*
- * PLcGrid2 is for passing (as arrays of pointers) 2d coordinate
- * transformation arrays. The grid dimensions are passed for possible bounds
- * checking.
- */
+//
+// PLcGrid2 is for passing (as arrays of pointers) 2d coordinate
+// transformation arrays. The grid dimensions are passed for possible bounds
+// checking.
+//
struct _N8
{
@@ -1213,12 +1213,12 @@
}
alias _N8 c_PLcGrid2;
-/*
- * NOTE: a PLcGrid3 is a good idea here but there is no way to exploit it yet
- * so I'll leave it out for now.
- */
+//
+// NOTE: a PLcGrid3 is a good idea here but there is no way to exploit it yet
+// so I'll leave it out for now.
+//
-/* PLColor is the usual way to pass an rgb color value. */
+// PLColor is the usual way to pass an rgb color value.
struct _N9
{
@@ -1230,7 +1230,7 @@
}
alias _N9 PLColor;
-/* PLControlPt is how cmap1 control points are represented. */
+// PLControlPt is how cmap1 control points are represented.
struct _N10
{
@@ -1243,8 +1243,8 @@
}
alias _N10 PLControlPt;
-/* A PLBufferingCB is a control block for interacting with devices
- * that support double buffering. */
+// A PLBufferingCB is a control block for interacting with devices
+// that support double buffering.
struct _N11
{
@@ -1258,53 +1258,53 @@
const PLESC_DOUBLEBUFFERING_QUERY = 3;
-/*--------------------------------------------------------------------------* * BRAINDEAD-ness
- *
- * Some systems allow the Fortran & C namespaces to clobber each other.
- * For PLplot to work from Fortran on these systems, we must name the the
- * externally callable C functions something other than their Fortran entry
- * names. In order to make this as easy as possible for the casual user,
- * yet reversible to those who abhor my solution, I have done the
- * following:
- *
- * The C-language bindings are actually different from those
- * described in the manual. Macros are used to convert the
- * documented names to the names used in this package. The
- * user MUST include plplot.h in order to get the name
- * redefinition correct.
- *
- * Sorry to have to resort to such an ugly kludge, but it is really the
- * best way to handle the situation at present. If all available
- * compilers offer a way to correct this stupidity, then perhaps we can
- * eventually reverse it.
- *
- * If you feel like screaming at someone (I sure do), please
- * direct it at your nearest system vendor who has a braindead shared
- * C/Fortran namespace. Some vendors do offer compiler switches that
- * change the object names, but then everybody who wants to use the
- * package must throw these same switches, leading to no end of trouble.
- *
- * Note that this definition should not cause any noticable effects except
- * when debugging PLplot calls, in which case you will need to remember
- * the real function names (same as before but with a 'c_' prepended).
- *
- * Also, to avoid macro conflicts, the BRAINDEAD part must not be expanded
- * in the stub routines.
- *
- * Aside: the reason why a shared Fortran/C namespace is deserving of the
- * BRAINDEAD characterization is that it completely precludes the the kind
- * of universal API that is attempted (more or less) with PLplot, without
- * Herculean efforts (e.g. remapping all of the C bindings by macros as
- * done here). The vendors of such a scheme, in order to allow a SINGLE
- * type of argument to be passed transparently between C and Fortran,
- * namely, a pointer to a conformable data type, have slammed the door on
- * insertion of stub routines to handle the conversions needed for other
- * data types. Intelligent linkers could solve this problem, but these are
- * not anywhere close to becoming universal. So meanwhile, one must live
- * with either stub routines for the inevitable data conversions, or a
- * different API. The former is what is used here, but is made far more
- * difficult in a braindead shared Fortran/C namespace.
- \*--------------------------------------------------------------------------*/
+//--------------------------------------------------------------------------* * BRAINDEAD-ness
+//
+// Some systems allow the Fortran & C namespaces to clobber each other.
+// For PLplot to work from Fortran on these systems, we must name the the
+// externally callable C functions something other than their Fortran entry
+// names. In order to make this as easy as possible for the casual user,
+// yet reversible to those who abhor my solution, I have done the
+// following:
+//
+// The C-language bindings are actually different from those
+// described in the manual. Macros are used to convert the
+// documented names to the names used in this package. The
+// user MUST include plplot.h in order to get the name
+// redefinition correct.
+//
+// Sorry to have to resort to such an ugly kludge, but it is really the
+// best way to handle the situation at present. If all available
+// compilers offer a way to correct this stupidity, then perhaps we can
+// eventually reverse it.
+//
+// If you feel like screaming at someone (I sure do), please
+// direct it at your nearest system vendor who has a braindead shared
+// C/Fortran namespace. Some vendors do offer compiler switches that
+// change the object names, but then everybody who wants to use the
+// package must throw these same switches, leading to no end of trouble.
+//
+// Note that this definition should not cause any noticable effects except
+// when debugging PLplot calls, in which case you will need to remember
+// the real function names (same as before but with a 'c_' prepended).
+//
+// Also, to avoid macro conflicts, the BRAINDEAD part must not be expanded
+// in the stub routines.
+//
+// Aside: the reason why a shared Fortran/C namespace is deserving of the
+// BRAINDEAD characterization is that it completely precludes the the kind
+// of universal API that is attempted (more or less) with PLplot, without
+// Herculean efforts (e.g. remapping all of the C bindings by macros as
+// done here). The vendors of such a scheme, in order to allow a SINGLE
+// type of argument to be passed transparently between C and Fortran,
+// namely, a pointer to a conformable data type, have slammed the door on
+// insertion of stub routines to handle the conversions needed for other
+// data types. Intelligent linkers could solve this problem, but these are
+// not anywhere close to becoming universal. So meanwhile, one must live
+// with either stub routines for the inevitable data conversions, or a
+// different API. The former is what is used here, but is made far more
+// difficult in a braindead shared Fortran/C namespace.
+//--------------------------------------------------------------------------
@@ -1477,7 +1477,7 @@
alias c_plxormod plxormod;
-/* Redefine some old function names for backward compatibility */
+// Redefine some old function names for backward compatibility
alias pleop plclr;
@@ -1491,211 +1491,211 @@
alias plgvpw plP_gvpw;
-/*--------------------------------------------------------------------------* * Function Prototypes
-\*--------------------------------------------------------------------------*/
+//--------------------------------------------------------------------------* * Function Prototypes
+//--------------------------------------------------------------------------
-/* All void types */
-/* C routines callable from stub routines come first */
+// All void types
+// C routines callable from stub routines come first
-/* set the format of the contour labels */
+// set the format of the contour labels
void c_pl_setcontlabelformat( PLINT lexp, PLINT sigdig );
-/* set offset and spacing of contour labels */
+// set offset and spacing of contour labels
void c_pl_setcontlabelparam( PLFLT offset, PLFLT size, PLFLT spacing, PLINT active );
-/* Advance to subpage "page", or to the next one if "page" = 0. */
+// Advance to subpage "page", or to the next one if "page" = 0.
void c_pladv( PLINT page );
-/* simple arrow plotter. */
+// simple arrow plotter.
void c_plvect( PLFLT **u, PLFLT **v, PLINT nx, PLINT ny, PLFLT scale,
void function( PLFLT, PLFLT, PLFLT *, PLFLT *, PLPointer ) pltr, PLPointer pltr_data );
void c_plsvect( PLFLT *arrowx, PLFLT *arrowy, PLINT npts, PLBOOL fill );
-/* This functions similarly to plbox() except that the origin of the axes */
-/* is placed at the user-specified point (x0, y0). */
+// This functions similarly to plbox() except that the origin of the axes
+// is placed at the user-specified point (x0, y0).
void c_plaxes( PLFLT x0, PLFLT y0, char *xopt, PLFLT xtick, PLINT nxsub,
char *yopt, PLFLT ytick, PLINT nysub );
-/* Flags for plbin() - opt argument */
+// Flags for plbin() - opt argument
const PL_BIN_DEFAULT = 0;
const PL_BIN_CENTRED = 1;
const PL_BIN_NOEXPAND = 2;
const PL_BIN_NOEMPTY = 4;
-/* Plot a histogram using x to store data values and y to store frequencies */
+// Plot a histogram using x to store data values and y to store frequencies
void c_plbin( PLINT nbin, PLFLT *x, PLFLT *y, PLINT opt );
-/* Start new page. Should only be used with pleop(). */
+// Start new page. Should only be used with pleop().
void c_plbop();
-/* This draws a box around the current viewport. */
+// This draws a box around the current viewport.
void c_plbox( char *xopt, PLFLT xtick, PLINT nxsub, char *yopt, PLFLT ytick, PLINT nysub );
-/* This is the 3-d analogue of plbox(). */
+// This is the 3-d analogue of plbox().
void c_plbox3( char *xopt, char *xlabel, PLFLT xtick, PLINT nsubx, char *yopt,
char *ylabel, PLFLT ytick, PLINT nsuby, char *zopt, char *zlabel,
PLFLT ztick, PLINT nsubz );
-/* Calculate broken-down time from continuous time for current stream. */
+// Calculate broken-down time from continuous time for current stream.
void c_plbtime( PLINT *year, PLINT *month, PLINT *day, PLINT *hour, PLINT *min, PLFLT *sec, PLFLT ctime );
-/* Setup a user-provided custom labeling function */
+// Setup a user-provided custom labeling function
void c_plslabelfunc( void function( PLINT, PLFLT, char*, PLINT, PLPointer ) labelfunc,
PLPointer label_data );
-/* Calculate world coordinates and subpage from relative device coordinates. */
+// Calculate world coordinates and subpage from relative device coordinates.
void c_plcalc_world( PLFLT rx, PLFLT ry, PLFLT *wx, PLFLT *wy, PLINT *window );
-/* Plot an arc */
+// Plot an arc
void c_plarc( PLFLT x, PLFLT y, PLFLT a, PLFLT b, PLFLT angle1, PLFLT angle2,
PLFLT rotate, PLBOOL fill );
-/* Clear current subpage. */
+// Clear current subpage.
void c_plclear();
-/* Set color, map 0. Argument is integer between 0 and 15. */
+// Set color, map 0. Argument is integer between 0 and 15.
void c_plcol0( PLINT icol0 );
-/* Set color, map 1. Argument is a float between 0. and 1. */
+// Set color, map 1. Argument is a float between 0. and 1.
void c_plcol1( PLFLT col1 );
-/* Configure transformation between continuous and broken-down time (and
- * vice versa) for current stream. */
+// Configure transformation between continuous and broken-down time (and
+// vice versa) for current stream.
void c_plconfigtime( PLFLT scale, PLFLT offset1, PLFLT offset2, PLINT ccontrol, PLBOOL ifbtime_offset,
PLINT year, PLINT month, PLINT day, PLINT hour, PLINT min, PLFLT sec );
-/* 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.
- */
+// 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.
+//
void c_plcont( PLFLT **f, PLINT nx, PLINT ny, PLINT kx, PLINT lx, PLINT ky, PLINT ly,
PLFLT *clevel, PLINT nlevel,
void function( PLFLT, PLFLT, PLFLT *, PLFLT *, PLPointer ) pltr, PLPointer pltr_data );
-/* 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.
- */
+// 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.
+//
void plfcont( PLFLT function( PLINT, PLINT, PLPointer ) f2eval, PLPointer f2eval_data, PLINT nx, PLINT ny,
PLINT kx, PLINT lx, PLINT ky, PLINT ly, PLFLT *clevel, PLINT nlevel,
void function( PLFLT, PLFLT, PLFLT *, PLFLT *, PLPointer ) pltr, PLPointer pltr_data );
-/* Copies state parameters from the reference stream to the current stream. */
+// Copies state parameters from the reference stream to the current stream.
void c_plcpstrm( PLINT iplsr, PLBOOL flags );
-/* Calculate continuous time from broken-down time for current stream. */
+// Calculate continuous time from broken-down time for current stream.
void c_plctime( PLINT year, PLINT month, PLINT day, PLINT hour, PLINT min, PLFLT sec, PLFLT *ctime );
-/* Converts input values from relative device coordinates to relative plot */
-/* coordinates. */
+// Converts input values from relative device coordinates to relative plot
+// coordinates.
void pldid2pc( PLFLT *xmin, PLFLT *ymin, PLFLT *xmax, PLFLT *ymax );
-/* Converts input values from relative plot coordinates to relative */
-/* device coordinates. */
+// Converts input values from relative plot coordinates to relative
+// device coordinates.
void pldip2dc( PLFLT *xmin, PLFLT *ymin, PLFLT *xmax, PLFLT *ymax );
-/* End a plotting session for all open streams. */
+// End a plotting session for all open streams.
void c_plend();
-/* End a plotting session for the current stream only. */
+// End a plotting session for the current stream only.
void c_plend1();
-/* Simple interface for defining viewport and window. */
+// Simple interface for defining viewport and window.
void c_plenv( PLFLT xmin, PLFLT xmax, PLFLT ymin, PLFLT ymax, PLINT just, PLINT axis );
-/* similar to plenv() above, but in multiplot mode does not advance the subpage,
- * instead the current subpage is cleared */
+// similar to plenv() above, but in multiplot mode does not advance the subpage,
+// instead the current subpage is cleared
void c_plenv0( PLFLT xmin, PLFLT xmax, PLFLT ymin, PLFLT ymax, PLINT just, PLINT axis );
-/* End current page. Should only be used with plbop(). */
+// End current page. Should only be used with plbop().
void c_pleop();
-/* Plot horizontal error bars (xmin(i),y(i)) to (xmax(i),y(i)) */
+// Plot horizontal error bars (xmin(i),y(i)) to (xmax(i),y(i))
void c_plerrx( PLINT n, PLFLT *xmin, PLFLT *xmax, PLFLT *y );
-/* Plot vertical error bars (x,ymin(i)) to (x(i),ymax(i)) */
+// Plot vertical error bars (x,ymin(i)) to (x(i),ymax(i))
void c_plerry( PLINT n, PLFLT *x, PLFLT *ymin, PLFLT *ymax );
-/* Advance to the next family file on the next new page */
+// Advance to the next family file on the next new page
void c_plfamadv();
-/* Pattern fills the polygon bounded by the input points. */
+// Pattern fills the polygon bounded by the input points.
void c_plfill( PLINT n, PLFLT *x, PLFLT *y );
-/* Pattern fills the 3d polygon bounded by the input points. */
+// Pattern fills the 3d polygon bounded by the input points.
void c_plfill3( PLINT n, PLFLT *x, PLFLT *y, PLFLT *z );
-/* Flushes the output stream. Use sparingly, if at all. */
+// Flushes the output stream. Use sparingly, if at all.
void c_plflush();
-/* Sets the global font flag to 'ifont'. */
+// Sets the global font flag to 'ifont'.
void c_plfont( PLINT ifont );
-/* Load specified font set. */
+// Load specified font set.
void c_plfontld( PLINT fnt );
-/* Get character default height and current (scaled) height */
+// Get character default height and current (scaled) height
void c_plgchr( PLFLT *p_def, PLFLT *p_ht );
-/* Returns 8 bit RGB values for given color from color map 0 */
+// Returns 8 bit RGB values for given color from color map 0
void c_plgcol0( PLINT icol0, PLINT *r, PLINT *g, PLINT *b );
-/* Returns 8 bit RGB values for given color from color map 0 and alpha value */
+// Returns 8 bit RGB values for given color from color map 0 and alpha value
void c_plgcol0a( PLINT icol0, PLINT *r, PLINT *g, PLINT *b, PLFLT *a );
-/* Returns the background color by 8 bit RGB value */
+// Returns the background color by 8 bit RGB value
void c_plgcolbg( PLINT *r, PLINT *g, PLINT *b );
-/* Returns the background color by 8 bit RGB value and alpha value */
+// Returns the background color by 8 bit RGB value and alpha value
void c_plgcolbga( PLINT *r, PLINT *g, PLINT *b, PLFLT *a );
-/* Returns the current compression setting */
+// Returns the current compression setting
void c_plgcompression( PLINT *compression );
-/* Get the current device (keyword) name */
+// Get the current device (keyword) name
void c_plgdev( char *p_dev );
-/* Retrieve current window into device space */
+// Retrieve current window into device space
void c_plgdidev( PLFLT *p_mar, PLFLT *p_aspect, PLFLT *p_jx, PLFLT *p_jy );
-/* Get plot orientation */
+// Get plot orientation
void c_plgdiori( PLFLT *p_rot );
-/* Retrieve current window into plot space */
+// Retrieve current window into plot space
void c_plgdiplt( PLFLT *p_xmin, PLFLT *p_ymin, PLFLT *p_xmax, PLFLT *p_ymax );
-/* Get FCI (font characterization integer) */
+// Get FCI (font characterization integer)
void c_plgfci( PLUNICODE *pfci );
-/* Get family file parameters */
+// Get family file parameters
void c_plgfam( PLINT *p_fam, PLINT *p_num, PLINT *p_bmax );
-/* Get the (current) output file name. Must be preallocated to >80 bytes */
+// Get the (current) output file name. Must be preallocated to >80 bytes
void c_plgfnam( char *fnam );
-/* Get the current font family, style and weight */
+// Get the current font family, style and weight
void c_plgfont( PLINT *p_family, PLINT *p_style, PLINT *p_weight );
-/* Get the (current) run level. */
+// Get the (current) run level.
void c_plglevel( PLINT *p_level );
-/* Get output device parameters. */
+// Get output device parameters.
void c_plgpage( PLFLT *p_xp, PLFLT *p_yp, PLINT *p_xleng, PLINT *p_yleng,
PLINT *p_xoff, PLINT *p_yoff );
-/* Switches to graphics screen. */
+// Switches to graphics screen.
void c_plgra();
-/* Draw gradient in polygon. */
+// Draw gradient in polygon.
void c_plgradient( PLINT n, PLFLT *x, PLFLT *y, PLFLT angle );
-/* grid irregularly sampled data */
+// grid irregularly sampled data
void c_plgriddata( PLFLT *x, PLFLT *y, PLFLT *z, PLINT npts, PLFLT *xg, PLINT nptsx,
PLFLT *yg, PLINT nptsy, PLFLT **zg, PLINT type, PLFLT data );
-/* type of gridding algorithm for plgriddata() */
+// type of gridding algorithm for plgriddata()
const GRID_CSA = 1;
const GRID_DTLI = 2;
const GRID_NNI = 3;
@@ -1703,54 +1703,54 @@
const GRID_NNLI = 5;
const GRID_NNAIDW = 6;
-/* Get subpage boundaries in absolute coordinates */
+// Get subpage boundaries in absolute coordinates
void c_plgspa( PLFLT *xmin, PLFLT *xmax, PLFLT *ymin, PLFLT *ymax );
-/* Get current stream number. */
+// Get current stream number.
void c_plgstrm( PLINT *p_strm );
-/* Get the current library version number */
+// Get the current library version number
void c_plgver( char *p_ver );
-/* Get viewport boundaries in normalized device coordinates */
+// Get viewport boundaries in normalized device coordinates
void c_plgvpd( PLFLT *p_xmin, PLFLT *p_xmax, PLFLT *p_ymin, PLFLT *p_ymax );
-/* Get viewport boundaries in world coordinates */
+// Get viewport boundaries in world coordinates
void c_plgvpw( PLFLT *p_xmin, PLFLT *p_xmax, PLFLT *p_ymin, PLFLT *p_ymax );
-/* Get x axis labeling parameters */
+// Get x axis labeling parameters
void c_plgxax( PLINT *p_digmax, PLINT *p_digits );
-/* Get y axis labeling parameters */
+// Get y axis labeling parameters
void c_plgyax( PLINT *p_digmax, PLINT *p_digits );
-/* Get z axis labeling parameters */
+// Get z axis labeling parameters
void c_plgzax( PLINT *p_digmax, PLINT *p_digits );
-/* Flags for plhist() - opt argument; note: some flags are passed to
- * plbin() for the actual plotting */
+// Flags for plhist() - opt argument; note: some flags are passed to
+// plbin() for the actual plotting
const PL_HIST_DEFAULT = 0;
const PL_HIST_NOSCALING = 1;
const PL_HIST_IGNORE_OUTLIERS = 2;
const PL_HIST_NOEXPAND = 8;
const PL_HIST_NOEMPTY = 16;
-/* Draws a histogram of n values of a variable in array data[0..n-1] */
+// Draws a histogram of n values of a variable in array data[0..n-1]
void c_plhist( PLINT n, PLFLT *data, PLFLT datmin, PLFLT datmax, PLINT nbin, PLINT opt );
-/* Set current color (map 0) by hue, lightness, and saturation. */
+// Set current color (map 0) by hue, lightness, and saturation.
void c_plhls( PLFLT h, PLFLT l, PLFLT s );
-/* Functions for converting between HLS and RGB color space */
+// Functions for converting between HLS and RGB color space
void c_plhlsrgb( PLFLT h, PLFLT l, PLFLT s, PLFLT *p_r, PLFLT *p_g, PLFLT *p_b );
-/* Initializes PLplot, using preset or default options */
+// Initializes PLplot, using preset or default options
void c_plinit();
-/* Draws a line segment from (x1, y1) to (x2, y2). */
+// Draws a line segment from (x1, y1) to (x2, y2).
void c_pljoin( PLFLT x1, PLFLT y1, PLFLT x2, PLFLT y2 );
-/* Simple routine for labelling graphs. */
+// Simple routine for labelling graphs.
void c_pllab( char *xlabel, char *ylabel, char *tlabel );
// Flags used for position argument of both pllegend and plcolorbar
@@ -1801,226 +1801,226 @@
PLINT *symbol_colors, PLFLT *symbol_scales,
PLINT *symbol_numbers, char **symbols );
-/* Sets position of the light source */
+// Sets position of the light source
void c_pllightsource( PLFLT x, PLFLT y, PLFLT z );
-/* Draws line segments connecting a series of points. */
+// Draws line segments connecting a series of points.
void c_plline( PLINT n, PLFLT *x, PLFLT *y );
-/* Draws a line in 3 space. */
+// Draws a line in 3 space.
void c_plline3( PLINT n, PLFLT *x, PLFLT *y, PLFLT *z );
-/* Set line style. */
+// Set line style.
void c_pllsty( PLINT lin );
-/* plot continental outline in world coordinates */
+// plot continental outline in world coordinates
void c_plmap( void function( PLINT, PLFLT *, PLFLT* ) mapform, char *type, PLFLT minlong,
PLFLT maxlong, PLFLT minlat, PLFLT maxlat );
-/* Plot the latitudes and longitudes on the background. */
+// Plot the latitudes and longitudes on the background.
void c_plmeridians( void function( PLINT, PLFLT *, PLFLT* ) mapform, PLFLT dlong, PLFLT dlat,
PLFLT minlong, PLFLT maxlong, PLFLT minlat, PLFLT maxlat );
-/* Plots a mesh representation of the function z[x][y]. */
+// Plots a mesh representation of the function z[x][y].
void c_plmesh( PLFLT *x, PLFLT *y, PLFLT **z, PLINT nx, PLINT ny, PLINT opt );
-/* Plots a mesh representation of the function z[x][y] with contour */
+// Plots a mesh representation of the function z[x][y] with contour
void c_plmeshc( PLFLT *x, PLFLT *y, PLFLT **z, PLINT nx, PLINT ny, PLINT opt,
PLFLT *clevel, PLINT nlevel );
-/* Creates a new stream and makes it the default. */
+// Creates a new stream and makes it the default.
void c_plmkstrm( PLINT *p_strm );
-/* Prints out "text" at specified position relative to viewport */
+// Prints out "text" at specified position relative to viewport
void c_plmtex( char *side, PLFLT disp, PLFLT pos, PLFLT just, char *text );
-/* Prints out "text" at specified position relative to viewport (3D)*/
+// Prints out "text" at specified position relative to viewport (3D)
void c_plmtex3( char *side, PLFLT disp, PLFLT pos, PLFLT just, char *text );
-/* Plots a 3-d representation of the function z[x][y]. */
+// Plots a 3-d representation of the function z[x][y].
void c_plot3d( PLFLT *x, PLFLT *y, PLFLT **z, PLINT nx, PLINT ny, PLINT opt, PLBOOL side );
-/* Plots a 3-d representation of the function z[x][y] with contour. */
+// Plots a 3-d representation of the function z[x][y] with contour.
void c_plot3dc( PLFLT *x, PLFLT *y, PLFLT **z, PLINT nx, PLINT ny, PLINT opt,
PLFLT *clevel, PLINT nlevel );
-/* Plots a 3-d representation of the function z[x][y] with contour and
- * y index limits. */
+// Plots a 3-d representation of the function z[x][y] with contour and
+// y index limits.
void c_plot3dcl( PLFLT *x, PLFLT *y, PLFLT **z, PLINT nx, PLINT ny, PLINT opt,
PLFLT *clevel, PLINT nlevel, PLINT ixstart, PLINT ixn,
PLINT *indexymin, PLINT *indexymax );
-/*
- * definitions for the opt argument in plot3dc() and plsurf3d()
- *
- * DRAW_LINEX *must* be 1 and DRAW_LINEY *must* be 2, because of legacy code!
- */
-const DRAW_LINEX = 1 << 0; /* draw lines parallel to the X axis */
-const DRAW_LINEY = 1 << 1; /* draw lines parallel to the Y axis */
-const DRAW_LINEXY = DRAW_LINEX | DRAW_LINEY; /* draw lines parallel to both the X and Y axis */
-const MAG_COLOR = 1 << 2; /* draw the mesh with a color dependent of the magnitude */
-const BASE_CONT = 1 << 3; /* draw contour plot at bottom xy plane */
-const TOP_CONT = 1 << 4; /* draw contour plot at top xy plane */
-const SURF_CONT = 1 << 5; /* draw contour plot at surface */
-const DRAW_SIDES = 1 << 6; /* draw sides */
-const FACETED = 1 << 7; /* draw outline for each square that makes up the surface */
-const MESH = 1 << 8; /* draw mesh */
+//
+// definitions for the opt argument in plot3dc() and plsurf3d()
+//
+// DRAW_LINEX *must* be 1 and DRAW_LINEY *must* be 2, because of legacy code!
+//
+const DRAW_LINEX = 1 << 0; // draw lines parallel to the X axis
+const DRAW_LINEY = 1 << 1; // draw lines parallel to the Y axis
+const DRAW_LINEXY = DRAW_LINEX | DRAW_LINEY; // draw lines parallel to both the X and Y axis
+const MAG_COLOR = 1 << 2; // draw the mesh with a color dependent of the magnitude
+const BASE_CONT = 1 << 3; // draw contour plot at bottom xy plane
+const TOP_CONT = 1 << 4; // draw contour plot at top xy plane
+const SURF_CONT = 1 << 5; // draw contour plot at surface
+const DRAW_SIDES = 1 << 6; // draw sides
+const FACETED = 1 << 7; // draw outline for each square that makes up the surface
+const MESH = 1 << 8; // draw mesh
-/*
- * valid options for plot3dc():
- *
- * DRAW_SIDES, BASE_CONT, TOP_CONT (not yet),
- * MAG_COLOR, DRAW_LINEX, DRAW_LINEY, DRAW_LINEXY.
- *
- * valid options for plsurf3d():
- *
- * MAG_COLOR, BASE_CONT, SURF_CONT, FACETED, DRAW_SIDES.
- */
+//
+// valid options for plot3dc():
+//
+// DRAW_SIDES, BASE_CONT, TOP_CONT (not yet),
+// MAG_COLOR, DRAW_LINEX, DRAW_LINEY, DRAW_LINEXY.
+//
+// valid options for plsurf3d():
+//
+// MAG_COLOR, BASE_CONT, SURF_CONT, FACETED,...
[truncated message content] |
