S2PLOT:Function List

From S2PLOT

(Difference between revisions)
Jump to: navigation, search
Revision as of 04:11, 26 October 2007
S2plot admin (Talk | contribs)

← Previous diff
Revision as of 04:12, 26 October 2007
S2plot admin (Talk | contribs)

Next diff →
Line 1: Line 1:
__FORCETOC__ __FORCETOC__
 +
==General == ==General ==
<table border=1 width=100%> <table border=1 width=100%>
Line 11: Line 12:
==Opening, Closing and Selecting Devices == ==Opening, Closing and Selecting Devices ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<th width=15%>S2PLOT<th><th width=*>Description<th><th width=15%>PGPLOT<th><tr>+<tr><td>[[Function:s2open | s2open]]</td><td>Open the S2PLOT device. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGOPEN PGOPEN]</td></tr>
-<tr><Tr><td>[[Function:reference.php?s=1&e=s2open | s2open]<td><td>Open the S2PLOT device. <td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGOPEN PGOPEN]<td><tr>+<tr><td>[[Function:s2opend | s2opend]]</td><td>Open the S2PLOT device (device string version). </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGOPEN PGOPEN]</td></tr>
-<Tr><td>[[Function:reference.php?s=1&e=s2opend | s2opend]<td><td>Open the S2PLOT device (device string version). <td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGOPEN PGOPEN]<td><tr>+<tr><td>[[Function:s2opendo | s2opendo]]</td><td>Open the S2PLOT device (device string version, ignoring command line arguments). </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGOPEN PGOPEN]</td></tr>
-<Tr><td>[[Function:reference.php?s=1&e=s2opendo | s2opendo]<td><td>Open the S2PLOT device (device string version, ignoring command line arguments). <td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGOPEN PGOPEN]<td><tr>+<tr><td>[[Function:s2ldev | s2ldev]]</td><td>List the available S2PLOT devices on stdout. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGLDEV PGLDEV]</td></tr>
-<Tr><td>[[Function:reference.php?s=1&e=s2ldev | s2ldev]<td><td>List the available S2PLOT devices on stdout. <td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGLDEV PGLDEV]<td><tr>+<tr><td>[[Function:s2show | s2show]]</td><td>Draw the scene and enter interactive mode if interactive is non-zero. </td><td> </td></tr>
-<Tr><td>[[Function:reference.php?s=1&e=s2show | s2show]<td><td>Draw the scene and enter interactive mode if interactive is non-zero. <td><td> <td><tr>+<tr><td>[[Function:s2disp | s2disp]]</td><td>Draw the scene, but return control when a timeout occurs or when 'TAB' key is pressed. </td><td> </td></tr>
-<Tr><td>[[Function:reference.php?s=1&e=s2disp | s2disp]<td><td>Draw the scene, but return control when a timeout occurs or when 'TAB' key is pressed. <td><td> <td><tr>+<tr><td>[[Function:s2eras | s2eras]]</td><td>Erase the geometry. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGERAS PGERAS]</td></tr>
-<Tr><td>[[Function:reference.php?s=1&e=s2eras | s2eras]<td><td>Erase the geometry. <td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGERAS PGERAS]<td><tr>+
-<table>+
- +
-==Opening, Closing and Selecting Devices==+
-<table border=1 width=100%>+
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+
-<tr><td>[[function:s2open | s2open]]</td><td> Open the S2PLOT device. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGOPEN PGOPEN]</td></tr>+
-<tr><td>[[function:s2opend | s2opend]]</td><td>Open the S2PLOT device (device string version).</td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGOPEN PGOPEN] </td></tr>+
-<tr><td>[[function:s2opendo | s2opendo]]</td><td>Open the S2PLOT device (device string version, ignoring command line arguments). </td><td> [http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGOPEN PGOPEN]</td></tr>+
-<tr><td>[[function:s2ldev | s2ldev]]</td><td>List the available S2PLOT devices on stdout.</td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGLDEV PGLDEV] </td></tr>+
-<tr><td>[[function:s2show | s2show]]</td><td>Draw the scene and enter interactive mode if interactive is non-zero.</td><td> </td></tr>+
-<tr><td>[[function:s2disp | s2disp]]</td><td>Draw the scene, but return control when a timeout occurs or when 'TAB' key is pressed. </td><td> </td></tr>+
-<tr><td>[[function:s2eras | s2eras]]</td><td>Erase the geometry.</td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGERAS PGERAS]</td></tr>+
</table> </table>
-==Windows and Viewports==+==Windows and Viewports ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2svp | s2svp]]</td><td> Set up the part of 3D space that is used for plotting. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGSVP PGSVP]</td></tr>+<tr><td>[[Function:s2svp | s2svp]]</td><td>Set up the part of 3D space that is used for plotting. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGSVP PGSVP]</td></tr>
-<tr><td>[[function:s2qvp | s2qvp]]</td><td>Query the device viewport range.</td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGQVP PGQVP]</td></tr>+<tr><td>[[Function:s2qvp | s2qvp]]</td><td>Query the device viewport range. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGQVP PGQVP]</td></tr>
-<tr><td>[[function:s2swin | s2swin]]</td><td> Set up the world coordinate range for the device.</td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGSWIN PGSWIN]</td></tr>+<tr><td>[[Function:s2swin | s2swin]]</td><td>Set up the world coordinate range for the device. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGSWIN PGSWIN]</td></tr>
-<tr><td>[[function:s2qwin | s2qwin]]</td><td>Query the world coordinate range. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGQWIN PGQWIN] </td></tr>+<tr><td>[[Function:s2qwin | s2qwin]]</td><td>Query the world coordinate range. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGQWIN PGQWIN]</td></tr>
-<tr><td>[[function:s2env | s2env]]</td><td>Convenience function which sets the plotting environment. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGENV PGENV]</td></tr>+<tr><td>[[Function:s2env | s2env]]</td><td>Convenience function which sets the plotting environment. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGENV PGENV]</td></tr>
</table> </table>
- +==Primitives ==
- +
-==Primitives==+
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>[[Function:s2line | s2line]]</td><td>Draw a poly line, n vertices at (xpts, ypts, zpts). </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGLINE PGLINE]</td></tr>
 +<tr><td>[[Function:s2circxy | s2circxy]]</td><td>Draw a circle in the xy plane at a given z coordinate. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGCIRC PGCIRC]</td></tr>
 +<tr><td>[[Function:s2circxz | s2circxz]]</td><td>Draw a circle in the xz plane at a given y coordinate. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGCIRC PGCIRC]</td></tr>
 +<tr><td>[[Function:s2circyz | s2circyz]]</td><td>Draw a circle in the yz plane at a given x coordinate. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGCIRC PGCIRC]</td></tr>
 +<tr><td>[[Function:s2diskxy | s2diskxy]]</td><td>Draw a disk in the xy plane at a given z coordinate. </td><td> </td></tr>
 +<tr><td>[[Function:s2diskxz | s2diskxz]]</td><td>Draw a disk in the xz plane at a given y coordinate. </td><td> </td></tr>
 +<tr><td>[[Function:s2diskyz | s2diskyz]]</td><td>Draw a disk in the yz plane at a given x coordinate. </td><td> </td></tr>
 +<tr><td>[[Function:s2rectxy | s2rectxy]]</td><td>Draw a rectangle in the xy plane at a given z coordinate. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGRECT PGRECT]</td></tr>
 +<tr><td>[[Function:s2rectxz | s2rectxz]]</td><td>Draw a rectangle in the xz plane at a given y coordinate. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGRECT PGRECT]</td></tr>
 +<tr><td>[[Function:s2rectyz | s2rectyz]]</td><td>Draw a rectangle in the yz plane at a given x coordinate. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGRECT PGRECT]</td></tr>
 +<tr><td>[[Function:s2pt1 | s2pt1]]</td><td>Draw a single point with a given symbol. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGPT1 PGPT1]</td></tr>
 +<tr><td>[[Function:s2pt | s2pt]]</td><td>Draw a set of points with a given symbol. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGPT PGPT]</td></tr>
 +<tr><td>[[Function:s2pnts | s2pnts]]</td><td>Draw a set of points with different markers. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGPNTS PGPNTS]</td></tr>
 +<tr><td>[[Function:s2textxy | s2textxy]]</td><td>Draw text in the xy plane at a fixed z coordinate. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGTEXT PGTEXT]</td></tr>
 +<tr><td>[[Function:s2textxz | s2textxz]]</td><td>Draw text in the xz plane at a fixed y coordinate. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGTEXT PGTEXT]</td></tr>
 +<tr><td>[[Function:s2textyz | s2textyz]]</td><td>Draw text in the yz plane at a fixed x coordinate. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGTEXT PGTEXT]</td></tr>
 +<tr><td>[[Function:s2textxyf | s2textxyf]]</td><td>Draw flipped text in the xy plane at a fixed z coordinate. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGTEXT PGTEXT]</td></tr>
 +<tr><td>[[Function:s2textxzf | s2textxzf]]</td><td>Draw flipped text in the xz plane at a fixed y coordinate. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGTEXT PGTEXT]</td></tr>
 +<tr><td>[[Function:s2textyzf | s2textyzf]]</td><td>Draw flipped text in the yz plane at a fixed x coordinate. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGTEXT PGTEXT]</td></tr>
 +<tr><td>[[Function:s2qtxtxy | s2qtxtxy]]</td><td>Find the bounding box of text drawn with s2textxy. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGQTXT PGQTXT]</td></tr>
 +<tr><td>[[Function:s2qtxtxz | s2qtxtxz]]</td><td>Find the bounding box of text drawn with s2textxz. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGQTXT PGQTXT]</td></tr>
 +<tr><td>[[Function:s2qtxtyz | s2qtxtyz]]</td><td>Find the bounding box of text drawn with s2textyz. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGQTXT PGQTXT]</td></tr>
 +<tr><td>[[Function:s2qtxtxyf | s2qtxtxyf]]</td><td>Find the bounding box of text drawn with s2textxyf. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGQTXT PGQTXT]</td></tr>
 +<tr><td>[[Function:s2qtxtxzf | s2qtxtxzf]]</td><td>Find the bounding box of text drawn with s2textxzf. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGQTXT PGQTXT]</td></tr>
 +<tr><td>[[Function:s2qtxtyzf | s2qtxtyzf]]</td><td>Find the bounding box of text drawn with s2textyzf. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGQTXT PGQTXT]</td></tr>
 +<tr><td>[[Function:s2arro | s2arro]]</td><td>Draw an arrow from the point with world-coordinates (x1,y1,z1) to (x2,y2,z2). </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGARRO PGARRO]</td></tr>
