SPHIGS

Section: Misc. Reference Manual Pages (local)
Updated: 20 January 1990
Index Return to Main Contents
 

NAME

SPHIGS - Simple PHIGS (v0.8)  

DESCRIPTION

The fundamentals of this package is described fully in Chapter 7 of "Computer Graphics" by Foley, van Dam, Feiner, and Hughes. A complete reference manual is included with all shipments of SPHIGS. This manpage only lists the functions, their parameters' data types, and their return values, and offers no insight into the functionality thereof. The functions are listed twice: once arranged categorically, and once alphabetically.  

IMPORTANT DATA STRUCTURES

typedef double point[3], vector[3], matrix[4][4];
 

PARAMETER DATA TYPES

All functions return void unless otherwise noted. Parameters whose names are all uppercase are integers whose values are to be chosen from a set of defined constants.

int rendering_mode;  /* WIREFRAME_RAW, WIREFRAME, LIT_FLAT */
int matrix_concat_type; /* ASSIGN, PRECONCATENATE, POSTCONCATENATE */
int projection_type;  /* ORTHOGRAPHIC, PERSPECTIVE */
int edge_flag;  /* EDGE_VISIBLE, EDGE_INVISIBLE */
int implicit_regeneration_mode;  /* SUPPRESSED, ALLOWED */

 

ROUTINES (arranged by category)

 

Housekeeping

void SPH_begin (int width, int height, int planecount, int shadecount);
void SPH_setDoubleBufferingFlag (boolean);
void SPH_setMaxStructureID (int);
void SPH_setMaxViewIndex (int);
void SPH_end (void);

 

Conveniences

double *SPH_defPoint (double *pt, double x, double y, double z);

 

Creating elements

void SPH_polyhedron (int numverts, int numfacets, 
                     point *verts, vertex_index *facets);
void SPH_fillArea (int vCount, point *vertices);
void SPH_polyMarker(int vCount, point *vertices);
void SPH_polyLine (int vCount, point *vertices);
void SPH_text (point origin, char *string);
void SPH_setInteriorColor (int value);
void SPH_setLineStyle (int LINE_STYLE);
void SPH_setLineColor (int value);
void SPH_setLineWidthScaleFactor (double value);
void SPH_setEdgeFlag (edge_flag);
void SPH_setEdgeStyle (int LINE_STYLE);
void SPH_setEdgeColor (int value);
void SPH_setEdgeWidthScaleFactor (double value);
void SPH_setMarkerStyle (int MARKER_STYLE);
void SPH_setMarkerColor (int value);
void SPH_setMarkerSizeScaleFactor (double value);
void SPH_setTextFont (int value);
void SPH_setTextColor (int value);
void SPH_setModelingTransformation (matrix, matrix_concat_type);
void SPH_clearModelingTransformation (void);
void SPH_label (int);
void SPH_setPickIdentifier (int);
void SPH_executeStructure (int structID);

 

Posting structures to views

void SPH_postRoot (int structID, int viewID);
void SPH_unpostRoot (int structID, int viewID);
void SPH_unpostAllRoots (int viewID);

 

Editing the structure network

void SPH_openStructure (int structID);
void SPH_closeStructure (void);
int  SPH_inquireElementPointer (void);
void SPH_setElementPointer (int elptr);
void SPH_offsetElementPointer (int offset);
void SPH_moveElementPointerToLabel (int label);
void SPH_deleteElement (void);
void SPH_deleteElementsInRange (int index1, int index2);
void SPH_deleteElementsBetweenLabels (int lab1, int lab2);

 

Controlling screen refreshing

void SPH_setImplicitRegenerationMode (implicit_regeneration_mode);
void SPH_regenerateScreen (void);

 

Setting the view table

void SPH_evaluateViewOrientationMatrix 
     (point view_ref_point,
      vector view_plane_normal, vector view_up_vector,
      matrix vo_matrix);
void SPH_evaluateViewMappingMatrix
     (double umin, double umax, double vmin, double vmax,
      projection_type,
      point proj_ref_point,
      double front_plane_dist, double back_plane_dist,
      double viewport_minx, double viewport_maxx, 
      double viewport_miny, double viewport_maxy,
      double viewport_minz, double viewport_maxz,
      matrix vm_matrix);
void SPH_setViewRepresentation 
     (int viewIndex,
      matrix vo_matrix, matrix vm_matrix,
      double vp_minx, double vp_maxx, 
      double vp_miny, double vp_maxy,
      double vp_minz, double vp_maxz);
void SPH_setRenderingMode (int viewindex, int value);
void SPH_setViewBackgroundColor (int viewIndex, int color);
void SPH_setViewPointLightSource (int viewIndex, double u, double v, double n);

 

Computing modeling transformation matrices

