S2PLOT:Function List

From S2PLOT

(Difference between revisions)

Current revision

General

S2PLOT	Description	PGPLOT
Colours	Useful colour definitions based on PGPlot default settings.
Textures	Important information on using textures in S2PLOT.
struct XYZ	Data structure for (x,y,z) coordinates.
struct COLOUR	Data structure for (r,g,b) colour indices.

Opening, Closing and Selecting Devices

S2PLOT	Description	PGPLOT
s2open	Open the S2PLOT device.	PGOPEN
s2opend	Open the S2PLOT device (device string version).	PGOPEN
s2opendo	Open the S2PLOT device (device string version, ignoring command line arguments).	PGOPEN
s2ldev	List the available S2PLOT devices on stdout.	PGLDEV
s2show	Draw the scene and enter interactive mode if interactive is non-zero.
s2disp	Draw the scene, but return control when a timeout occurs or when shift-ENTER is pressed.
s2eras	Erase the geometry.	PGERAS

Windows and Viewports

S2PLOT	Description	PGPLOT
s2svp	Set up the part of 3D space that is used for plotting.	PGSVP
s2qvp	Query the device viewport range.	PGQVP
s2swin	Set up the world coordinate range for the device.	PGSWIN
s2qwin	Query the world coordinate range.	PGQWIN
s2env	Convenience function which sets the plotting environment.	PGENV

Primitives

S2PLOT	Description	PGPLOT
s2line	Draw a poly line, n vertices at (xpts, ypts, zpts).	PGLINE
s2circxy	Draw a circle in the xy plane at a given z coordinate.	PGCIRC
s2circxz	Draw a circle in the xz plane at a given y coordinate.	PGCIRC
s2circyz	Draw a circle in the yz plane at a given x coordinate.	PGCIRC
s2diskxy	Draw a disk in the xy plane at a given z coordinate.
s2diskxz	Draw a disk in the xz plane at a given y coordinate.
s2diskyz	Draw a disk in the yz plane at a given x coordinate.
s2rectxy	Draw a rectangle in the xy plane at a given z coordinate.	PGRECT
s2rectxz	Draw a rectangle in the xz plane at a given y coordinate.	PGRECT
s2rectyz	Draw a rectangle in the yz plane at a given x coordinate.	PGRECT
s2wcube	Draw a wireframe cube.
s2pt1	Draw a single point with a given symbol.	PGPT1
s2pt	Draw a set of points with a given symbol.	PGPT
s2pnts	Draw a set of points with different markers.	PGPNTS
s2textxy	Draw text in the xy plane at a fixed z coordinate.	PGTEXT
s2textxz	Draw text in the xz plane at a fixed y coordinate.	PGTEXT
s2textyz	Draw text in the yz plane at a fixed x coordinate.	PGTEXT
s2textxyf	Draw flipped text in the xy plane at a fixed z coordinate.	PGTEXT
s2textxzf	Draw flipped text in the xz plane at a fixed y coordinate.	PGTEXT
s2textyzf	Draw flipped text in the yz plane at a fixed x coordinate.	PGTEXT
s2qtxtxy	Find the bounding box of text drawn with s2textxy.	PGQTXT
s2qtxtxz	Find the bounding box of text drawn with s2textxz.	PGQTXT
s2qtxtyz	Find the bounding box of text drawn with s2textyz.	PGQTXT
s2qtxtxyf	Find the bounding box of text drawn with s2textxyf.	PGQTXT
s2qtxtxzf	Find the bounding box of text drawn with s2textxzf.	PGQTXT
s2qtxtyzf	Find the bounding box of text drawn with s2textyzf.	PGQTXT
s2arro	Draw an arrow from the point with world-coordinates (x1,y1,z1) to (x2,y2,z2).	PGARRO

Drawing Attributes

