ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/common/bsdf.c
(Generate patch)

Comparing ray/src/common/bsdf.c (file contents):
Revision 2.37 by greg, Sun Mar 4 20:11:10 2012 UTC vs.
Revision 2.56 by greg, Fri Dec 7 07:38:15 2018 UTC

# Line 35 | Line 35 | const char             *SDerrorEnglish[] = {
35                                  "Unknown error"
36                          };
37  
38 + /* Pointer to error list in preferred language */
39 + const char              **SDerrorList = SDerrorEnglish;
40 +
41   /* Additional information on last error (ASCII English) */
42   char                    SDerrorDetail[256];
43  
44 + /* Empty distribution for getCDist() calls that fail for some reason */
45 + const SDCDst            SDemptyCD;
46 +
47   /* Cache of loaded BSDFs */
48   struct SDCache_s        *SDcacheList = NULL;
49  
50   /* Retain BSDFs in cache list */
51   int                     SDretainSet = SDretainNone;
52  
53 < /* Report any error to the indicated stream (in English) */
53 > /* Report any error to the indicated stream */
54   SDError
55 < SDreportEnglish(SDError ec, FILE *fp)
55 > SDreportError(SDError ec, FILE *fp)
56   {
57          if (!ec)
58                  return SDEnone;
# Line 56 | Line 62 | SDreportEnglish(SDError ec, FILE *fp)
62          }
63          if (fp == NULL)
64                  return ec;
65 <        fputs(SDerrorEnglish[ec], fp);
65 >        fputs(SDerrorList[ec], fp);
66          if (SDerrorDetail[0]) {
67                  fputs(": ", fp);
68                  fputs(SDerrorDetail, fp);
# Line 84 | Line 90 | to_meters(             /* return factor to convert given unit to
90  
91   /* Load geometric dimensions and description (if any) */
92   static SDError
93 < SDloadGeometry(SDData *sd, ezxml_t wdb)
93 > SDloadGeometry(SDData *sd, ezxml_t wtl)
94   {
95 <        ezxml_t         geom;
95 >        ezxml_t         node, matl, geom;
96          double          cfact;
97 <        const char      *fmt, *mgfstr;
97 >        const char      *fmt = NULL, *mgfstr;
98  
99 <        if (wdb == NULL)                /* no geometry section? */
100 <                return SDEnone;
101 <        sd->dim[0] = sd->dim[1] = sd->dim[2] = .0;
102 <        if ((geom = ezxml_child(wdb, "Width")) != NULL)
103 <                sd->dim[0] = atof(ezxml_txt(geom)) *
104 <                                to_meters(ezxml_attr(geom, "unit"));
105 <        if ((geom = ezxml_child(wdb, "Height")) != NULL)
106 <                sd->dim[1] = atof(ezxml_txt(geom)) *
107 <                                to_meters(ezxml_attr(geom, "unit"));
108 <        if ((geom = ezxml_child(wdb, "Thickness")) != NULL)
109 <                sd->dim[2] = atof(ezxml_txt(geom)) *
110 <                                to_meters(ezxml_attr(geom, "unit"));
111 <        if ((sd->dim[0] < 0) | (sd->dim[1] < 0) | (sd->dim[2] < 0)) {
112 <                sprintf(SDerrorDetail, "Negative size in \"%s\"", sd->name);
113 <                return SDEdata;
99 >        SDerrorDetail[0] = '\0';
100 >        sd->matn[0] = '\0'; sd->makr[0] = '\0';
101 >        sd->dim[0] = sd->dim[1] = sd->dim[2] = 0;
102 >        matl = ezxml_child(wtl, "Material");
103 >        if (matl != NULL) {                     /* get material info. */
104 >                if ((node = ezxml_child(matl, "Name")) != NULL) {
105 >                        strncpy(sd->matn, ezxml_txt(node), SDnameLn);
106 >                        if (sd->matn[SDnameLn-1])
107 >                                strcpy(sd->matn+(SDnameLn-4), "...");
108 >                }
109 >                if ((node = ezxml_child(matl, "Manufacturer")) != NULL) {
110 >                        strncpy(sd->makr, ezxml_txt(node), SDnameLn);
111 >                        if (sd->makr[SDnameLn-1])
112 >                                strcpy(sd->makr+(SDnameLn-4), "...");
113 >                }
114 >                if ((node = ezxml_child(matl, "Width")) != NULL)
115 >                        sd->dim[0] = atof(ezxml_txt(node)) *
116 >                                        to_meters(ezxml_attr(node, "unit"));
117 >                if ((node = ezxml_child(matl, "Height")) != NULL)
118 >                        sd->dim[1] = atof(ezxml_txt(node)) *
119 >                                        to_meters(ezxml_attr(node, "unit"));
120 >                if ((node = ezxml_child(matl, "Thickness")) != NULL)
121 >                        sd->dim[2] = atof(ezxml_txt(node)) *
122 >                                        to_meters(ezxml_attr(node, "unit"));
123 >                if ((sd->dim[0] < 0) | (sd->dim[1] < 0) | (sd->dim[2] < 0)) {
124 >                        if (!SDerrorDetail[0])
125 >                                sprintf(SDerrorDetail, "Negative dimension in \"%s\"",
126 >                                                        sd->name);
127 >                        return SDEdata;
128 >                }
129          }
130 <        if ((geom = ezxml_child(wdb, "Geometry")) == NULL ||
131 <                        (mgfstr = ezxml_txt(geom)) == NULL)
130 >        sd->mgf = NULL;
131 >        geom = ezxml_child(wtl, "Geometry");
132 >        if (geom == NULL)                       /* no actual geometry? */
133                  return SDEnone;
134 <        while (isspace(*mgfstr))
135 <                ++mgfstr;
114 <        if (!*mgfstr)
115 <                return SDEnone;
116 <        if ((fmt = ezxml_attr(geom, "format")) != NULL &&
117 <                        strcasecmp(fmt, "MGF")) {
134 >        fmt = ezxml_attr(geom, "format");
135 >        if (fmt != NULL && strcasecmp(fmt, "MGF")) {
136                  sprintf(SDerrorDetail,
137                          "Unrecognized geometry format '%s' in \"%s\"",
138                                          fmt, sd->name);
139                  return SDEsupport;
140          }
141 <        cfact = to_meters(ezxml_attr(geom, "unit"));
141 >        if ((node = ezxml_child(geom, "MGFblock")) == NULL ||
142 >                        (mgfstr = ezxml_txt(node)) == NULL)
143 >                return SDEnone;
144 >        while (isspace(*mgfstr))
145 >                ++mgfstr;
146 >        if (!*mgfstr)
147 >                return SDEnone;
148 >        cfact = to_meters(ezxml_attr(node, "unit"));
149 >        if (cfact <= 0)
150 >                return SDEformat;
151          sd->mgf = (char *)malloc(strlen(mgfstr)+32);
152          if (sd->mgf == NULL) {
153                  strcpy(SDerrorDetail, "Out of memory in SDloadGeometry");
# Line 162 | Line 189 | SDloadFile(SDData *sd, const char *fname)
189                  ezxml_free(fl);
190                  return SDEformat;
191          }
192 +        wtl = ezxml_child(fl, "FileType");
193 +        if (wtl != NULL && strcmp(ezxml_txt(wtl), "BSDF")) {
194 +                sprintf(SDerrorDetail,
195 +                        "XML \"%s\": wrong FileType (must be 'BSDF')",
196 +                                sd->name);
197 +                ezxml_free(fl);
198 +                return SDEformat;
199 +        }
200          wtl = ezxml_child(ezxml_child(fl, "Optical"), "Layer");
201          if (wtl == NULL) {
202 <                sprintf(SDerrorDetail, "BSDF \"%s\": no optical layer'",
202 >                sprintf(SDerrorDetail, "BSDF \"%s\": no optical layers",
203                                  sd->name);
204                  ezxml_free(fl);
205                  return SDEformat;
206          }
207                                  /* load geometry if present */
208 <        lastErr = SDloadGeometry(sd, ezxml_child(wtl, "Material"));
208 >        lastErr = SDloadGeometry(sd, wtl);
209          if (lastErr) {
210                  ezxml_free(fl);
211                  return lastErr;
# Line 198 | Line 233 | SDloadFile(SDData *sd, const char *fname)
233          if (sd->tf != NULL && sd->tf->maxHemi <= .001) {
234                  SDfreeSpectralDF(sd->tf); sd->tf = NULL;
235          }
236 +        if (sd->tb != NULL && sd->tb->maxHemi <= .001) {
237 +                SDfreeSpectralDF(sd->tb); sd->tb = NULL;
238 +        }
239                                  /* return success */
240          return SDEnone;
241   }
# Line 332 | Line 370 | SDfreeBSDF(SDData *sd)
370                  SDfreeSpectralDF(sd->tf);
371                  sd->tf = NULL;
372          }
373 +        if (sd->tb != NULL) {
374 +                SDfreeSpectralDF(sd->tb);
375 +                sd->tb = NULL;
376 +        }
377          sd->rLambFront.cieY = .0;
378          sd->rLambFront.spec.flags = 0;
379          sd->rLambBack.cieY = .0;
# Line 380 | Line 422 | SDcacheFile(const char *fname)
422          if (fname == NULL || !*fname)
423                  return NULL;
424          SDerrorDetail[0] = '\0';
425 +        /* PLACE MUTEX LOCK HERE FOR THREAD-SAFE */
426          if ((sd = SDgetCache(fname)) == NULL) {
427 <                SDreportEnglish(SDEmemory, stderr);
427 >                SDreportError(SDEmemory, stderr);
428                  return NULL;
429          }
430          if (!SDisLoaded(sd) && (ec = SDloadFile(sd, fname))) {
431 <                SDreportEnglish(ec, stderr);
431 >                SDreportError(ec, stderr);
432                  SDfreeCache(sd);
433 <                return NULL;
433 >                sd = NULL;
434          }
435 +        /* END MUTEX LOCK */
436          return sd;
437   }
438  
# Line 419 | Line 463 | SDfreeCache(const SDData *sd)
463                  SDfreeCumulativeCache(sd->rf);
464                  SDfreeCumulativeCache(sd->rb);
465                  SDfreeCumulativeCache(sd->tf);
466 +                SDfreeCumulativeCache(sd->tb);
467                  return;
468          }
469                                          /* remove from list and free */
# Line 445 | Line 490 | SDsampComponent(SDValue *sv, FVECT ioVec, double randX
490                  return SDEargument;
491                                          /* get cumulative distribution */
492          VCOPY(inVec, ioVec);
493 +        sv->cieY = 0;
494          cd = (*sdc->func->getCDist)(inVec, sdc);
495 <        if (cd == NULL)
496 <                return SDEmemory;
497 <        if (cd->cTotal <= 1e-6) {       /* anything to sample? */
495 >        if (cd != NULL)
496 >                sv->cieY = cd->cTotal;
497 >        if (sv->cieY <= 1e-6) {         /* nothing to sample? */
498                  sv->spec = c_dfcolor;
499 <                sv->cieY = .0;
454 <                memset(ioVec, 0, 3*sizeof(double));
499 >                memset(ioVec, 0, sizeof(FVECT));
500                  return SDEnone;
501          }
457        sv->cieY = cd->cTotal;
502                                          /* compute sample direction */
503          ec = (*sdc->func->sampCDist)(ioVec, randX, cd);
504          if (ec)
# Line 471 | Line 515 | SDsampComponent(SDValue *sv, FVECT ioVec, double randX
515                  c_cmix(&sv->spec, d, &sv->spec, coef[n], &sdc->cspec[n]);
516                  d += coef[n];
517          }
518 <                                        /* make sure everything is set */
475 <        c_ccvt(&sv->spec, C_CSXY+C_CSSPEC);
518 >        c_ccvt(&sv->spec, C_CSXY);      /* make sure (x,y) is set */
519          return SDEnone;
520   }
521  
# Line 485 | Line 528 | SDmultiSamp(double t[], int n, double randX)
528          unsigned        nBits;
529          double          scale;
530          bitmask_t       ndx, coord[MS_MAXDIM];
531 <        
531 >
532 >        if (n <= 0)                     /* check corner cases */
533 >                return;
534 >        if (randX < 0) randX = 0;
535 >        else if (randX >= 1.) randX = 0.999999999999999;
536 >        if (n == 1) {
537 >                t[0] = randX;
538 >                return;
539 >        }
540          while (n > MS_MAXDIM)           /* punt for higher dimensions */
541                  t[--n] = rand()*(1./(RAND_MAX+.5));
542          nBits = (8*sizeof(bitmask_t) - 1) / n;
# Line 508 | Line 559 | SDdiffuseSamp(FVECT outVec, int outFront, double randX
559          SDmultiSamp(outVec, 2, randX);
560          SDsquare2disk(outVec, outVec[0], outVec[1]);
561          outVec[2] = 1. - outVec[0]*outVec[0] - outVec[1]*outVec[1];
562 <        if (outVec[2] > 0)              /* a bit of paranoia */
512 <                outVec[2] = sqrt(outVec[2]);
562 >        outVec[2] = sqrt(outVec[2]*(outVec[2]>0));
563          if (!outFront)                  /* going out back? */
564                  outVec[2] = -outVec[2];
565   }
# Line 539 | Line 589 | SDsizeBSDF(double *projSA, const FVECT v1, const RREAL
589          case 0:
590                  return SDEargument;
591          }
592 <        if (v1[2] > 0)                  /* front surface query? */
592 >        if (v1[2] > 0) {                /* front surface query? */
593                  rdf = sd->rf;
594 <        else
594 >                tdf = (sd->tf != NULL) ? sd->tf : sd->tb;
595 >        } else {
596                  rdf = sd->rb;
597 <        tdf = sd->tf;
598 <        if (v2 != NULL)                 /* bidirectional? */
597 >                tdf = (sd->tb != NULL) ? sd->tb : sd->tf;
598 >        }
599 >        if (v2 != NULL) {               /* bidirectional? */
600                  if (v1[2] > 0 ^ v2[2] > 0)
601                          rdf = NULL;
602                  else
603                          tdf = NULL;
604 +        }
605          ec = SDEdata;                   /* run through components */
606          for (i = (rdf==NULL) ? 0 : rdf->ncomp; i--; ) {
607                  ec = (*rdf->comp[i].func->queryProjSA)(projSA, v1, v2,
# Line 566 | Line 619 | SDsizeBSDF(double *projSA, const FVECT v1, const RREAL
619                  projSA[0] = M_PI;
620                  if (qflags == SDqueryMin+SDqueryMax)
621                          projSA[1] = M_PI;
622 <        }
622 >        } else if (qflags == SDqueryMin+SDqueryMax && projSA[0] > projSA[1])
623 >                projSA[0] = projSA[1];
624          return SDEnone;
625   }
626  
# Line 591 | Line 645 | SDevalBSDF(SDValue *sv, const FVECT outVec, const FVEC
645          } else if (!(inFront | outFront)) {
646                  *sv = sd->rLambBack;
647                  sdf = sd->rb;
648 <        } else /* inFront ^ outFront */ {
648 >        } else if (outFront) {
649                  *sv = sd->tLamb;
650 <                sdf = sd->tf;
650 >                sdf = (sd->tf != NULL) ? sd->tf : sd->tb;
651 >        } else /* inFront & !outFront */ {
652 >                *sv = sd->tLamb;
653 >                sdf = (sd->tb != NULL) ? sd->tb : sd->tf;
654          }
655          sv->cieY *= 1./M_PI;
656                                          /* add non-diffuse components */
# Line 607 | Line 664 | SDevalBSDF(SDValue *sv, const FVECT outVec, const FVEC
664                          sv->cieY += coef[nch];
665                  }
666          }
667 <                                        /* make sure everything is set */
611 <        c_ccvt(&sv->spec, C_CSXY+C_CSSPEC);
667 >        c_ccvt(&sv->spec, C_CSXY);      /* make sure (x,y) is set */
668          return SDEnone;
669   }
670  
# Line 617 | Line 673 | double
673   SDdirectHemi(const FVECT inVec, int sflags, const SDData *sd)
674   {
675          double          hsum;
676 <        SDSpectralDF    *rdf;
676 >        SDSpectralDF    *rdf, *tdf;
677          const SDCDst    *cd;
678          int             i;
679                                          /* check arguments */
# Line 627 | Line 683 | SDdirectHemi(const FVECT inVec, int sflags, const SDDa
683          if (inVec[2] > 0) {
684                  hsum = sd->rLambFront.cieY;
685                  rdf = sd->rf;
686 +                tdf = (sd->tf != NULL) ? sd->tf : sd->tb;
687          } else /* !inFront */ {
688                  hsum = sd->rLambBack.cieY;
689                  rdf = sd->rb;
690 +                tdf = (sd->tb != NULL) ? sd->tb : sd->tf;
691          }
692          if ((sflags & SDsampDf+SDsampR) != SDsampDf+SDsampR)
693                  hsum = .0;
694          if ((sflags & SDsampDf+SDsampT) == SDsampDf+SDsampT)
695                  hsum += sd->tLamb.cieY;
696                                          /* gather non-diffuse components */
697 <        i = ((sflags & SDsampSp+SDsampR) == SDsampSp+SDsampR &&
698 <                        rdf != NULL) ? rdf->ncomp : 0;
697 >        i = (((sflags & SDsampSp+SDsampR) == SDsampSp+SDsampR) &
698 >                        (rdf != NULL)) ? rdf->ncomp : 0;
699          while (i-- > 0) {               /* non-diffuse reflection */
700                  cd = (*rdf->comp[i].func->getCDist)(inVec, &rdf->comp[i]);
701                  if (cd != NULL)
702                          hsum += cd->cTotal;
703          }
704 <        i = ((sflags & SDsampSp+SDsampT) == SDsampSp+SDsampT &&
705 <                        sd->tf != NULL) ? sd->tf->ncomp : 0;
704 >        i = (((sflags & SDsampSp+SDsampT) == SDsampSp+SDsampT) &
705 >                        (tdf != NULL)) ? tdf->ncomp : 0;
706          while (i-- > 0) {               /* non-diffuse transmission */
707 <                cd = (*sd->tf->comp[i].func->getCDist)(inVec, &sd->tf->comp[i]);
707 >                cd = (*tdf->comp[i].func->getCDist)(inVec, &tdf->comp[i]);
708                  if (cd != NULL)
709                          hsum += cd->cTotal;
710          }
# Line 660 | Line 718 | SDsampBSDF(SDValue *sv, FVECT ioVec, double randX, int
718          SDError         ec;
719          FVECT           inVec;
720          int             inFront;
721 <        SDSpectralDF    *rdf;
721 >        SDSpectralDF    *rdf, *tdf;
722          double          rdiff;
723          float           coef[SDmaxCh];
724          int             i, j, n, nr;
# Line 677 | Line 735 | SDsampBSDF(SDValue *sv, FVECT ioVec, double randX, int
735          if (inFront) {
736                  *sv = sd->rLambFront;
737                  rdf = sd->rf;
738 +                tdf = (sd->tf != NULL) ? sd->tf : sd->tb;
739          } else /* !inFront */ {
740                  *sv = sd->rLambBack;
741                  rdf = sd->rb;
742 +                tdf = (sd->tb != NULL) ? sd->tb : sd->tf;
743          }
744          if ((sflags & SDsampDf+SDsampR) != SDsampDf+SDsampR)
745                  sv->cieY = .0;
# Line 687 | Line 747 | SDsampBSDF(SDValue *sv, FVECT ioVec, double randX, int
747          if ((sflags & SDsampDf+SDsampT) == SDsampDf+SDsampT)
748                  sv->cieY += sd->tLamb.cieY;
749                                          /* gather non-diffuse components */
750 <        i = nr = ((sflags & SDsampSp+SDsampR) == SDsampSp+SDsampR &&
751 <                        rdf != NULL) ? rdf->ncomp : 0;
752 <        j = ((sflags & SDsampSp+SDsampT) == SDsampSp+SDsampT &&
753 <                        sd->tf != NULL) ? sd->tf->ncomp : 0;
750 >        i = nr = (((sflags & SDsampSp+SDsampR) == SDsampSp+SDsampR) &
751 >                        (rdf != NULL)) ? rdf->ncomp : 0;
752 >        j = (((sflags & SDsampSp+SDsampT) == SDsampSp+SDsampT) &
753 >                        (tdf != NULL)) ? tdf->ncomp : 0;
754          n = i + j;
755          if (n > 0 && (cdarr = (const SDCDst **)malloc(n*sizeof(SDCDst *))) == NULL)
756                  return SDEmemory;
757          while (j-- > 0) {               /* non-diffuse transmission */
758 <                cdarr[i+j] = (*sd->tf->comp[j].func->getCDist)(inVec, &sd->tf->comp[j]);
759 <                if (cdarr[i+j] == NULL) {
760 <                        free(cdarr);
701 <                        return SDEmemory;
702 <                }
758 >                cdarr[i+j] = (*tdf->comp[j].func->getCDist)(inVec, &tdf->comp[j]);
759 >                if (cdarr[i+j] == NULL)
760 >                        cdarr[i+j] = &SDemptyCD;
761                  sv->cieY += cdarr[i+j]->cTotal;
762          }
763          while (i-- > 0) {               /* non-diffuse reflection */
764                  cdarr[i] = (*rdf->comp[i].func->getCDist)(inVec, &rdf->comp[i]);
765 <                if (cdarr[i] == NULL) {
766 <                        free(cdarr);
709 <                        return SDEmemory;
710 <                }
765 >                if (cdarr[i] == NULL)
766 >                        cdarr[i] = &SDemptyCD;
767                  sv->cieY += cdarr[i]->cTotal;
768          }
769          if (sv->cieY <= 1e-6) {         /* anything to sample? */
770                  sv->cieY = .0;
771 <                memset(ioVec, 0, 3*sizeof(double));
771 >                memset(ioVec, 0, sizeof(FVECT));
772                  return SDEnone;
773          }
774                                          /* scale random variable */
# Line 733 | Line 789 | SDsampBSDF(SDValue *sv, FVECT ioVec, double randX, int
789                  randX -= sd->tLamb.cieY;
790          }
791                                          /* else one of cumulative dist. */
792 <        for (i = 0; i < n && randX < cdarr[i]->cTotal; i++)
792 >        for (i = 0; i < n && randX >= cdarr[i]->cTotal; i++)
793                  randX -= cdarr[i]->cTotal;
794          if (i >= n)
795                  return SDEinternal;
796                                          /* compute sample direction */
797 <        sdc = (i < nr) ? &rdf->comp[i] : &sd->tf->comp[i-nr];
797 >        sdc = (i < nr) ? &rdf->comp[i] : &tdf->comp[i-nr];
798          ec = (*sdc->func->sampCDist)(ioVec, randX/cdarr[i]->cTotal, cdarr[i]);
799          if (ec)
800                  return ec;
# Line 758 | Line 814 | SDsampBSDF(SDValue *sv, FVECT ioVec, double randX, int
814   done:
815          if (cdarr != NULL)
816                  free(cdarr);
817 <                                        /* make sure everything is set */
762 <        c_ccvt(&sv->spec, C_CSXY+C_CSSPEC);
817 >        c_ccvt(&sv->spec, C_CSXY);      /* make sure (x,y) is set */
818          return SDEnone;
819   }
820  
# Line 830 | Line 885 | SDmapDir(FVECT resVec, RREAL vMtx[3][3], const FVECT i
885          VCOPY(resVec, vTmp);
886          return SDEnone;
887   }
833
834 /*################################################################*/
835 /*######### DEPRECATED ROUTINES AWAITING PERMANENT REMOVAL #######*/
836
837 /*
838 * Routines for handling BSDF data
839 */
840
841 #include "standard.h"
842 #include "paths.h"
843
844 #define MAXLATS         46              /* maximum number of latitudes */
845
846 /* BSDF angle specification */
847 typedef struct {
848        char    name[64];               /* basis name */
849        int     nangles;                /* total number of directions */
850        struct {
851                float   tmin;                   /* starting theta */
852                short   nphis;                  /* number of phis (0 term) */
853        }       lat[MAXLATS+1];         /* latitudes */
854 } ANGLE_BASIS;
855
856 #define MAXABASES       7               /* limit on defined bases */
857
858 static ANGLE_BASIS      abase_list[MAXABASES] = {
859        {
860                "LBNL/Klems Full", 145,
861                { {-5., 1},
862                {5., 8},
863                {15., 16},
864                {25., 20},
865                {35., 24},
866                {45., 24},
867                {55., 24},
868                {65., 16},
869                {75., 12},
870                {90., 0} }
871        }, {
872                "LBNL/Klems Half", 73,
873                { {-6.5, 1},
874                {6.5, 8},
875                {19.5, 12},
876                {32.5, 16},
877                {46.5, 20},
878                {61.5, 12},
879                {76.5, 4},
880                {90., 0} }
881        }, {
882                "LBNL/Klems Quarter", 41,
883                { {-9., 1},
884                {9., 8},
885                {27., 12},
886                {46., 12},
887                {66., 8},
888                {90., 0} }
889        }
890 };
891
892 static int      nabases = 3;    /* current number of defined bases */
893
894 #define  FEQ(a,b)       ((a)-(b) <= 1e-6 && (b)-(a) <= 1e-6)
895
896 static int
897 fequal(double a, double b)
898 {
899        if (b != 0)
900                a = a/b - 1.;
901        return((a <= 1e-6) & (a >= -1e-6));
902 }
903
904 /* Returns the name of the given tag */
905 #ifdef ezxml_name
906 #undef ezxml_name
907 static char *
908 ezxml_name(ezxml_t xml)
909 {
910        if (xml == NULL)
911                return(NULL);
912        return(xml->name);
913 }
914 #endif
915
916 /* Returns the given tag's character content or empty string if none */
917 #ifdef ezxml_txt
918 #undef ezxml_txt
919 static char *
920 ezxml_txt(ezxml_t xml)
921 {
922        if (xml == NULL)
923                return("");
924        return(xml->txt);
925 }
926 #endif
927
928
929 static int
930 ab_getvec(              /* get vector for this angle basis index */
931        FVECT v,
932        int ndx,
933        void *p
934 )
935 {
936        ANGLE_BASIS  *ab = (ANGLE_BASIS *)p;
937        int     li;
938        double  pol, azi, d;
939        
940        if ((ndx < 0) | (ndx >= ab->nangles))
941                return(0);
942        for (li = 0; ndx >= ab->lat[li].nphis; li++)
943                ndx -= ab->lat[li].nphis;
944        pol = PI/180.*0.5*(ab->lat[li].tmin + ab->lat[li+1].tmin);
945        azi = 2.*PI*ndx/ab->lat[li].nphis;
946        v[2] = d = cos(pol);
947        d = sqrt(1. - d*d);     /* sin(pol) */
948        v[0] = cos(azi)*d;
949        v[1] = sin(azi)*d;
950        return(1);
951 }
952
953
954 static int
955 ab_getndx(              /* get index corresponding to the given vector */
956        FVECT v,
957        void *p
958 )
959 {
960        ANGLE_BASIS  *ab = (ANGLE_BASIS *)p;
961        int     li, ndx;
962        double  pol, azi;
963
964        if ((v[2] < -1.0) | (v[2] > 1.0))
965                return(-1);
966        pol = 180.0/PI*acos(v[2]);
967        azi = 180.0/PI*atan2(v[1], v[0]);
968        if (azi < 0.0) azi += 360.0;
969        for (li = 1; ab->lat[li].tmin <= pol; li++)
970                if (!ab->lat[li].nphis)
971                        return(-1);
972        --li;
973        ndx = (int)((1./360.)*azi*ab->lat[li].nphis + 0.5);
974        if (ndx >= ab->lat[li].nphis) ndx = 0;
975        while (li--)
976                ndx += ab->lat[li].nphis;
977        return(ndx);
978 }
979
980
981 static double
982 ab_getohm(              /* get solid angle for this angle basis index */
983        int ndx,
984        void *p
985 )
986 {
987        ANGLE_BASIS  *ab = (ANGLE_BASIS *)p;
988        int     li;
989        double  theta, theta1;
990        
991        if ((ndx < 0) | (ndx >= ab->nangles))
992                return(0);
993        for (li = 0; ndx >= ab->lat[li].nphis; li++)
994                ndx -= ab->lat[li].nphis;
995        theta1 = PI/180. * ab->lat[li+1].tmin;
996        if (ab->lat[li].nphis == 1) {           /* special case */
997                if (ab->lat[li].tmin > FTINY)
998                        error(USER, "unsupported BSDF coordinate system");
999                return(2.*PI*(1. - cos(theta1)));
1000        }
1001        theta = PI/180. * ab->lat[li].tmin;
1002        return(2.*PI*(cos(theta) - cos(theta1))/(double)ab->lat[li].nphis);
1003 }
1004
1005
1006 static int
1007 ab_getvecR(             /* get reverse vector for this angle basis index */
1008        FVECT v,
1009        int ndx,
1010        void *p
1011 )
1012 {
1013        if (!ab_getvec(v, ndx, p))
1014                return(0);
1015
1016        v[0] = -v[0];
1017        v[1] = -v[1];
1018        v[2] = -v[2];
1019
1020        return(1);
1021 }
1022
1023
1024 static int
1025 ab_getndxR(             /* get index corresponding to the reverse vector */
1026        FVECT v,
1027        void *p
1028 )
1029 {
1030        FVECT  v2;
1031        
1032        v2[0] = -v[0];
1033        v2[1] = -v[1];
1034        v2[2] = -v[2];
1035
1036        return ab_getndx(v2, p);
1037 }
1038
1039
1040 static void
1041 load_angle_basis(       /* load custom BSDF angle basis */
1042        ezxml_t wab
1043 )
1044 {
1045        char    *abname = ezxml_txt(ezxml_child(wab, "AngleBasisName"));
1046        ezxml_t wbb;
1047        int     i;
1048        
1049        if (!abname || !*abname)
1050                return;
1051        for (i = nabases; i--; )
1052                if (!strcasecmp(abname, abase_list[i].name))
1053                        return;         /* assume it's the same */
1054        if (nabases >= MAXABASES)
1055                error(INTERNAL, "too many angle bases");
1056        strcpy(abase_list[nabases].name, abname);
1057        abase_list[nabases].nangles = 0;
1058        for (i = 0, wbb = ezxml_child(wab, "AngleBasisBlock");
1059                        wbb != NULL; i++, wbb = wbb->next) {
1060                if (i >= MAXLATS)
1061                        error(INTERNAL, "too many latitudes in custom basis");
1062                abase_list[nabases].lat[i+1].tmin = atof(ezxml_txt(
1063                                ezxml_child(ezxml_child(wbb,
1064                                        "ThetaBounds"), "UpperTheta")));
1065                if (!i)
1066                        abase_list[nabases].lat[i].tmin =
1067                                        -abase_list[nabases].lat[i+1].tmin;
1068                else if (!fequal(atof(ezxml_txt(ezxml_child(ezxml_child(wbb,
1069                                        "ThetaBounds"), "LowerTheta"))),
1070                                abase_list[nabases].lat[i].tmin))
1071                        error(WARNING, "theta values disagree in custom basis");
1072                abase_list[nabases].nangles +=
1073                        abase_list[nabases].lat[i].nphis =
1074                                atoi(ezxml_txt(ezxml_child(wbb, "nPhis")));
1075        }
1076        abase_list[nabases++].lat[i].nphis = 0;
1077 }
1078
1079
1080 static void
1081 load_geometry(          /* load geometric dimensions and description (if any) */
1082        struct BSDF_data *dp,
1083        ezxml_t wdb
1084 )
1085 {
1086        ezxml_t         geom;
1087        double          cfact;
1088        const char      *fmt, *mgfstr;
1089
1090        dp->dim[0] = dp->dim[1] = dp->dim[2] = 0;
1091        dp->mgf = NULL;
1092        if ((geom = ezxml_child(wdb, "Width")) != NULL)
1093                dp->dim[0] = atof(ezxml_txt(geom)) *
1094                                to_meters(ezxml_attr(geom, "unit"));
1095        if ((geom = ezxml_child(wdb, "Height")) != NULL)
1096                dp->dim[1] = atof(ezxml_txt(geom)) *
1097                                to_meters(ezxml_attr(geom, "unit"));
1098        if ((geom = ezxml_child(wdb, "Thickness")) != NULL)
1099                dp->dim[2] = atof(ezxml_txt(geom)) *
1100                                to_meters(ezxml_attr(geom, "unit"));
1101        if ((geom = ezxml_child(wdb, "Geometry")) == NULL ||
1102                        (mgfstr = ezxml_txt(geom)) == NULL)
1103                return;
1104        if ((fmt = ezxml_attr(geom, "format")) != NULL &&
1105                        strcasecmp(fmt, "MGF")) {
1106                sprintf(errmsg, "unrecognized geometry format '%s'", fmt);
1107                error(WARNING, errmsg);
1108                return;
1109        }
1110        cfact = to_meters(ezxml_attr(geom, "unit"));
1111        dp->mgf = (char *)malloc(strlen(mgfstr)+32);
1112        if (dp->mgf == NULL)
1113                error(SYSTEM, "out of memory in load_geometry");
1114        if (cfact < 0.99 || cfact > 1.01)
1115                sprintf(dp->mgf, "xf -s %.5f\n%s\nxf\n", cfact, mgfstr);
1116        else
1117                strcpy(dp->mgf, mgfstr);
1118 }
1119
1120
1121 static void
1122 load_bsdf_data(         /* load BSDF distribution for this wavelength */
1123        struct BSDF_data *dp,
1124        ezxml_t wdb
1125 )
1126 {
1127        char  *cbasis = ezxml_txt(ezxml_child(wdb,"ColumnAngleBasis"));
1128        char  *rbasis = ezxml_txt(ezxml_child(wdb,"RowAngleBasis"));
1129        char  *sdata;
1130        int  i;
1131        
1132        if ((!cbasis || !*cbasis) | (!rbasis || !*rbasis)) {
1133                error(WARNING, "missing column/row basis for BSDF");
1134                return;
1135        }
1136        for (i = nabases; i--; )
1137                if (!strcasecmp(cbasis, abase_list[i].name)) {
1138                        dp->ninc = abase_list[i].nangles;
1139                        dp->ib_priv = (void *)&abase_list[i];
1140                        dp->ib_vec = ab_getvecR;
1141                        dp->ib_ndx = ab_getndxR;
1142                        dp->ib_ohm = ab_getohm;
1143                        break;
1144                }
1145        if (i < 0) {
1146                sprintf(errmsg, "undefined ColumnAngleBasis '%s'", cbasis);
1147                error(WARNING, errmsg);
1148                return;
1149        }
1150        for (i = nabases; i--; )
1151                if (!strcasecmp(rbasis, abase_list[i].name)) {
1152                        dp->nout = abase_list[i].nangles;
1153                        dp->ob_priv = (void *)&abase_list[i];
1154                        dp->ob_vec = ab_getvec;
1155                        dp->ob_ndx = ab_getndx;
1156                        dp->ob_ohm = ab_getohm;
1157                        break;
1158                }
1159        if (i < 0) {
1160                sprintf(errmsg, "undefined RowAngleBasis '%s'", rbasis);
1161                error(WARNING, errmsg);
1162                return;
1163        }
1164                                /* read BSDF data */
1165        sdata  = ezxml_txt(ezxml_child(wdb,"ScatteringData"));
1166        if (!sdata || !*sdata) {
1167                error(WARNING, "missing BSDF ScatteringData");
1168                return;
1169        }
1170        dp->bsdf = (float *)malloc(sizeof(float)*dp->ninc*dp->nout);
1171        if (dp->bsdf == NULL)
1172                error(SYSTEM, "out of memory in load_bsdf_data");
1173        for (i = 0; i < dp->ninc*dp->nout; i++) {
1174                char  *sdnext = fskip(sdata);
1175                if (sdnext == NULL) {
1176                        error(WARNING, "bad/missing BSDF ScatteringData");
1177                        free(dp->bsdf); dp->bsdf = NULL;
1178                        return;
1179                }
1180                while (*sdnext && isspace(*sdnext))
1181                        sdnext++;
1182                if (*sdnext == ',') sdnext++;
1183                dp->bsdf[i] = atof(sdata);
1184                sdata = sdnext;
1185        }
1186        while (isspace(*sdata))
1187                sdata++;
1188        if (*sdata) {
1189                sprintf(errmsg, "%d extra characters after BSDF ScatteringData",
1190                                (int)strlen(sdata));
1191                error(WARNING, errmsg);
1192        }
1193 }
1194
1195
1196 static int
1197 check_bsdf_data(        /* check that BSDF data is sane */
1198        struct BSDF_data *dp
1199 )
1200 {
1201        double          *omega_iarr, *omega_oarr;
1202        double          dom, hemi_total, full_total;
1203        int             nneg;
1204        FVECT           v;
1205        int             i, o;
1206
1207        if (dp == NULL || dp->bsdf == NULL)
1208                return(0);
1209        omega_iarr = (double *)calloc(dp->ninc, sizeof(double));
1210        omega_oarr = (double *)calloc(dp->nout, sizeof(double));
1211        if ((omega_iarr == NULL) | (omega_oarr == NULL))
1212                error(SYSTEM, "out of memory in check_bsdf_data");
1213                                        /* incoming projected solid angles */
1214        hemi_total = .0;
1215        for (i = dp->ninc; i--; ) {
1216                dom = getBSDF_incohm(dp,i);
1217                if (dom <= 0) {
1218                        error(WARNING, "zero/negative incoming solid angle");
1219                        continue;
1220                }
1221                if (!getBSDF_incvec(v,dp,i) || v[2] > FTINY) {
1222                        error(WARNING, "illegal incoming BSDF direction");
1223                        free(omega_iarr); free(omega_oarr);
1224                        return(0);
1225                }
1226                hemi_total += omega_iarr[i] = dom * -v[2];
1227        }
1228        if ((hemi_total > 1.02*PI) | (hemi_total < 0.98*PI)) {
1229                sprintf(errmsg, "incoming BSDF hemisphere off by %.1f%%",
1230                                100.*(hemi_total/PI - 1.));
1231                error(WARNING, errmsg);
1232        }
1233        dom = PI / hemi_total;          /* fix normalization */
1234        for (i = dp->ninc; i--; )
1235                omega_iarr[i] *= dom;
1236                                        /* outgoing projected solid angles */
1237        hemi_total = .0;
1238        for (o = dp->nout; o--; ) {
1239                dom = getBSDF_outohm(dp,o);
1240                if (dom <= 0) {
1241                        error(WARNING, "zero/negative outgoing solid angle");
1242                        continue;
1243                }
1244                if (!getBSDF_outvec(v,dp,o) || v[2] < -FTINY) {
1245                        error(WARNING, "illegal outgoing BSDF direction");
1246                        free(omega_iarr); free(omega_oarr);
1247                        return(0);
1248                }
1249                hemi_total += omega_oarr[o] = dom * v[2];
1250        }
1251        if ((hemi_total > 1.02*PI) | (hemi_total < 0.98*PI)) {
1252                sprintf(errmsg, "outgoing BSDF hemisphere off by %.1f%%",
1253                                100.*(hemi_total/PI - 1.));
1254                error(WARNING, errmsg);
1255        }
1256        dom = PI / hemi_total;          /* fix normalization */
1257        for (o = dp->nout; o--; )
1258                omega_oarr[o] *= dom;
1259        nneg = 0;                       /* check outgoing totals */
1260        for (i = 0; i < dp->ninc; i++) {
1261                hemi_total = .0;
1262                for (o = dp->nout; o--; ) {
1263                        double  f = BSDF_value(dp,i,o);
1264                        if (f >= 0)
1265                                hemi_total += f*omega_oarr[o];
1266                        else {
1267                                nneg += (f < -FTINY);
1268                                BSDF_value(dp,i,o) = .0f;
1269                        }
1270                }
1271                if (hemi_total > 1.01) {
1272                        sprintf(errmsg,
1273                        "incoming BSDF direction %d passes %.1f%% of light",
1274                                        i, 100.*hemi_total);
1275                        error(WARNING, errmsg);
1276                }
1277        }
1278        if (nneg) {
1279                sprintf(errmsg, "%d negative BSDF values (ignored)", nneg);
1280                error(WARNING, errmsg);
1281        }
1282        full_total = .0;                /* reverse roles and check again */
1283        for (o = 0; o < dp->nout; o++) {
1284                hemi_total = .0;
1285                for (i = dp->ninc; i--; )
1286                        hemi_total += BSDF_value(dp,i,o) * omega_iarr[i];
1287
1288                if (hemi_total > 1.01) {
1289                        sprintf(errmsg,
1290                        "outgoing BSDF direction %d collects %.1f%% of light",
1291                                        o, 100.*hemi_total);
1292                        error(WARNING, errmsg);
1293                }
1294                full_total += hemi_total*omega_oarr[o];
1295        }
1296        full_total /= PI;
1297        if (full_total > 1.00001) {
1298                sprintf(errmsg, "BSDF transfers %.4f%% of light",
1299                                100.*full_total);
1300                error(WARNING, errmsg);
1301        }
1302        free(omega_iarr); free(omega_oarr);
1303        return(1);
1304 }
1305
1306
1307 struct BSDF_data *
1308 load_BSDF(              /* load BSDF data from file */
1309        char *fname
1310 )
1311 {
1312        char                    *path;
1313        ezxml_t                 fl, wtl, wld, wdb;
1314        struct BSDF_data        *dp;
1315        
1316        path = getpath(fname, getrlibpath(), R_OK);
1317        if (path == NULL) {
1318                sprintf(errmsg, "cannot find BSDF file \"%s\"", fname);
1319                error(WARNING, errmsg);
1320                return(NULL);
1321        }
1322        fl = ezxml_parse_file(path);
1323        if (fl == NULL) {
1324                sprintf(errmsg, "cannot open BSDF \"%s\"", path);
1325                error(WARNING, errmsg);
1326                return(NULL);
1327        }
1328        if (ezxml_error(fl)[0]) {
1329                sprintf(errmsg, "BSDF \"%s\" %s", path, ezxml_error(fl));
1330                error(WARNING, errmsg);
1331                ezxml_free(fl);
1332                return(NULL);
1333        }
1334        if (strcmp(ezxml_name(fl), "WindowElement")) {
1335                sprintf(errmsg,
1336                        "BSDF \"%s\": top level node not 'WindowElement'",
1337                                path);
1338                error(WARNING, errmsg);
1339                ezxml_free(fl);
1340                return(NULL);
1341        }
1342        wtl = ezxml_child(ezxml_child(fl, "Optical"), "Layer");
1343        if (strcasecmp(ezxml_txt(ezxml_child(ezxml_child(wtl,
1344                        "DataDefinition"), "IncidentDataStructure")),
1345                        "Columns")) {
1346                sprintf(errmsg,
1347                        "BSDF \"%s\": unsupported IncidentDataStructure",
1348                                path);
1349                error(WARNING, errmsg);
1350                ezxml_free(fl);
1351                return(NULL);
1352        }
1353        for (wld = ezxml_child(ezxml_child(wtl,
1354                                "DataDefinition"), "AngleBasis");
1355                        wld != NULL; wld = wld->next)
1356                load_angle_basis(wld);
1357        dp = (struct BSDF_data *)calloc(1, sizeof(struct BSDF_data));
1358        load_geometry(dp, ezxml_child(wtl, "Material"));
1359        for (wld = ezxml_child(wtl, "WavelengthData");
1360                                wld != NULL; wld = wld->next) {
1361                if (strcasecmp(ezxml_txt(ezxml_child(wld,"Wavelength")),
1362                                "Visible"))
1363                        continue;
1364                for (wdb = ezxml_child(wld, "WavelengthDataBlock");
1365                                wdb != NULL; wdb = wdb->next)
1366                        if (!strcasecmp(ezxml_txt(ezxml_child(wdb,
1367                                        "WavelengthDataDirection")),
1368                                        "Transmission Front"))
1369                                break;
1370                if (wdb != NULL) {              /* load front BTDF */
1371                        load_bsdf_data(dp, wdb);
1372                        break;                  /* ignore the rest */
1373                }
1374        }
1375        ezxml_free(fl);                         /* done with XML file */
1376        if (!check_bsdf_data(dp)) {
1377                sprintf(errmsg, "bad/missing BTDF data in \"%s\"", path);
1378                error(WARNING, errmsg);
1379                free_BSDF(dp);
1380                dp = NULL;
1381        }
1382        return(dp);
1383 }
1384
1385
1386 void
1387 free_BSDF(              /* free BSDF data structure */
1388        struct BSDF_data *b
1389 )
1390 {
1391        if (b == NULL)
1392                return;
1393        if (b->mgf != NULL)
1394                free(b->mgf);
1395        if (b->bsdf != NULL)
1396                free(b->bsdf);
1397        free(b);
1398 }
1399
1400
1401 int
1402 r_BSDF_incvec(          /* compute random input vector at given location */
1403        FVECT v,
1404        struct BSDF_data *b,
1405        int i,
1406        double rv,
1407        MAT4 xm
1408 )
1409 {
1410        FVECT   pert;
1411        double  rad;
1412        int     j;
1413        
1414        if (!getBSDF_incvec(v, b, i))
1415                return(0);
1416        rad = sqrt(getBSDF_incohm(b, i) / PI);
1417        multisamp(pert, 3, rv);
1418        for (j = 0; j < 3; j++)
1419                v[j] += rad*(2.*pert[j] - 1.);
1420        if (xm != NULL)
1421                multv3(v, v, xm);
1422        return(normalize(v) != 0.0);
1423 }
1424
1425
1426 int
1427 r_BSDF_outvec(          /* compute random output vector at given location */
1428        FVECT v,
1429        struct BSDF_data *b,
1430        int o,
1431        double rv,
1432        MAT4 xm
1433 )
1434 {
1435        FVECT   pert;
1436        double  rad;
1437        int     j;
1438        
1439        if (!getBSDF_outvec(v, b, o))
1440                return(0);
1441        rad = sqrt(getBSDF_outohm(b, o) / PI);
1442        multisamp(pert, 3, rv);
1443        for (j = 0; j < 3; j++)
1444                v[j] += rad*(2.*pert[j] - 1.);
1445        if (xm != NULL)
1446                multv3(v, v, xm);
1447        return(normalize(v) != 0.0);
1448 }
1449
1450
1451 static int
1452 addrot(                 /* compute rotation (x,y,z) => (xp,yp,zp) */
1453        char *xfarg[],
1454        FVECT xp,
1455        FVECT yp,
1456        FVECT zp
1457 )
1458 {
1459        static char     bufs[3][16];
1460        int     bn = 0;
1461        char    **xfp = xfarg;
1462        double  theta;
1463
1464        if (yp[2]*yp[2] + zp[2]*zp[2] < 2.*FTINY*FTINY) {
1465                /* Special case for X' along Z-axis */
1466                theta = -atan2(yp[0], yp[1]);
1467                *xfp++ = "-ry";
1468                *xfp++ = xp[2] < 0.0 ? "90" : "-90";
1469                *xfp++ = "-rz";
1470                sprintf(bufs[bn], "%f", theta*(180./PI));
1471                *xfp++ = bufs[bn++];
1472                return(xfp - xfarg);
1473        }
1474        theta = atan2(yp[2], zp[2]);
1475        if (!FEQ(theta,0.0)) {
1476                *xfp++ = "-rx";
1477                sprintf(bufs[bn], "%f", theta*(180./PI));
1478                *xfp++ = bufs[bn++];
1479        }
1480        theta = asin(-xp[2]);
1481        if (!FEQ(theta,0.0)) {
1482                *xfp++ = "-ry";
1483                sprintf(bufs[bn], " %f", theta*(180./PI));
1484                *xfp++ = bufs[bn++];
1485        }
1486        theta = atan2(xp[1], xp[0]);
1487        if (!FEQ(theta,0.0)) {
1488                *xfp++ = "-rz";
1489                sprintf(bufs[bn], "%f", theta*(180./PI));
1490                *xfp++ = bufs[bn++];
1491        }
1492        *xfp = NULL;
1493        return(xfp - xfarg);
1494 }
1495
1496
1497 int
1498 getBSDF_xfm(            /* compute BSDF orient. -> world orient. transform */
1499        MAT4 xm,
1500        FVECT nrm,
1501        UpDir ud,
1502        char *xfbuf
1503 )
1504 {
1505        char    *xfargs[7];
1506        XF      myxf;
1507        FVECT   updir, xdest, ydest;
1508        int     i;
1509
1510        updir[0] = updir[1] = updir[2] = 0.;
1511        switch (ud) {
1512        case UDzneg:
1513                updir[2] = -1.;
1514                break;
1515        case UDyneg:
1516                updir[1] = -1.;
1517                break;
1518        case UDxneg:
1519                updir[0] = -1.;
1520                break;
1521        case UDxpos:
1522                updir[0] = 1.;
1523                break;
1524        case UDypos:
1525                updir[1] = 1.;
1526                break;
1527        case UDzpos:
1528                updir[2] = 1.;
1529                break;
1530        case UDunknown:
1531                return(0);
1532        }
1533        fcross(xdest, updir, nrm);
1534        if (normalize(xdest) == 0.0)
1535                return(0);
1536        fcross(ydest, nrm, xdest);
1537        xf(&myxf, addrot(xfargs, xdest, ydest, nrm), xfargs);
1538        copymat4(xm, myxf.xfm);
1539        if (xfbuf == NULL)
1540                return(1);
1541                                /* return xf arguments as well */
1542        for (i = 0; xfargs[i] != NULL; i++) {
1543                *xfbuf++ = ' ';
1544                strcpy(xfbuf, xfargs[i]);
1545                while (*xfbuf) ++xfbuf;
1546        }
1547        return(1);
1548 }
1549
1550 /*######### END DEPRECATED ROUTINES #######*/
1551 /*################################################################*/

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines