--- ray/doc/man/man1/rtpict.1 2020/05/06 14:23:18 1.6 +++ ray/doc/man/man1/rtpict.1 2022/04/10 03:46:27 1.10 @@ -1,7 +1,7 @@ -.\" RCSid "$Id: rtpict.1,v 1.6 2020/05/06 14:23:18 greg Exp $" +.\" RCSid "$Id: rtpict.1,v 1.10 2022/04/10 03:46:27 greg Exp $" .TH RTPICT 1 3/19/2018 RADIANCE .SH NAME -rtpict - generate a RADIANCE picture or layerd image using rtrace +rtpict - generate a RADIANCE picture or layered image using rtrace .SH SYNOPSIS .B rtpict .B "-n nproc" @@ -100,7 +100,7 @@ with the 'v' type will be renamed .I "irradiance.hdr" and some other output types become irrelevant (i.e., 'r', 'x', 'R', and 'X'). If one or more of the associated output files already exists in the -destination directory, it will be overwritten with the new data. +destination directory, an error will be printed and the command will abort. .SH EXAMPLES To render a scene with four processes: .IP "" .2i @@ -112,25 +112,26 @@ rtpict -n 8 -vf fish.vf @render.opt -ovLn fisholay sce .SH NOTES Users should seriously consider using .I rpiece(1) +for multiprocessing when irradiance caching is employed with a shared ambient file. If .I rtpict -is used in multiprocessing mode with a shared irradiance cache, -it is trying to compute almost -the same part of the same scanline in different processes, which -results in many redundant calculations. -The -.I rpiece -program avoids this by working on separate tiles in each -process, with less overlap in the indirect irradiance calculation. -Either program will benefit from an "overture" run of a -single-process rpict to create the ambient file using a low-resolution -rendering that is discarded, but this will not completely solve the -problem for -.I rtpict. +is used with +.I \-n +greater than 1, it tries to compute neighboring parts +of the same scanline in different processes, which can +result in many redundant calculations and cache entries. +.I Rtpict +will automatically run a randomly-ordered overture calculation +to mitigate this problem, but it is not a perfect solution. +.I Rpiece +avoids redundant cache calculations by working on separate tiles in each +process, which brings other benefits as well, such as enabling the +.I \-ps +option for image plane sampling. .SH AUTHOR Greg Ward .SH "SEE ALSO" getinfo(1), mkpmap(1), oconv(1), pfilt(1), pvalue(1), rad(1), rcode_depth(1), rcode_normal(1), rcode_ident(1), -rpiece(1), rpict(1), rsplit(1), rtrace(1), rvu(1), vwrays(1), +rcrop(1), rpiece(1), rpict(1), rsplit(1), rtrace(1), rvu(1), vwrays(1)