src/util/cmatrix.c

#ifndef lint
static const char RCSid[] = "$Id: cmatrix.c,v 2.40 2025/03/22 01:27:22 greg Exp $";
#endif
/*
 * Color matrix routines.
 *
 *      G. Ward
 */

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

/* Allocate a color coefficient matrix */
CMATRIX *
cm_alloc(int nrows, int ncols)
{
        CMATRIX *cm;

        if ((nrows <= 0) | (ncols <= 0))
                error(USER, "attempt to create empty matrix");
        cm = (CMATRIX *)malloc(sizeof(CMATRIX) +
                                sizeof(COLOR)*((size_t)nrows*ncols - 1));
        if (!cm)
                error(SYSTEM, "out of memory in cm_alloc()");
        cm->nrows = nrows;
        cm->ncols = ncols;
        return(cm);
}

static void
adjacent_ra_sizes(size_t bounds[2], size_t target)
{
        bounds[0] = 0; bounds[1] = 2048;
        while (bounds[1] < target) {
                bounds[0] = bounds[1];
                bounds[1] += bounds[1]>>1;
        }
}

/* Resize color coefficient matrix */
CMATRIX *
cm_resize(CMATRIX *cm, int nrows)
{
        size_t  old_size, new_size, ra_bounds[2];

        if (!cm)
                return(NULL);
        if (nrows == cm->nrows)
                return(cm);
        if (nrows <= 0) {
                cm_free(cm);
                return(NULL);
        }
        old_size = sizeof(CMATRIX) + sizeof(COLOR)*((size_t)cm->nrows*cm->ncols - 1);
        adjacent_ra_sizes(ra_bounds, old_size);
        new_size = sizeof(CMATRIX) + sizeof(COLOR)*((size_t)nrows*cm->ncols - 1);
        if (nrows < cm->nrows ? new_size <= ra_bounds[0] :
                                new_size > ra_bounds[1]) {
                adjacent_ra_sizes(ra_bounds, new_size);
                cm = (CMATRIX *)realloc(cm, ra_bounds[1]);
                if (!cm)
                        error(SYSTEM, "out of memory in cm_resize()");
        }
        cm->nrows = nrows;
        return(cm);
}

typedef struct {
        int     dtype;          /* data type */
        int     need2swap;      /* need byte swap? */
        int     nrows, ncols;   /* matrix size */
        COLOR   expos;          /* exposure value */
        char    *err;           /* error message */
} CMINFO;               /* header info record */

static int
get_cminfo(char *s, void *p)
{
        CMINFO  *ip = (CMINFO *)p;
        char    fmt[MAXFMTLEN];
        int     i;

        if (isncomp(s) && ncompval(s) != 3) {
                ip->err = "unexpected # components (must be 3)";
                return(-1);
        }
        if (!strncmp(s, "NROWS=", 6)) {
                ip->nrows = atoi(s+6);
                return(0);
        }
        if (!strncmp(s, "NCOLS=", 6)) {
                ip->ncols = atoi(s+6);
                return(0);
        }
        if ((i = isbigendian(s)) >= 0) {
                ip->need2swap = (nativebigendian() != i);
                return(0);
        }
        if (isexpos(s)) {
                double  d = exposval(s);
                scalecolor(ip->expos, d);
                return(0);
        }
        if (iscolcor(s)) {
                COLOR   ctmp;
                colcorval(ctmp, s);
                multcolor(ip->expos, ctmp);
                return(0);
        }
        if (!formatval(fmt, s))
                return(0);
        for (i = 1; i < DTend; i++)
                if (!strcmp(fmt, cm_fmt_id[i]))
                        ip->dtype = i;
        return(0);
}

/* Load header to obtain/check data type and number of columns */
char *
cm_getheader(int *dt, int *nr, int *nc, int *swp, COLOR scale, FILE *fp)
{
        CMINFO  cmi;
                                                /* read header */
        cmi.dtype = DTfromHeader;
        cmi.need2swap = 0;
        cmi.expos[0] = cmi.expos[1] = cmi.expos[2] = 1.f;
        cmi.nrows = cmi.ncols = 0;
        cmi.err = "unexpected EOF in header";
        if (getheader(fp, get_cminfo, &cmi) < 0)
                return(cmi.err);
        if (dt) {                               /* get/check data type? */
                if (cmi.dtype == DTfromHeader) {
                        if (*dt == DTfromHeader)
                                return("missing/unknown data format in header");
                } else if (*dt == DTfromHeader)
                        *dt = cmi.dtype;
                else if (*dt != cmi.dtype)
                        return("unexpected data format in header");
        }
        if (nr) {                               /* get/check #rows? */
                if (*nr <= 0)
                        *nr = cmi.nrows;
                else if ((cmi.nrows > 0) & (*nr != cmi.nrows))
                        return("unexpected row count in header");
        }
        if (nc) {                               /* get/check #columns? */
                if (*nc <= 0)
                        *nc = cmi.ncols;
                else if ((cmi.ncols > 0) & (*nc != cmi.ncols))
                        return("unexpected column count in header");
        }
        if (swp)                                /* get/check swap? */
                *swp = cmi.need2swap;
        if (scale) {                            /* transfer exposure comp. */
                scale[0] = 1.f/cmi.expos[0];
                scale[1] = 1.f/cmi.expos[1];
                scale[2] = 1.f/cmi.expos[2];
        }
        return(NULL);
}