S2PLOT	Description	PGPLOT
s2sci	Set the pen colour by index.	PGSCI
s2qci	Query the colour index
s2scr	Set colour representation, ie. define a colour associated with an index.	PGSCR
s2qcr	Query colour representation.	PGQCR
s2slw	Set the linewidth in pixels.	PGSLW
s2qlw	Query the line width
s2sls	Set the line style.
s2qls	Query the line style.
s2sch	Set the character height in "arbitrary" units.	PGSCH
s2qch	Query the character height
s2sah	Set the style to be used for arrowheads drawn with s2arro.	PGSAH
s2qah	Query the arrow-head style
s2twc	Set the window clipping mode
s2qwc	Query the window clipping mode
ss2txh	Enable/disable/toggle the visibility of the cursor cross-hair
ss2qxh	Query the visibility of the cursor cross-hair
ss2tsc	Enable/disable 2-d screen coordinates

Axes, Boxes & Labels

S2PLOT	Description	PGPLOT
s2box	Draw a labelled box around the world space.	PGBOX
s2lab	Draw labels along the edges of bounding box.	PGLAB
s2help	Set the custom help string.

XY(Z) Plots

S2PLOT	Description	PGPLOT
s2errb	Draw error bars at the coordinates (xpts[i], ypts[i], zpts[i]).	PGERRB
s2funt	Draw a curve defined by parametric equations fx(t), fy(t) and fz(t).	PGFUNT
s2funtc	Draw a curve defined by parametric equations fx(t), fy(t) and fz(t) with colour control.	PGFUNT
s2funxy	Draw the surface described by the provided function fxy.	PGFUNX
s2funxz	Draw the surface described by the provided function fxz.	PGFUNY
s2funyz	Draw the surface described by the provided function fyz.	PGFUNX
s2funxyr	Draw surface as per s2funxy, but with explicit settings for the colour range mapping.
s2funxzr	Draw surface as per s2funxz, but with explicit settings for the colour range mapping.
s2funyzr	Draw surface as per s2funyz, but with explicit settings for the colour range mapping.
s2funuv	Plot a parametric function (generally a surface) defined by functions fx(u,v), fy(u,v) and fz(u,v).
s2funuva	Plot a parametric function (generally a surface) defined by functions fx(u,v), fy(u,v) and fz(u,v) with transparency.

Images/Surfaces

S2PLOT	Description	PGPLOT
s2surp	Draw a colour surface representation of the 2-dimensional array, data, containing nx * ny values.	PGIMAG
s2surpa	Draw a colour surface representation of the 2-dimensional array, data, containing nx * ny values.	PGIMAG
s2scir	Set the range of colour indices used for shading.	PGSCIR
s2qcir	Query the colour index range.	PGQCIR
s2icm	Install various colour maps.	PGSITF

Isosurfaces

S2PLOT	Description	PGPLOT
ns2cis	Create an isosurface object
ns2cisc	Create an isosurface object with a colour function
ns2dis	Draw an isosurface object
ns2sisl	Change the level of isosurface
ns2sisa	Set the alpha channel for an isosurface
ns2sisc	Set the colour for an isosurface
ns2ssq	Set general surface quality.
ns2qsq	Query general surface quality.

Volume Rendering

S2PLOT	Description	PGPLOT
ns2cvr	Create a volume rendering object
ns2cvra	Volume rendering with alpha function specified.
ds2dvr	Draw a volume render object from a dynamic callback.
ns2svrl	Change volume rendering data and alpha ranges
ns2svas	Set alpha scaling mode.
ns2qvas	Query alpha scaling mode.
ns2sevas	Explicitly set alpha scaling values.

Misecllaneous Plots

S2PLOT	Description	PGPLOT
s2vect3	Draw a vector map of a 3D data array, with blanking.	PGVECT
s2skypa	Draw a skyscraper plot with/without walls
s2impa	Draw an impulse plot with/without trunks
s2chromapts	Plot points on a sphere using chromastereoscopic colouring for depth
s2chromacpts	Plot cartesian points using chromastereoscopic colouring for depth

S2 "Native" Routines