</table> </table>
-==Attributes==+==Attributes ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>[[Function:s2sci | s2sci]]</td><td>Set the pen colour by index. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGSCI PGSCI]</td></tr>
 +<tr><td>[[Function:s2scr | s2scr]]</td><td>Set colour representation, ie. define a colour associated with an index. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGSCR PGSCR]</td></tr>
 +<tr><td>[[Function:s2qcr | s2qcr]]</td><td>Query colour representation. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGQCR PGQCR]</td></tr>
 +<tr><td>[[Function:s2slw | s2slw]]</td><td>Set the linewidth in pixels. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGSLW PGSLW]</td></tr>
 +<tr><td>[[Function:s2sch | s2sch]]</td><td>Set the character height in "arbitrary" units. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGSCH PGSCH]</td></tr>
 +<tr><td>[[Function:s2sah | s2sah]]</td><td>Set the style to be used for arrowheads drawn with s2arro. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGSAH PGSAH]</td></tr>
</table> </table>
-==Axes, Boxes & Labels==+==Axes, Boxes & Labels ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>[[Function:s2box | s2box]]</td><td>Draw a labelled box around the world space. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGBOX PGBOX]</td></tr>
 +<tr><td>[[Function:s2lab | s2lab]]</td><td>Draw labels along the edges of bounding box. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGLAB PGLAB]</td></tr>
</table> </table>
-==XY(Z) Plots==+==XY(Z) Plots ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>[[Function:s2errb | s2errb]]</td><td>Draw error bars at the coordinates (xpts[i], ypts[i], zpts[i]). </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGERRB PGERRB]</td></tr>
 +<tr><td>[[Function:s2funt | s2funt]]</td><td>Draw a curve defined by parametric equations fx(t), fy(t) and fz(t). </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGFUNT PGFUNT]</td></tr>
 +<tr><td>[[Function:s2funtc | s2funtc]]</td><td>Draw a curve defined by parametric equations fx(t), fy(t) and fz(t) with colour control. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGFUNT PGFUNT]</td></tr>
 +<tr><td>[[Function:s2funxy | s2funxy]]</td><td>Draw the surface described by the provided function fxy. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGFUNX PGFUNX]</td></tr>
 +<tr><td>[[Function:s2funxz | s2funxz]]</td><td>Draw the surface described by the provided function fxz. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGFUNY PGFUNY]</td></tr>
 +<tr><td>[[Function:s2funyz | s2funyz]]</td><td>Draw the surface described by the provided function fyz. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGFUNX PGFUNX]</td></tr>
 +<tr><td>[[Function:s2funxyr | s2funxyr]]</td><td>Draw surface as per s2funxy, but with explicit settings for the colour range mapping. </td><td> </td></tr>
 +<tr><td>[[Function:s2funxzr | s2funxzr]]</td><td>Draw surface as per s2funxz, but with explicit settings for the colour range mapping. </td><td> </td></tr>
 +<tr><td>[[Function:s2funyzr | s2funyzr]]</td><td>Draw surface as per s2funyz, but with explicit settings for the colour range mapping. </td><td> </td></tr>
 +<tr><td>[[Function:s2funuv | s2funuv]]</td><td>Plot a parametric function (generally a surface) defined by functions fx(u,v), fy(u,v) and fz(u,v). </td><td> </td></tr>
