---

prm.c

Go to the documentation of this file.

/*
** ----------------------------------------------------------------
** prm.c  -  Primitive data structure functions.
**
** ----------------------------------------------------------------
*/

/*
** ---------------------------------------------------------------
** Global variables and symbols:
*/
#include <stdlib.h>
#include <stdio.h>
#include "prm.h"
#include "quad.h"
#include "circ.h"

/*
** ---------------------------------------------------------------
** Local variables and symbols:
*/

/*
** ---------------------------------------------------------------
** Primitive data structure:
** In this module, the primitives are stored in memory in a 
** circular doubly-linked list, with a pointer to the head of the
** list:
**
**       ---------- 
**      | prm_head |
**       ----------
**           |
**           |
**           V
**         -----     -----     -----     -----     -----
**  /---->|     |-->|     |-->|     |-->|     |-->|     |------\
**  |     | prm |   | prm |   | prm |   | prm |   | prm |      |
**  |  /--|     |<--|     |<--|     |<--|     |<--|     |<--\  |
**  |  |   -----     -----     -----     -----     -----    |  |
**  |  |  (first)                                  (last)   |  |
**  |  |                                                    |  |
**  |  \----------------------------------------------------/  |
**  |                                                          |
**  \----------------------------------------------------------/
*/
struct _prm {
  struct _prm   *next;
  struct _prm   *prev;
  int           type;
  void          *geom;
  int           sel;
  long int      color;
  double        height;
 };

static Prm *prm_head = 0L;


/*
** ---------------------------------------------------------------
** Private functions:
*/

/*======================  prmCreateEmpty  ======================*/

static Prm *prmCreateEmpty( void )
{
 Prm *prm;

/* Allocate memory for a new primitive.
 */
 prm = malloc( sizeof( Prm ) );
 if( prm == NULL )
  return( NULL );

/* Set default values for new primitive.
 */
 prm->next = NULL;
 prm->prev = NULL;
 prm->type = PRM_UNDEF;
 prm->geom = NULL;
 prm->sel = 0;
 prm->color = 0L;
 prm->height = 0.0;

 return( prm );
}

/*======================  prmInsertFront  ======================*/

static void prmInsertFront( Prm *prm )
{
/*** COMPLETE HERE: 01 ***/
}

/*======================  prmInsertBack  =======================*/

static void prmInsertBack( Prm *prm )
{
/*** COMPLETE HERE: 02 ***/
}

/*=====================  prmRemoveFromList  ====================*/

static void prmRemoveFromList( Prm *prm )
{
/*** COMPLETE HERE: 03 ***/
}

/*===================  prmGetFirstSelected  ====================*/

static Prm *prmGetFirstSelected( void )
{
/*** COMPLETE HERE: 04 ***/

 return( NULL );
}

/*
** ---------------------------------------------------------------
** Public functions:
*/

/*======================  prmCreateFront  ======================*/

Prm *prmCreateFront( PrmType type )
{
 Prm *prm;
 prm = prmCreateEmpty( );
 if( prm == NULL )
  return( NULL );

 switch( type )
 {
  case PRM_QUAD:
   prm->type = PRM_QUAD;
   prm->geom = quadCreate( );
   break;
  case PRM_CIRC:
   prm->type = PRM_CIRC;
   prm->geom = circCreate( );
   break;
  default:
   free( prm );
   return( NULL );
 }
 prmInsertFront( prm );

 return( prm );
}

/*=======================  prmCreateBack  ======================*/

Prm *prmCreateBack( PrmType type )
{
 Prm *prm;
 prm = prmCreateEmpty( );
 if( prm == NULL )
  return( NULL );

 switch( type )
 {
  case PRM_QUAD:
   prm->type = PRM_QUAD;
   prm->geom = quadCreate( );
   break;
  case PRM_CIRC:
   prm->type = PRM_CIRC;
   prm->geom = circCreate( );
   break;
  default:
   free( prm );
   return( NULL );
 }
 prmInsertBack( prm );

 return( prm );
}