S2PLOT	Description	PGPLOT
ns2sphere	Draw a sphere, with a given centre, radius and colour.
ns2vsphere	Draw a sphere, with a given centre, radius and colour - vecotr input.
ns2spheret	Draw a textured sphere, with given centre, radius, colour and texture filename.
ns2vspheret	Draw a textured sphere, with given centre, radius, colour and texture filename - vector input.
ns2spherex	Draw a textured sphere, with given centre, radius, colour and texture ID.
ns2vspherex	Draw a textured sphere, with given centre, radius, colour and texture ID - vector input.
ns2vplanett	Draw a planet with texture filename.
ns2vplanetx	Draw a planet with texture id.
ns2disk	Draw an annulus with given centre, inner and out radii, and colour.
ns2vdisk	Draw an annulus with given centre, inner and out radii, and colour - vector input.
ns2arc	Draw an arc at (px,py,pz) with normal (nx,ny,nz) in current pen (thickness,colour).
ns2varc	Draw an arc at (px,py,pz) with normal (nx,ny,nz) in current pen (thickness,colour) - vector input.
ns2erc	Draw an arc.
ns2verc	Draw an arc - vector input.
ns2text	Draw text at a given position, with right and up vectors, a specific colour, and a text string of course.
ns2vtext	Draw text at a given position, with right and up vectors, a specific colour, and a text string of course - vector input.
ns2point	Draw a point at the given position and colour.
ns2vpoint	Draw a point at the given position and colour - vector input.
ns2vnpoint	Draw multiple points at the given positions with one colour - vector input.
ns2thpoint	Draw a thick point at given position, in colour and thickness in pixels (not world coords).
ns2vthpoint	Draw a thick point at given position, in colour and thickness in pixels (not world coords) - vector input.
ns2vpa	Draw a thick transparent point.
ns2i	Illumination.
ns2vi	Illumination - vector input.
ns2line	Draw a line from one point to another in a specific colour.
ns2vline	Draw a line from one point to another in a specific colour - vector input.
ns2thline	Draw a thick line from one point to another in a specific colour.
ns2vthline	Draw a thick line from one point to another in a specific colour - vector input.
ns2thwcube	Draw a wireframe cube.
ns2vthwcube	Draw a wireframe cube - vector input.
ns2cline	Draw a coloured line, with colour blended between the two given colours along the line.
ns2vcline	Draw a coloured line, with colour blended between the two given colours along the line - vector input.
ns2thcline	Draw a thick coloured line.
ns2vthcline	Draw a thick coloured line - vector input.
ns2vf3	3-vertex facet with single colour and automatic normals.
ns2vf3a	3-vertex facet with transparency
ns2vf3n	3-vertex facet with single colour and normals given.
ns2vf3c	3-vertex facet with coloured vertices and autmoatic normals.
ns2vf3nc	3-vertex facet with coloured vertices and normals given.
ns2vf3na	Transparent 3-vertex facet with coloured vertices, normals and alpha given.
ns2vf3nca	3-vertex facet with coloured vertices, normals and alpha per vertex given.
ns2vf4	4-vertex facet with single colour and automatic normals.
ns2vf4n	4-vertex facet with single colour and normals given.
ns2vf4c	4-vertex facet with coloured vertices and automatic normals.
ns2vf4nc	4-vertex facet with coloured vertices and normals given.
ns2vf4t	Textured 4-vertex facet, scale in [0,1]; trans = 'o' or 't'.
ns2vf4x	Draw a textured 4-vertex facet using a texture id.
ns2vf4xt	Draw a textured 4-vertex facet with alpha channel using a texture id.
ns2scube	Draw a solid cube.
ns2vscube	Draw a solid cube - vector input.
ns2m	Draw a marker
ns2vm	Draw a marker - vector input

Dynamic-Only Geometry Functions

S2PLOT	Description	PGPLOT
ds2bb	Draw a (dynamic) billboard: a textured facet that always faces the camera
ds2vbb	Draw a (dynamic) billboard: a textured facet that always faces the camera - vector input
ds2vbbr	Draw a (dynamic) billboard texture with specified rotation
ds2vbbp	Draw a "billboard" with aspect ratio - vector input.
ds2vbbpr	Billboard with aspect ratio, offset in screen coords, and rotation of texture - vector input.
ds2tb	Draw text that always faces the camera
ds2vtb	Draw text that always faces the camera - vector input
ds2protect	Protect dynamic geometry
ds2unprotect	Unprotect dynamic geometry
ds2isprotected	Query state of dynamic geometry protection

Callback and Handle System