</table> </table>
-==Images/Surfaces==+==Images/Surfaces ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>[[Function:s2surp | s2surp]]</td><td>Draw a colour surface representation of the 2-dimensional array, data, containing nx * ny values. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGIMAG PGIMAG]</td></tr>
 +<tr><td>[[Function:s2surpa | s2surpa]]</td><td>Draw a colour surface representation of the 2-dimensional array, data, containing nx * ny values. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGIMAG PGIMAG]</td></tr>
 +<tr><td>[[Function:s2scir | s2scir]]</td><td>Set the range of colour indices used for shading. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGSCIR PGSCIR]</td></tr>
 +<tr><td>[[Function:s2qcir | s2qcir]]</td><td>Query the colour index range. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGQCIR PGQCIR]</td></tr>
 +<tr><td>[[Function:s2icm | s2icm]]</td><td>Install various colour maps. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGSITF PGSITF]</td></tr>
 +<tr><td>[[Function:s2wedge | s2wedge]]</td><td>Draw a colour wedge. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGWEDG PGWEDG]</td></tr>
</table> </table>
-==Vector Plots==+==Vector Plots ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>[[Function:s2vect3 | s2vect3]]</td><td>Draw a vector map of a 3D data array, with blanking. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGVECT PGVECT]</td></tr>
</table> </table>
-==Miscellaneous Routines==+==Miscellaneous Routines ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>[[Function:s2iden | s2iden]]</td><td>Write username, date, time and optional string at bottom of plot. </td><td>[http://www.astro.caltech.edu/~tjp/pgplot/subroutines.html#PGIDEN PGIDEN]</td></tr>
</table> </table>
-==S2 "Native" Routines==+==S2 "Native" Routines ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>[[Function:ns2sphere | ns2sphere]]</td><td>Draw a sphere, with a given centre, radius and colour. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vsphere | ns2vsphere]]</td><td>Draw a sphere, with a given centre, radius and colour - vecotr input. </td><td> </td></tr>
 +<tr><td>[[Function:ns2spheret | ns2spheret]]</td><td>Draw a textured sphere, with given centre, radius, colour and texture filename. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vspheret | ns2vspheret]]</td><td>Draw a textured sphere, with given centre, radius, colour and texture filename - vector input. </td><td> </td></tr>
 +<tr><td>[[Function:ns2disk | ns2disk]]</td><td>Draw an annulus with given centre, inner and out radii, and colour. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vdisk | ns2vdisk]]</td><td>Draw an annulus with given centre, inner and out radii, and colour - vector input. </td><td> </td></tr>
 +<tr><td>[[Function:ns2arc | ns2arc]]</td><td>Draw an arc at (px,py,pz) with normal (nx,ny,nz) in current pen (thickness,colour). </td><td> </td></tr>
 +<tr><td>[[Function:ns2varc | ns2varc]]</td><td>Draw an arc at (px,py,pz) with normal (nx,ny,nz) in current pen (thickness,colour) - vector input. </td><td> </td></tr>
 +<tr><td>[[Function:ns2text | ns2text]]</td><td>Draw text at a given position, with right and up vectors, a specific colour, and a text string of course. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vtext | ns2vtext]]</td><td>Draw text at a given position, with right and up vectors, a specific colour, and a text string of course - vector input. </td><td> </td></tr>
 +<tr><td>[[Function:ns2point | ns2point]]</td><td>Draw a point at the given position and colour. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vpoint | ns2vpoint]]</td><td>Draw a point at the given position and colour - vector input. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vnpoint | ns2vnpoint]]</td><td>Draw multiple points at the given positions with one colour - vector input. </td><td> </td></tr>
 +<tr><td>[[Function:ns2thpoint | ns2thpoint]]</td><td>Draw a thick point at given position, in colour and thickness in pixels (not world coords). </td><td> </td></tr>
 +<tr><td>[[Function:ns2vthpoint | ns2vthpoint]]</td><td>Draw a thick point at given position, in colour and thickness in pixels (not world coords) - vector input. </td><td> </td></tr>
 +<tr><td>[[Function:ns2i | ns2i]]</td><td>Illumination. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vi | ns2vi]]</td><td>Illumination - vector input. </td><td> </td></tr>
 +<tr><td>[[Function:ns2line | ns2line]]</td><td>Draw a line from one point to another in a specific colour. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vline | ns2vline]]</td><td>Draw a line from one point to another in a specific colour - vector input. </td><td> </td></tr>
 +<tr><td>[[Function:ns2thline | ns2thline]]</td><td>Draw a thick line from one point to another in a specific colour. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vthline | ns2vthline]]</td><td>Draw a thick line from one point to another in a specific colour - vector input. </td><td> </td></tr>
 +<tr><td>[[Function:ns2cline | ns2cline]]</td><td>Draw a coloured line, with colour blended between the two given colours along the line. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vcline | ns2vcline]]</td><td>Draw a coloured line, with colour blended between the two given colours along the line - vector input. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vf3 | ns2vf3]]</td><td>3-vertex facet with single colour and automatic normals. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vf3n | ns2vf3n]]</td><td>3-vertex facet with single colour and normals given. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vf3c | ns2vf3c]]</td><td>3-vertex facet with coloured vertices and autmoatic normals. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vf3nc | ns2vf3nc]]</td><td>3-vertex facet with coloured vertices and normals given. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vf4 | ns2vf4]]</td><td>4-vertex facet with single colour and automatic normals. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vf4n | ns2vf4n]]</td><td>4-vertex facet with single colour and normals given. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vf4c | ns2vf4c]]</td><td>4-vertex facet with coloured vertices and automatic normals. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vf4nc | ns2vf4nc]]</td><td>4-vertex facet with coloured vertices and normals given. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vf4t | ns2vf4t]]</td><td>Textured 4-vertex facet, scale in [0,1]; trans = 'o' or 't'. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vf4x | ns2vf4x]]</td><td>Draw a textured 4-vertex facet using a texture id. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vf4xt | ns2vf4xt]]</td><td>Draw a textured 4-vertex facet with alpha channel using a texture id. </td><td> </td></tr>
 +<tr><td>[[Function:ns2m | ns2m]]</td><td>Draw a marker </td><td> </td></tr>
 +<tr><td>[[Function:ns2vm | ns2vm]]</td><td>Draw a marker - vector input </td><td> </td></tr>
