/home/rex/ebltrunk/core/libidx/include/imageIO.h

/***************************************************************************
 *   Copyright (C) 2008 by Yann LeCun and Pierre Sermanet *
 *   yann@cs.nyu.edu, pierre.sermanet@gmail.com *
 *   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.
 *     * Redistribution under a license not approved by the Open Source
 *       Initiative (http://www.opensource.org) must display the
 *       following acknowledgement in all advertising material:
 *        This product includes software developed at the Courant
 *        Institute of Mathematical Sciences (http://cims.nyu.edu).
 *     * The names of the authors may not be used to endorse or promote products
 *       derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED ``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 ThE AUTHORS 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.
 ***************************************************************************/

#ifndef IMAGEIO_H_
#define IMAGEIO_H_

#include "libidx.h"

namespace ebl {
  
  // loading
  
  template <class T>
    void load_image(const char *fname, idx<T> &out);

  template <class T>
    void load_image(const string &fname, idx<T> &out);

  template <class T>
    idx<T> load_image(const char *fname);
  
  template <class T>
    idx<T> load_image(const string &fname);

  // saving
  
  // format is the desired image format. e.g.: "JPG", "PNG", etc.
  template <class T> bool save_image(const string &fname, idx<T> &in,
                                    const char *format);
  template <class T> bool save_image_ppm(const string &fname, idx<T> &in);
  template <class T> bool save_image_ppm(const char *fname, idx<T> &in);
  template <class T> bool save_image_ppm(FILE *fp, idx<T> &in);
  template <class T> bool save_image_jpg(const string &fname, idx<T> &in);
  
  // helper functions

  EXPORT idx<ubyte> pnm_read(FILE *fp, idx<ubyte> *out = NULL);
  
  //  EXPORT idx<ubyte> pnm_read2(istream &in, idx<ubyte> *out = NULL);

  template <class T>
    idx<T> image_read(const char *fname, idx<T> *out = NULL, int attempts = 3);

} // end namespace ebl

#include "imageIO.hpp"

#endif /* IMAGEIO_H_ */