S2PLOT	Description	PGPLOT
cs2scb	Set the callback function; can be null to cancel callback.
cs2scbx	Set dynamic callback with initialisation data
cs2ecb	Animation state - Enable callback.
cs2dcb	Animation state - Disable callback.
cs2tcb	Animation state - Toggle callback.
cs2sncb	Set the function to call when number-keys pressed.
cs2socb	Register function that will draw direct OpenGL graphics when called.
cs2srcb	Register when remote control data is received.
cs2shcb	Set the handle callback function for when a handle is (de)selected
cs2sdhcb	Set the handle dragging callback
cs2skcb	Set the keyboard callback
cs2spcb	Set the user prompt callback
cs2sptxy	Set the text and position of a prompt.
ds2ah	Add a handle to allow interactive picking of objects
ds2ahx	Add a handle with a specified texture
cs2th	Toggle the state of a named (dynamic) handle
cs2thv	Toggle the current state of selection handles
cs2qhv	Query whether selection handles are currently visible

Panels

S2PLOT	Description	PGPLOT
xs2ap	Add a new panel
xs2cp	Select a panel for subsequent geometry calls
xs2mp	Modify location of existing panel
xs2tp	Toggle visibility of panel
xs2lpc	Link panel cameras together
xs2qcpa	Query status of currently selected panel
xs2qpa	Query whether identified panel is active
xs2qsp	Query currently selected panel
xs2spp	Set panel frame properties.
ss2qsd	Query screen panel dimensions

Advanced Texture and Colormap Handling

S2PLOT	Description	PGPLOT
ss2lt	Load a texture for future (generally repeated) use.
ss2gt	Get a pointer to an identified texture.
ss2ct	Create a texture with specified width and height
ss2pt	Reinstall a texture.
ss2ctt	Create a transient texture map
ss2ptt	Reinstall a transient texture map
ss2dt	Delete a texture
ss2lcm	Load a colourmap into memory.
ss2ltt	Create a texture with LATEX commands.
ss2ftt	Use a named freetype font to create a texture map.
ns2texpoly3d	Draw a 3d texture.
ss2c3dt	Create an empty 3d texture.
ss2g3dt	Fetch pointer to 3d texture.

Environment and Rendering Attributes

S2PLOT	Description	PGPLOT
ss2ssr	Set sphere resolution.
ss2qsr	Query the sphere resolution
ss2srm	Set the rendering mode.
ss2qrm	Get the rendering mode.
ss2sl	Set the entire lighting environment
ss2sfc	Set the foreground colour
ss2qfc	Query the foreground colour
ss2sbc	Set the background colour.
ss2qbc	Query the background colour
ss2sfra	Set the fisheye rotation angle (degrees).
ss2qfra	Query fisheye rotation angle
ss2spt	Set the projection type of the device in use
ss2qpt	Fetch the projection type of the device in use.
ss2qsa	Query the screen type and settings
ss2qar	Query the aspect ratio
ss2snfe	Set the clipping plane expansion factor
ss2qnfp	Query the near and far clip plane distances

Advanced Camera Control

S2PLOT	Description	PGPLOT
ss2sc	Set the camera position, up vector and view direction.
ss2qc	Query the camera position, up vector and view direction.
ss2scaf	Set the camera position, up vector, view direction and rotate point.
ss2sas	Start/Stop the camera rotation.
ss2qas	Query the autospin state
ss2scf	Set the camera mid/focus point.
ss2qcf	Query camera focus point and state
ss2qpr	Query point to rotate camera about.
ss2ucf	Unset the camera mid/focus point - revert to auto mid-point.
ss2sca	Set the camera aperture.
ss2qca	Query the camera aperture.
ss2tc	Enable/disable (1,0) camera translation.
ss2sss	Set the spin / interaction speed
ss2qss	Get the spin / interaction speed
ss2scs	Set the camera speed.
ss2qcs	Query the camera speed.
ss2qess	Get the eye separation multiplier
ss2sess	Set the eye separation multiplier

Image Writing/Fetching

S2PLOT	Description	PGPLOT
ss2wtga	Write the current frame image to a TGA file
ss2gpix	Fetch the current RGB buffer

Miscellaneous Routines

S2PLOT	Description	PGPLOT
s2iden	Write username, date, time and optional string at bottom of plot.	PGIDEN
pushVRMLname	Push the given name onto the VRML name stack.

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

