top of page

Now It's Your Turn To Try

All of the code and images are up on GutHub.  Download the code and follow these steps:

​

  1. Reduce the size of your images to less than 1000x1000 pixels.  Increase the size until it takes too long to process.

  2. Place all the relevant images in one folder.  

  3. Create a metadata file in that folder that lists the images by name, followed by the shutter speed x,  where 1/x is the amount of time the shutter is open (e.g. 0.5 means 2 seconds and 2 means 1/2 second).  See examples named testfile in the various included examples.

  4. Change the settings in the 'RunProject' script

  5. Run the 'RunProject' script

Settings Explained

Here are all the settings needed to get the program to work on your own examples.  See the sample 'RunProject' script included in the code to better understand these settings.

folder_name

     Name of folder with images

​

folder

     Relative path to the folder with images

​

metadata_file

     Metadata file name that contains shutter speeds

​

metadata_format

     Metadata file format for each line

  •  %s = string

  •  %f = double

​

registration

     Image Registration required?

  •  true : select this if the images don't line up.

  •  false : select this if the images already line up.  It's faster.

​

point_num

     Number of sample points.  The greater the number of points, the more accurate, but the longer it takes to

     manually select.  

​

point_select

     Point Selection

  •  'auto' : automatic point selection

  •  'manual' : select points by hand

​

tonemap_type

     Type of tonemapping

  •  'general' - uses tonemap() function

  •  'local' - uses localTonemap() function

  •  'both' - saves a copy of both

​

HDR_creation

     HDR creation method

  •  'D&M' = uses method proposed by Debevec & Malik.  Recommended

  •  'sat' = uses modified method that avoids artifacts that appear due to pixels that are saturated across all shutter speeds - think sun in the picture.  Does lead to a flatter looking image

  •  'mix' = attempts to preserve the higher saturation of 'D&M' while using 'sat' for the saturated areas

​

IF USING 'mix' HDR CREATION METHOD:  (if not, this value is not used)

HDR_mix_threshold
     Threshold for brightness above which the difference will be used to replace 'D&M' pixels with 'sat' pixels.

​

output_folder

     Location to save final images

​

HDR_name

     Final image base name

​

response_curve_save

     Save a copy of the camera response curve?

  • true/false

​

IF SAVING A COPY OF THE RESPONSE CURVE

response_curve_points
     Show points that contributed to its estimation on the curve?

  • true/false

bottom of page