/* Allocate and load image data into matrix */
static CMATRIX *
cm_load_rgbe(FILE *fp, int nrows, int ncols)
{
        CMATRIX *cm;
        COLORV  *mp;
                                                /* header already loaded */
        cm = cm_alloc(nrows, ncols);
        if (!cm)
                return(NULL);
        mp = cm->cmem;
        while (nrows--) {
                if (freadscan((COLOR *)mp, ncols, fp) < 0) {
                        error(USER, "error reading color picture as matrix");
                        cm_free(cm);
                        return(NULL);
                }
                mp += 3*ncols;
        }                                       /* caller closes stream */
        return(cm);
}

/* Allocate and load a matrix from the given input (or stdin if NULL) */
CMATRIX *
cm_load(const char *inspec, int nrows, int ncols, int dtype)
{
        const int       ROWINC = 2048;
        int             dimsOK = (dtype == DTascii) | (nrows > 0) && ncols;
        int             swap = 0;
        FILE            *fp;
        COLOR           scale;
        CMATRIX         *cm;

        if (!inspec)
                inspec = stdin_name;
        else if (!*inspec)
                return(NULL);
        if (inspec == stdin_name) {             /* reading from stdin? */
                fp = stdin;
        } else if (inspec[0] == '!') {
                fp = popen(inspec+1, "r");
                if (!fp) {
                        sprintf(errmsg, "cannot start command '%s'", inspec);
                        error(SYSTEM, errmsg);
                }
        } else if (!(fp = fopen(inspec, "r"))) {
                sprintf(errmsg, "cannot open file '%s'", inspec);
                error(SYSTEM, errmsg);
        }
#ifdef getc_unlocked
        flockfile(fp);
#endif
        if (dtype != DTascii)
                SET_FILE_BINARY(fp);            /* doesn't really work */
        if (!dtype | !dimsOK) {                 /* expecting header? */
                char    *err = cm_getheader(&dtype, &nrows, &ncols, &swap, scale, fp);
                if (err)
                        error(USER, err);
                dimsOK = ncols > 0 && ( nrows > 0 ||
                                (dtype != DTrgbe) & (dtype != DTxyze) );
        }
        if (!dimsOK && !fscnresolu(&ncols, &nrows, fp))
                error(USER, "unspecified matrix size");
        switch (dtype) {
        case DTascii:
        case DTfloat:
        case DTdouble:
                break;
        case DTrgbe:
        case DTxyze:
                cm = cm_load_rgbe(fp, nrows, ncols);
                goto cleanup;
        default:
                error(USER, "unexpected data type in cm_load()");
        }
        if (nrows <= 0) {                       /* don't know length? */
                int     guessrows = 147;        /* usually big enough */
                if (cm_elem_size[dtype] && (fp != stdin) & (inspec[0] != '!')) {
                        long    startpos = ftell(fp);
                        if (fseek(fp, 0L, SEEK_END) == 0) {
                                long    rowsiz = (long)ncols*cm_elem_size[dtype];
                                long    endpos = ftell(fp);

                                if ((endpos - startpos) % rowsiz) {
                                        sprintf(errmsg,
                                        "improper length for binary file '%s'",
                                                        inspec);
                                        error(USER, errmsg);
                                }
                                guessrows = (endpos - startpos)/rowsiz;
                                if (fseek(fp, startpos, SEEK_SET) < 0) {
                                        sprintf(errmsg,
                                                "fseek() error on file '%s'",
                                                        inspec);
                                        error(SYSTEM, errmsg);
                                }
                                nrows = guessrows;      /* we're confident */
                        }
                }
                cm = cm_alloc(guessrows, ncols);
        } else
                cm = cm_alloc(nrows, ncols);
        if (!cm)                                        /* XXX never happens */
                return(NULL);
        if (dtype == DTascii) {                         /* read text file */
                int     maxrow = (nrows > 0 ? nrows : 32000);
                int     r, c;
                for (r = 0; r < maxrow; r++) {
                    if (r >= cm->nrows)                 /* need more space? */
                        cm = cm_resize(cm, cm->nrows+ROWINC);
                    for (c = 0; c < ncols; c++) {
                        COLORV  *cv = cm_lval(cm,r,c);
                        if (fscanf(fp, COLSPEC, cv, cv+1, cv+2) != 3) {
                                if ((nrows <= 0) & (r > 0) & !c) {
                                        cm = cm_resize(cm, maxrow=r);
                                        break;
                                } else
                                        goto EOFerror;
                        }
                    }
                }
                while ((c = getc(fp)) != EOF)
                        if (!isspace(c)) {
                                sprintf(errmsg,
                                "unexpected data at end of ascii input '%s'",
                                                inspec);
                                error(WARNING, errmsg);
                                break;
                        }
        } else {                                        /* read binary file */
                if (sizeof(COLOR) == cm_elem_size[dtype]) {
                        size_t  nread = 0;
                        do {                            /* read all we can */
                                nread += getbinary(cm->cmem + 3*nread,
                                                sizeof(COLOR),
                                                (size_t)cm->nrows*cm->ncols - nread,
                                                fp);
                                if (nrows <= 0) {       /* unknown length */
                                        if (nread == (size_t)cm->nrows*cm->ncols)
                                                        /* need more space? */
                                                cm = cm_resize(cm, cm->nrows+ROWINC);
                                        else if (nread && !(nread % cm->ncols))
                                                        /* seem to be  done */
                                                cm = cm_resize(cm, nread/cm->ncols);
                                        else            /* ended mid-row */
                                                goto EOFerror;
                                } else if (nread < (size_t)cm->nrows*cm->ncols)
                                        goto EOFerror;
                        } while (nread < (size_t)cm->nrows*cm->ncols);

                        if (swap) {
                                if (sizeof(COLORV) == 4)
                                        swap32((char *)cm->cmem,
                                                        3*(size_t)cm->nrows*cm->ncols);
                                else /* sizeof(COLORV) == 8 */
                                        swap64((char *)cm->cmem,
                                                        3*(size_t)cm->nrows*cm->ncols);
                        }
                } else if (dtype == DTdouble) {
                        double  dc[3];                  /* load from double */
                        COLORV  *cvp = cm->cmem;
                        size_t  n = (size_t)nrows*ncols;

                        if (n <= 0)
                                goto not_handled;
                        while (n--) {
                                if (getbinary(dc, sizeof(double), 3, fp) != 3)
                                        goto EOFerror;
                                if (swap) swap64((char *)dc, 3);
                                copycolor(cvp, dc);
                                cvp += 3;
                        }
                } else /* dtype == DTfloat */ {
                        float   fc[3];                  /* load from float */
                        COLORV  *cvp = cm->cmem;
                        size_t  n = (size_t)nrows*ncols;

                        if (n <= 0)
                                goto not_handled;
                        while (n--) {
                                if (getbinary(fc, sizeof(float), 3, fp) != 3)
                                        goto EOFerror;
                                if (swap) swap32((char *)fc, 3);
                                copycolor(cvp, fc);
                                cvp += 3;
                        }
                }
                if (fgetc(fp) != EOF) {
                                sprintf(errmsg,
                                "unexpected data at end of binary input '%s'",
                                                inspec);
                                error(WARNING, errmsg);
                }
        }
cleanup:
        if (fp != stdin) {
                if (inspec[0] != '!')
                        fclose(fp);
                else if (pclose(fp)) {
                        sprintf(errmsg, "error running command '%s'", inspec);
                        error(WARNING, errmsg);
                }
        }
#ifdef getc_unlocked
        else
                funlockfile(fp);
#endif
        if ((scale[0] < .99) | (scale[0] > 1.01) |
                        (scale[1] < .99) | (scale[1] > 1.01) |
                        (scale[2] < .99) | (scale[2] > 1.01)) {
                size_t  n = (size_t)ncols*nrows;
                COLORV  *mp = cm->cmem;
                while (n--) {           /* apply exposure scaling */
                        *mp++ *= scale[0];
                        *mp++ *= scale[1];
                        *mp++ *= scale[2];
                }
        }
        return(cm);
EOFerror:
        sprintf(errmsg, "unexpected EOF reading %s", inspec);
        error(USER, errmsg);
        return(NULL);
not_handled:
        error(INTERNAL, "unhandled data size or length in cm_load()");
        return(NULL);   /* gratis return */
}

