| 1 |
/* RCSid $Id: objutil.h,v 2.16 2021/04/23 18:31:45 greg Exp $ */ |
| 2 |
/* |
| 3 |
* Declarations for .OBJ file utility |
| 4 |
* |
| 5 |
* Include after <stdio.h> |
| 6 |
* |
| 7 |
* Created by Greg Ward on Wed Feb 11 2004. |
| 8 |
*/ |
| 9 |
|
| 10 |
#ifndef _OBJUTIL_H_ |
| 11 |
#define _OBJUTIL_H_ |
| 12 |
|
| 13 |
#ifdef __cplusplus |
| 14 |
extern "C" { |
| 15 |
#endif |
| 16 |
|
| 17 |
#ifndef DUP_CHECK_REVERSE |
| 18 |
#define DUP_CHECK_REVERSE 1 /* eliminate flipped duplicates */ |
| 19 |
#endif |
| 20 |
#ifndef POPEN_SUPPORT |
| 21 |
#define POPEN_SUPPORT 1 /* support "!command" i/o */ |
| 22 |
#endif |
| 23 |
/* face flags */ |
| 24 |
#define FACE_DEGENERATE 01 |
| 25 |
#define FACE_DUPLICATE 02 |
| 26 |
#define FACE_SELECTED 04 |
| 27 |
#define FACE_CUSTOM(n) (FACE_SELECTED<<(n)) |
| 28 |
#define FACE_RESERVED (1<<15) |
| 29 |
|
| 30 |
struct Face; /* forward declaration */ |
| 31 |
|
| 32 |
typedef int VNDX[3]; /* vertex indices (point,map,normal) */ |
| 33 |
|
| 34 |
/* Structure to hold vertex indices and link back to face list */ |
| 35 |
typedef struct { |
| 36 |
int vid; /* vertex id */ |
| 37 |
int tid; /* texture id */ |
| 38 |
int nid; /* normal id */ |
| 39 |
struct Face *fnext; /* next in vertex face list */ |
| 40 |
} VertEnt; |
| 41 |
|
| 42 |
/* Structure to hold face and its vertex references */ |
| 43 |
typedef struct Face { |
| 44 |
struct Face *next; /* next face in main list */ |
| 45 |
short flags; /* face selected, etc */ |
| 46 |
short nv; /* number of vertices */ |
| 47 |
short grp; /* group/object index */ |
| 48 |
short mat; /* material index */ |
| 49 |
/* in cases where the same vertex appears twice, first has link */ |
| 50 |
VertEnt v[3]; /* vertex list (extends struct) */ |
| 51 |
} Face; |
| 52 |
|
| 53 |
/* Structure to hold vertex */ |
| 54 |
typedef struct { |
| 55 |
double p[3]; /* 3-D position */ |
| 56 |
Face *vflist; /* linked face list (no repeats) */ |
| 57 |
} Vertex; |
| 58 |
|
| 59 |
/* Structure to hold texture coordinate */ |
| 60 |
typedef struct { |
| 61 |
float u, v; /* 2-D local texture coordinate */ |
| 62 |
} TexCoord; |
| 63 |
|
| 64 |
/* Array to hold surface normal */ |
| 65 |
typedef float Normal[3]; |
| 66 |
|
| 67 |
/* Structure to hold a loaded .OBJ file */ |
| 68 |
typedef struct { |
| 69 |
char **descr; /* descriptive comments */ |
| 70 |
int ndescr; /* number of comments */ |
| 71 |
char **grpname; /* object/group name list */ |
| 72 |
int ngrps; /* number of group names */ |
| 73 |
int lastgrp; /* last group seen */ |
| 74 |
char **matname; /* material name list */ |
| 75 |
int nmats; /* number of materials */ |
| 76 |
int lastmat; /* last material seen */ |
| 77 |
Vertex *vert; /* vertex array */ |
| 78 |
int nverts; /* number of vertices */ |
| 79 |
TexCoord *tex; /* texture coordinate array */ |
| 80 |
int ntex; /* number of texture coord's */ |
| 81 |
Normal *norm; /* surface normal array */ |
| 82 |
int nnorms; /* number of surface normals */ |
| 83 |
Face *flist; /* linked face list */ |
| 84 |
int nfaces; /* count of faces */ |
| 85 |
} Scene; |
| 86 |
|
| 87 |
/* Allocate a new scene holder */ |
| 88 |
extern Scene * newScene(void); |
| 89 |
|
| 90 |
/* Add a .OBJ file to a scene */ |
| 91 |
extern Scene * loadOBJ(Scene *sc, const char *fspec); |
| 92 |
|
| 93 |
/* Duplicate a scene, optionally selecting faces */ |
| 94 |
extern Scene * dupScene(const Scene *sc, int flreq, int flexc); |
| 95 |
|
| 96 |
/* Add one scene to another, not checking for redundancies */ |
| 97 |
extern int addScene(Scene *scdst, const Scene *scsrc); |
| 98 |
|
| 99 |
/* Transform entire scene */ |
| 100 |
extern int xfScene(Scene *sc, int xac, char *xav[]); |
| 101 |
extern int xfmScene(Scene *sc, const char *xfm); |
| 102 |
|
| 103 |
/* Add a descriptive comment */ |
| 104 |
extern void addComment(Scene *sc, const char *comment); |
| 105 |
|
| 106 |
/* Find index for comment containing the given string (starting from n) */ |
| 107 |
extern int findComment(Scene *sc, const char *match, int n); |
| 108 |
|
| 109 |
/* Clear comments */ |
| 110 |
extern void clearComments(Scene *sc); |
| 111 |
|
| 112 |
/* Write a .OBJ file, return # faces written or -1 on error */ |
| 113 |
extern int toOBJ(Scene *sc, FILE *fp); |
| 114 |
extern int writeOBJ(Scene *sc, const char *fspec); |
| 115 |
|
| 116 |
/* Convert indicated faces to Radiance, return # written or -1 on error */ |
| 117 |
extern int toRadiance(Scene *sc, FILE *fp, int flreq, int flexc); |
| 118 |
extern int writeRadiance(Scene *sc, const char *fspec, |
| 119 |
int flreq, int flexc); |
| 120 |
|
| 121 |
/* Compute face area (and normal) */ |
| 122 |
extern double faceArea(const Scene *sc, const Face *f, Normal nrm); |
| 123 |
|
| 124 |
/* Eliminate duplicate vertices, return # joined */ |
| 125 |
extern int coalesceVertices(Scene *sc, double eps); |
| 126 |
|
| 127 |
/* Identify duplicate faces */ |
| 128 |
extern int findDuplicateFaces(Scene *sc); |
| 129 |
|
| 130 |
/* Delete indicated faces, return # deleted */ |
| 131 |
extern int deleteFaces(Scene *sc, int flreq, int flexc); |
| 132 |
|
| 133 |
/* Clear face selection */ |
| 134 |
extern void clearSelection(Scene *sc, int set); |
| 135 |
|
| 136 |
/* Invert face selection */ |
| 137 |
extern void invertSelection(Scene *sc); |
| 138 |
|
| 139 |
/* Count number of faces selected */ |
| 140 |
extern int numberSelected(Scene *sc); |
| 141 |
|
| 142 |
/* Select faces by object name (modifies current) */ |
| 143 |
extern void selectGroup(Scene *sc, const char *gname, int invert); |
| 144 |
|
| 145 |
/* Select faces by material name (modifies current) */ |
| 146 |
extern void selectMaterial(Scene *sc, const char *mname, int invert); |
| 147 |
|
| 148 |
/* Execute callback on indicated faces */ |
| 149 |
extern int foreachFace(Scene *sc, int (*cb)(Scene *, Face *, void *), |
| 150 |
int flreq, int flexc, void *c_data); |
| 151 |
|
| 152 |
/* Remove texture coordinates from the indicated faces */ |
| 153 |
extern int removeTexture(Scene *sc, int flreq, int flexc); |
| 154 |
|
| 155 |
/* Remove surface normals from the indicated faces */ |
| 156 |
extern int removeNormals(Scene *sc, int flreq, int flexc); |
| 157 |
|
| 158 |
/* Change group for the indicated faces */ |
| 159 |
extern int changeGroup(Scene *sc, const char *gname, |
| 160 |
int flreq, int flexc); |
| 161 |
|
| 162 |
/* Change material for the indicated faces */ |
| 163 |
extern int changeMaterial(Scene *sc, const char *mname, |
| 164 |
int flreq, int flexc); |
| 165 |
|
| 166 |
/* Add a vertex to our scene, returning index */ |
| 167 |
extern int addVertex(Scene *sc, double x, double y, double z); |
| 168 |
|
| 169 |
/* Add a texture coordinate to our scene, returning index */ |
| 170 |
extern int addTexture(Scene *sc, double u, double v); |
| 171 |
|
| 172 |
/* Add a surface normal to our scene, returning index */ |
| 173 |
extern int addNormal(Scene *sc, double xn, double yn, double zn); |
| 174 |
|
| 175 |
/* Set current group (sc->lastgrp) to given ID */ |
| 176 |
extern void setGroup(Scene *sc, const char *nm); |
| 177 |
|
| 178 |
/* Set current material (sc->lastmat) to given ID */ |
| 179 |
extern void setMaterial(Scene *sc, const char *nm); |
| 180 |
|
| 181 |
/* Add a new face to our scene, using current group and material */ |
| 182 |
extern Face * addFace(Scene *sc, VNDX vid[], int nv); |
| 183 |
|
| 184 |
/* Get neighbor vertices: malloc array with valence in index[0] */ |
| 185 |
extern int * getVertexNeighbors(Scene *sc, int vid); |
| 186 |
|
| 187 |
/* Expand bounding box min & max (initialize bbox to all zeroes) */ |
| 188 |
extern int growBoundingBox(Scene *sc, double bbox[2][3], |
| 189 |
int flreq, int flexc); |
| 190 |
|
| 191 |
/* Convert all faces with > 3 vertices to triangles */ |
| 192 |
extern int triangulateScene(Scene *sc); |
| 193 |
|
| 194 |
/* Delete unreferenced vertices, normals, texture coords */ |
| 195 |
extern void deleteUnreferenced(Scene *sc); |
| 196 |
|
| 197 |
/* Free a scene */ |
| 198 |
extern void freeScene(Scene *sc); |
| 199 |
|
| 200 |
/* Find an existing name in a list of names */ |
| 201 |
extern int findName(const char *nm, const char **nmlist, int n); |
| 202 |
|
| 203 |
/* Verbose mode global */ |
| 204 |
extern int verbose; |
| 205 |
|
| 206 |
extern char *emalloc(unsigned int n); |
| 207 |
extern char *ecalloc(unsigned int ne, unsigned int n); |
| 208 |
extern char *erealloc(char *cp, unsigned int n); |
| 209 |
extern void efree(char *cp); |
| 210 |
|
| 211 |
#define getGroupID(sc,nm) findName(nm, (const char **)(sc)->grpname, (sc)->ngrps) |
| 212 |
#define getMaterialID(sc,nm) findName(nm, (const char **)(sc)->matname, (sc)->nmats) |
| 213 |
|
| 214 |
#define CHUNKBITS 7 /* object allocation chunk bits */ |
| 215 |
#define CHUNKSIZ (1<<CHUNKBITS) /* object allocation chunk size */ |
| 216 |
|
| 217 |
#define chunk_alloc(typ, arr, nold) \ |
| 218 |
((nold)&(CHUNKSIZ-1) ? (arr) : \ |
| 219 |
(typ *)erealloc(arr, sizeof(typ)*((nold)+CHUNKSIZ))) |
| 220 |
|
| 221 |
#ifdef __cplusplus |
| 222 |
} |
| 223 |
#endif |
| 224 |
|
| 225 |
#endif /* ! _OBJUTIL_H_ */ |