void SPH_scale (double x, double y, double z, matrix result);
void SPH_rotateX (double angle, matrix result);
void SPH_rotateY (double angle, matrix result);
void SPH_rotateZ (double angle, matrix result);
void SPH_translate (double x, double y, double z, matrix result);
void SPH_compose (matrix m1, matrix m2, matrix result);

 

Loading the SPHIGS color table

void SPH_loadCommonColor (int microcolorindex, char *name);

 

ROUTINES (arranged alphabetically)

void SPH_begin (int width, int height, int planecount, int shadecount);
void SPH_clearModelingTransformation (void);
void SPH_closeStructure (void);
void SPH_compose (matrix m1, matrix m2, matrix result);
double *SPH_defPoint (double *pt, double x, double y, double z);
void SPH_deleteElement (void);
void SPH_deleteElementsBetweenLabels (int lab1, int lab2);
void SPH_deleteElementsInRange (int index1, int index2);
void SPH_end (void);
void SPH_evaluateViewMappingMatrix
     (double umin, double umax, double vmin, double vmax, 
      projection_type, point proj_ref_point, 
      double front_plane_dist, double back_plane_dist, 
      double viewport_minx, double viewport_maxx, 
      double viewport_miny, double viewport_maxy, 
      double viewport_minz, double viewport_maxz, matrix vm_matrix);
void SPH_evaluateViewOrientationMatrix 
     (point view_ref_point, 
      vector view_plane_normal, 
      vector view_up_vector, matrix vo_matrix);
void SPH_executeStructure (int structID);
void SPH_fillArea (int vCount, point *vertices);
int  SPH_inquireElementPointer (void);
void SPH_label (int);
void SPH_loadCommonColor (int microcolorindex, char *name);
void SPH_moveElementPointerToLabel (int label);
void SPH_offsetElementPointer (int offset);
void SPH_openStructure (int structID);
void SPH_polyLine (int vCount, point *vertices);
void SPH_polyMarker(int vCount, point *vertices);
void SPH_polyhedron 
     (int numverts, int numfacets, point *verts, vertex_index *facets);
void SPH_postRoot (int structID, int viewID);
void SPH_regenerateScreen (void);
void SPH_rotateX (double angle, matrix result);
void SPH_rotateY (double angle, matrix result);
void SPH_rotateZ (double angle, matrix result);
void SPH_scale (double x, double y, double z, matrix result);
void SPH_setDoubleBufferingFlag (boolean);
void SPH_setEdgeColor (int value);
void SPH_setEdgeFlag (edge_flag);
void SPH_setEdgeStyle (int LINE_STYLE);
void SPH_setEdgeWidthScaleFactor (double value);
void SPH_setElementPointer (int elptr);
void SPH_setImplicitRegenerationMode (implicit_regeneration_mode);
void SPH_setInteriorColor (int value);
void SPH_setLineColor (int value);
void SPH_setLineStyle (int LINE_STYLE);
void SPH_setLineWidthScaleFactor (double value);
void SPH_setMarkerColor (int value);
void SPH_setMarkerSizeScaleFactor (double value);
void SPH_setMarkerStyle (int MARKER_STYLE);
void SPH_setMaxStructureID (int);
void SPH_setMaxViewIndex (int);
void SPH_setModelingTransformation (matrix, matrix_concat_type);
void SPH_setPickIdentifier (int);
void SPH_setRenderingMode (int viewindex, int value);
void SPH_setTextColor (int value);
void SPH_setTextFont (int value);
void SPH_setViewBackgroundColor (int viewIndex, int color);
void SPH_setViewPointLightSource (int viewIndex, double u, double v, double n);
void SPH_setViewRepresentation 
     (int viewIndex, matrix vo_matrix, matrix vm_matrix, 
      double vp_minx, double vp_maxx, double vp_miny, double vp_maxy, 
      double vp_minz, double vp_maxz);
void SPH_text (point origin, char *string);
void SPH_translate (double x, double y, double z, matrix result);
void SPH_unpostAllRoots (int viewID);
void SPH_unpostRoot (int structID, int viewID);
 

BUGS

Please consult section 0 of the SPHIGS Reference Manual for details on omissions, known bugs, and differences with the textual specification.  

AUTHOR

David Sklar


 

Index

NAME
DESCRIPTION
IMPORTANT DATA STRUCTURES
PARAMETER DATA TYPES
ROUTINES (arranged by category)
Housekeeping
Conveniences
Creating elements
Posting structures to views
Editing the structure network
Controlling screen refreshing
Setting the view table
Computing modeling transformation matrices
Loading the SPHIGS color table
ROUTINES (arranged alphabetically)
BUGS
AUTHOR

This document was created by man2html, using the manual pages.
Time: 00:29:51 GMT, December 05, 2024