src/util/dctimestep.c

#ifndef lint
static const char RCSid[] = "$Id: dctimestep.c,v 2.34 2014/09/17 22:40:49 greg Exp $";
#endif
/*
 * Compute time-step result using Daylight Coefficient method.
 *
 *      G. Ward
 */

#include <ctype.h>
#include "standard.h"
#include "cmatrix.h"
#include "platform.h"
#include "resolu.h"

char    *progname;                      /* global argv[0] */

/* Sum together a set of images and write result to fout */
static int
sum_images(const char *fspec, const CMATRIX *cv, FILE *fout)
{
        int     myDT = DTfromHeader;
        COLOR   *scanline = NULL;
        CMATRIX *pmat = NULL;
        int     myXR=0, myYR=0;
        int     i, y;

        if (cv->ncols != 1)
                error(INTERNAL, "expected vector in sum_images()");
        for (i = 0; i < cv->nrows; i++) {
                const COLORV    *scv = cv_lval(cv,i);
                char            fname[1024];
                FILE            *fp;
                int             dt, xr, yr;
                COLORV          *psp;
                char            *err;
                                                        /* check for zero */
                if ((scv[RED] == 0) & (scv[GRN] == 0) & (scv[BLU] == 0) &&
                                (myDT != DTfromHeader) | (i < cv->nrows-1))
                        continue;
                                                        /* open next picture */
                sprintf(fname, fspec, i);
                if ((fp = fopen(fname, "rb")) == NULL) {
                        sprintf(errmsg, "cannot open picture '%s'", fname);
                        error(SYSTEM, errmsg);
                }
                dt = DTfromHeader;
                if ((err = cm_getheader(&dt, NULL, NULL, fp)) != NULL)
                        error(USER, err);
                if ((dt != DTrgbe) & (dt != DTxyze) ||
                                !fscnresolu(&xr, &yr, fp)) {
                        sprintf(errmsg, "file '%s' not a picture", fname);
                        error(USER, errmsg);
                }
                if (myDT == DTfromHeader) {             /* on first one */
                        myDT = dt;
                        myXR = xr; myYR = yr;
                        scanline = (COLOR *)malloc(sizeof(COLOR)*myXR);
                        if (scanline == NULL)
                                error(SYSTEM, "out of memory in sum_images()");
                        pmat = cm_alloc(myYR, myXR);
                        memset(pmat->cmem, 0, sizeof(COLOR)*myXR*myYR);
                                                        /* finish header */
                        fputformat((char *)cm_fmt_id[myDT], fout);
                        fputc('\n', fout);
                        fflush(fout);
                } else if ((dt != myDT) | (xr != myXR) | (yr != myYR)) {
                        sprintf(errmsg, "picture '%s' format/size mismatch",
                                        fname);
                        error(USER, errmsg);
                }
                psp = pmat->cmem;
                for (y = 0; y < yr; y++) {              /* read it in */
                        int     x;
                        if (freadscan(scanline, xr, fp) < 0) {
                                sprintf(errmsg, "error reading picture '%s'",
                                                fname);
                                error(SYSTEM, errmsg);
                        }
                                                        /* sum in scanline */
                        for (x = 0; x < xr; x++, psp += 3) {
                                multcolor(scanline[x], scv);
                                addcolor(psp, scanline[x]);
                        }
                }
                fclose(fp);                             /* done this picture */
        }
        free(scanline);
        i = cm_write(pmat, myDT, fout);                 /* write picture */
        cm_free(pmat);                                  /* free data */
        return(i);
}

/* check to see if a string contains a %d or %o specification */
static int
hasNumberFormat(const char *s)
{
        if (s == NULL)
                return(0);

        while (*s) {
                while (*s != '%')
                        if (!*s++)
                                return(0);
                if (*++s == '%') {              /* ignore "%%" */
                        ++s;
                        continue;
                }
                while (isdigit(*s))             /* field length */
                        ++s;
                                                /* field we'll use? */
                if ((*s == 'd') | (*s == 'i') | (*s == 'o') |
                                        (*s == 'x') | (*s == 'X'))
                        return(1);
        }
        return(0);                              /* didn't find one */
}

