S2PLOT:Function List

From S2PLOT

Contents 1 General 2 Opening, Closing and Selecting Devices 3 Windows and Viewports 4 Primitives 5 Drawing Attributes 6 Axes, Boxes & Labels 7 XY(Z) Plots 8 Images/Surfaces 9 Isosurfaces 10 Volume Rendering 11 Misecllaneous Plots 12 S2 "Native" Routines 13 Dynamic-Only Geometry Functions 14 Callback and Handle System 15 Panels 16 Advanced Texture and Colormap Handling 17 Environment and Rendering Attributes 18 Advanced Camera Control 19 Image Writing/Fetching 20 Miscellaneous Routines 21 Deprecated Function Names (V1.48-V1.62)

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	3-vertex facet with coloured vertices and alpha given.
ns2vf3nca	3-vertex facet with coloured vertices, alpha and normals 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.
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
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.