/* Extract a column vector from a matrix */
CMATRIX *
cm_column(const CMATRIX *cm, int c)
{
        CMATRIX *cvr;
        int     dr;

        if (!cm)
                return(NULL);
        if ((c < 0) | (c >= cm->ncols))
                error(INTERNAL, "column requested outside matrix");
        cvr = cm_alloc(cm->nrows, 1);
        if (!cvr)
                return(NULL);
        for (dr = 0; dr < cm->nrows; dr++) {
                const COLORV    *sp = cm_lval(cm,dr,c);
                COLORV          *dp = cv_lval(cvr,dr);
                dp[0] = sp[0];
                dp[1] = sp[1];
                dp[2] = sp[2];
        }
        return(cvr);
}

/* Multiply two matrices (or a matrix and a vector) and allocate the result */
CMATRIX *
cm_multiply(const CMATRIX *cm1, const CMATRIX *cm2)
{
        char    *rowcheck=NULL, *colcheck=NULL;
        CMATRIX *cmr;
        int     dr, dc, i;

        if (!cm1 | !cm2)
                return(NULL);
        if ((cm1->ncols <= 0) | (cm1->ncols != cm2->nrows))
                error(INTERNAL, "matrix dimension mismatch in cm_multiply()");
        cmr = cm_alloc(cm1->nrows, cm2->ncols);
        if (!cmr)
                return(NULL);
                                /* optimization: check for zero rows & cols */
        if (((cm1->nrows > 5) | (cm2->ncols > 5)) & (cm1->ncols > 5)) {
                static const COLOR      czero;
                rowcheck = (char *)calloc(cmr->nrows, 1);
                for (dr = cm1->nrows*(rowcheck != NULL); dr--; )
                    for (dc = cm1->ncols; dc--; )
                        if (memcmp(cm_lval(cm1,dr,dc), czero, sizeof(COLOR))) {
                                rowcheck[dr] = 1;
                                break;
                        }
                colcheck = (char *)calloc(cmr->ncols, 1);
                for (dc = cm2->ncols*(colcheck != NULL); dc--; )
                    for (dr = cm2->nrows; dr--; )
                        if (memcmp(cm_lval(cm2,dr,dc), czero, sizeof(COLOR))) {
                                colcheck[dc] = 1;
                                break;
                        }
        }
        for (dr = 0; dr < cmr->nrows; dr++)
            for (dc = 0; dc < cmr->ncols; dc++) {
                COLORV  *dp = cm_lval(cmr,dr,dc);
                double  res[3];
                dp[0] = dp[1] = dp[2] = 0;
                if (rowcheck && !rowcheck[dr])
                        continue;
                if (colcheck && !colcheck[dc])
                        continue;
                res[0] = res[1] = res[2] = 0;
                for (i = 0; i < cm1->ncols; i++) {
                    const COLORV        *cp1 = cm_lval(cm1,dr,i);
                    const COLORV        *cp2 = cm_lval(cm2,i,dc);
                    res[0] += (double)cp1[0] * cp2[0];
                    res[1] += (double)cp1[1] * cp2[1];
                    res[2] += (double)cp1[2] * cp2[2];
                }
                copycolor(dp, res);
            }
        if (rowcheck) free(rowcheck);
        if (colcheck) free(colcheck);
        return(cmr);
}