/*=========================  prmDelete  ========================*/

void prmDelete( Prm *prm )
{
 prmRemoveFromList( prm );
 if( prm->geom )
 {
  switch( prm->type )
  {
   case PRM_QUAD:
    quadDelete( (Quad *)prm->geom );
    break;
   case PRM_CIRC:
    circDelete( (Circ *)prm->geom );
    break;
   default:
    break;
  }
 }
 free( prm );
}

/*=====================  prmDeleteSelected  ====================*/

void prmDeleteSelected( void )
{
 Prm *prm;
 while( (prm = prmGetFirstSelected( )) != NULL )
 {
  prmDelete( prm );
 }
}

/*=======================  prmDeleteList  ======================*/

void prmDeleteList( void )
{
/*** COMPLETE HERE: 05 ***/
}

/*==========================  prmFirst  ========================*/

Prm *prmFirst( void )
{
/*** COMPLETE HERE: 06 ***/
}

/*==========================  prmLast  =========================*/

Prm *prmLast( void )
{
/*** COMPLETE HERE: 07 ***/
}

/*==========================  prmNext  =========================*/

Prm *prmNext( Prm *prm )
{
/*** COMPLETE HERE: 08 ***/
}

/*========================  prmPrevious  =======================*/

Prm *prmPrevious( Prm *prm )
{
/*** COMPLETE HERE: 09 ***/
}

/*=======================  prmMoveFront  =======================*/

void prmMoveFront( Prm *prm )
{
/* Handle case in which given primitive is already at the 
 * beginning of list. This also considers the case of a
 * single primitive list.
 */
 if( prm == prm_head )
  return;

/* When we get here, there are at least two primitives in
 * the list and the primitive to move is not the first one.
 * Therefore, it is just necessary to remove from its 
 * current position in the list and inserts it at the beginning
 * of list.
 */
 prmRemoveFromList( prm );
 prmInsertFront( prm );
}

/*========================  prmMoveBack  =======================*/

void prmMoveBack( Prm *prm )
{
/* Handle case in which given primitive is already at the 
 * end of list. This also considers the case of a
 * single primitive list.
 */
 if( prm == prm_head->prev )
  return;

/* When we get here, there are at least two primitives in
 * the list and the primitive to move is not the last one.
 * Therefore, it is just necessary to remove from its 
 * current position in the list and inserts it at the end
 * of list.
 */
 prmRemoveFromList( prm );
 prmInsertBack( prm );
}

/*========================  prmGetType  ========================*/

int prmGetType( Prm *prm )
{
 return( (int)prm->type );
}

/*==========================  prmRead  =========================*/

void prmRead( Prm *prm, FILE *fd )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadRead( (Quad *)prm->geom, fd );
   break;
  case PRM_CIRC:
   circRead( (Circ *)prm->geom, fd );
   break;
  default:
   break;
 }
}

/*=========================  prmWrite  =========================*/

void prmWrite( Prm *prm, FILE *fd )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadWrite( (Quad *)prm->geom, fd );
   break;
  case PRM_CIRC:
   circWrite( (Circ *)prm->geom, fd );
   break;
  default:
   break;
 }
}

/*========================  prmGetNPts  ========================*/

int prmGetNPts( Prm *prm )
{
 int npts;

 switch( prm->type )
 {
  case PRM_QUAD:
   npts = quadGetNPts( (Quad *)prm->geom );
   break;
  case PRM_CIRC:
   npts = circGetNPts( (Circ *)prm->geom );
   break;
  default:
   npts = 0;
   break;
 }
 return( npts );
}

/*=======================  prmSetCoords  =======================*/

void prmSetCoords( Prm *prm, int id, double x, double y )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadSetCoords( (Quad *)prm->geom, id, x, y );
   break;
  case PRM_CIRC:
   circSetCoords( (Circ *)prm->geom, id, x, y );
   break;
  default:
   break;
 }
}

/*=======================  prmGetCoords  =======================*/

