LIBRARY FUNCTION DESCRIPTIONS
| Sub-Program Name | Description |
| Device Routines |
| vinit(device) | Initialise device |
| vexit() | Reset window/terminal (must be last routine called) |
| voutput(path) | Redirect output from *next* vinit to file |
| vnewdev(device) | Reinitialize to use new device without changing |
| vgetdev(device) | Get name of current device |
| pushdev(device) | push current device onto a stack |
| popdev(device) | pop device from stack created by pushdev. |
| getdepth() | Return number of bit planes (color planes) |
| Routines For Setting Up Windows |
| prefposition(x, y) | Specify preferred position of window |
| prefsize(width, height) | Specify preferred width and height of window |
| Clipping Routines |
| clipping(onoff) | Turn clipping on or off |
| Color Routines |
| clear() | Clears screen to current color |
| color(col) | Set current color |
| mapcolor(indx, red, green, blue) | Set color map index |
| Interactive Routines |
| getkey() | Return ASCII ordinal of next key typed |
| checkkey() | Returns zero if no key is pressed or ASCII ordinal |
| getstring(bcol, string) | Read in a string, echoing it in current font |
| locator(xaddr, yaddr) | Find out where cursor is |
| slocator(xaddr, yaddr) | Find out where cursor is in screen coordinates |
| Flushing |
| vsetflush(yesno) | Set global flushing status |
| vflush() | Call device flush or syncronisation routine |
| Viewport Routines |
| viewport(left, right, bottom, top) | Specify which part of screen to draw in |
| pushviewport() | Save current viewport |
| popviewport() | Retrieve last viewport |
| getviewport(left, right, bottom, top) | Returns limits of current viewport in screen coordinates |
| Getting the aspect details |
| getaspect() | Returns the ratio height over width of the display device. |
| getfactors(wfact, hfact) | Returns width over min(width of device, height of device) and height over min(width of device, height of device). |
| getdisplaysize(w, h) | Returns width and height of device in pixels |
| Attribute Stack Routines |
| pushattributes() | Save the current attributes on the attribute stack. |
| popattributes() | Restore attributes to what they were at last pushattributes(). |
| Projection Routines |
| ortho(left, right, bottom, top, near, far) | Define x,y,z clipping planes. |
| ortho2(left, right, bottom, top) | Define x and y clipping planes. |
| perspective(fov, aspect, near, far) | Specify perspective viewing pyramid |
| window(left, right, bot, top, near, far) | Specify a perspective viewing pyramid |
| Matrix Stack Routines |
| pushmatrix() | Save the current transformation matrix on the matrix stack. |
| popmatrix() | Reinstall the last matrix pushed |
| Viewpoint Routines |
| polarview(dist, azim, inc, twist) | Specify the viewer's position in polar coordinates |
| up(x, y, z) | Specify the world up. |
| lookat(vx, vy, vz, px, py, pz, twist) | Specify the viewer's position |
| Move Routines |
| move(x, y, z) | Move current graphics position to (x, y, z) |
| rmove(deltax, deltay, deltaz) | Relative move |
| move2(x, y) | Move graphics position to point (x, y) |
| rmove2(deltax, deltay) | Relative move in world units. |
| smove2(x, y) | Move current graphics position in screen coordinates (-1.0 to 1.0). |
| rsmove2(deltax, deltay) | Relative move in screen units (-1.0 to 1.0). |
| LineStyle Routines |
| linewidth() | set line width in rasters |
| dashcode() | set dash pattern length |
| linestyle() | set the line dash pattern |
| Draw Routines |
| draw(x, y, z) | Draw from current graphics position to (x, y, z) |
| rdraw(deltax, deltay, deltaz) | Relative draw |
| draw2(x, y) | Draw from current graphics position to point (x, y) |
| rdraw2(deltax,deltay) | Relative draw |
| sdraw2(x, y) | Draw in screen coordinates (-1.0 to 1.0). |
| rsdraw2(deltax, deltay) | Relative draw in screen units (-1.0 to 1.0). |
| Arcs and Circles |
| circleprecision(nsegs) | Set number of line segments in a circle. Default is 32. |
| arc(x, y, radius, startang, endang) | Draw an arc in world units. |
| sector(x, y, radius, startang, endang) | Draw a sector. Note: sectors are polygons. |
| circle(x, y, radius) | Draw a circle. Note: circles are polygons. |
| Curve Routines |
| curvebasis(basis) | Define a basis matrix for a curve. |
| curveprecision(nsegs) | Define number of line segments used to draw a curve. |
| rcurve(geom) | Draw a rational curve. |
| curve(geom) | Draw a curve. |
| curven(n, geom) | Draw n - 3 overlapping curve segments. Note: n must be at least 4. |
| Rectangles and General Polygon Routines |
| rect(x1, y1, x2, y2) | Draw a rectangle. |
| polyfill(onoff) | Set the polygon fill flag |
| polyhatch(onoff) | Set the polygon hatch flag |
| hatchang(angle) | Set the angle of the hatch lines. |
| hatchpitch(pitch) | Set the distance between hatch lines. |
| poly2(n, points) | Construct an (x, y) polygon from an array of points |
| poly(n, points) | Construct a polygon from an array of points |
| makepoly() | opens polygon constructed by a series of move-draws and closed by closepoly |
| closepoly() | Terminates a polygon opened by makepoly. |
| backface(onoff) | Turns on culling of backfacing polygons. |
| backfacedir(clockwise) | Sets backfacing direction to clockwise or anti-clockwise |
| Text Routines |
| font(fontname) | Set the current font |
| numchars() | Return number of characters in the current SOFTWARE font. |
| textsize(width, height) | Set maximum size of a character in the current SOFTWARE font. |
| textang(ang) | Set the SOFTWARE text angle. |
| fixedwidth(onoff) | Turns fixedwidth mode on or off for SOFTWARE fonts. |
| centertext(onoff) | Turns centertext mode on or off for SOFTWARE fonts. |
| getcharsize(c, width, height) | Get the width and height of a character. |
| getfontdec() | Return size of maximum font descender |
| getfontsize(width, height) | Get maximum width and height of a character in a font. |
| drawchar(c) | Draw the character c and update current position. |
| drawstr(str) | Draw the text in string at the current position. |
| strlength(str) | Return the length of the string s |
| boxtext(x, y, l, h, s) | Draw the SOFTWARE string s so that it fits in the imaginary box |
| boxfit(x, y, l, h, s) | resize the SOFTWARE text size so it fits in a box |
| textjustify(val) | general text justification (C only) |
| leftjustify() | left justify text |
| rightjustify() | right justify text |
| xcentertext() | center text in the X direction |
| topjustify() | top justify text |
| bottomjustify() | bottom justify text |
| ycentertext() | center text in the Y direction |
| textslant() | Defines the obliqueness of the fonts. |
| textweight() | Defines the weight of the fonts. |
| Transformations Routines |
| translate(x, y, z) | Set up a translation. |
| scale(x, y, z) | Set up scaling factors in x, y, and z axis. |
| rotate(angle, axis) | Set up a rotation in axis axis where axis is one of 'x','y', or 'z'. |
| Patch Routines |
| patchbasis(tbasis, ubasis) | Define the t and u basis matrices of a patch. |
| patchprecision(tseg, useg) | Set minimum number of line segments making up curves in a patch. |
| patchcurves(nt, nu) | Set the number of curves making up a patch. |
| rpatch(gx, gy, gz, gw) | Draws a rational patch in the current basis, according to the geometry matrices gx, gy, gz, and gw. |
| patch(gx, gy, gz) | Draws a patch in the current basis, according to the geometry matrices gx, gy, and gz. |
| Point Routines |
| point(x, y, z) | Draw a point at x, y, z |
| point2(x, y) | Draw a point at x, y. |
| Object Routines |
| makeobj(n) | Commence the object number n. |
| closeobj() | Close the current object. |
| genobj() | Returns a unique object identifier. |
| getopenobj() | Return the number of the current object. |
| callobj(n) | Draw object number n. |
| isobj(n) | Returns non-zero if there is an object of number n. |
| delobj(n) | Delete the object number n. |
| loadobj(n, filename) | Load the object in the file filename as object number n. |
| saveobj(n, filename) | Save object number n into file filename. Does NOT save objects called inside object n. |
| Double Buffering |
| backbuffer() | Draw in the backbuffer. Returns -1 if the device is not up to it. |
| frontbuffer() | Draw in the front buffer. This will always work. |
| swapbuffers() | Swap the front and back buffers. |
| Position Routines |
| getgp(x, y, z) | Gets the current graphics position |
| getgp2(x, y) | Gets the current graphics position |
| sgetgp2(x, y) | Gets the current screen graphics position in screen coords (-1 to 1) |