For function names from earlier releases of S2PLOT that have been deprecated, see here.

Retrieved from "https://astronomy.swin.edu.au/s2plot/index.php?title=S2PLOT:Function_List"

S2PLOT:Function List

From S2PLOT

Current revision

Contents

General

Opening, Closing and Selecting Devices

Windows and Viewports

Primitives

Drawing Attributes

Axes, Boxes & Labels

XY(Z) Plots

Images/Surfaces

Isosurfaces

Volume Rendering

Misecllaneous Plots

S2 "Native" Routines

Dynamic-Only Geometry Functions

Callback and Handle System

Panels

Advanced Texture and Colormap Handling

Environment and Rendering Attributes

Advanced Camera Control

Image Writing/Fetching

Miscellaneous Routines

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

Views

Personal tools

Navigation

Search

Toolbox

 __FORCETOC__
-==General==
+==General ==
 <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:Colours | Colours]]</td><td>Useful colour definitions based on PGPlot default settings. </td><td> </td></tr>
+<tr><td>[[Function:Textures | Textures]]</td><td>Important information on using textures in S2PLOT. </td><td> </td></tr>
+<tr><td>[[Function:struct_XYZ | struct XYZ]]</td><td>Data structure for (x,y,z) coordinates. </td><td> </td></tr>
+<tr><td>[[Function:struct_COLOUR | struct COLOUR]]</td><td>Data structure for (r,g,b) colour indices. </td><td> </td></tr>
 </table>
-==Opening, Closing and Selecting Devices==
+==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><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: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 shift-ENTER 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>
-==Windows and Viewports==
+==Windows and Viewports ==
 <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: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: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: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>
-==Windows and Viewports==
+==Primitives ==
 <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:s2wcube |s2wcube]]</td><td>Draw a wireframe cube.</td><td></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>
-==Primitives==
+==Drawing Attributes ==
 <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:s2qci | s2qci]]</td><td>Query the colour index</td><td> </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:s2qlw | s2qlw]]</td><td>Query the line width</td><td> </td></tr>
+<tr><td>[[Function:s2sls | s2sls]]</td><td>Set the line style.</td/><td></td></tr>
+<tr><td>[[Function:s2qls | s2qls]]</td><td>Query the line style.</td/><td></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:s2qch | s2qch]]</td><td>Query the character height</td><td> </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>
+<tr><td>[[Function:s2qah | s2qah]]</td><td>Query the arrow-head style</td><td> </td></tr>
+<tr><td>[[Function:s2twc | s2twc]]</td><td>Set the window clipping mode</td><td> </td></tr>
+<tr><td>[[Function:s2qwc| s2qwc]]</td><td>Query the window clipping mode</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>
+<tr><td>[[Function:ss2tsc | ss2tsc]]</td><td>Enable/disable 2-d screen coordinates</td><td> </td></tr>
 </table>
+==Axes, Boxes & Labels ==
+<table border=1 width=100%>
+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></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>
+<tr><td>[[Function:s2help | s2help]]</td><td>Set the custom help string.</td/><td></td></tr>
+</table>
+==XY(Z) Plots ==
+<table border=1 width=100%>
+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></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>
+<tr><td>[[Function:s2funuva | s2funuva]]</td><td>Plot a parametric function (generally a surface) defined by functions fx(u,v), fy(u,v) and fz(u,v) with transparency. </td><td> </td></tr>
+</table>
-==Attributes==<table border=1 width=100%>
+==Images/Surfaces ==
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>
+<table border=1 width=100%>
-<tr><td>[[function:s2opend | s2opend]]</td><td>  </td><td> </td></tr>
+<tr><th width=15%>S2PLOT</th><th width=*>Description</th><th width=15%>PGPLOT</th></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>
 </table>
+==Isosurfaces ==
-==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: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:ns2sisa | ns2sisa]]</td><td>Set the alpha channel for an isosurface</td><td> </td></tr>
+<tr><td>[[Function:ns2sisc | ns2sisc]]</td><td>Set the colour for an isosurface</td><td> </td></tr>
+<tr><td>[[Function:ns2ssq |ns2ssq ]]</td><td>Set general surface quality.</td/><td></td></tr>
+<tr><td>[[Function:ns2qsq |ns2qsq ]]</td><td>Query general surface quality.</td/><td></td></tr>
 </table>
