--- ray/src/rt/source.h 2003/02/22 02:07:29 2.5 +++ ray/src/rt/source.h 2025/10/22 16:39:58 2.28 @@ -1,68 +1,27 @@ -/* RCSid: $Id: source.h,v 2.5 2003/02/22 02:07:29 greg Exp $ */ +/* RCSid $Id: source.h,v 2.28 2025/10/22 16:39:58 greg Exp $ */ /* * source.h - header file for ray tracing sources. * * Include after ray.h */ +#ifndef _RAD_SOURCE_H_ +#define _RAD_SOURCE_H_ -/* ==================================================================== - * The Radiance Software License, Version 1.0 - * - * Copyright (c) 1990 - 2002 The Regents of the University of California, - * through Lawrence Berkeley National Laboratory. All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in - * the documentation and/or other materials provided with the - * distribution. - * - * 3. The end-user documentation included with the redistribution, - * if any, must include the following acknowledgment: - * "This product includes Radiance software - * (http://radsite.lbl.gov/) - * developed by the Lawrence Berkeley National Laboratory - * (http://www.lbl.gov/)." - * Alternately, this acknowledgment may appear in the software itself, - * if and wherever such third-party acknowledgments normally appear. - * - * 4. The names "Radiance," "Lawrence Berkeley National Laboratory" - * and "The Regents of the University of California" must - * not be used to endorse or promote products derived from this - * software without prior written permission. For written - * permission, please contact radiance@radsite.lbl.gov. - * - * 5. Products derived from this software may not be called "Radiance", - * nor may "Radiance" appear in their name, without prior written - * permission of Lawrence Berkeley National Laboratory. - * - * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED - * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES - * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE - * DISCLAIMED. IN NO EVENT SHALL Lawrence Berkeley National Laboratory OR - * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF - * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND - * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, - * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT - * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF - * SUCH DAMAGE. - * ==================================================================== - * - * This software consists of voluntary contributions made by many - * individuals on behalf of Lawrence Berkeley National Laboratory. For more - * information on Lawrence Berkeley National Laboratory, please see - * . - */ +#include +#ifdef __cplusplus +extern "C" { +#endif + +#ifndef AIMREQT #define AIMREQT 100 /* required aim success/failure */ +#endif +#ifndef SHADCACHE +#define SHADCACHE 20 /* shadow cache resolution */ +#endif +#ifndef MINSHADCNT +#define MINSHADCNT 2 /* test at least this many shadows */ +#endif #define SDISTANT 01 /* source distant flag */ #define SSKIP 02 /* source skip flag */ @@ -70,8 +29,9 @@ #define SSPOT 010 /* source spotlight flag */ #define SVIRTUAL 020 /* source virtual flag */ #define SFLAT 040 /* source flat flag */ -#define SCYL 0100 /* source cylindrical flag */ -#define SFOLLOW 0200 /* source follow path flag */ +#define SCIR 0100 /* source circular flag */ +#define SCYL 0200 /* source cylindrical flag */ +#define SFOLLOW 0400 /* source follow path flag */ typedef struct { FVECT aim; /* aim direction or center */ @@ -80,11 +40,25 @@ typedef struct { } SPOT; /* spotlight */ typedef struct { - int sflags; /* source flags */ + union { + struct { + FVECT u, v; /* unit vectors */ + } f; /* flat source indexing */ + struct { + FVECT o; /* origin position */ + RREAL e1, e2; /* 1/extent */ + int ax; /* major direction */ + } d; /* distant source indexing */ + } p; /* indexing parameters */ + OBJECT obs[1]; /* cache obstructors (extends struct) */ +} OBSCACHE; /* obstructor cache */ + +typedef struct { FVECT sloc; /* direction or position of source */ FVECT ss[3]; /* source dimension vectors, U, V, and W */ float srad; /* maximum source radius */ float ss2; /* solid angle or projected area */ + OBJREC *so; /* source destination object */ struct { float prox; /* proximity */ SPOT *s; /* spot */ @@ -96,8 +70,12 @@ typedef struct { int sn; /* next source to aim for */ } sv; /* virtual source */ } sa; /* source aiming information */ - long ntests, nhits; /* shadow tests and hits */ - OBJREC *so; /* source destination object */ + unsigned long + ntests, nhits; /* shadow tests and hits */ +#if SHADCACHE + OBSCACHE *obscache; /* obstructor cache */ +#endif + int sflags; /* source flags */ } SRCREC; /* light source */ #define MAXSPART 64 /* maximum partitions per source */ @@ -110,16 +88,16 @@ typedef struct { #define snorm ss[SW] /* normal vector for flat source */ typedef struct { + double dom; /* solid angle of partition */ int sn; /* source number */ short np; /* number of partitions */ short sp; /* this partition number */ - double dom; /* solid angle of partition */ unsigned char spt[MAXSPART/2]; /* source partitioning */ } SRCINDEX; /* source index structure */ #define initsrcindex(s) ((s)->sn = (s)->sp = -1, (s)->np = 0) -#define clrpart(pt) bzero((char *)(pt), MAXSPART/2) +#define clrpart(pt) memset((char *)(pt), '\0', MAXSPART/2) #define setpart(pt,i,v) ((pt)[(i)>>2] |= (v)<<(((i)&3)<<1)) #define spart(pt,pi) ((pt)[(pi)>>2] >> (((pi)&3)<<1) & 3) @@ -139,16 +117,16 @@ typedef struct { * i passed to vproj runs from 0 to nproj-1. */ -typedef struct { - int (*vproj)(); /* project virtual sources */ +typedef struct { /* project virtual sources */ + int (*vproj)(MAT4,OBJREC*,SRCREC*,int); int nproj; /* number of possible projections */ } VSMATERIAL; /* virtual source material functions */ typedef struct { - void (*setsrc)(); /* set light source for object */ - void (*partit)(); /* partition light source object */ - double (*getpleq)(); /* plane equation for surface */ - double (*getdisk)(); /* maximum disk for surface */ + void (*setsrc)(SRCREC*,OBJREC*); /* set light source for object */ + void (*partit)(SRCINDEX*,RAY*); /* partition light source object */ + double (*getpleq)(FVECT,OBJREC*); /* plane equation for surface */ + double (*getdisk)(FVECT,OBJREC*); /* maximum disk for surface */ } SOBJECT; /* source object functions */ typedef union { @@ -167,68 +145,39 @@ extern int nsources; /* the number of sources */ #define getmaxdisk(c,o) (*sfun[(o)->otype].of->getdisk)(c,o) #define setsource(s,o) (*sfun[(o)->otype].of->setsrc)(s,o) -#ifdef NOPROTO - -extern void marksources(); -extern void freesources(); -extern int srcray(); -extern void srcvalue(); -extern int sourcehit(); -extern void direct(); -extern void srcscatter(); -extern int m_light(); -extern double nextssamp(); -extern int skipparts(); -extern void nopart(); -extern void cylpart(); -extern void flatpart(); -extern double scylform(); -extern void initstypes(); -extern int newsource(); -extern void setflatss(); -extern void fsetsrc(); -extern void ssetsrc(); -extern void sphsetsrc(); -extern void rsetsrc(); -extern void cylsetsrc(); -extern SPOT *makespot(); -extern int spotout(); -extern double fgetmaxdisk(); -extern double rgetmaxdisk(); -extern double fgetplaneq(); -extern double rgetplaneq(); -extern int commonspot(); -extern int commonbeam(); -extern int checkspot(); -extern double spotdisk(); -extern double beamdisk(); -extern double intercircle(); -extern void markvirtuals(); -extern void addvirtuals(); -extern void vproject(); -extern OBJREC *vsmaterial(); -extern int makevsrc(); -extern double getdisk(); -extern int vstestvis(); -extern void virtverb(); - -#else /* defined in source.c */ extern void marksources(void); +extern void distantsources(void); extern void freesources(void); extern int srcray(RAY *sr, RAY *r, SRCINDEX *si); extern void srcvalue(RAY *r); extern int sourcehit(RAY *r); -extern void direct(RAY *r, void (*f)(), char *p); +typedef void srcdirf_t(SCOLOR cv, void *np, FVECT ldir, double omega); +extern void direct(RAY *r, srcdirf_t *f, void *p); extern void srcscatter(RAY *r); extern int m_light(OBJREC *m, RAY *r); + /* defined in srcobstr.c */ +extern void initobscache(int sn); +extern int srcblocker(RAY *r); +extern int srcblocked(RAY *r); +extern void freeobscache(SRCREC *s); +extern void markclip(OBJREC *m); /* defined in srcsamp.c */ +extern int srcskip(int sn, RAY *r); extern double nextssamp(RAY *r, SRCINDEX *si); extern int skipparts(int ct[3], int sz[3], int pp[2], unsigned char *pt); extern void nopart(SRCINDEX *si, RAY *r); extern void cylpart(SRCINDEX *si, RAY *r); extern void flatpart(SRCINDEX *si, RAY *r); extern double scylform(int sn, FVECT dir); + /* defined in srcskipload.c */ +extern int sskip_dim[2]; /* source skip image size */ +extern int srcskip_open(char *bmpspec, char *scorrimg); +extern int srcskip_getrow(int row, int *sndx, float *scorr); +extern int *srcskip_ndxmap(void); +extern float *srcskip_corrmap(void); +extern void srcskip_close(void); +extern void srcskip_free_maps(void); /* defined in srcsupp.c */ extern void initstypes(void); extern int newsource(void); @@ -261,4 +210,9 @@ extern double getdisk(FVECT oc, OBJREC *op, int sn); extern int vstestvis(int f, OBJREC *o, FVECT oc, double or2, int sn); extern void virtverb(int sn, FILE *fp); + +#ifdef __cplusplus +} #endif +#endif /* _RAD_SOURCE_H_ */ +