This is drawer.h in view mode; [Download] [Up]
/* Copyright (c) 1992 The Geometry Center; University of Minnesota
1300 South Second Street; Minneapolis, MN 55454, USA;
This file is part of geomview/OOGL. geomview/OOGL is free software;
you can redistribute it and/or modify it only under the terms given in
the file COPYING, which you should have received along with this file.
This and other related software may be obtained via anonymous ftp from
geom.umn.edu; email: software@geom.umn.edu. */
/* Authors: Stuart Levy, Tamara Munzner, Mark Phillips */
#ifndef _DRAWER_H_
#define _DRAWER_H_
#include "common.h"
#include "transformn.h"
#include "pick.h"
/* N-D color maps */
typedef struct cent { /* Colormap entry */
float v; /* projection value */
ColorA c; /* color */
int interp; /* interpolate values between cmap points */
} cent;
typedef struct cmap { /* Colormap table */
HPointN *axis; /* projection axis */
vvec cents; /* colormap; entries are 'cent's */
} cmap;
#define MAXCMAP 4
struct ndstuff { /* mg info */
TransformN *T; /* object-to-ND-camera transform */
int *axes; /* visible subspace: axes in N-D camera seen by cur cam */
TransformN *Tc; /* object-to-coloring-space-transform */
int ncm; /* number of colormaps */
cmap *cm; /* colormap array */
HPointN *hc; /* work area for color projections */
};
#define OBJECTFIELDS \
char *name[2]; /* array of names */ \
Geom *Item; /* For Geoms, the Inst holding the \
* modelling transform; for DViews, \
* an Inst pointing to the scene. \
* In all cases this Inst holds any \
* relevant Appearance. \
*/ \
PFI updateproc; /* motion update procedure */ \
Handle *incrhandle; /* Handle to above */ \
Transform Incr; /* xform per frame update, if no updateproc */ \
int id; /* my id */ \
char seqno; /* sequence no for keeping track of changes */ \
char redraw; /* object needs redrawing */ \
char changed; /* Something about this obj changed; redraw */ \
char moving; /* moving -> Incr != identity || updateproc != NULL */
typedef struct DObject {
OBJECTFIELDS
} DObject;
typedef struct DGeom {
OBJECTFIELDS
Geom *Inorm; /* Inst holding normalization transform */
Geom *Lgeom; /* List node holding pointer to user's Geom */
Geom *Lbbox; /* List node holding pointer to our Bbox */
char bboxdraw; /* boolean */
char everted; /* Normals everted on this geom */
char normalization; /* Normalization: NONE, EACH, or ALL */
char bboxvalid; /* bbox is valid */
int bezdice; /* Meshsize for diced up bezier patch */
int pickable; /* Is this Dgeom pickable ? */
Appearance *bboxap;
enum {ORDINARY, THEWORLD, ALIEN} citizenship;
TransformN *NDT, *NDTinv; /* N-D transform and its inverse; NULL for 3-D objects */
/* Ordinary DGeoms are subgeoms of Theworld DGeom.
* Theworld is the single DGeom containing the world transforms
* and all ordinary DGeoms.
* Alien DGeoms are in the Universe list but are not part of Theworld.
*/
} DGeom;
typedef struct DView {
OBJECTFIELDS
Handle *camhandle; /* Handle to above */
Camera *cam; /* The camera itself */
WnWindow *win; /* The (abstract) window */
short frozen; /* flag: frozen: Don't attempt to redraw this view */
short newcam; /* flag: need to mgreshapeviewport() */
mgcontext *mgctx; /* Window's mg context pointer */
int apseq; /* seq no: has global default changed? */
float lineznudge; /* millionths of Z-range by which lines lie closer
* than surfaces */
Color backcolor; /* Window background color */
int cameradraw; /* Do we draw cameras in this view? */
Geom *hsphere; /* hsphere at infy for use in hyp mode; when NULL
don't draw it, otherwise draw it */
int hmodel; /* model of hyperbollic space for this camera; value
is one of VIRTUAL, PROJECTIVE, CONFORMAL, and is
meaningful only when viewing hyperbolic geometry */
PFV extradraw; /* function to draw any extra stuff in this window */
int stereo; /* {NO,HORIZONTAL,VERTICAL}_KEYWORD: stereo style */
int stereogap; /* gap between subwindows in stereo mode */
WnPosition vp[2]; /* Subwindow viewports, if stereo != MONO */
mgshadefunc shader; /* Software shader function (NULL -> hardware) */
int NDPerm[4]; /* N-D -> 3-D axis permutation */
int nNDcmap;
cmap NDcmap[MAXCMAP]; /* N-D color map */
struct NDcam *cluster;/* to which cluster do we belong? NULL if not N-D */
} DView;
typedef struct NDcam {
char *name; /* camera-cluster name */
TransformN *C2W, *W2C; /* N-D camera-to-universe transform */
struct NDcam *next; /* next N-D camera */
} NDcam;
/*
* The array of DGeoms is a flat structure with pointers into the
* following OOGL hierarchy:
*
*
* drawerstate.universe --> LIST -------- LIST --- LIST... [rest of Aliens]
* | | |
* | INST INST
* | [Alien] [Alien]
* |
* drawerstate.world == dgeom[0]:
* |
* dgeom[0]->Item --> INST [world modelling xform]
* [Theworld]
* |
* dgeom[0]->Inorm --> INST [world normalizing xform]
* |
* dgeom[0]->Lgeom --> LIST ----- LIST --- ... [all ordinary DGeoms]
* [Ordinary] [Ordinary]
* |
* DGeom[x]:
* |
* INST (= Item) [modelling xform, appearance]
* |
* |
* INST (= Inorm) [normalization xform]
* |
* |
* LIST (= Lgeom) -------- LIST (= Lbbox)
* | |
* [user's Geom] [BBox of user's Geom, or NULL]
*
* Note that the world appearance is *not* dgeom[0]->Item->ap, which
* is always NULL.
* Changes to the world appearance are broadcast to all individual dgeoms.
* worldap is kept around in drawer.c to let the ui know how to
* set control panels when the world is the target.
*/
typedef struct DrawerState {
int pause; /* hiatus on emodule input? */
float lastupdate; /* Time (seconds since program began) of last xfm update */
DView defview; /* default DView */
WnPosition winpos; /* screen position of current mg context's window */
int normalization; /* NONE, EACH, KEEP, or ALL (default EACH) */
int space; /* TM_EUCLIDEAN, TM_HYPERBOLIC,
TM_SPHERICAL (default EUC) */
int changed; /* Flag: geom or camera or something changed,
* must redraw. */
Appearance * ap; /* Default appearance: backstop + .v.ap */
int apseq; /* Sequence number of default appearance;
* each drawer mg context should reexamine ap
* if drawerstate.apseq != view->apseq
*/
Geom * world; /* Everything in the world, including
* global modelling xform & appearance.
*/
Geom * universe; /* List of everything in the universe:
* world and aliens. */
int NDim; /* Dimension of all ND items */
NDcam *NDcams; /* List of all ND camera clusters, or NULL */
#ifdef MANIFOLD
#define MTMAX 500
#define DVMAX 50
Transform MT[MTMAX];/* manifold transforms */
int nMT; /* number of transforms actually in MT */
HPoint3 DV[DVMAX];/* vertices of manifold Dirichlet domain */
int nDV; /* number of vertices actually in DV */
float d1, i1;
#endif
float motionscale; /* set by user; used in scaling some
(not all) motions */
Geom *camgeom; /* Object used when drawing cameras */
int camproj; /* Apply camera's projection to it? */
/* drawerstate.world is the first node in drawerstate.universe
* dgeom[0]->Item == drawerstate.world
* dgeom[0]->Inorm is the child of the above
* dgeom[0]->Lgeom is the child of dgeom[0]->Inorm
*/
} DrawerState;
/*
* LOOPGEOMS(i,dg) loops over all defined geoms; for each defined
* geom, int i is the index in the dgeoms array, and DGeom *dg
* points to the geom. Usage:
* LOOPGEOMS(i,dg) {
* < body of loop --- use i and dg as needed >
* }
* Note we skip dgeom[0], since it's by definition the entire world.
*/
#define LOOPGEOMS(i,dg) \
for (i=1; i<dgeom_max; ++i) if ( (dg=dgeom[i]) != NULL)
/*
* LOOPSOMEGEOMS(i,dg,cit) is like LOOPGEOMS but only returns ordinary DGeoms
*/
#define LOOPSOMEGEOMS(i,dg,cit) \
for (i=1; i<dgeom_max; ++i) if ( (dg=dgeom[i]) && (dg->citizenship==cit) )
/*
* LOOPVIEWS(i,dv) is like LOOPGEOMS but for views.
*/
#define LOOPVIEWS(i,dv) \
for (i=0; i<dview_max; ++i) if ( (dv=dview[i]) != NULL)
/* Broadcast by looping the correct array if index == ALLINDEX
* else broadcast to all dgeoms that are not aliens if id == WORLDGEOM
* else don't go through loop at all if improper index
* else just go through for loop once if index is normal.
* Obj is set to correct value on each pass through the loop.
*
* int i is index in the dgeoms or views array,
* type is T_GEOM or T_CAM (or T_NONE if either is acceptable),
* and objtype *obj is set to successive elements in the dgeoms/views array.
*
* Usage:
* MAYBE_LOOP(id,i,type,objtype,obj) {
* < body of loop: use i and obj as needed >
* is set correctly on any given pass through the loop >
* }
*/
#define MAYBE_LOOP(id, i, type, objtype, obj) \
for(i = 0; obj = (objtype *)drawer_next_bcast(id, &i, type); i++)
#define MAYBE_LOOP_ALL(id, i, type, objtype, obj) \
for(i = 0; obj = (objtype *)drawer_next_object(id, &i, type); i++)
/*
* An ID encodes an index (int) and a type (cam or geom).
*/
#define T_NONE 0
#define T_GEOM 1
#define T_CAM 2
#define T_MAX 3 /* Max T_* value plus one */
#define GEOMID(i) ((i)<<2 | T_GEOM) /* Geometric object #i */
#define CAMID(i) ((i)<<2 | T_CAM) /* Camera #i */
#define NOID ((0)<<2 | T_NONE)
#define ID(type,i) ((i)<<2 | type)
#define ISGEOM(id) (((id) & 3) == T_GEOM)
#define ISCAM(id) (((id) & 3) == T_CAM)
#define ISTYPE(type,id) (((id) & 3) == type)
#define TYPEOF(id) ((id) & 3)
#define INDEXOF(id) ((id) >> 2)
#define ALLINDEX -1
#define WORLDGEOM GEOMID(0)
#define FOCUSID CAMID(-4)
/* these are not necessarily geoms! */
#define TARGETID GEOMID(-5) /* "current target" */
#define CENTERID GEOMID(-8) /* "current center" */
#define TARGETGEOMID GEOMID(-6) /* "current target geom" */
#define TARGETCAMID CAMID(-7) /* "current target cam" */
#define DEFAULTCAMID CAMID(-5)
#define SELF GEOMID(-9) /* "this geomview object" */
#define UNIVERSE GEOMID(-10) /* the universe (as coordinate system) */
#define PRIMITIVE GEOMID(-11) /* this picked OOGL primitive (coord system) */
#define ALLCAMS CAMID(ALLINDEX)
#define ALLGEOMS GEOMID(ALLINDEX)
/* models of hyperbolic space; these must start with 0 and be
consecutive because they are used as indices in the browser */
typedef enum {
VIRTUAL=0,
PROJECTIVE,
CONFORMALBALL
} HModelValue;
typedef enum {
DRAWER_NEAR,
DRAWER_FAR,
DRAWER_FOV,
DRAWER_FOCALLENGTH,
DRAWER_KA,
DRAWER_KS,
DRAWER_KD,
DRAWER_SHININESS,
DRAWER_NORMSCALE,
DRAWER_LIGHT_INTENSITY,
DRAWER_LINE_ZNUDGE,
DRAWER_FACEDRAW,
DRAWER_EDGEDRAW,
DRAWER_VECTDRAW,
DRAWER_NORMALDRAW,
DRAWER_SHADING,
DRAWER_LINEWIDTH,
DRAWER_PERSPECTIVE,
DRAWER_EVERT,
DRAWER_BBOXDRAW,
DRAWER_NORMALIZATION,
DRAWER_SAVE,
DRAWER_PROJECTION,
DRAWER_BEZDICE,
DRAWER_CAMERADRAW,
DRAWER_PICKABLE,
DRAWER_HSPHERE,
DRAWER_DOUBLEBUFFER,
DRAWER_APOVERRIDE,
DRAWER_DIFFUSE,
DRAWER_EDGECOLOR,
DRAWER_NORMALCOLOR,
DRAWER_BBOXCOLOR,
DRAWER_BACKCOLOR,
DRAWER_LIGHTCOLOR,
DRAWER_TRANSPARENT,
DRAWER_ALPHA,
DRAWER_INERTIA,
DRAWER_CONSTRAIN,
DRAWER_OWNMOTION
} DrawerKeyword;
extern DView ** dview;
extern DGeom ** dgeom;
extern DrawerState drawerstate;
extern int dgeom_max;
extern int dview_max;
extern TransformStruct ts_identity;
DObject * drawer_get_object( int id );/* Get DObject * for object 'id' */
DObject * drawer_next_object( int id, int *indexp, int type );
DObject *drawer_next_bcast( int id, int *indexp, int type );
Appearance * drawer_get_ap( int id ); /* Get net appearance for DGeom 'id' */
int drawer_geom_count();
int drawer_cam_count();
int drawer_idbyctx( mgcontext *ctx );
int drawer_moving(); /* is anything (DGeom, DView) moving? */
int drawer_idbyname(char *name);
char *drawer_id2name(int id);
int drawer_name2metaid(char *name);
int drawer_objok(int id, int type);
int drawer_pick( int id, int x, int y, Pick *pick);
void drawer_init(char *apdefault, char *camgeometry, char *windefault);
void drawer_merge_baseap( ApStruct *as );
void drawer_merge_camera( int id, Camera *cam );
void drawer_merge_window( int id, WnWindow *win );
void drawer_name_object(int id, int ni, char *name);
void drawer_updateproc(int id, PFI func);
void drawer_center(int id);
void drawer_stop(int id);
void drawer_pause(int pause);
void drawer_set_window(int id, WnWindow *win);
void drawer_snap_window(int id, char *fname);
void drawer_init_dgeom(DGeom *dg, int id, int citizenship);
void drawer_nuke_world();
void drawer_nuke_cameras(int keepzero);
void drawer_get_transform(int id, Transform T, int cumulative);
int drawer_idmatch(int id1, int id2);
mgshadefunc softshader(int camid);
void drawer_float(int id, DrawerKeyword key, float fval);
/* key = DRAWER_NEAR, DRAWER_FAR, DRAWER_KA, DRAWER_KS,
DRAWER_KD, DRAWER_SHININESS, DRAWER_NORMSCALE,
DRAWER_LIGHT_INTENSITY */
void drawer_int(int id, DrawerKeyword key, int ival);
/* key = DRAWER_FACEDRAW, DRAWER_EDGEDRAW, DRAWER_NORMALDRAW,
DRAWER_SHADING, DRAWER_LINEWIDTH, DRAWER_PERSPECTIVE,
DRAWER_EVERT, DRAWER_BEZDICE, DRAWER_NORMALIZATION,
DRAWER_CAMERADRAW */
void drawer_color(int id, DrawerKeyword key, Color *col);
/* key = DRAWER_DIFFUSE, DRAWER_EDGECOLOR, DRAWER_NORMALCOLOR,
DRAWER_BBOXCOLOR, DRAWER_BACKCOLOR */
float scaleof(int id);
int spaceof(int id);
extern int hmodelkeyword(char *s, int val);
void drawer_set_ap(int id, Handle *h, Appearance *ap);
#ifdef MANIFOLD
int drawer_read_manifold(char *file);
#endif /* MANIFOLD */
#endif /* ! _DRAWER_H_ */
These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.