</table> </table>
-==Callback and Handle System==+==Callback and Handle System ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>[[Function:cs2scb | cs2scb]]</td><td>Set the callback function; can be null to cancel callback. </td><td> </td></tr>
 +<tr><td>[[Function:cs2ecb | cs2ecb]]</td><td>Animation state - Enable callback. </td><td> </td></tr>
 +<tr><td>[[Function:cs2dcb | cs2dcb]]</td><td>Animation state - Disable callback. </td><td> </td></tr>
 +<tr><td>[[Function:cs2tcb | cs2tcb]]</td><td>Animation state - Toggle callback. </td><td> </td></tr>
 +<tr><td>[[Function:cs2sncb | cs2sncb]]</td><td>Set the function to call when number-keys pressed. </td><td> </td></tr>
 +<tr><td>[[Function:cs2socb | cs2socb]]</td><td>Register function that will draw direct OpenGL graphics when called. </td><td> </td></tr>
 +<tr><td>[[Function:cs2ah | cs2ah]]</td><td>Add a handle to allow interactive picking of objects </td><td> </td></tr>
 +<tr><td>[[Function:cs2shcb | cs2shcb]]</td><td>Set the handle callback function for when a handle is (de)selected </td><td> </td></tr>
 +<tr><td>[[Function:cs2th | cs2th]]</td><td>Toggle the state of a named (dynamic) handle </td><td> </td></tr>
 +<tr><td>[[Function:cs2qhv | cs2qhv]]</td><td>Query whether selection handles are currently visible </td><td> </td></tr>
</table> </table>
-==Advanced Texture and Colormap Handling==+==Advanced Texture and Colormap Handling ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>[[Function:ss2lt | ss2lt]]</td><td>Load a texture for future (generally repeated) use. </td><td> </td></tr>
 +<tr><td>[[Function:ss2gt | ss2gt]]</td><td>Get a pointer to an identified texture. </td><td> </td></tr>
 +<tr><td>[[Function:ss2pt | ss2pt]]</td><td>Reinstall a texture. </td><td> </td></tr>
 +<tr><td>[[Function:ss2lcm | ss2lcm]]</td><td>Load a colourmap into memory. </td><td> </td></tr>
 +<tr><td>[[Function:ns2spherex | ns2spherex]]</td><td>Draw a textured sphere, with given centre, radius, colour and texture ID. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vspherex | ns2vspherex]]</td><td>Draw a textured sphere, with given centre, radius, colour and texture ID - vector input. </td><td> </td></tr>
</table> </table>
-==Environment and Rendering Attributes==+==Environment and Rendering Attributes ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>[[Function:ss2ssr | ss2ssr]]</td><td>Set sphere resolution. </td><td> </td></tr>
 +<tr><td>[[Function:ss2srm | ss2srm]]</td><td>Set the rendering mode. </td><td> </td></tr>
 +<tr><td>[[Function:ss2qrm | ss2qrm]]</td><td>Get the rendering mode. </td><td> </td></tr>
 +<tr><td>[[Function:ss2sl | ss2sl]]</td><td>Set the entire lighting environment </td><td> </td></tr>
 +<tr><td>[[Function:ss2sbc | ss2sbc]]</td><td>Set the background colour. </td><td> </td></tr>
 +<tr><td>[[Function:ss2sfra | ss2sfra]]</td><td>Set the fisheye rotation angle (degrees). </td><td> </td></tr>
 +<tr><td>[[Function:ss2qpt | ss2qpt]]</td><td>Fetch the projection type of the device in use. </td><td> </td></tr>
</table> </table>
-==Advanced Camera Control==+==Advanced Camera Control ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>[[Function:ss2sc | ss2sc]]</td><td>Set the camera position, up vector and view direction. </td><td> </td></tr>
 +<tr><td>[[Function:ss2qc | ss2qc]]</td><td>Query the camera position, up vector and view direction. </td><td> </td></tr>
 +<tr><td>[[Function:ss2sas | ss2sas]]</td><td>Start/Stop the camera rotation. </td><td> </td></tr>
 +<tr><td>[[Function:ss2scf | ss2scf]]</td><td>Set the camera mid/focus point. </td><td> </td></tr>
 +<tr><td>[[Function:ss2ucf | ss2ucf]]</td><td>Unset the camera mid/focus point - revert to auto mid-point. </td><td> </td></tr>
 +<tr><td>[[Function:ss2tc | ss2tc]]</td><td>Enable/disable (1,0) camera translation. </td><td> </td></tr>
 +<tr><td>[[Function:ss2sss | ss2sss]]</td><td>Set the spin / interaction speed </td><td> </td></tr>
 +<tr><td>[[Function:ss2qss | ss2qss]]</td><td>Get the spin / interaction speed </td><td> </td></tr>
</table> </table>
-==Additional Primitives==+==Additional Primitives ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>[[Function:s2chromapts | s2chromapts]]</td><td>Plot points on a sphere using chromastereoscopic colouring for depth </td><td> </td></tr>
 +<tr><td>[[Function:s2chromacpts | s2chromacpts]]</td><td>Plot cartesian points using chromastereoscopic colouring for depth </td><td> </td></tr>
</table> </table>
-==Functions in Testing/Development==+==Functions in Testing/Development ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>[[Function:s2latexture | s2latexture]]</td><td>Create a texture with LATEX commands. </td><td> </td></tr>
 +<tr><td>[[Function:ns2vf3a | ns2vf3a]]</td><td>3-vertex facet with transparency </td><td> </td></tr>
 +<tr><td>[[Function:ns2cis | ns2cis]]</td><td>Create an isosurface object </td><td> </td></tr>
 +<tr><td>[[Function:ns2cisc | ns2cisc]]</td><td>Create an isosurface object with a colour function </td><td> </td></tr>
 +<tr><td>[[Function:ns2dis | ns2dis]]</td><td>Draw an isosurface object </td><td> </td></tr>
 +<tr><td>[[Function:ns2sisl | ns2sisl]]</td><td>Change the level of isosurface </td><td> </td></tr>
 +<tr><td>[[Function:ns2cvr | ns2cvr]]</td><td>Create a volume rendering object </td><td> </td></tr>
 +<tr><td>[[Function:cs2thv | cs2thv]]</td><td>Toggle the current state of selection handles </td><td> </td></tr>
 +<tr><td>[[Function:ss2ct | ss2ct]]</td><td>Create a texture with specified width and height </td><td> </td></tr>
 +<tr><td>[[Function:ss2dt | ss2dt]]</td><td>Delete a texture </td><td> </td></tr>
 +<tr><td>[[Function:ss2txh | ss2txh]]</td><td>Enable/disable/toggle the visibility of the cursor cross-hair </td><td> </td></tr>
 +<tr><td>[[Function:ss2qxh | ss2qxh]]</td><td>Query the visibility of the cursor cross-hair </td><td> </td></tr>
