ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/common/header.c
Revision: 2.51
Committed: Sat Jun 7 05:09:45 2025 UTC (16 hours, 15 minutes ago) by greg
Content type: text/plain
Branch: MAIN
CVS Tags: HEAD
Changes since 2.50: +1 -27 lines
Log Message:
refactor: Put some declarations into "paths.h" and included in "platform.h"

File Contents

# Content
1 #ifndef lint
2 static const char RCSid[] = "$Id: header.c,v 2.50 2025/06/06 19:11:21 greg Exp $";
3 #endif
4 /*
5 * header.c - routines for reading and writing information headers.
6 *
7 * Externals declared in rtio.h
8 *
9 * newheader(t,fp) start new information header identified by string t
10 * headidval(r,s) copy header identifier value in s to r
11 * dateval(t,s) get capture date value as UTC
12 * gmtval(t,s) get GMT as UTC
13 * fputdate(t,fp) put out the given UTC
14 * fputnow(fp) put out the current date and time
15 * formatval(r,s) copy the format value in s to r
16 * fputformat(s,fp) write "FORMAT=%s" to fp
17 * nativebigendian() are we native on big-endian machine?
18 * isbigendian(s) header line matches "BigEndian=1" (-1 if irrelevant)
19 * fputendian(fp) write native endianness in BigEndian= line
20 * getheader(fp,f,p) read header from fp, calling f(s,p) on each line
21 * globmatch(pat, str) check for glob match of str against pat
22 * checkheader(i,p,o) check header format from i against p and copy to o
23 *
24 * To copy header from input to output, use getheader(fin, fputs, fout)
25 */
26
27 #include "copyright.h"
28
29 #include <ctype.h>
30
31 #include "tiff.h" /* for int32 */
32 #include "rtio.h"
33 #include "color.h"
34 #include "resolu.h"
35
36 #define MAXLINE 2048
37
38 extern time_t timegm(struct tm *tm);
39
40 const char HDRSTR[] = "#?"; /* information header magic number */
41
42 const char FMTSTR[] = "FORMAT="; /* format identifier */
43
44 const char TMSTR[] = "CAPDATE="; /* capture date identifier */
45 const char GMTSTR[] = "GMT="; /* GMT identifier */
46
47 const char BIGEND[] = "BigEndian="; /* big-endian variable */
48
49 static gethfunc mycheck;
50
51
52 void
53 newheader( /* identifying line of information header */
54 const char *s,
55 FILE *fp
56 )
57 {
58 fputs(HDRSTR, fp);
59 fputs(s, fp);
60 fputc('\n', fp);
61 }
62
63
64 int
65 headidval( /* get header id (return true if is id) */
66 char *r,
67 const char *s
68 )
69 {
70 const char *cp = HDRSTR;
71
72 while (*cp) if (*cp++ != *s++) return(0);
73 if (r == NULL) return(1);
74 while (*s && !isspace(*s)) *r++ = *s++;
75 *r = '\0';
76 return(1);
77 }
78
79
80 int
81 dateval( /* convert capture date line to UTC */
82 time_t *tloc,
83 const char *s
84 )
85 {
86 struct tm tms;
87 const char *cp = TMSTR;
88
89 while (*cp) if (*cp++ != *s++) return(0);
90 while (isspace(*s)) s++;
91 if (!*s) return(0);
92 if (sscanf(s, "%d:%d:%d %d:%d:%d",
93 &tms.tm_year, &tms.tm_mon, &tms.tm_mday,
94 &tms.tm_hour, &tms.tm_min, &tms.tm_sec) != 6)
95 return(0);
96 if (tloc == NULL)
97 return(1);
98 tms.tm_mon--;
99 tms.tm_year -= 1900;
100 tms.tm_isdst = -1; /* ask mktime() to figure out DST */
101 *tloc = mktime(&tms);
102 return(1);
103 }
104
105
106 int
107 gmtval( /* convert GMT date line to UTC */
108 time_t *tloc,
109 const char *s
110 )
111 {
112 struct tm tms;
113 const char *cp = GMTSTR;
114
115 while (*cp) if (*cp++ != *s++) return(0);
116 while (isspace(*s)) s++;
117 if (!*s) return(0);
118 if (sscanf(s, "%d:%d:%d %d:%d:%d",
119 &tms.tm_year, &tms.tm_mon, &tms.tm_mday,
120 &tms.tm_hour, &tms.tm_min, &tms.tm_sec) != 6)
121 return(0);
122 if (tloc == NULL)
123 return(1);
124 tms.tm_mon--;
125 tms.tm_year -= 1900;
126 *tloc = timegm(&tms);
127 return(1);
128 }
129
130
131 void
132 fputdate( /* write out the given time value (local & GMT) */
133 time_t tv,
134 FILE *fp
135 )
136 {
137 struct tm *tms;
138
139 tms = localtime(&tv);
140 if (tms != NULL)
141 fprintf(fp, "%s %04d:%02d:%02d %02d:%02d:%02d\n", TMSTR,
142 tms->tm_year+1900, tms->tm_mon+1, tms->tm_mday,
143 tms->tm_hour, tms->tm_min, tms->tm_sec);
144 tms = gmtime(&tv);
145 if (tms != NULL)
146 fprintf(fp, "%s %04d:%02d:%02d %02d:%02d:%02d\n", GMTSTR,
147 tms->tm_year+1900, tms->tm_mon+1, tms->tm_mday,
148 tms->tm_hour, tms->tm_min, tms->tm_sec);
149 }
150
151
152 void
153 fputnow( /* write out the current time */
154 FILE *fp
155 )
156 {
157 time_t tv;
158 time(&tv);
159 fputdate(tv, fp);
160 }
161
162
163 int
164 formatval( /* get format value (return true if format) */
165 char fmt[MAXFMTLEN],
166 const char *s
167 )
168 {
169 const char *cp = FMTSTR;
170 char *r = fmt;
171 /* check against format string */
172 while (*cp) if (*cp++ != *s++) return(0);
173 while (isspace(*s)) s++;
174 if (!*s) return(0);
175 if (r == NULL) /* just checking if format? */
176 return(1);
177 do /* copy format ID */
178 *r++ = *s++;
179 while (*s && r-fmt < MAXFMTLEN-1);
180
181 do /* remove trailing white space */
182 *r-- = '\0';
183 while (r > fmt && isspace(*r));
184
185 return(1);
186 }
187
188
189 void
190 fputformat( /* put out a format value */
191 const char *s,
192 FILE *fp
193 )
194 {
195 int align = 0;
196
197 fputs(FMTSTR, fp);
198 fputs(s, fp);
199 /* pad to align binary type for mmap() */
200 if (globmatch(PICFMT, s))
201 align = 0; /* not needed for picture data */
202 else if (!strncmp("float", s, 5))
203 align = sizeof(float);
204 else if (!strncmp("double", s, 6))
205 align = sizeof(double);
206 else if (!strncmp("16-bit", s, 6))
207 align = 2;
208 else if (!strncmp("32-bit", s, 6))
209 align = 4;
210 else if (!strncmp("64-bit", s, 6))
211 align = 8;
212 if (align) {
213 long pos = ftell(fp);
214 if (pos >= 0) {
215 pos = (pos + 2) % align;
216 if (pos) align -= pos;
217 else align = 0;
218 } else
219 align = 0;
220 }
221 while (align-- > 0)
222 putc(' ', fp);
223 fputc('\n', fp);
224 }
225
226
227 int
228 nativebigendian() /* are we native on a big-endian machine? */
229 {
230 union { int32 i; char c[4]; } u;
231
232 u.i = 1;
233
234 return(u.c[0] == 0);
235 }
236
237
238 int
239 isbigendian( /* header line says "BigEndian=1" (-1 if irrelevant) */
240 const char *s
241 )
242 {
243 const char *be = BIGEND;
244
245 while ((*s != '\0') & (*be != '=') && *s++ == *be)
246 ++be;
247 if (*be != '=')
248 return(-1); /* irrelevant */
249 while (isspace(*s))
250 s++;
251 if (*s++ != '=')
252 return(-1);
253 while (isspace(*s))
254 s++;
255 return(*s == '1');
256 }
257
258
259 void
260 fputendian( /* write native endianness in BigEndian= line */
261 FILE *fp
262 )
263 {
264 fputs(BIGEND, fp);
265 if (nativebigendian())
266 fputs("1\n", fp);
267 else
268 fputs("0\n", fp);
269 }
270
271
272 int
273 getheader( /* get header from file */
274 FILE *fp,
275 gethfunc *f,
276 void *p
277 )
278 {
279 int rtotal = 0;
280 char buf[MAXLINE];
281 int firstc = fgetc(fp);
282
283 if (!isprint(firstc))
284 return(-1); /* messed up */
285 ungetc(firstc, fp);
286 for ( ; ; ) {
287 int rval = 0;
288 buf[MAXLINE-2] = '\n';
289 if (fgets(buf, MAXLINE, fp) == NULL)
290 return(-1);
291 if (buf[buf[0]=='\r'] == '\n') /* end of header? */
292 return(rtotal);
293 if (buf[MAXLINE-2] != '\n') {
294 ungetc(buf[MAXLINE-2], fp); /* prevent false end */
295 buf[MAXLINE-2] = '\0';
296 }
297 if (f != NULL && (rval = (*f)(buf, p)) < 0)
298 return(-1);
299 rtotal += rval;
300 }
301 }
302
303
304 struct check {
305 FILE *fp;
306 char fs[MAXFMTLEN];
307 };
308
309
310 static int
311 mycheck( /* check a header line for format info. */
312 char *s,
313 void *cp
314 )
315 {
316 struct check *scp = (struct check *)cp;
317
318 if (!formatval(scp->fs, s) && scp->fp != NULL)
319 return(fputs(s, scp->fp));
320
321 return(0);
322 }
323
324
325 int
326 globmatch( /* check for match of s against pattern p */
327 const char *p,
328 const char *s
329 )
330 {
331 int setmatch;
332
333 do {
334 switch (*p) {
335 case '?': /* match any character */
336 if (!*s++)
337 return(0);
338 break;
339 case '*': /* match any string */
340 while (p[1] == '*') p++;
341 do
342 if ( (p[1]=='?') | (p[1]==*s) &&
343 globmatch(p+1,s) )
344 return(1);
345 while (*s++);
346 return(0);
347 case '[': /* character set */
348 setmatch = (*s == *++p);
349 if (!*p)
350 return(0);
351 while (*++p != ']') {
352 if (!*p)
353 return(0);
354 if (*p == '-') {
355 setmatch += (p[-1] <= *s) & (*s <= p[1]);
356 if (!*++p)
357 break;
358 } else
359 setmatch += (*p == *s);
360 }
361 if (!setmatch)
362 return(0);
363 s++;
364 break;
365 case '\\': /* literal next */
366 if (!*++p)
367 return(0);
368 /* fall through */
369 default: /* normal character */
370 if (*p != *s)
371 return(0);
372 s++;
373 break;
374 }
375 } while (*p++);
376 return(1);
377 }
378
379
380 /*
381 * Checkheader(fin,fmt,fout) returns a value of 1 if the input format
382 * matches the specification in fmt, 0 if no input format was found,
383 * and -1 if the input format does not match or there is an
384 * error reading the header. If fmt is empty, then -1 is returned
385 * if any input format is found (or there is an error), and 0 otherwise.
386 * If fmt contains any '*' or '?' characters, then checkheader
387 * does wildcard expansion and copies a matching result into fmt.
388 * Be sure that fmt is big enough to hold the match in such cases,
389 * and that it is not a static, read-only string!
390 * The input header (minus any format lines) is copied to fout
391 * if fout is not NULL.
392 */
393
394 int
395 checkheader(
396 FILE *fin,
397 char fmt[MAXFMTLEN],
398 FILE *fout
399 )
400 {
401 struct check cdat;
402 char *cp;
403
404 cdat.fp = fout;
405 cdat.fs[0] = '\0';
406 if (getheader(fin, mycheck, &cdat) < 0)
407 return(-1);
408 if (!cdat.fs[0])
409 return(0);
410 for (cp = fmt; *cp; cp++) /* check for globbing */
411 if ((*cp == '?') | (*cp == '*')) {
412 if (globmatch(fmt, cdat.fs)) {
413 strcpy(fmt, cdat.fs);
414 return(1);
415 } else
416 return(-1);
417 }
418 return(strcmp(fmt, cdat.fs) ? -1 : 1); /* literal match */
419 }