void prmGetCoords( Prm *prm, int id, double *x, double *y )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadGetCoords( (Quad *)prm->geom, id, x, y );
   break;
  case PRM_CIRC:
   circGetCoords( (Circ *)prm->geom, id, x, y );
   break;
  default:
   break;
 }
}

/*=======================  prmSet1stPt  ========================*/

void prmSet1stPt( Prm *prm, double x, double y )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadSet1stPt( (Quad *)prm->geom, x, y );
   break;
  case PRM_CIRC:
   circSet1stPt( (Circ *)prm->geom, x, y );
   break;
  default:
   break;
 }
}
 
/*=======================  prmSet2ndPt  ========================*/

void prmSet2ndPt( Prm *prm, double x, double y )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadSet2ndPt( (Quad *)prm->geom, x, y );
   break;
  case PRM_CIRC:
   circSet2ndPt( (Circ *)prm->geom, x, y );
   break;
  default:
   break;
 }
}

/*=======================  prmSelectAll  =======================*/

void prmSelectAll( )
{
/*** COMPLETE HERE: 10 ***/
}

/*=========================  prmSelect  ========================*/

void prmSelect( Prm *prm )
{
/*** COMPLETE HERE: 11 ***/
}

/*========================  prmUnselect  =======================*/

void prmUnselect( Prm *prm )
{
/*** COMPLETE HERE: 12 ***/
}

/*======================  prmUnselectAll  ======================*/

void prmUnselectAll( )
{
/*** COMPLETE HERE: 13 ***/
}

/*=====================  prmCheckSelected  =====================*/

int prmCheckSelected( Prm *prm )
{
/*** COMPLETE HERE: 14 ***/
 return( 0 );
}

/*========================  prmSetColor  =======================*/

void prmSetColor( Prm *prm, long int color )
{
 prm->color = color;
}

/*========================  prmGetColor  =======================*/

long int prmGetColor( Prm *prm )
{
 return( prm->color );
}

/*========================  prmSetHeight  ======================*/

void prmSetHeight( Prm *prm, double height )
{
 prm->height = height;
}

/*========================  prmGetHeight  ======================*/

double prmGetHeight( Prm *prm )
{
 return( prm->height );
}

/*=======================  prmPickArea  ========================*/

int prmPickArea( Prm *prm, double x, double y )
{
 int status;

 switch( prm->type )
 {
  case PRM_QUAD:
   status = quadPickArea( (Quad *)prm->geom, x, y );
   break;
  case PRM_CIRC:
   status = circPickArea( (Circ *)prm->geom, x, y );
   break;
  default:
   status = 0;
   break;
 }
 return( status );
}

/*======================  prmPickVertex  =======================*/

int prmPickVertex( Prm *prm, double x, double y, double tol,
                   int *id )
{
 int status;

 switch( prm->type )
 {
  case PRM_QUAD:
   status = quadPickVertex( (Quad *)prm->geom, x, y, tol, id );
   break;
  case PRM_CIRC:
   status = circPickVertex( (Circ *)prm->geom, x, y, tol, id );
   break;
  default:
   status = 0;
   break;
 }
 return( status );
}

/*=======================  prmPickSide  ========================*/

int prmPickSide( Prm *prm, double x, double y, double tol,
                 int *id )
{
 int status;

 switch( prm->type )
 {
  case PRM_QUAD:
   status = quadPickSide( (Quad *)prm->geom, x, y, tol, id );
   break;
  case PRM_CIRC:
   status = circPickSide( (Circ *)prm->geom, x, y, tol, id );
   break;
  default:
   status = 0;
   break;
 }
 return( status );
}

/*=======================  prmTranslate  =======================*/

void prmTranslate( Prm *prm, double dx, double dy )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadTranslate( (Quad *)prm->geom, dx, dy );
   break;
  case PRM_CIRC:
   circTranslate( (Circ *)prm->geom, dx, dy );
   break;
  default:
   break;
 }
}

/*====================  prmTranslateVertex  ====================*/