int
main(int argc, char *argv[])
{
        int             skyfmt = DTfromHeader;
        int             outfmt = DTascii;
        int             headout = 1;
        int             nsteps = 0;
        char            *ofspec = NULL;
        FILE            *ofp = stdout;
        CMATRIX         *cmtx;          /* component vector/matrix result */
        char            fnbuf[256];
        int             a, i;

        progname = argv[0];
                                        /* get options */
        for (a = 1; a < argc && argv[a][0] == '-'; a++)
                switch (argv[a][1]) {
                case 'n':
                        nsteps = atoi(argv[++a]);
                        if (nsteps < 0)
                                goto userr;
                        skyfmt = nsteps ? DTascii : DTfromHeader;
                        break;
                case 'h':
                        headout = !headout;
                        break;
                case 'i':
                        switch (argv[a][2]) {
                        case 'f':
                                skyfmt = DTfloat;
                                break;
                        case 'd':
                                skyfmt = DTdouble;
                                break;
                        case 'a':
                                skyfmt = DTascii;
                                break;
                        default:
                                goto userr;
                        }
                        break;
                case 'o':
                        switch (argv[a][2]) {
                        case '\0':      /* output specification (not format) */
                                ofspec = argv[++a];
                                break;
                        case 'f':
                                outfmt = DTfloat;
                                break;
                        case 'd':
                                outfmt = DTdouble;
                                break;
                        case 'a':
                                outfmt = DTascii;
                                break;
                        default:
                                goto userr;
                        }
                        break;
                default:
                        goto userr;
                }
        if ((argc-a < 1) | (argc-a > 4))
                goto userr;

        if (argc-a > 2) {                       /* VTDs expression */
                CMATRIX *smtx, *Dmat, *Tmat, *imtx;
                                                /* get sky vector/matrix */
                smtx = cm_load(argv[a+3], 0, nsteps, skyfmt);
                nsteps = smtx->ncols;
                                                /* load BSDF */
                Tmat = cm_loadBTDF(argv[a+1]);
                                                /* load Daylight matrix */
                Dmat = cm_load(argv[a+2], Tmat==NULL ? 0 : Tmat->ncols,
                                        smtx->nrows, DTfromHeader);
                                                /* multiply vector through */
                imtx = cm_multiply(Dmat, smtx);
                cm_free(Dmat); cm_free(smtx);
                cmtx = cm_multiply(Tmat, imtx);
                cm_free(Tmat); 
                cm_free(imtx);
        } else {                                /* sky vector/matrix only */
                cmtx = cm_load(argv[a+1], 0, nsteps, skyfmt);
                nsteps = cmtx->ncols;
        }
                                                /* prepare output stream */
        if ((ofspec != NULL) & (nsteps == 1) && hasNumberFormat(ofspec)) {
                sprintf(fnbuf, ofspec, 1);
                ofspec = fnbuf;
        }
        if (ofspec != NULL && !hasNumberFormat(ofspec)) {
                if ((ofp = fopen(ofspec, "w")) == NULL) {
                        fprintf(stderr, "%s: cannot open '%s' for output\n",
                                        progname, ofspec);
                        return(1);
                }
                ofspec = NULL;                  /* only need to open once */
        }
        if (hasNumberFormat(argv[a])) {         /* generating image(s) */
                if (ofspec == NULL) {
                        SET_FILE_BINARY(ofp);
                        newheader("RADIANCE", ofp);
                        printargs(argc, argv, ofp);
                        fputnow(ofp);
                }
                if (nsteps > 1)                 /* multiple output frames? */
                        for (i = 0; i < nsteps; i++) {
                                CMATRIX *cvec = cm_column(cmtx, i);
                                if (ofspec != NULL) {
                                        sprintf(fnbuf, ofspec, i+1);
                                        if ((ofp = fopen(fnbuf, "wb")) == NULL) {
                                                fprintf(stderr,
                                        "%s: cannot open '%s' for output\n",
                                                        progname, fnbuf);
                                                return(1);
                                        }
                                        newheader("RADIANCE", ofp);
                                        printargs(argc, argv, ofp);
                                        fputnow(ofp);
                                }
                                fprintf(ofp, "FRAME=%d\n", i+1);
                                if (!sum_images(argv[a], cvec, ofp))
                                        return(1);
                                if (ofspec != NULL) {
                                        if (fclose(ofp) == EOF) {
                                                fprintf(stderr,
                                                "%s: error writing to '%s'\n",
                                                        progname, fnbuf);
                                                return(1);
                                        }
                                        ofp = stdout;
                                }
                                cm_free(cvec);
                        }
                else if (!sum_images(argv[a], cmtx, ofp))
                        return(1);
        } else {                                /* generating vector/matrix */
                CMATRIX *Vmat = cm_load(argv[a], 0, cmtx->nrows, DTfromHeader);
                CMATRIX *rmtx = cm_multiply(Vmat, cmtx);
                cm_free(Vmat);
                if (ofspec != NULL) {           /* multiple vector files? */
                        const char      *wtype = (outfmt==DTascii) ? "w" : "wb";
                        for (i = 0; i < nsteps; i++) {
                                CMATRIX *rvec = cm_column(rmtx, i);
                                sprintf(fnbuf, ofspec, i+1);
                                if ((ofp = fopen(fnbuf, wtype)) == NULL) {
                                        fprintf(stderr,
                                        "%s: cannot open '%s' for output\n",
                                                        progname, fnbuf);
                                        return(1);
                                }
#ifdef getc_unlocked
                                flockfile(ofp);
#endif
                                if (headout) {  /* header output */
                                        newheader("RADIANCE", ofp);
                                        printargs(argc, argv, ofp);
                                        fputnow(ofp);
                                        fprintf(ofp, "FRAME=%d\n", i+1);
                                        fprintf(ofp, "NROWS=%d\n", rvec->nrows);
                                        fputs("NCOLS=1\nNCOMP=3\n", ofp);
                                        fputformat((char *)cm_fmt_id[outfmt], ofp);
                                        fputc('\n', ofp);
                                }
                                cm_write(rvec, outfmt, ofp);
                                if (fclose(ofp) == EOF) {
                                        fprintf(stderr,
                                                "%s: error writing to '%s'\n",
                                                        progname, fnbuf);
                                        return(1);
                                }
                                ofp = stdout;
                                cm_free(rvec);
                        }
                } else {
#ifdef getc_unlocked
                        flockfile(ofp);
#endif
                        if (outfmt != DTascii)
                                SET_FILE_BINARY(ofp);
                        if (headout) {          /* header output */
                                newheader("RADIANCE", ofp);
                                printargs(argc, argv, ofp);
                                fputnow(ofp);
                                fprintf(ofp, "NROWS=%d\n", rmtx->nrows);
                                fprintf(ofp, "NCOLS=%d\n", rmtx->ncols);
                                fputs("NCOMP=3\n", ofp);
                                fputformat((char *)cm_fmt_id[outfmt], ofp);
                                fputc('\n', ofp);
                        }
                        cm_write(rmtx, outfmt, ofp);
                }
                cm_free(rmtx);
        }
        if (fflush(ofp) == EOF) {               /* final clean-up */
                fprintf(stderr, "%s: write error on output\n", progname);
                return(1);
        }
        cm_free(cmtx);
        return(0);
userr:
        fprintf(stderr, "Usage: %s [-n nsteps][-o ospec][-i{f|d|h}][-o{f|d}] DCspec [skyf]\n",
                                progname);
        fprintf(stderr, "   or: %s [-n nsteps][-o ospec][-i{f|d|h}][-o{f|d}] Vspec Tbsdf.xml Dmat.dat [skyf]\n",
                                progname);
        return(1);
}
Revision:	2.35
Committed:	Fri Sep 26 23:33:09 2014 UTC (11 years, 1 month ago) by greg
Content type:	text/plain
Branch:	MAIN
CVS Tags:	rad4R2P2
Changes since 2.34:	+4 -2 lines
Log Message:	Fixed bug in handling of sky matrices with default -n 0
#	User	Rev	Content
1	greg	2.1	#ifndef lint
2	greg	2.35	static const char RCSid[] = "$Id: dctimestep.c,v 2.34 2014/09/17 22:40:49 greg Exp $";
3	greg	2.1	#endif
4			/*
5			* Compute time-step result using Daylight Coefficient method.
6			*
7			* G. Ward
8			*/
9
10			#include <ctype.h>
11			#include "standard.h"
12	greg	2.28	#include "cmatrix.h"
13	greg	2.1	#include "platform.h"
14			#include "resolu.h"
15
16			char progname; / global argv[0] */
17
18	greg	2.24	/* Sum together a set of images and write result to fout */
19	greg	2.1	static int
20	greg	2.13	sum_images(const char fspec, const CMATRIX cv, FILE *fout)
21	greg	2.1	{
22			int myDT = DTfromHeader;
23	greg	2.24	COLOR *scanline = NULL;
24			CMATRIX *pmat = NULL;
25			int myXR=0, myYR=0;
26	greg	2.1	int i, y;
27
28			if (cv->ncols != 1)
29	greg	2.35	error(INTERNAL, "expected vector in sum_images()");
30	greg	2.1	for (i = 0; i < cv->nrows; i++) {
31			const COLORV *scv = cv_lval(cv,i);
32			char fname[1024];
33			FILE *fp;
34			int dt, xr, yr;
35			COLORV *psp;
36	greg	2.31	char *err;
37	greg	2.14	/* check for zero */
38	greg	2.19	if ((scv[RED] == 0) & (scv[GRN] == 0) & (scv[BLU] == 0) &&
39			(myDT != DTfromHeader) \| (i < cv->nrows-1))
40	greg	2.14	continue;
41	greg	2.1	/* open next picture */
42			sprintf(fname, fspec, i);
43	greg	2.31	if ((fp = fopen(fname, "rb")) == NULL) {
44	greg	2.1	sprintf(errmsg, "cannot open picture '%s'", fname);
45			error(SYSTEM, errmsg);
46			}
47	greg	2.31	dt = DTfromHeader;
48			if ((err = cm_getheader(&dt, NULL, NULL, fp)) != NULL)
49			error(USER, err);
50	greg	2.1	if ((dt != DTrgbe) & (dt != DTxyze) \|\|
51			!fscnresolu(&xr, &yr, fp)) {
52			sprintf(errmsg, "file '%s' not a picture", fname);
53			error(USER, errmsg);
54			}
55			if (myDT == DTfromHeader) { /* on first one */
56			myDT = dt;
57			myXR = xr; myYR = yr;
58			scanline = (COLOR )malloc(sizeof(COLOR)myXR);
59			if (scanline == NULL)
60			error(SYSTEM, "out of memory in sum_images()");
61			pmat = cm_alloc(myYR, myXR);
62			memset(pmat->cmem, 0, sizeof(COLOR)myXRmyYR);
63	greg	2.2	/* finish header */
64	greg	2.30	fputformat((char *)cm_fmt_id[myDT], fout);
65	greg	2.13	fputc('\n', fout);
66			fflush(fout);
67	greg	2.1	} else if ((dt != myDT) \| (xr != myXR) \| (yr != myYR)) {
68			sprintf(errmsg, "picture '%s' format/size mismatch",
69			fname);
70			error(USER, errmsg);
71			}
72			psp = pmat->cmem;
73			for (y = 0; y < yr; y++) { /* read it in */
74			int x;
75			if (freadscan(scanline, xr, fp) < 0) {
76			sprintf(errmsg, "error reading picture '%s'",
77			fname);
78			error(SYSTEM, errmsg);
79			}
80			/* sum in scanline */
81			for (x = 0; x < xr; x++, psp += 3) {
82			multcolor(scanline[x], scv);
83			addcolor(psp, scanline[x]);
84			}
85			}
86			fclose(fp); /* done this picture */
87			}
88			free(scanline);
89	greg	2.30	i = cm_write(pmat, myDT, fout); /* write picture */
90			cm_free(pmat); /* free data */
91			return(i);
92	greg	2.1	}
93
94	greg	2.11	/* check to see if a string contains a %d or %o specification */
95			static int
96			hasNumberFormat(const char *s)
97	greg	2.1	{
98	greg	2.24	if (s == NULL)
99			return(0);
100
101	greg	2.18	while (*s) {
102			while (*s != '%')
103			if (!*s++)
104			return(0);
105			if (++s == '%') { / ignore "%%" */
106			++s;
107			continue;
108			}
109			while (isdigit(s)) / field length */
110			++s;
111			/* field we'll use? */
112			if ((s == 'd') \| (s == 'i') \| (*s == 'o') \|
113			(s == 'x') \| (s == 'X'))
114			return(1);
115			}
116			return(0); /* didn't find one */
117	greg	2.1	}
118
119			int
120			main(int argc, char *argv[])
121			{
122	greg	2.34	int skyfmt = DTfromHeader;
123	greg	2.30	int outfmt = DTascii;
124	greg	2.34	int headout = 1;
125			int nsteps = 0;
126	greg	2.24	char *ofspec = NULL;
127			FILE *ofp = stdout;
128			CMATRIX cmtx; / component vector/matrix result */
129			char fnbuf[256];
130			int a, i;
131	greg	2.1
132			progname = argv[0];
133	greg	2.24	/* get options */
134	greg	2.25	for (a = 1; a < argc && argv[a][0] == '-'; a++)
135			switch (argv[a][1]) {
136	greg	2.24	case 'n':
137			nsteps = atoi(argv[++a]);
138	greg	2.31	if (nsteps < 0)
139	greg	2.24	goto userr;
140	greg	2.34	skyfmt = nsteps ? DTascii : DTfromHeader;
141			break;
142			case 'h':
143			headout = !headout;
144	greg	2.24	break;
145	greg	2.25	case 'i':
146			switch (argv[a][2]) {
147			case 'f':
148			skyfmt = DTfloat;
149			break;
150			case 'd':
151			skyfmt = DTdouble;
152			break;
153			case 'a':
154			skyfmt = DTascii;
155			break;
156			default:
157			goto userr;
158			}
159			break;
160	greg	2.30	case 'o':
161			switch (argv[a][2]) {
162			case '\0': /* output specification (not format) */
163			ofspec = argv[++a];
164			break;
165			case 'f':
166			outfmt = DTfloat;
167			break;
168			case 'd':
169			outfmt = DTdouble;
170			break;
171			case 'a':
172			outfmt = DTascii;
173			break;
174			default:
175			goto userr;
176			}
177			break;
178	greg	2.24	default:
179			goto userr;
180			}
181			if ((argc-a < 1) \| (argc-a > 4))
182			goto userr;
183	greg	2.1
184	greg	2.24	if (argc-a > 2) { /* VTDs expression */
185			CMATRIX smtx, Dmat, Tmat, imtx;
186			/* get sky vector/matrix */
187	greg	2.25	smtx = cm_load(argv[a+3], 0, nsteps, skyfmt);
188	greg	2.35	nsteps = smtx->ncols;
189	greg	2.12	/* load BSDF */
190	greg	2.29	Tmat = cm_loadBTDF(argv[a+1]);
191	greg	2.5	/* load Daylight matrix */
192	greg	2.24	Dmat = cm_load(argv[a+2], Tmat==NULL ? 0 : Tmat->ncols,
193			smtx->nrows, DTfromHeader);
194	greg	2.1	/* multiply vector through */
195	greg	2.24	imtx = cm_multiply(Dmat, smtx);
196			cm_free(Dmat); cm_free(smtx);
197	greg	2.29	cmtx = cm_multiply(Tmat, imtx);
198			cm_free(Tmat);
199	greg	2.24	cm_free(imtx);
200			} else { /* sky vector/matrix only */
201	greg	2.25	cmtx = cm_load(argv[a+1], 0, nsteps, skyfmt);
202	greg	2.35	nsteps = cmtx->ncols;
203	greg	2.24	}
204			/* prepare output stream */
205			if ((ofspec != NULL) & (nsteps == 1) && hasNumberFormat(ofspec)) {
206			sprintf(fnbuf, ofspec, 1);
207			ofspec = fnbuf;
208			}
209			if (ofspec != NULL && !hasNumberFormat(ofspec)) {
210			if ((ofp = fopen(ofspec, "w")) == NULL) {
211			fprintf(stderr, "%s: cannot open '%s' for output\n",
212			progname, ofspec);
213			return(1);
214			}
215			ofspec = NULL; /* only need to open once */
216	greg	2.12	}
217	greg	2.24	if (hasNumberFormat(argv[a])) { /* generating image(s) */
218			if (ofspec == NULL) {
219			SET_FILE_BINARY(ofp);
220			newheader("RADIANCE", ofp);
221			printargs(argc, argv, ofp);
222			fputnow(ofp);
223			}
224			if (nsteps > 1) /* multiple output frames? */
225			for (i = 0; i < nsteps; i++) {
226			CMATRIX *cvec = cm_column(cmtx, i);
227			if (ofspec != NULL) {
228			sprintf(fnbuf, ofspec, i+1);
229			if ((ofp = fopen(fnbuf, "wb")) == NULL) {
230			fprintf(stderr,
231			"%s: cannot open '%s' for output\n",
232			progname, fnbuf);
233			return(1);
234			}
235			newheader("RADIANCE", ofp);
236			printargs(argc, argv, ofp);
237			fputnow(ofp);
238			}
239			fprintf(ofp, "FRAME=%d\n", i+1);
240			if (!sum_images(argv[a], cvec, ofp))
241			return(1);
242			if (ofspec != NULL) {
243			if (fclose(ofp) == EOF) {
244			fprintf(stderr,
245			"%s: error writing to '%s'\n",
246			progname, fnbuf);
247			return(1);
248			}
249			ofp = stdout;
250			}
251			cm_free(cvec);
252			}
253			else if (!sum_images(argv[a], cmtx, ofp))
254	greg	2.1	return(1);
255	greg	2.24	} else { /* generating vector/matrix */
256			CMATRIX *Vmat = cm_load(argv[a], 0, cmtx->nrows, DTfromHeader);
257			CMATRIX *rmtx = cm_multiply(Vmat, cmtx);
258	greg	2.1	cm_free(Vmat);
259	greg	2.30	if (ofspec != NULL) { /* multiple vector files? */
260			const char *wtype = (outfmt==DTascii) ? "w" : "wb";
261	greg	2.24	for (i = 0; i < nsteps; i++) {
262			CMATRIX *rvec = cm_column(rmtx, i);
263			sprintf(fnbuf, ofspec, i+1);
264	greg	2.30	if ((ofp = fopen(fnbuf, wtype)) == NULL) {
265	greg	2.24	fprintf(stderr,
266			"%s: cannot open '%s' for output\n",
267			progname, fnbuf);
268			return(1);
269			}
270	greg	2.31	#ifdef getc_unlocked
271			flockfile(ofp);
272			#endif
273	greg	2.34	if (headout) { /* header output */
274			newheader("RADIANCE", ofp);
275			printargs(argc, argv, ofp);
276			fputnow(ofp);
277			fprintf(ofp, "FRAME=%d\n", i+1);
278			fprintf(ofp, "NROWS=%d\n", rvec->nrows);
279			fputs("NCOLS=1\nNCOMP=3\n", ofp);
280			fputformat((char *)cm_fmt_id[outfmt], ofp);
281			fputc('\n', ofp);
282			}
283	greg	2.30	cm_write(rvec, outfmt, ofp);
284	greg	2.24	if (fclose(ofp) == EOF) {
285			fprintf(stderr,
286			"%s: error writing to '%s'\n",
287			progname, fnbuf);
288			return(1);
289			}
290			ofp = stdout;
291			cm_free(rvec);
292			}
293	greg	2.30	} else {
294	greg	2.31	#ifdef getc_unlocked
295			flockfile(ofp);
296			#endif
297	greg	2.30	if (outfmt != DTascii)
298			SET_FILE_BINARY(ofp);
299	greg	2.34	if (headout) { /* header output */
300	greg	2.30	newheader("RADIANCE", ofp);
301			printargs(argc, argv, ofp);
302			fputnow(ofp);
303	greg	2.33	fprintf(ofp, "NROWS=%d\n", rmtx->nrows);
304	greg	2.31	fprintf(ofp, "NCOLS=%d\n", rmtx->ncols);
305			fputs("NCOMP=3\n", ofp);
306	greg	2.30	fputformat((char *)cm_fmt_id[outfmt], ofp);
307			fputc('\n', ofp);
308			}
309			cm_write(rmtx, outfmt, ofp);
310			}
311	greg	2.24	cm_free(rmtx);
312			}
313			if (fflush(ofp) == EOF) { /* final clean-up */
314			fprintf(stderr, "%s: write error on output\n", progname);
315			return(1);
316	greg	2.1	}
317	greg	2.24	cm_free(cmtx);
318	greg	2.1	return(0);
319	greg	2.24	userr:
320	greg	2.32	fprintf(stderr, "Usage: %s [-n nsteps][-o ospec][-i{f\|d\|h}][-o{f\|d}] DCspec [skyf]\n",
321	greg	2.24	progname);
322	greg	2.32	fprintf(stderr, " or: %s [-n nsteps][-o ospec][-i{f\|d\|h}][-o{f\|d}] Vspec Tbsdf.xml Dmat.dat [skyf]\n",
323	greg	2.24	progname);
324			return(1);
325	greg	2.1	}