/* write out matrix to file (precede by resolution string if picture) */
int
cm_write(const CMATRIX *cm, int dtype, FILE *fp)
{
        static const char       tabEOL[2] = {'\t','\n'};
        const COLORV            *mp;
        int                     r, c;
        size_t                  n, rv;

        if (!cm)
                return(0);
#ifdef getc_unlocked
        flockfile(fp);
#endif
        mp = cm->cmem;
        switch (dtype) {
        case DTascii:
                for (r = 0; r < cm->nrows; r++)
                        for (c = 0; c < cm->ncols; c++, mp += 3)
                                fprintf(fp, "%.6e %.6e %.6e%c",
                                                mp[0], mp[1], mp[2],
                                                tabEOL[c >= cm->ncols-1]);
                break;
        case DTfloat:
        case DTdouble:
                if (sizeof(COLOR) == cm_elem_size[dtype]) {
                        n = (size_t)cm->ncols*cm->nrows;
                        while (n > 0) {
                                rv = fwrite(mp, sizeof(COLOR), n, fp);
                                if (rv <= 0)
                                        return(0);
                                mp += 3*rv;
                                n -= rv;
                        }
                } else if (dtype == DTdouble) {
                        double  dc[3];
                        n = (size_t)cm->ncols*cm->nrows;
                        while (n--) {
                                copycolor(dc, mp);
                                if (putbinary(dc, sizeof(double), 3, fp) != 3)
                                        return(0);
                                mp += 3;
                        }
                } else /* dtype == DTfloat */ {
                        float   fc[3];
                        n = (size_t)cm->ncols*cm->nrows;
                        while (n--) {
                                copycolor(fc, mp);
                                if (putbinary(fc, sizeof(float), 3, fp) != 3)
                                        return(0);
                                mp += 3;
                        }
                }
                break;
        case DTrgbe:
        case DTxyze:
                fprtresolu(cm->ncols, cm->nrows, fp);
                for (r = 0; r < cm->nrows; r++, mp += 3*cm->ncols)
                        if (fwritescan((COLOR *)mp, cm->ncols, fp) < 0)
                                return(0);
                break;
        default:
                fputs("Unsupported data type in cm_write()!\n", stderr);
                return(0);
        }
#ifdef getc_unlocked
        funlockfile(fp);
#endif
        return(fflush(fp) == 0);
}
Revision:	2.41
Committed:	Sat Apr 19 17:12:59 2025 UTC (4 weeks ago) by greg
Content type:	text/plain
Branch:	MAIN
CVS Tags:	HEAD
Changes since 2.40:	+1 -12 lines
Log Message:	refactor: Isolated RMATRIX<->CMATRIX conversion routines
#	User	Rev	Content
1	greg	2.1	#ifndef lint
2	greg	2.41	static const char RCSid[] = "$Id: cmatrix.c,v 2.40 2025/03/22 01:27:22 greg Exp $";
3	greg	2.1	#endif
4			/*
5			* Color matrix routines.
6			*
7			* G. Ward
8			*/
9
10			#include <ctype.h>
11	schorsch	2.16	#include "platform.h"
12	greg	2.1	#include "standard.h"
13			#include "cmatrix.h"
14			#include "platform.h"
15	greg	2.14	#include "paths.h"
16	greg	2.2	#include "resolu.h"
17
18	greg	2.1	/* Allocate a color coefficient matrix */
19			CMATRIX *
20			cm_alloc(int nrows, int ncols)
21			{
22			CMATRIX *cm;
23
24			if ((nrows <= 0) \| (ncols <= 0))
25			error(USER, "attempt to create empty matrix");
26			cm = (CMATRIX *)malloc(sizeof(CMATRIX) +
27	greg	2.29	sizeof(COLOR)((size_t)nrowsncols - 1));
28	greg	2.21	if (!cm)
29	greg	2.1	error(SYSTEM, "out of memory in cm_alloc()");
30			cm->nrows = nrows;
31			cm->ncols = ncols;
32			return(cm);
33			}
34
35	greg	2.6	static void
36			adjacent_ra_sizes(size_t bounds[2], size_t target)
37			{
38			bounds[0] = 0; bounds[1] = 2048;
39			while (bounds[1] < target) {
40			bounds[0] = bounds[1];
41			bounds[1] += bounds[1]>>1;
42			}
43			}
44
45	greg	2.1	/* Resize color coefficient matrix */
46			CMATRIX *
47			cm_resize(CMATRIX *cm, int nrows)
48			{
49	greg	2.6	size_t old_size, new_size, ra_bounds[2];
50
51	greg	2.21	if (!cm)
52			return(NULL);
53	greg	2.1	if (nrows == cm->nrows)
54			return(cm);
55			if (nrows <= 0) {
56			cm_free(cm);
57			return(NULL);
58			}
59	greg	2.30	old_size = sizeof(CMATRIX) + sizeof(COLOR)((size_t)cm->nrowscm->ncols - 1);
60	greg	2.6	adjacent_ra_sizes(ra_bounds, old_size);
61	greg	2.30	new_size = sizeof(CMATRIX) + sizeof(COLOR)((size_t)nrowscm->ncols - 1);
62	greg	2.6	if (nrows < cm->nrows ? new_size <= ra_bounds[0] :
63			new_size > ra_bounds[1]) {
64			adjacent_ra_sizes(ra_bounds, new_size);
65			cm = (CMATRIX *)realloc(cm, ra_bounds[1]);
66	greg	2.21	if (!cm)
67	greg	2.6	error(SYSTEM, "out of memory in cm_resize()");
68			}
69	greg	2.1	cm->nrows = nrows;
70			return(cm);
71			}
72
73	greg	2.5	typedef struct {
74			int dtype; /* data type */
75	greg	2.22	int need2swap; /* need byte swap? */
76	greg	2.5	int nrows, ncols; /* matrix size */
77	greg	2.25	COLOR expos; /* exposure value */
78	greg	2.5	char err; / error message */
79			} CMINFO; /* header info record */
80
81	greg	2.1	static int
82	greg	2.5	get_cminfo(char s, void p)
83	greg	2.1	{
84	greg	2.5	CMINFO ip = (CMINFO )p;
85	greg	2.20	char fmt[MAXFMTLEN];
86	greg	2.2	int i;
87	greg	2.5
88	greg	2.40	if (isncomp(s) && ncompval(s) != 3) {
89	greg	2.5	ip->err = "unexpected # components (must be 3)";
90			return(-1);
91			}
92			if (!strncmp(s, "NROWS=", 6)) {
93			ip->nrows = atoi(s+6);
94			return(0);
95			}
96			if (!strncmp(s, "NCOLS=", 6)) {
97			ip->ncols = atoi(s+6);
98			return(0);
99			}
100	greg	2.22	if ((i = isbigendian(s)) >= 0) {
101			ip->need2swap = (nativebigendian() != i);
102			return(0);
103			}
104	greg	2.25	if (isexpos(s)) {
105			double d = exposval(s);
106			scalecolor(ip->expos, d);
107			return(0);
108			}
109			if (iscolcor(s)) {
110			COLOR ctmp;
111			colcorval(ctmp, s);
112			multcolor(ip->expos, ctmp);
113			return(0);
114			}
115	greg	2.2	if (!formatval(fmt, s))
116			return(0);
117			for (i = 1; i < DTend; i++)
118			if (!strcmp(fmt, cm_fmt_id[i]))
119	greg	2.5	ip->dtype = i;
120	greg	2.1	return(0);
121			}
122
123	greg	2.5	/* Load header to obtain/check data type and number of columns */
124			char *
125	greg	2.25	cm_getheader(int dt, int nr, int nc, int swp, COLOR scale, FILE *fp)
126	greg	2.1	{
127	greg	2.5	CMINFO cmi;
128			/* read header */
129			cmi.dtype = DTfromHeader;
130	greg	2.22	cmi.need2swap = 0;
131	greg	2.25	cmi.expos[0] = cmi.expos[1] = cmi.expos[2] = 1.f;
132	greg	2.5	cmi.nrows = cmi.ncols = 0;
133			cmi.err = "unexpected EOF in header";
134	greg	2.7	if (getheader(fp, get_cminfo, &cmi) < 0)
135	greg	2.5	return(cmi.err);
136	greg	2.21	if (dt) { /* get/check data type? */
137	greg	2.5	if (cmi.dtype == DTfromHeader) {
138			if (*dt == DTfromHeader)
139			return("missing/unknown data format in header");
140			} else if (*dt == DTfromHeader)
141			*dt = cmi.dtype;
142			else if (*dt != cmi.dtype)
143			return("unexpected data format in header");
144			}
145	greg	2.21	if (nr) { /* get/check #rows? */
146	greg	2.5	if (*nr <= 0)
147			*nr = cmi.nrows;
148			else if ((cmi.nrows > 0) & (*nr != cmi.nrows))
149			return("unexpected row count in header");
150			}
151	greg	2.21	if (nc) { /* get/check #columns? */
152	greg	2.5	if (*nc <= 0)
153			*nc = cmi.ncols;
154			else if ((cmi.ncols > 0) & (*nc != cmi.ncols))
155			return("unexpected column count in header");
156			}
157	greg	2.22	if (swp) /* get/check swap? */
158			*swp = cmi.need2swap;
159	greg	2.25	if (scale) { /* transfer exposure comp. */
160			scale[0] = 1.f/cmi.expos[0];
161			scale[1] = 1.f/cmi.expos[1];
162			scale[2] = 1.f/cmi.expos[2];
163			}
164	greg	2.5	return(NULL);
165	greg	2.1	}
166
167	greg	2.23	/* Allocate and load image data into matrix */
168			static CMATRIX *
169	greg	2.37	cm_load_rgbe(FILE *fp, int nrows, int ncols)
170	greg	2.23	{
171			CMATRIX *cm;
172			COLORV *mp;
173			/* header already loaded */
174			cm = cm_alloc(nrows, ncols);
175			if (!cm)
176			return(NULL);
177			mp = cm->cmem;
178			while (nrows--) {
179			if (freadscan((COLOR *)mp, ncols, fp) < 0) {
180			error(USER, "error reading color picture as matrix");
181			cm_free(cm);
182			return(NULL);
183			}
184	greg	2.37	mp += 3*ncols;
185	greg	2.23	} /* caller closes stream */
186			return(cm);
187			}
188
189	greg	2.9	/* Allocate and load a matrix from the given input (or stdin if NULL) */
190	greg	2.1	CMATRIX *
191	greg	2.9	cm_load(const char *inspec, int nrows, int ncols, int dtype)
192	greg	2.1	{
193	greg	2.15	const int ROWINC = 2048;
194	greg	2.36	int dimsOK = (dtype == DTascii) \| (nrows > 0) && ncols;
195	greg	2.22	int swap = 0;
196	greg	2.32	FILE *fp;
197	greg	2.25	COLOR scale;
198	greg	2.15	CMATRIX *cm;
199	greg	2.1
200	greg	2.33	if (!inspec)
201			inspec = stdin_name;
202			else if (!*inspec)
203	greg	2.32	return(NULL);
204	greg	2.33	if (inspec == stdin_name) { /* reading from stdin? */
205	greg	2.32	fp = stdin;
206	greg	2.33	} else if (inspec[0] == '!') {
207	greg	2.9	fp = popen(inspec+1, "r");
208	greg	2.21	if (!fp) {
209	greg	2.9	sprintf(errmsg, "cannot start command '%s'", inspec);
210			error(SYSTEM, errmsg);
211			}
212	greg	2.21	} else if (!(fp = fopen(inspec, "r"))) {
213	greg	2.9	sprintf(errmsg, "cannot open file '%s'", inspec);
214	greg	2.1	error(SYSTEM, errmsg);
215			}
216			#ifdef getc_unlocked
217			flockfile(fp);
218			#endif
219			if (dtype != DTascii)
220			SET_FILE_BINARY(fp); /* doesn't really work */
221	greg	2.36	if (!dtype \| !dimsOK) { /* expecting header? */
222	greg	2.25	char *err = cm_getheader(&dtype, &nrows, &ncols, &swap, scale, fp);
223	greg	2.21	if (err)
224	greg	2.5	error(USER, err);
225	greg	2.36	dimsOK = ncols > 0 && ( nrows > 0 \|\|
226			(dtype != DTrgbe) & (dtype != DTxyze) );
227	greg	2.5	}
228	greg	2.36	if (!dimsOK && !fscnresolu(&ncols, &nrows, fp))
229	greg	2.34	error(USER, "unspecified matrix size");
230	greg	2.1	switch (dtype) {
231			case DTascii:
232			case DTfloat:
233			case DTdouble:
234			break;
235	greg	2.23	case DTrgbe:
236			case DTxyze:
237	greg	2.37	cm = cm_load_rgbe(fp, nrows, ncols);
238	greg	2.23	goto cleanup;
239	greg	2.1	default:
240			error(USER, "unexpected data type in cm_load()");
241			}
242			if (nrows <= 0) { /* don't know length? */
243			int guessrows = 147; /* usually big enough */
244	greg	2.27	if (cm_elem_size[dtype] && (fp != stdin) & (inspec[0] != '!')) {
245	greg	2.1	long startpos = ftell(fp);
246			if (fseek(fp, 0L, SEEK_END) == 0) {
247	greg	2.27	long rowsiz = (long)ncols*cm_elem_size[dtype];
248	greg	2.1	long endpos = ftell(fp);
249
250	greg	2.27	if ((endpos - startpos) % rowsiz) {
251	greg	2.1	sprintf(errmsg,
252			"improper length for binary file '%s'",
253	greg	2.9	inspec);
254	greg	2.1	error(USER, errmsg);
255			}
256	greg	2.27	guessrows = (endpos - startpos)/rowsiz;
257	greg	2.1	if (fseek(fp, startpos, SEEK_SET) < 0) {
258			sprintf(errmsg,
259			"fseek() error on file '%s'",
260	greg	2.9	inspec);
261	greg	2.1	error(SYSTEM, errmsg);
262			}
263			nrows = guessrows; /* we're confident */
264			}
265			}
266			cm = cm_alloc(guessrows, ncols);
267			} else
268			cm = cm_alloc(nrows, ncols);
269	greg	2.21	if (!cm) /* XXX never happens */
270	greg	2.1	return(NULL);
271			if (dtype == DTascii) { /* read text file */
272			int maxrow = (nrows > 0 ? nrows : 32000);
273			int r, c;
274			for (r = 0; r < maxrow; r++) {
275			if (r >= cm->nrows) /* need more space? */
276	greg	2.15	cm = cm_resize(cm, cm->nrows+ROWINC);
277	greg	2.1	for (c = 0; c < ncols; c++) {
278			COLORV *cv = cm_lval(cm,r,c);
279	greg	2.13	if (fscanf(fp, COLSPEC, cv, cv+1, cv+2) != 3) {
280	greg	2.1	if ((nrows <= 0) & (r > 0) & !c) {
281			cm = cm_resize(cm, maxrow=r);
282			break;
283			} else
284			goto EOFerror;
285	greg	2.13	}
286	greg	2.1	}
287			}
288			while ((c = getc(fp)) != EOF)
289			if (!isspace(c)) {
290			sprintf(errmsg,
291	greg	2.9	"unexpected data at end of ascii input '%s'",
292			inspec);
293	greg	2.1	error(WARNING, errmsg);
294			break;
295			}
296			} else { /* read binary file */
297	greg	2.2	if (sizeof(COLOR) == cm_elem_size[dtype]) {
298	greg	2.31	size_t nread = 0;
299	greg	2.1	do { /* read all we can */
300	greg	2.17	nread += getbinary(cm->cmem + 3*nread,
301	greg	2.4	sizeof(COLOR),
302	greg	2.31	(size_t)cm->nrows*cm->ncols - nread,
303	greg	2.1	fp);
304			if (nrows <= 0) { /* unknown length */
305	greg	2.31	if (nread == (size_t)cm->nrows*cm->ncols)
306	greg	2.1	/* need more space? */
307	greg	2.15	cm = cm_resize(cm, cm->nrows+ROWINC);
308	greg	2.1	else if (nread && !(nread % cm->ncols))
309			/* seem to be done */
310			cm = cm_resize(cm, nread/cm->ncols);
311			else /* ended mid-row */
312			goto EOFerror;
313	greg	2.31	} else if (nread < (size_t)cm->nrows*cm->ncols)
314	greg	2.1	goto EOFerror;
315	greg	2.31	} while (nread < (size_t)cm->nrows*cm->ncols);
316	greg	2.1
317	greg	2.26	if (swap) {
318			if (sizeof(COLORV) == 4)
319			swap32((char *)cm->cmem,
320	greg	2.31	3(size_t)cm->nrowscm->ncols);
321	greg	2.26	else /* sizeof(COLORV) == 8 */
322			swap64((char *)cm->cmem,
323	greg	2.31	3(size_t)cm->nrowscm->ncols);
324	greg	2.26	}
325	greg	2.1	} else if (dtype == DTdouble) {
326			double dc[3]; /* load from double */
327			COLORV *cvp = cm->cmem;
328	greg	2.31	size_t n = (size_t)nrows*ncols;
329	greg	2.1
330			if (n <= 0)
331			goto not_handled;
332			while (n--) {
333	greg	2.17	if (getbinary(dc, sizeof(double), 3, fp) != 3)
334	greg	2.1	goto EOFerror;
335	greg	2.26	if (swap) swap64((char *)dc, 3);
336	greg	2.1	copycolor(cvp, dc);
337			cvp += 3;
338			}
339			} else /* dtype == DTfloat */ {
340			float fc[3]; /* load from float */
341			COLORV *cvp = cm->cmem;
342	greg	2.31	size_t n = (size_t)nrows*ncols;
343	greg	2.1
344			if (n <= 0)
345			goto not_handled;
346			while (n--) {
347	greg	2.17	if (getbinary(fc, sizeof(float), 3, fp) != 3)
348	greg	2.1	goto EOFerror;
349	greg	2.26	if (swap) swap32((char *)fc, 3);
350	greg	2.1	copycolor(cvp, fc);
351			cvp += 3;
352			}
353			}
354			if (fgetc(fp) != EOF) {
355			sprintf(errmsg,
356	greg	2.9	"unexpected data at end of binary input '%s'",
357			inspec);
358	greg	2.1	error(WARNING, errmsg);
359			}
360			}
361	greg	2.23	cleanup:
362	greg	2.9	if (fp != stdin) {
363			if (inspec[0] != '!')
364			fclose(fp);
365			else if (pclose(fp)) {
366			sprintf(errmsg, "error running command '%s'", inspec);
367			error(WARNING, errmsg);
368			}
369			}
370	greg	2.1	#ifdef getc_unlocked
371			else
372			funlockfile(fp);
373			#endif
374	greg	2.37	if ((scale[0] < .99) \| (scale[0] > 1.01) \|
375			(scale[1] < .99) \| (scale[1] > 1.01) \|
376			(scale[2] < .99) \| (scale[2] > 1.01)) {
377			size_t n = (size_t)ncols*nrows;
378			COLORV *mp = cm->cmem;
379			while (n--) { /* apply exposure scaling */
380			mp++ = scale[0];
381			mp++ = scale[1];
382			mp++ = scale[2];
383			}
384			}
385	greg	2.1	return(cm);
386			EOFerror:
387	greg	2.9	sprintf(errmsg, "unexpected EOF reading %s", inspec);
388	greg	2.1	error(USER, errmsg);
389	greg	2.23	return(NULL);
390	greg	2.1	not_handled:
391			error(INTERNAL, "unhandled data size or length in cm_load()");
392			return(NULL); /* gratis return */
393			}
394
395			/* Extract a column vector from a matrix */
396			CMATRIX *
397			cm_column(const CMATRIX *cm, int c)
398			{
399			CMATRIX *cvr;
400			int dr;
401
402	greg	2.21	if (!cm)
403			return(NULL);
404	greg	2.1	if ((c < 0) \| (c >= cm->ncols))
405			error(INTERNAL, "column requested outside matrix");
406			cvr = cm_alloc(cm->nrows, 1);
407	greg	2.21	if (!cvr)
408	greg	2.1	return(NULL);
409			for (dr = 0; dr < cm->nrows; dr++) {
410			const COLORV *sp = cm_lval(cm,dr,c);
411			COLORV *dp = cv_lval(cvr,dr);
412			dp[0] = sp[0];
413			dp[1] = sp[1];
414			dp[2] = sp[2];
415			}
416			return(cvr);
417			}
418
419			/* Multiply two matrices (or a matrix and a vector) and allocate the result */
420			CMATRIX *
421			cm_multiply(const CMATRIX cm1, const CMATRIX cm2)
422			{
423			char rowcheck=NULL, colcheck=NULL;
424			CMATRIX *cmr;
425			int dr, dc, i;
426
427	greg	2.21	if (!cm1 \| !cm2)
428			return(NULL);
429	greg	2.1	if ((cm1->ncols <= 0) \| (cm1->ncols != cm2->nrows))
430			error(INTERNAL, "matrix dimension mismatch in cm_multiply()");
431			cmr = cm_alloc(cm1->nrows, cm2->ncols);
432	greg	2.21	if (!cmr)
433	greg	2.1	return(NULL);
434			/* optimization: check for zero rows & cols */
435			if (((cm1->nrows > 5) \| (cm2->ncols > 5)) & (cm1->ncols > 5)) {
436			static const COLOR czero;
437			rowcheck = (char *)calloc(cmr->nrows, 1);
438			for (dr = cm1->nrows*(rowcheck != NULL); dr--; )
439			for (dc = cm1->ncols; dc--; )
440			if (memcmp(cm_lval(cm1,dr,dc), czero, sizeof(COLOR))) {
441			rowcheck[dr] = 1;
442			break;
443			}
444			colcheck = (char *)calloc(cmr->ncols, 1);
445			for (dc = cm2->ncols*(colcheck != NULL); dc--; )
446			for (dr = cm2->nrows; dr--; )
447			if (memcmp(cm_lval(cm2,dr,dc), czero, sizeof(COLOR))) {
448			colcheck[dc] = 1;
449			break;
450			}
451			}
452			for (dr = 0; dr < cmr->nrows; dr++)
453			for (dc = 0; dc < cmr->ncols; dc++) {
454			COLORV *dp = cm_lval(cmr,dr,dc);
455	greg	2.4	double res[3];
456	greg	2.1	dp[0] = dp[1] = dp[2] = 0;
457	greg	2.21	if (rowcheck && !rowcheck[dr])
458	greg	2.1	continue;
459	greg	2.21	if (colcheck && !colcheck[dc])
460	greg	2.1	continue;
461	greg	2.4	res[0] = res[1] = res[2] = 0;
462	greg	2.1	for (i = 0; i < cm1->ncols; i++) {
463			const COLORV *cp1 = cm_lval(cm1,dr,i);
464			const COLORV *cp2 = cm_lval(cm2,i,dc);
465	greg	2.18	res[0] += (double)cp1[0] * cp2[0];
466			res[1] += (double)cp1[1] * cp2[1];
467			res[2] += (double)cp1[2] * cp2[2];
468	greg	2.1	}
469	greg	2.4	copycolor(dp, res);
470	greg	2.1	}
471	greg	2.21	if (rowcheck) free(rowcheck);
472			if (colcheck) free(colcheck);
473	greg	2.1	return(cmr);
474			}
475
476	greg	2.2	/* write out matrix to file (precede by resolution string if picture) */
477			int
478			cm_write(const CMATRIX cm, int dtype, FILE fp)
479	greg	2.1	{
480	greg	2.3	static const char tabEOL[2] = {'\t','\n'};
481	greg	2.21	const COLORV *mp;
482	greg	2.3	int r, c;
483	greg	2.30	size_t n, rv;
484	greg	2.2
485	greg	2.21	if (!cm)
486			return(0);
487	greg	2.39	#ifdef getc_unlocked
488			flockfile(fp);
489			#endif
490	greg	2.21	mp = cm->cmem;
491	greg	2.2	switch (dtype) {
492			case DTascii:
493	greg	2.3	for (r = 0; r < cm->nrows; r++)
494	greg	2.2	for (c = 0; c < cm->ncols; c++, mp += 3)
495	greg	2.3	fprintf(fp, "%.6e %.6e %.6e%c",
496			mp[0], mp[1], mp[2],
497			tabEOL[c >= cm->ncols-1]);
498	greg	2.2	break;
499			case DTfloat:
500			case DTdouble:
501			if (sizeof(COLOR) == cm_elem_size[dtype]) {
502	greg	2.30	n = (size_t)cm->ncols*cm->nrows;
503			while (n > 0) {
504			rv = fwrite(mp, sizeof(COLOR), n, fp);
505			if (rv <= 0)
506	greg	2.2	return(0);
507	greg	2.30	mp += 3*rv;
508			n -= rv;
509	greg	2.2	}
510			} else if (dtype == DTdouble) {
511			double dc[3];
512	greg	2.30	n = (size_t)cm->ncols*cm->nrows;
513			while (n--) {
514	greg	2.2	copycolor(dc, mp);
515	greg	2.17	if (putbinary(dc, sizeof(double), 3, fp) != 3)
516	greg	2.2	return(0);
517			mp += 3;
518			}
519			} else /* dtype == DTfloat */ {
520			float fc[3];
521	greg	2.30	n = (size_t)cm->ncols*cm->nrows;
522			while (n--) {
523	greg	2.2	copycolor(fc, mp);
524	greg	2.17	if (putbinary(fc, sizeof(float), 3, fp) != 3)
525	greg	2.2	return(0);
526			mp += 3;
527			}
528			}
529			break;
530			case DTrgbe:
531			case DTxyze:
532			fprtresolu(cm->ncols, cm->nrows, fp);
533			for (r = 0; r < cm->nrows; r++, mp += 3*cm->ncols)
534			if (fwritescan((COLOR *)mp, cm->ncols, fp) < 0)
535			return(0);
536			break;
537			default:
538			fputs("Unsupported data type in cm_write()!\n", stderr);
539			return(0);
540	greg	2.1	}
541	greg	2.39	#ifdef getc_unlocked
542			funlockfile(fp);
543			#endif
544	greg	2.2	return(fflush(fp) == 0);
545	greg	2.1	}