Home | History | Annotate | Download | only in src
      1 /*M///////////////////////////////////////////////////////////////////////////////////////
      2 //
      3 //  IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING.
      4 //
      5 //  By downloading, copying, installing or using the software you agree to this license.
      6 //  If you do not agree to this license, do not download, install,
      7 //  copy or use the software.
      8 //
      9 //
     10 //                           License Agreement
     11 //                For Open Source Computer Vision Library
     12 //
     13 // Copyright (C) 2000-2008, Intel Corporation, all rights reserved.
     14 // Copyright (C) 2009, Willow Garage Inc., all rights reserved.
     15 // Third party copyrights are property of their respective owners.
     16 //
     17 // Redistribution and use in source and binary forms, with or without modification,
     18 // are permitted provided that the following conditions are met:
     19 //
     20 //   * Redistribution's of source code must retain the above copyright notice,
     21 //     this list of conditions and the following disclaimer.
     22 //
     23 //   * Redistribution's in binary form must reproduce the above copyright notice,
     24 //     this list of conditions and the following disclaimer in the documentation
     25 //     and/or other materials provided with the distribution.
     26 //
     27 //   * The name of the copyright holders may not be used to endorse or promote products
     28 //     derived from this software without specific prior written permission.
     29 //
     30 // This software is provided by the copyright holders and contributors "as is" and
     31 // any express or implied warranties, including, but not limited to, the implied
     32 // warranties of merchantability and fitness for a particular purpose are disclaimed.
     33 // In no event shall the Intel Corporation or contributors be liable for any direct,
     34 // indirect, incidental, special, exemplary, or consequential damages
     35 // (including, but not limited to, procurement of substitute goods or services;
     36 // loss of use, data, or profits; or business interruption) however caused
     37 // and on any theory of liability, whether in contract, strict liability,
     38 // or tort (including negligence or otherwise) arising in any way out of
     39 // the use of this software, even if advised of the possibility of such damage.
     40 //
     41 //M*/
     42 
     43 #ifndef _RGBE_HDR_H_
     44 #define _RGBE_HDR_H_
     45 
     46 // posted to http://www.graphics.cornell.edu/~bjw/
     47 // written by Bruce Walter  (bjw (at) graphics.cornell.edu)  5/26/95
     48 // based on code written by Greg Ward
     49 
     50 #include <stdio.h>
     51 
     52 typedef struct {
     53   int valid;            /* indicate which fields are valid */
     54   char programtype[16]; /* listed at beginning of file to identify it
     55                          * after "#?".  defaults to "RGBE" */
     56   float gamma;          /* image has already been gamma corrected with
     57                          * given gamma.  defaults to 1.0 (no correction) */
     58   float exposure;       /* a value of 1.0 in an image corresponds to
     59        * <exposure> watts/steradian/m^2.
     60        * defaults to 1.0 */
     61 } rgbe_header_info;
     62 
     63 /* flags indicating which fields in an rgbe_header_info are valid */
     64 #define RGBE_VALID_PROGRAMTYPE 0x01
     65 #define RGBE_VALID_GAMMA       0x02
     66 #define RGBE_VALID_EXPOSURE    0x04
     67 
     68 /* return codes for rgbe routines */
     69 #define RGBE_RETURN_SUCCESS 0
     70 #define RGBE_RETURN_FAILURE -1
     71 
     72 /* read or write headers */
     73 /* you may set rgbe_header_info to null if you want to */
     74 int RGBE_WriteHeader(FILE *fp, int width, int height, rgbe_header_info *info);
     75 int RGBE_ReadHeader(FILE *fp, int *width, int *height, rgbe_header_info *info);
     76 
     77 /* read or write pixels */
     78 /* can read or write pixels in chunks of any size including single pixels*/
     79 int RGBE_WritePixels(FILE *fp, float *data, int numpixels);
     80 int RGBE_ReadPixels(FILE *fp, float *data, int numpixels);
     81 
     82 /* read or write run length encoded files */
     83 /* must be called to read or write whole scanlines */
     84 int RGBE_WritePixels_RLE(FILE *fp, float *data, int scanline_width,
     85        int num_scanlines);
     86 int RGBE_ReadPixels_RLE(FILE *fp, float *data, int scanline_width,
     87       int num_scanlines);
     88 
     89 #endif/*_RGBE_HDR_H_*/
     90