+==Volume Rendering ==
-==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:ns2cvr | ns2cvr]]</td><td>Create a volume rendering object </td><td> </td></tr>
+<tr><td>[[Function:ns2cvra | ns2cvra]]</td><td>Volume rendering with alpha function specified.</td/><td></td></tr>
+<tr><td>[[Function:ds2dvr | ds2dvr]]</td><td>Draw a volume render object from a dynamic callback. </td><td> </td></tr>
+<tr><td>[[Function:ns2svrl | ns2svrl]]</td><td>Change volume rendering data and alpha ranges </td><td> </td></tr>
+<tr><td>[[Function:ns2svas |ns2svas ]]</td><td>Set alpha scaling mode.</td/><td></td></tr>
+<tr><td>[[Function:ns2qvas |ns2qvas ]]</td><td>Query alpha scaling mode.</td/><td></td></tr>
+<tr><td>[[Function:ns2sevas |ns2sevas ]]</td><td>Explicitly set alpha scaling values.</td/><td></td></tr>
 </table>
+==Misecllaneous Plots ==
-==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: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>
+<tr><td>[[Function:s2skypa | s2skypa]]</td><td>Draw a skyscraper plot with/without walls</td><td> </td></tr>
+<tr><td>[[Function:s2impa | s2impa]]</td><td>Draw an impulse plot with/without trunks</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>
-==Vector Plots==<table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td>  </td><td> </td></tr>
-</table>
+==S2 "Native" Routines ==
-==Miscellaneous Routines==
 <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: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>
+<tr><td>[[Function:ns2vplanett |ns2vplanett ]]</td><td>Draw a planet with texture filename.</td/><td></td></tr>
+<tr><td>[[Function:ns2vplanetx |ns2vplanetx ]]</td><td>Draw a planet with texture id.</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:ns2erc |ns2erc ]]</td><td>Draw an arc.</td/><td></td></tr>
+<tr><td>[[Function:ns2verc |ns2verc ]]</td><td>Draw an arc - 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:ns2vpa | ns2vpa]]</td><td>Draw a thick transparent point. </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:ns2thwcube |ns2thwcube ]]</td><td>Draw a wireframe cube.</td/><td></td></tr>
+<tr><td>[[Function:ns2vthwcube |ns2vthwcube ]]</td><td>Draw a wireframe cube - 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:ns2thcline |ns2thcline ]]</td><td>Draw a thick coloured line.</td/><td></td></tr>
+<tr><td>[[Function:ns2vthcline |ns2vthcline ]]</td><td>Draw a thick coloured 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:ns2vf3a | ns2vf3a]]</td><td>3-vertex facet with transparency </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:ns2vf3na | ns2vf3na]]</td><td>Transparent 3-vertex facet with coloured vertices, normals and alpha given. </td><td> </td></tr>
+<tr><td>[[Function:ns2vf3nca | ns2vf3nca]]</td><td>3-vertex facet with coloured vertices, normals and alpha per vertex 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:ns2scube |ns2scube ]]</td><td>Draw a solid cube.</td/><td></td></tr>
+<tr><td>[[Function:ns2vscube |ns2vscube ]]</td><td>Draw a solid cube - vector input.</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>
+==Dynamic-Only Geometry Functions ==
-==S2 "Native" Routines==
 <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:ds2vbbr | ds2vbbr]]</td><td>Draw a (dynamic) billboard texture with specified rotation</td><td> </td></tr>
+<tr><td>[[Function:ds2vbbp |ds2vbbp ]]</td><td>Draw a "billboard" with aspect ratio - vector input.</td/><td></td></tr>
+<tr><td>[[Function:ds2vbbpr |ds2vbbpr ]]</td><td>Billboard with aspect ratio, offset in screen coords, and rotation of texture - 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:ds2protect | ds2protect]]</td><td>Protect dynamic geometry </td><td> </td></tr>
+<tr><td>[[Function:ds2unprotect | ds2unprotect]]</td><td>Unprotect dynamic geometry </td><td> </td></tr>
+<tr><td>[[Function:ds2isprotected | ds2isprotected]]</td><td>Query state of  dynamic geometry protection</td><td> </td></tr>
 </table>