</table> </table>
-==Dynamic-Only Geometry Functions==+==Dynamic-Only Geometry Functions ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>[[Function:ds2bb | ds2bb]]</td><td>Draw a (dynamic) billboard: a textured facet that always faces the camera </td><td> </td></tr>
 +<tr><td>[[Function:ds2vbb | ds2vbb]]</td><td>Draw a (dynamic) billboard: a textured facet that always faces the camera - vector input </td><td> </td></tr>
 +<tr><td>[[Function:ds2tb | ds2tb]]</td><td>Draw text that always faces the camera </td><td> </td></tr>
 +<tr><td>[[Function:ds2vtb | ds2vtb]]</td><td>Draw text that always faces the camera - vector input </td><td> </td></tr>
 +<tr><td>[[Function:ds2dvr | ds2dvr]]</td><td>Draw a volume render object from a dynamic callback </td><td> </td></tr>
</table> </table>
-==Deprecated Function Names (V1.48-V1.62)==+==Deprecated Function Names (V1.48-V1.62) ==
<table border=1 width=100%> <table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td> </td><td> </td></tr>+<tr><td>ns2Vsphere<a></td><td>[[Function replaced by: <Function:fname | ns2vsphere]]<td><td> </td></tr>
 +<tr><td>ns2Vspheret<a></td><td>[[Function replaced by: <Function:fname | ns2vspheret]]<td><td> </td></tr>
 +<tr><td>s2spheretID<a></td><td>[[Function replaced by: <Function:fname | ns2spherex]]<td><td> </td></tr>
 +<tr><td>s2VspheretID<a></td><td>[[Function replaced by: <Function:fname | ns2vspherex]]<td><td> </td></tr>
 +<tr><td>ns2Vdisk<a></td><td>[[Function replaced by: <Function:fname | ns2vdisk]]<td><td> </td></tr>
 +<tr><td>s2disk<a></td><td>[[Function replaced by: <Function:fname | ns2arc]]<td><td> </td></tr>
 +<tr><td>s2Vdisk<a></td><td>[[Function replaced by: <Function:fname | ns2varc]]<td><td> </td></tr>
 +<tr><td>ns2Vtext<a></td><td>[[Function replaced by: <Function:fname | ns2vtext]]<td><td> </td></tr>
 +<tr><td>ns2Vpoint<a></td><td>[[Function replaced by: <Function:fname | ns2vpoint]]<td><td> </td></tr>
 +<tr><td>ns2Vthpoint<a></td><td>[[Function replaced by: <Function:fname | ns2vthpoint]]<td><td> </td></tr>
 +<tr><td>ns2Vi<a></td><td>[[Function replaced by: <Function:fname | ns2vi]]<td><td> </td></tr>
 +<tr><td>ns2Vline<a></td><td>[[Function replaced by: <Function:fname | ns2vline]]<td><td> </td></tr>
 +<tr><td>ns2Vthline<a></td><td>[[Function replaced by: <Function:fname | ns2vthline]]<td><td> </td></tr>
 +<tr><td>ns2Vcline<a></td><td>[[Function replaced by: <Function:fname | ns2vcline]]<td><td> </td></tr>
 +<tr><td>ns2Vf3<a></td><td>[[Function replaced by: <Function:fname | ns2vf3]]<td><td> </td></tr>
 +<tr><td>ns2Vf3n<a></td><td>[[Function replaced by: <Function:fname | ns2vf3n]]<td><td> </td></tr>
 +<tr><td>ns2Vf3c<a></td><td>[[Function replaced by: <Function:fname | ns2vf3c]]<td><td> </td></tr>
 +<tr><td>ns2Vf3nc<a></td><td>[[Function replaced by: <Function:fname | ns2vf3nc]]<td><td> </td></tr>
 +<tr><td>ns2Vf4<a></td><td>[[Function replaced by: <Function:fname | ns2vf4]]<td><td> </td></tr>
 +<tr><td>ns2Vf4n<a></td><td>[[Function replaced by: <Function:fname | ns2vf4n]]<td><td> </td></tr>
 +<tr><td>ns2Vf4c<a></td><td>[[Function replaced by: <Function:fname | ns2vf4c]]<td><td> </td></tr>
 +<tr><td>ns2Vf4nc<a></td><td>[[Function replaced by: <Function:fname | ns2vf4nc]]<td><td> </td></tr>
 +<tr><td>ns2Vf4t<a></td><td>[[Function replaced by: <Function:fname | ns2vf4t]]<td><td> </td></tr>
 +<tr><td>s2Vf4tID<a></td><td>[[Function replaced by: <Function:fname | ns2vf4x]]<td><td> </td></tr>
 +<tr><td>s2Vf4tIDt<a></td><td>[[Function replaced by: <Function:fname | ns2vf4xt]]<td><td> </td></tr>
 +<tr><td>ns2Vm<a></td><td>[[Function replaced by: <Function:fname | ns2vm]]<td><td> </td></tr>
 +<tr><td>s2scb<a></td><td>[[Function replaced by: <Function:fname | cs2scb]]<td><td> </td></tr>
 +<tr><td>s2ecb<a></td><td>[[Function replaced by: <Function:fname | cs2ecb]]<td><td> </td></tr>
 +<tr><td>s2dcb<a></td><td>[[Function replaced by: <Function:fname | cs2dcb]]<td><td> </td></tr>
 +<tr><td>s2tcb<a></td><td>[[Function replaced by: <Function:fname | cs2tcb]]<td><td> </td></tr>
 +<tr><td>s2snumcb<a></td><td>[[Function replaced by: <Function:fname | cs2sncb]]<td><td> </td></tr>
 +<tr><td>s2soglcb<a></td><td>[[Function replaced by: <Function:fname | cs2socb]]<td><td> </td></tr>
 +<tr><td>s2handle<a></td><td>[[Function replaced by: <Function:fname | cs2ah]]<td><td> </td></tr>
 +<tr><td>s2shcb<a></td><td>[[Function replaced by: <Function:fname | cs2shcb]]<td><td> </td></tr>
 +<tr><td>s2togglehandle<a></td><td>[[Function replaced by: <Function:fname | cs2th]]<td><td> </td></tr>
 +<tr><td>s2handlesvisible<a></td><td>[[Function replaced by: <Function:fname | cs2qhv ]]<td><td> </td></tr>
 +<tr><td>s2loadtexture<a></td><td>[[Function replaced by: <Function:fname | ss2lt]]<td><td> </td></tr>
 +<tr><td>s2gettexture<a></td><td>[[Function replaced by: <Function:fname | ss2gt]]<td><td> </td></tr>
 +<tr><td>s2pushtexture<a></td><td>[[Function replaced by: <Function:fname | ss2pt]]<td><td> </td></tr>
 +<tr><td>s2loadmap<a></td><td>[[Function replaced by: <Function:fname | ss2lcm]]<td><td> </td></tr>
 +<tr><td>ns2ssphres<a></td><td>[[Function replaced by: <Function:fname | ss2ssr]]<td><td> </td></tr>
 +<tr><td>ns2srenmode<a></td><td>[[Function replaced by: <Function:fname | ss2srm]]<td><td> </td></tr>
 +<tr><td>ns2grenmode<a></td><td>[[Function replaced by: <Function:fname | ss2qrm]]<td><td> </td></tr>
 +<tr><td>s2setlighting<a></td><td>[[Function replaced by: <Function:fname | ss2sl]]<td><td> </td></tr>
 +<tr><td>s2sbc<a></td><td>[[Function replaced by: <Function:fname | ss2sbc]]<td><td> </td></tr>
 +<tr><td>ns2fishr<a></td><td>[[Function replaced by: <Function:fname | ss2sfra]]<td><td> </td></tr>
 +<tr><td>ns2ptype<a></td><td>[[Function replaced by: <Function:fname | ss2qpt]]<td><td> </td></tr>
 +<tr><td>ns2setcam<a></td><td>[[Function replaced by: <Function:fname | ss2sc]]<td><td> </td></tr>
 +<tr><td>ns2getcam<a></td><td>[[Function replaced by: <Function:fname | ss2qc]]<td><td> </td></tr>
 +<tr><td>ns2rotcam<a></td><td>[[Function replaced by: <Function:fname | ss2sas]]<td><td> </td></tr>
 +<tr><td>ns2setfocus<a></td><td>[[Function replaced by: <Function:fname | ss2scf]]<td><td> </td></tr>
 +<tr><td>ns2unsetfocus<a></td><td>[[Function replaced by: <Function:fname | ss2ucf]]<td><td> </td></tr>
 +<tr><td>ns2sspinspd<a></td><td>[[Function replaced by: <Function:fname | ss2sss]]<td><td> </td></tr>
 +<tr><td>ns2gspinspd<a></td><td>[[Function replaced by: <Function:fname | ss2qss]]<td><td> </td></tr>
 +<tr><td>s2transcam<a></td><td>[[Function replaced by: <Function:fname | ss2tc]]<td><td> </td></tr>
