Design Integration Laboratory

Radiance Rif File Example

# ----------------------------------- XXX -----------------------------------
#
# Annotated "sample rif" File
#
#       Optimized for Radiance Renderings of DesignWorkshop Models
#
#       960220.kmm
#
#   To convert this file from a web document to a pure "sample.rif" file  
#   using Netscape, use Save As... TEXT to save the  
#   file onto your own hard disk, then open the text file with a text  
#   editor and delete all the lines above XXX at the top of the file,   
#   and below ZZZ at the bottom, and finally again Save the file.
#
#
# ____________________________ General Notes _________________________________
#
#   This is a command file for running Radiance using the "rad" command
#   with view parameters extracted from DesignWorkshop (DW) exported x.rpict.sh,
#
#   and with the zone of interest x min, x max; y min, y max;  z min, z max
#   recorded manually in DW for the DW scene.  
#
#   Be sure to set the correct base name "p" for your scene
#   in four places: OCTREE= p.oct, scene= p.rad, picture= p, and ambfile= p.amb
#   replacing the word "project" below with the base filename for your project.
#
#   To actually execute the rendering on a unix system, use a command line like
#
#        nice rad project.rif &
#
#
# _______________________ Project Specific Notes _____________________________
#
#
# Put any working notes of your own in here as convenient, preceeding each line 
# with the number symbol so the comments are ignored by the rad program.  
#
#
# _________________________ Functional Content _______________________________
#
#
# ______ REQUIRED CHANGES Section (Lines 1-6) ________________________________
#
#        Most lines in this section require some editing for your specific 
#        project.  The changes you need to make in this section are explained
#        line by line as follows.
#
#
#        1) Set base file name correctly for "scene".  
#
scene= project.rad
#
#        2) Uncomment and set base file name correctly for "materials" file,
#           if you are using one.  
#
# materials= project.mat
#
#        3) Set base file name correctly for "octree".  
#
OCTREE= project.oct
#
#        4) Set base file name correctly for "picture", the base name for
#           output images.  
#
PICTURE= project
#
#        5) Paste in your own view parameters, using the values from the 
#           DW export file project.rpict.sh 
#   
view=  -vtv -vp -169.308 -146.681 17.0199 -vd 109.551 96.3275 0.0801116 -vu 0 0 1 -vh 70 -vv 70 -vs 0 -vl 0
#     
#        6) Read dimensions from DW model to set zone of interest, interior 
#           or exterior.
#
#           Note: 
#           The y axis is reversed in direction in the Radiance coordinate system
#           as compared to the DesignWorkshop coordinate system, 
#           so switch the sign of Y max and Y min values (only).
#           Switch the sign of each the DW Y values, but don't consider their
#           order until after the signs have been switched.  Then look
#           at them, and make sure they end up in the order y min, y max.
#
#         (In DesignWorkshop, max Y is in the far south, but in Radiance,
#          max Y is in the far north)
#
#          Format:
#
#          zone_type  x min x max  y min y max  z min z max
#
ZONE= exterior -75 75 -50 50 0 50
#
#
# ______ OPTIONAL CHANGES Section ______________________________________________
#
#        When doing repeated refinement of large scenes, 
#        uncomment the ambient file setting below for efficiency
#        and set base file name correctly for "ambfile".
#        (See Radiance documentation for details.)
#
# AMBFILE= project.amb
#
#
#        "resolution" sets the dimensions in pixels of the final rendering.  
#        Our default is 512. 
# 
RESOLUTION= 512
#
#        "quality" can be set low, medium, or high. Our default is medium.  
#
QUALITY= medium
#
#        "detail" can be set low, medium, or high. Our default is medium.  
#
DETAIL= medium
#
#        Increasing "variability" will smooth the lighting in a scene
#        but will substantially increase rendering times.
#        Our default is medium.  
#
VARIABILITY= medium
#
#        "indirect" defines the number of indirect bounces for lighting
#        calculations.
#        0 gives shading without interreflections.  
#        A number greater than 2 will be slow with diminishing returns.  
#        Our default of 2 provides good interior renderings.  
#
INDIRECT= 1
#
#        "report" defines the interval for periodic status reports, 
#        by default set here to every "2" minutes, and the name for the "error
#        file" used for these reports, by default set here to "progress"
#
REPORT= 2 progress
#
#        Set "penumbras" to T to get softer lights, at the expense of much slower
#        renderings.  
#
PENUMBRAS= F
#
#
# ______ OPTIONAL Additional View Controls __________________________________
#
#        There are  several  standard view identifiers defined by rad, which you
#        can use to define orthographic and axonometric projections. 
#
#        Thesestandard views are specified by strings of  the  form
#
#               [x]?[y]?[z]?[vlah]?
#
#        (That is, an x or X followed  by a y or Y followed by a z or Z followed  
#        by  an optional v, l, a or h.)  
#
#        The letters indicate the desired view position, where
#        upper case  X  means maximum X, lower case x means minimum x
#        and so on.  The final letter  is  the  view  type, where  'v'  is  
#        perspective  (the default), 'l' is parallel, 'a'  is  angular  fisheye,  
#        and  'h'  is hemispherical  fisheye.   A  perspective view from  
#        maximum X, minimum Y would be "Xy"  or  "Xyv".  A parallel view from 
#        maximum Z would be "Zl".  
#
#        If "ZONE" is an interior  zone, the standard views will be cut to inside 
#        the zone perimeter.  If it is an exterior zone, the standard views  
#        will be outside, as if the model is viewed from entirely outside its
#        boundaries.
#
#        To calculate several views at once of the same model, add another 
#        "view= " line for each.  Rad will automatically produce an image for
#        each view, reusing as much information as possible for maximum
#        efficiency.
#        You can do this with the standard views specified below, or with a
#        series of perspective views exported for DesignWorkshop, for 
#        instance for animations.)
#        
#        ________ Standard Views _________
#
#        Uncomment each "view=" line to render that view in
#        addition to any other views you have set up above.  
# 
# view= Zl  # plan view, looking straight down (from max Z of "zone" if interior)
#
# view= yl  # south elevation, looking straight north 
#             (section from min y of"zone" if interior)
#
# view= Xl  # east elevation, looking straight west (section from min y of
#             (section from min y ofif interior)
#
# view= Yl  # north elevation, looking straight south (section from min y of
#             (section from min y of"zone" if interior)
#
# view= xl  # west elevation, looking straight east (section from min y of
#             (section from min y ofif interior)
#
# view= xyZl  # SWaxn -- axonometric from southwest and above
# view= XyZl  # SWaxn -- axonometric from southeast and above
# view= xYZl  # NWaxn -- axonometric from northwest and above
# view= XYZl  # NEaxn -- axonometric from northeast and above
#
#
# ________________________ CONSTANT Parameters _____________________________
#
#        "up" defines the axis to consider vertical.  This should 
#        not normally be changed while using DesignWorkshop models.  
#
UP= Z
#
#
# -------------------------------- ZZZ -------------------------------------