void prmTranslateVertex( Prm *prm, int id, double dx, double dy )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadTranslateVertex( (Quad *)prm->geom, id, dx, dy );
   break;
  case PRM_CIRC:
   circTranslateVertex( (Circ *)prm->geom, id, dx, dy );
   break;
  default:
   break;
 }
}

/*=====================  prmTranslateSide  =====================*/

void prmTranslateSide( Prm *prm, int id, double dx, double dy )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadTranslateSide( (Quad *)prm->geom, id, dx, dy );
   break;
  case PRM_CIRC:
   circTranslateSide( (Circ *)prm->geom, id, dx, dy );
   break;
  default:
   break;
 }
}

/*=========================  prmGetBox  ========================*/

void prmGetBox( Prm *prm, double *xmin, double *xmax, 
                          double *ymin, double *ymax )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadGetBox( (Quad *)prm->geom, xmin, xmax, ymin, ymax );
   break;
  case PRM_CIRC:
   circGetBox( (Circ *)prm->geom, xmin, xmax, ymin, ymax );
   break;
  default:
   break;
 }
}

/*======================  prmGetGlobalBox  =====================*/

int prmGetGlobalBox( double *xmin, double *xmax, 
                     double *ymin, double *ymax )
{
/*** COMPLETE HERE: 15 ***/

 return( 1 );
}

/*====================  prmDisplayBoundary  ====================*/

void prmDisplayBoundary( Prm *prm )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadDisplayBoundary( (Quad *)prm->geom );
   break;
  case PRM_CIRC:
   circDisplayBoundary( (Circ *)prm->geom );
   break;
  default:
   break;
 }
}

/*====================  prmDisplayInterior  ====================*/

void prmDisplayInterior( Prm *prm )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadDisplayInterior( (Quad *)prm->geom );
   break;
  case PRM_CIRC:
   circDisplayInterior( (Circ *)prm->geom );
   break;
  default:
   break;
 }
}

/*=====================  prmDisplaySolid  ======================*/

void prmDisplaySolid( Prm *prm )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadDisplaySolid( (Quad *)prm->geom, prmGetHeight( prm ) );
   break;
  case PRM_CIRC:
   circDisplaySolid( (Circ *)prm->geom, prmGetHeight( prm ) );
   break;
  default:
   break;
 }
}

/*======================  prmHighltSolid  ======================*/

void prmHighltSolid( Prm *prm )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadHighltSolid( (Quad *)prm->geom, prmGetHeight( prm ) );
   break;
  case PRM_CIRC:
   circHighltSolid( (Circ *)prm->geom, prmGetHeight( prm ) );
   break;
  default:
   break;
 }
}

/*====================  prmDisplayZbuffer  =====================*/

void prmDisplayZbuffer( Prm *prm )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadDisplayZbuffer( (Quad *)prm->geom, prmGetHeight( prm ), 
                                          prmGetColor( prm ) );
   break;
  case PRM_CIRC:
   circDisplayZbuffer( (Circ *)prm->geom, prmGetHeight( prm ),
                                          prmGetColor( prm ) );
   break;
  default:
   break;
 }
}

===========  prmHighltSolid  ======================*/

void prmHighltSolid( Prm *prm )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadHighltSolid( (Quad *)prm->geom, prmGetHeight( prm ) );
   break;
  case PRM_CIRC:
   circHighltSolid( (Circ *)prm->geom, prmGetHeight( prm ) );
   break;
  default:
   break;
 }
}

/*====================  prmDisplayZbuffer  =====================*/

void prmDisplayZbuffer( Prm *prm )
{
 switch( prm->type )
 {
  case PRM_QUAD:
   quadDisplayZbuffer( (Quad *)prm->geom, prmGetHeight( prm ), 
                                          prmGetColor( prm ) );
   break;
  case PRM_CIRC:
   circDisplayZbuffer( (Circ *)prm->geom, prmGetHeight( prm ),
                                          prmGetColor( prm ) );
   break;
  default:
   break;
 }
}

---