</table> </table>

Revision as of 04:12, 26 October 2007


Contents

General

S2PLOTDescriptionPGPLOT
ColoursUseful colour definitions based on PGPlot default settings.
TexturesImportant information on using textures in S2PLOT.
struct XYZData structure for (x,y,z) coordinates.
struct COLOURData structure for (r,g,b) colour indices.

Opening, Closing and Selecting Devices

S2PLOTDescriptionPGPLOT
s2openOpen the S2PLOT device. PGOPEN
s2opendOpen the S2PLOT device (device string version). PGOPEN
s2opendoOpen the S2PLOT device (device string version, ignoring command line arguments). PGOPEN
s2ldevList the available S2PLOT devices on stdout. PGLDEV
s2showDraw the scene and enter interactive mode if interactive is non-zero.
s2dispDraw the scene, but return control when a timeout occurs or when 'TAB' key is pressed.
s2erasErase the geometry. PGERAS

Windows and Viewports

S2PLOTDescriptionPGPLOT
s2svpSet up the part of 3D space that is used for plotting. PGSVP
s2qvpQuery the device viewport range. PGQVP
s2swinSet up the world coordinate range for the device. PGSWIN
s2qwinQuery the world coordinate range. PGQWIN
s2envConvenience function which sets the plotting environment. PGENV

Primitives

S2PLOTDescriptionPGPLOT
s2lineDraw a poly line, n vertices at (xpts, ypts, zpts). PGLINE
s2circxyDraw a circle in the xy plane at a given z coordinate. PGCIRC
s2circxzDraw a circle in the xz plane at a given y coordinate. PGCIRC
s2circyzDraw a circle in the yz plane at a given x coordinate. PGCIRC
s2diskxyDraw a disk in the xy plane at a given z coordinate.
s2diskxzDraw a disk in the xz plane at a given y coordinate.
s2diskyzDraw a disk in the yz plane at a given x coordinate.
s2rectxyDraw a rectangle in the xy plane at a given z coordinate. PGRECT
s2rectxzDraw a rectangle in the xz plane at a given y coordinate. PGRECT
s2rectyzDraw a rectangle in the yz plane at a given x coordinate. PGRECT
s2pt1Draw a single point with a given symbol. PGPT1
s2ptDraw a set of points with a given symbol. PGPT
s2pntsDraw a set of points with different markers. PGPNTS
s2textxyDraw text in the xy plane at a fixed z coordinate. PGTEXT
s2textxzDraw text in the xz plane at a fixed y coordinate. PGTEXT
s2textyzDraw text in the yz plane at a fixed x coordinate. PGTEXT
s2textxyfDraw flipped text in the xy plane at a fixed z coordinate. PGTEXT
s2textxzfDraw flipped text in the xz plane at a fixed y coordinate. PGTEXT
s2textyzfDraw flipped text in the yz plane at a fixed x coordinate. PGTEXT
s2qtxtxyFind the bounding box of text drawn with s2textxy. PGQTXT
s2qtxtxzFind the bounding box of text drawn with s2textxz. PGQTXT
s2qtxtyzFind the bounding box of text drawn with s2textyz. PGQTXT
s2qtxtxyfFind the bounding box of text drawn with s2textxyf. PGQTXT
s2qtxtxzfFind the bounding box of text drawn with s2textxzf. PGQTXT
s2qtxtyzfFind the bounding box of text drawn with s2textyzf. PGQTXT
s2arroDraw an arrow from the point with world-coordinates (x1,y1,z1) to (x2,y2,z2). PGARRO

