--------------------------------------------------------------------------------------
  
  Author:  Mikko Niemelä, mikko.niemela@oulu.fi
  
  Organisation: University of Oulu, Oulu Southern institute, RFMedia Laboratory
  
  Project: Real 3D – Digital holography for 3D and 4D real-world objects' capture, 
                     processing, and display
                     European Community's Seventh Framework Programme FP7/2007-2013
                     Grant agreement no. 216105

  Created: 2010-05-20

  Copyright (c) 2010, University of Oulu
  All rights reserved.
  
  Redistribution and use in source and binary forms, with or without
  modification, are permitted provided that the following conditions are met:
      * Redistributions of source code must retain the above copyright
        notice, this list of conditions and the following disclaimer.
      * 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.
      * Neither the name of the University of Oulu nor the
        names of its contributors may be used to endorse or promote products
        derived from this software without specific prior written permission.
  
  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
  ANY EXPRESS 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 UNIVERSITY OF OULU 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 is example case how to read and write dataset from/to HDF5 file.

This software uses our modified HDF5 library. "szip" and "zlib" are disabled in our 
version of HDF5 library. 

We modified library becouse we ran into problems while compiling project in debug mode 
with original library.

Release version of software sould work fine with original HDF5 library.

Our modified HDF5 library can be found from our web site 
(http://www.digitalholography.eu).


Original HDF5 library is distributed by The HDF Group (http://www.hdfgroup.org/).

--------------------------------------------------------------------------------------

Notes:

Project was started as Empty Console Application.

Few modifications to project setting was made:

(configurations for "Release" mode)
Project -> Properties
- configuration Properties
  - C/C++
    - Generial
      + Additional Include Directories: "../include/hdf"
    - Preprocessor
      + Preprocessor Definitions: "HDF5CPP_USEDLL"
  - Linker
    - General
      + Additional Library Directories: "../dll/hdf"
    - Input
      + Additional Dependencies: "hdf5dll.lib hdf5_cppdll.lib"


*********************************************************
For Debug to work you have to use modified HDF5 library:
 > !! Gzip and Szip disabled !!
*********************************************************

(configurations for "Debug" mode)
Project -> Properties
- configuration Properties
  - C/C++
    - Generial
      + Additional Include Directories: "../include/hdf"
    - Preprocessor
      + Preprocessor Definitions: "HDF5CPP_USEDLL"
  - Linker
    - General
      + Additional Library Directories: "../dll/hdf"
    - Input
      + Additional Dependencies: "hdf5ddll.lib hdf5_cppddll.lib"