+==Callback and Handle System ==
-==Callback and Handle System==
 <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:cs2scbx | cs2scbx]]</td><td>Set dynamic callback with initialisation data</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:cs2srcb |cs2srcb ]]</td><td>Register when remote control data is received.</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:cs2sdhcb | cs2sdhcb]]</td><td>Set the handle dragging callback</td><td> </td></tr>
+<tr><td>[[Function:cs2skcb | cs2skcb]]</td><td>Set the keyboard callback</td><td> </td></tr>
+<tr><td>[[Function:cs2spcb | cs2spcb]]</td><td>Set the user prompt callback</td><td> </td></tr>
+<tr><td>[[Function:cs2sptxy |cs2sptxy ]]</td><td>Set the text and position of a prompt.</td/><td></td></tr>
+<tr><td>[[Function:ds2ah | ds2ah]]</td><td>Add a handle to allow interactive picking of objects </td><td> </td></tr>
+<tr><td>[[Function:ds2ahx | ds2ahx]]</td><td>Add a handle with a specified texture</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:cs2thv | cs2thv]]</td><td>Toggle the current state of selection handles </td><td>
+<tr><td>[[Function:cs2qhv | cs2qhv]]</td><td>Query whether selection handles are currently visible </td><td> </td></tr></td></tr>
 </table>
+==Panels ==
-==Advanced Texture and Colormap Handling==
 <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:xs2ap | xs2ap]]</td><td>Add a new panel</td><td> </td></tr>
+<tr><td>[[Function:xs2cp | xs2cp]]</td><td>Select a panel for subsequent geometry calls</td><td> </td></tr>
+<tr><td>[[Function:xs2mp | xs2mp]]</td><td>Modify location of existing panel</td><td> </td></tr>
+<tr><td>[[Function:xs2tp | xs2tp]]</td><td>Toggle visibility of panel</td><td> </td></tr>
+<tr><td>[[Function:xs2lpc | xs2lpc]]</td><td>Link panel cameras together</td><td> </td></tr>
+<tr><td>[[Function:xs2qcpa | xs2qcpa]]</td><td>Query status of currently selected panel</td><td> </td></tr>
+<tr><td>[[Function:xs2qpa | xs2qpa]]</td><td>Query whether identified panel is active</td><td> </td></tr>
+<tr><td>[[Function:xs2qsp | xs2qsp]]</td><td>Query currently selected panel</td><td> </td></tr>
+<tr><td>[[Function:xs2spp | xs2spp]]</td><td>Set panel frame properties.</td/><td></td></tr>
+<tr><td>[[Function:ss2qsd | ss2qsd]]</td><td>Query screen panel dimensions</td><td> </td></tr>
 </table>
+==Advanced Texture and Colormap Handling ==
-==Environment and Rendering Attributes==
 <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:ss2ct | ss2ct]]</td><td>Create a texture with specified width and height</td><td></td></tr>
+<tr><td>[[Function:ss2pt | ss2pt]]</td><td>Reinstall a texture. </td><td> </td></tr>
+<tr><td>[[Function:ss2ctt | ss2ctt]]</td><td>Create a transient texture map</td><td> </td></tr>
+<tr><td>[[Function:ss2ptt | ss2ptt]]</td><td>Reinstall a transient texture map</td><td> </td></tr>
+<tr><td>[[Function:ss2dt | ss2dt]]</td><td>Delete 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:ss2ltt | ss2ltt]]</td><td>Create a texture with LATEX commands. </td><td> </td></tr>
+<tr><td>[[Function:ss2ftt | ss2ftt]] </td><td>Use a named freetype font to create a texture map.</td><td></td></tr>
+<tr><td>[[Function:ns2texpoly3d | ns2texpoly3d]] </td><td>Draw a 3d texture.</td><td></td></tr>
+<tr><td>[[Function:ss2c3dt | ss2c3dt]] </td><td>Create an empty 3d texture.</td><td></td></tr>
+<tr><td>[[Function:ss2g3dt | ss2g3dt]] </td><td>Fetch pointer to 3d texture.</td><td></td></tr>
 </table>