Attributes

S2PLOTDescriptionPGPLOT
s2sciSet the pen colour by index. PGSCI
s2scrSet colour representation, ie. define a colour associated with an index. PGSCR
s2qcrQuery colour representation. PGQCR
s2slwSet the linewidth in pixels. PGSLW
s2schSet the character height in "arbitrary" units. PGSCH
s2sahSet the style to be used for arrowheads drawn with s2arro. PGSAH

Axes, Boxes & Labels

S2PLOTDescriptionPGPLOT
s2boxDraw a labelled box around the world space. PGBOX
s2labDraw labels along the edges of bounding box. PGLAB

XY(Z) Plots

S2PLOTDescriptionPGPLOT
s2errbDraw error bars at the coordinates (xpts[i], ypts[i], zpts[i]). PGERRB
s2funtDraw a curve defined by parametric equations fx(t), fy(t) and fz(t). PGFUNT
s2funtcDraw a curve defined by parametric equations fx(t), fy(t) and fz(t) with colour control. PGFUNT
s2funxyDraw the surface described by the provided function fxy. PGFUNX
s2funxzDraw the surface described by the provided function fxz. PGFUNY
s2funyzDraw the surface described by the provided function fyz. PGFUNX
s2funxyrDraw surface as per s2funxy, but with explicit settings for the colour range mapping.
s2funxzrDraw surface as per s2funxz, but with explicit settings for the colour range mapping.
s2funyzrDraw surface as per s2funyz, but with explicit settings for the colour range mapping.
s2funuvPlot a parametric function (generally a surface) defined by functions fx(u,v), fy(u,v) and fz(u,v).

Images/Surfaces

S2PLOTDescriptionPGPLOT
s2surpDraw a colour surface representation of the 2-dimensional array, data, containing nx * ny values. PGIMAG
s2surpaDraw a colour surface representation of the 2-dimensional array, data, containing nx * ny values. PGIMAG
s2scirSet the range of colour indices used for shading. PGSCIR
s2qcirQuery the colour index range. PGQCIR
s2icmInstall various colour maps. PGSITF
s2wedgeDraw a colour wedge. PGWEDG

Vector Plots

S2PLOTDescriptionPGPLOT
s2vect3Draw a vector map of a 3D data array, with blanking. PGVECT

Miscellaneous Routines

S2PLOTDescriptionPGPLOT
s2idenWrite username, date, time and optional string at bottom of plot. PGIDEN

S2 "Native" Routines

S2PLOTDescriptionPGPLOT
ns2sphereDraw a sphere, with a given centre, radius and colour.
ns2vsphereDraw a sphere, with a given centre, radius and colour - vecotr input.
ns2spheretDraw a textured sphere, with given centre, radius, colour and texture filename.
ns2vspheretDraw a textured sphere, with given centre, radius, colour and texture filename - vector input.
ns2diskDraw an annulus with given centre, inner and out radii, and colour.
ns2vdiskDraw an annulus with given centre, inner and out radii, and colour - vector input.
ns2arcDraw an arc at (px,py,pz) with normal (nx,ny,nz) in current pen (thickness,colour).
ns2varcDraw an arc at (px,py,pz) with normal (nx,ny,nz) in current pen (thickness,colour) - vector input.
ns2textDraw text at a given position, with right and up vectors, a specific colour, and a text string of course.
ns2vtextDraw text at a given position, with right and up vectors, a specific colour, and a text string of course - vector input.
ns2pointDraw a point at the given position and colour.
ns2vpointDraw a point at the given position and colour - vector input.
ns2vnpointDraw multiple points at the given positions with one colour - vector input.
ns2thpointDraw a thick point at given position, in colour and thickness in pixels (not world coords).
ns2vthpointDraw a thick point at given position, in colour and thickness in pixels (not world coords) - vector input.
ns2iIllumination.
ns2viIllumination - vector input.
ns2lineDraw a line from one point to another in a specific colour.
ns2vlineDraw a line from one point to another in a specific colour - vector input.
ns2thlineDraw a thick line from one point to another in a specific colour.
ns2vthlineDraw a thick line from one point to another in a specific colour - vector input.
ns2clineDraw a coloured line, with colour blended between the two given colours along the line.
ns2vclineDraw a coloured line, with colour blended between the two given colours along the line - vector input.
ns2vf33-vertex facet with single colour and automatic normals.
ns2vf3n3-vertex facet with single colour and normals given.
ns2vf3c3-vertex facet with coloured vertices and autmoatic normals.
ns2vf3nc3-vertex facet with coloured vertices and normals given.
ns2vf44-vertex facet with single colour and automatic normals.
ns2vf4n4-vertex facet with single colour and normals given.
ns2vf4c4-vertex facet with coloured vertices and automatic normals.
ns2vf4nc4-vertex facet with coloured vertices and normals given.
ns2vf4tTextured 4-vertex facet, scale in [0,1]; trans = 'o' or 't'.
ns2vf4xDraw a textured 4-vertex facet using a texture id.
ns2vf4xtDraw a textured 4-vertex facet with alpha channel using a texture id.
ns2mDraw a marker
ns2vmDraw a marker - vector input

Callback and Handle System

S2PLOTDescriptionPGPLOT
cs2scbSet the callback function; can be null to cancel callback.
cs2ecbAnimation state - Enable callback.
cs2dcbAnimation state - Disable callback.
cs2tcbAnimation state - Toggle callback.
cs2sncbSet the function to call when number-keys pressed.
cs2socbRegister function that will draw direct OpenGL graphics when called.
cs2ahAdd a handle to allow interactive picking of objects
cs2shcbSet the handle callback function for when a handle is (de)selected
cs2thToggle the state of a named (dynamic) handle
cs2qhvQuery whether selection handles are currently visible

Advanced Texture and Colormap Handling

S2PLOTDescriptionPGPLOT
ss2ltLoad a texture for future (generally repeated) use.
ss2gtGet a pointer to an identified texture.
ss2ptReinstall a texture.
ss2lcmLoad a colourmap into memory.
ns2spherexDraw a textured sphere, with given centre, radius, colour and texture ID.
ns2vspherexDraw a textured sphere, with given centre, radius, colour and texture ID - vector input.

Environment and Rendering Attributes

S2PLOTDescriptionPGPLOT
ss2ssrSet sphere resolution.
ss2srmSet the rendering mode.
ss2qrmGet the rendering mode.
ss2slSet the entire lighting environment
ss2sbcSet the background colour.
ss2sfraSet the fisheye rotation angle (degrees).
ss2qptFetch the projection type of the device in use.

Advanced Camera Control

