---

VMDDisplayList.h

Go to the documentation of this file.

/***************************************************************************
 *cr
 *cr            (C) Copyright 1995-2008 The Board of Trustees of the
 *cr                        University of Illinois
 *cr                         All Rights Reserved
 *cr
 ***************************************************************************/

/***************************************************************************
 * RCS INFORMATION:
 *
 *      $RCSfile: VMDDisplayList.h,v $
 *      $Author: johns $        $Locker:  $             $State: Exp $
 *      $Revision: 1.35 $      $Date: 2008/03/27 19:36:49 $
 *
 ***************************************************************************
 * DESCRIPTION:
 *   Display list data structure used to hold all of the rendering commands
 *   VMD generates and interprets in order to do its 3-D rendering.
 ***************************************************************************/

#ifndef VMDLINKEDLIST_H__
#define VMDLINKEDLIST_H__

#include <string.h>
#include "Matrix4.h"

struct VMDClipPlane {
  float center[3]; 
  float normal[3]; 
  float color[3];  
  int mode;        

  VMDClipPlane() {
    center[0] = center[1] = center[2] = 0;
    normal[0] = normal[1] = 0; normal[2] = 1;
    color[0] = color[1] = color[2] = 0.5;
    mode = 0;
  }
};

#define VMD_MAX_CLIP_PLANE 6

#define PBC_NONE   0x00  // don't draw any PBC images
#define PBC_X      0x01  // +X images
#define PBC_Y      0x02  // +Y images
#define PBC_Z      0x04  // +Z images
#define PBC_OPX    0x08  // -X images
#define PBC_OPY    0x10  // -Y images
#define PBC_OPZ    0x20  // -Z images
#define PBC_NOSELF 0x40  // set this flag to NOT draw the original image


class VMDDisplayList {
private:
  struct CommandHeader {
    int code; 
    int size; 
  };

public:
  VMDDisplayList();   
  ~VMDDisplayList();  

  void *operator new(size_t);           
  void operator delete(void *, size_t); 

  Matrix4 mat;          
  unsigned long serial; 
  int cacheskip;        
  int pbc;              
  int npbc;             
  Matrix4 transX, transY, transZ; 
  Matrix4 transXinv, transYinv, transZinv; 


  float ambient, specular, diffuse, shininess, opacity;
  int materialtag;  


  VMDClipPlane clipplanes[VMD_MAX_CLIP_PLANE]; 

  void *append(int code, int size);

  // Reset and also free up any linked memory blocks.  The original block will 
  // not be freed; it doesn't go away until you delete the object.
  void reset_and_free(unsigned long newserial);

  const VMDClipPlane *clipplane(int i) {
    if (i < 0 || i >= VMD_MAX_CLIP_PLANE) return NULL;
    return clipplanes+i;
  }


  // normals need not be normalized; it will be be normalized internally. 
  int set_clip_center(int i, const float *);
  int set_clip_normal(int i, const float *);
  int set_clip_color(int i, const float *);
  int set_clip_status(int i, int);

  struct VMDLinkIter {
    char *ptr;    // pointer to current place in memory pool
    int ncmds;    // commands remaining in the list
  };

  void first(VMDLinkIter *it) const {
    it->ptr = pool;
    it->ncmds = listsize;
  }

  int next(VMDLinkIter *it, char *&d) const {
    if (!(it->ncmds--)) return -1; // corresponds to DLASTCOMMAND
    CommandHeader *header = (CommandHeader *)(it->ptr);
    int code = header->code;
    int size = header->size;
    d = it->ptr + sizeof(CommandHeader);
    it->ptr += size;
    return code;
  }

private:
  // number of commands in the display list
  int listsize; 

  // size of memory pool
  unsigned long poolsize;

  // amount of memory pool consumed by the current display list
  unsigned long poolused;

  // our memory pool
  char *pool;
};    

#endif

---