+==Environment and Rendering Attributes ==
-==Advanced Camera Control==
 <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:ss2qsr | ss2qsr]]</td><td>Query the 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:ss2sfc | ss2sfc]]</td><td>Set the foreground colour</td><td> </td></tr>
+<tr><td>[[Function:ss2qfc | ss2qfc]]</td><td>Query the foreground colour</td><td> </td></tr>
+<tr><td>[[Function:ss2sbc | ss2sbc]]</td><td>Set the background colour. </td><td> </td></tr>
+<tr><td>[[Function:ss2qbc | ss2qbc]]</td><td>Query 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:ss2qfra | ss2qfra]]</td><td>Query fisheye rotation angle</td><td> </td></tr>
+<tr><td>[[Function:ss2spt | ss2spt]]</td><td>Set the projection type of the device in use</td><td> </td></tr>
+<tr><td>[[Function:ss2qpt | ss2qpt]]</td><td>Fetch the projection type of the device in use. </td><td> </td></tr>
+<tr><td>[[Function:ss2qsa | ss2qsa]]</td><td>Query the screen type and settings</td><td> </td></tr>
+<tr><td>[[Function:ss2qar | ss2qar]]</td><td>Query the aspect ratio</td><td> </td></tr>
+<tr><td>[[Function:ss2snfe | ss2snfe]]</td><td>Set the clipping plane expansion factor</td><td> </td></tr>
+<tr><td>[[Function:ss2qnfp | ss2qnfp]]</td><td>Query the near and far clip plane distances</td><td> </td></tr>
 </table>
+==Advanced Camera Control ==
-==Additional Primitives==
 <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:ss2scaf | ss2scaf]]</td><td>Set the camera position, up vector, view direction and rotate point. </td><td> </td></tr>
+<tr><td>[[Function:ss2sas | ss2sas]]</td><td>Start/Stop the camera rotation. </td><td> </td></tr>
+<tr><td>[[Function:ss2qas | ss2qas]]</td><td>Query the autospin state</td><td> </td></tr>
+<tr><td>[[Function:ss2scf | ss2scf]]</td><td>Set the camera mid/focus point. </td><td> </td></tr>
+<tr><td>[[Function:ss2qcf | ss2qcf]]</td><td>Query camera focus point and state</td><td> </td></tr>
+<tr><td>[[Function:ss2qpr | ss2qpr]]</td><td>Query point to rotate camera about. </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:ss2sca |ss2sca ]]</td><td>Set the camera aperture.</td/><td></td></tr>
+<tr><td>[[Function:ss2qca |ss2qca ]]</td><td>Query the camera aperture.</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>
+<tr><td>[[Function:ss2scs |ss2scs ]]</td><td>Set the camera speed.</td/><td></td></tr>
+<tr><td>[[Function:ss2qcs |ss2qcs ]]</td><td>Query the camera speed.</td/><td></td></tr>
+<tr><td>[[Function:ss2qess | ss2qess]]</td><td>Get the eye separation multiplier</td><td> </td></tr>
+<tr><td>[[Function:ss2sess | ss2sess]]</td><td>Set the eye separation multiplier </td><td> </td></tr>
 </table>
+==Image Writing/Fetching ==
-==Functions in Testing/Development==
 <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:ss2wtga | ss2wtga]]</td><td>Write the current frame image to a TGA file</td><td> </td></tr>
+<tr><td>[[Function:ss2gpix | ss2gpix]]</td><td>Fetch the current RGB buffer</td><td> </td></tr>
 </table>
+==Miscellaneous Routines ==
-==Dynamic-Only Geometry Functions==
 <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>
+<tr><td>[[Function:pushVRMLname | pushVRMLname]] </td><td>Push the given name onto the VRML name stack.</td><td></td></tr>
 </table>
+==Deprecated Function Names (V1.48-V1.62) ==
-==Deprecated Function Names (V1.48-V1.62)==
+For function names from earlier releases of S2PLOT that have been deprecated, see [[Functions:Deprecated | here]].
-<table border=1 width=100%>
-<tr><th width=20%>S2PLOT</th><th>Description</th><th width=20%>PGPLOT</th></tr>
-<tr><td>[[function:s2opend | s2opend]]</td><td>  </td><td> </td></tr>
-</table>