S2PLOTDescriptionPGPLOT
ss2scSet the camera position, up vector and view direction.
ss2qcQuery the camera position, up vector and view direction.
ss2sasStart/Stop the camera rotation.
ss2scfSet the camera mid/focus point.
ss2ucfUnset the camera mid/focus point - revert to auto mid-point.
ss2tcEnable/disable (1,0) camera translation.
ss2sssSet the spin / interaction speed
ss2qssGet the spin / interaction speed

Additional Primitives

S2PLOTDescriptionPGPLOT
s2chromaptsPlot points on a sphere using chromastereoscopic colouring for depth
s2chromacptsPlot cartesian points using chromastereoscopic colouring for depth

Functions in Testing/Development

S2PLOTDescriptionPGPLOT
s2latextureCreate a texture with LATEX commands.
ns2vf3a3-vertex facet with transparency
ns2cisCreate an isosurface object
ns2ciscCreate an isosurface object with a colour function
ns2disDraw an isosurface object
ns2sislChange the level of isosurface
ns2cvrCreate a volume rendering object
cs2thvToggle the current state of selection handles
ss2ctCreate a texture with specified width and height
ss2dtDelete a texture
ss2txhEnable/disable/toggle the visibility of the cursor cross-hair
ss2qxhQuery the visibility of the cursor cross-hair

Dynamic-Only Geometry Functions

S2PLOTDescriptionPGPLOT
ds2bbDraw a (dynamic) billboard: a textured facet that always faces the camera
ds2vbbDraw a (dynamic) billboard: a textured facet that always faces the camera - vector input
ds2tbDraw text that always faces the camera
ds2vtbDraw text that always faces the camera - vector input
ds2dvrDraw a volume render object from a dynamic callback

Deprecated Function Names (V1.48-V1.62)

</tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </table>
S2PLOTDescriptionPGPLOT
ns2Vsphere<a>[[Function replaced by: <Function:fname | ns2vsphere]]
ns2Vspheret<a>[[Function replaced by: <Function:fname | ns2vspheret]]
s2spheretID<a>[[Function replaced by: <Function:fname | ns2spherex]]
s2VspheretID<a>[[Function replaced by: <Function:fname | ns2vspherex]]
ns2Vdisk<a>[[Function replaced by: <Function:fname | ns2vdisk]]
s2disk<a>[[Function replaced by: <Function:fname | ns2arc]]
s2Vdisk<a>[[Function replaced by: <Function:fname | ns2varc]]
ns2Vtext<a>[[Function replaced by: <Function:fname | ns2vtext]]
ns2Vpoint<a>[[Function replaced by: <Function:fname | ns2vpoint]]
ns2Vthpoint<a>[[Function replaced by: <Function:fname | ns2vthpoint]]
ns2Vi<a>[[Function replaced by: <Function:fname | ns2vi]]
ns2Vline<a>[[Function replaced by: <Function:fname | ns2vline]]
ns2Vthline<a>[[Function replaced by: <Function:fname | ns2vthline]]
ns2Vcline<a>[[Function replaced by: <Function:fname | ns2vcline]]
ns2Vf3<a>[[Function replaced by: <Function:fname | ns2vf3]]
ns2Vf3n<a>[[Function replaced by: <Function:fname | ns2vf3n]]
ns2Vf3c<a>[[Function replaced by: <Function:fname | ns2vf3c]]
ns2Vf3nc<a>[[Function replaced by: <Function:fname | ns2vf3nc]]
ns2Vf4<a>[[Function replaced by: <Function:fname | ns2vf4]]
ns2Vf4n<a>[[Function replaced by: <Function:fname | ns2vf4n]]
ns2Vf4c<a>[[Function replaced by: <Function:fname | ns2vf4c]]
ns2Vf4nc<a>[[Function replaced by: <Function:fname | ns2vf4nc]]
ns2Vf4t<a>[[Function replaced by: <Function:fname | ns2vf4t]]
s2Vf4tID<a>[[Function replaced by: <Function:fname | ns2vf4x]]
s2Vf4tIDt<a>[[Function replaced by: <Function:fname | ns2vf4xt]]
ns2Vm<a>[[Function replaced by: <Function:fname | ns2vm]]
s2scb<a>[[Function replaced by: <Function:fname | cs2scb]]
s2ecb<a>[[Function replaced by: <Function:fname | cs2ecb]]
s2dcb<a>[[Function replaced by: <Function:fname | cs2dcb]]
s2tcb<a>[[Function replaced by: <Function:fname | cs2tcb]]
s2snumcb<a>[[Function replaced by: <Function:fname | cs2sncb]]
s2soglcb<a>[[Function replaced by: <Function:fname | cs2socb]]
s2handle<a>[[Function replaced by: <Function:fname | cs2ah]]
s2shcb<a>[[Function replaced by: <Function:fname | cs2shcb]]
s2togglehandle<a>[[Function replaced by: <Function:fname | cs2th]]
s2handlesvisible<a>[[Function replaced by: <Function:fname | cs2qhv ]]
s2loadtexture<a>[[Function replaced by: <Function:fname | ss2lt]]
s2gettexture<a>[[Function replaced by: <Function:fname | ss2gt]]
s2pushtexture<a>[[Function replaced by: <Function:fname | ss2pt]]
s2loadmap<a>[[Function replaced by: <Function:fname | ss2lcm]]
ns2ssphres<a>[[Function replaced by: <Function:fname | ss2ssr]]
ns2srenmode<a>[[Function replaced by: <Function:fname | ss2srm]]
ns2grenmode<a>[[Function replaced by: <Function:fname | ss2qrm]]
s2setlighting<a>[[Function replaced by: <Function:fname | ss2sl]]
s2sbc<a>[[Function replaced by: <Function:fname | ss2sbc]]
ns2fishr<a>[[Function replaced by: <Function:fname | ss2sfra]]
ns2ptype<a>[[Function replaced by: <Function:fname | ss2qpt]]
ns2setcam<a>[[Function replaced by: <Function:fname | ss2sc]]
ns2getcam<a>[[Function replaced by: <Function:fname | ss2qc]]
ns2rotcam<a>[[Function replaced by: <Function:fname | ss2sas]]
ns2setfocus<a>[[Function replaced by: <Function:fname | ss2scf]]
ns2unsetfocus<a>[[Function replaced by: <Function:fname | ss2ucf]]
ns2sspinspd<a>[[Function replaced by: <Function:fname | ss2sss]]
ns2gspinspd<a>[[Function replaced by: <Function:fname | ss2qss]]
s2transcam<a>[[Function replaced by: <Function:fname | ss2tc]]