image_io.hpp
上传用户:yhdzpy8989
上传日期:2007-06-13
资源大小:13604k
文件大小:6k
源码类别:

生物技术

开发平台:

C/C++

  1. /*
  2.  * ===========================================================================
  3.  * PRODUCTION $Log: image_io.hpp,v $
  4.  * PRODUCTION Revision 1000.2  2004/02/12 21:58:33  gouriano
  5.  * PRODUCTION PRODUCTION: UPGRADED [CORE_001] Dev-tree R1.5
  6.  * PRODUCTION
  7.  * ===========================================================================
  8.  */
  9. #ifndef GUI_IMAGE___IMAGE_READER__HPP
  10. #define GUI_IMAGE___IMAGE_READER__HPP
  11. /*  $Id: image_io.hpp,v 1000.2 2004/02/12 21:58:33 gouriano Exp $
  12.  * ===========================================================================
  13.  *
  14.  *                            PUBLIC DOMAIN NOTICE
  15.  *               National Center for Biotechnology Information
  16.  *
  17.  *  This software/database is a "United States Government Work" under the
  18.  *  terms of the United States Copyright Act.  It was written as part of
  19.  *  the author's official duties as a United States Government employee and
  20.  *  thus cannot be copyrighted.  This software/database is freely available
  21.  *  to the public for use. The National Library of Medicine and the U.S.
  22.  *  Government have not placed any restriction on its use or reproduction.
  23.  *
  24.  *  Although all reasonable efforts have been taken to ensure the accuracy
  25.  *  and reliability of the software and data, the NLM and the U.S.
  26.  *  Government do not and cannot warrant the performance or results that
  27.  *  may be obtained by using this software or data. The NLM and the U.S.
  28.  *  Government disclaim all warranties, express or implied, including
  29.  *  warranties of performance, merchantability or fitness for any particular
  30.  *  purpose.
  31.  *
  32.  *  Please cite the author in any work or product based on this material.
  33.  *
  34.  * ===========================================================================
  35.  *
  36.  * Authors:  Mike DiCuccio
  37.  *
  38.  * File Description:
  39.  *    CImageIO -- framework for reading/writing images
  40.  */
  41. #include <corelib/ncbistd.hpp>
  42. #include <util/image/image.hpp>
  43. BEGIN_NCBI_SCOPE
  44. class CImageIOHandler;
  45. //
  46. // class CImageIO defines a static interface for reading and writing images
  47. // from files.
  48. //
  49. // This class is a front end to a variety of format-specific readers and
  50. // writers, and supported importing and exporing images in JPEG, PNG, GIF, BMP,
  51. // SGI, and TIFF formats.  In addition, this class supports importing and
  52. // exporting sub-regions of images.
  53. //
  54. class NCBI_XIMAGE_EXPORT CImageIO
  55. {
  56. public:
  57.     // enumerated list of recognized image types
  58.     enum EType {
  59.         eUnknown,
  60.         eBmp,
  61.         eGif,
  62.         eJpeg,
  63.         ePng,
  64.         eSgi,
  65.         eTiff,
  66.         eXpm,
  67.         eRaw
  68.     };
  69.     // enumerated list of compression grades
  70.     enum ECompress {
  71.         eCompress_None,
  72.         eCompress_Low,
  73.         eCompress_Medium,
  74.         eCompress_High,
  75.         eCompress_Min     = eCompress_None,
  76.         eCompress_Max     = eCompress_High,
  77.         eCompress_Default = eCompress_Medium,
  78.     };
  79.     // retrieve an image type from its magic number
  80.     static EType GetTypeFromMagic(CNcbiIstream& istr);
  81.     static EType GetTypeFromMagic(const string& file);
  82.     // retrieve an image type from its file name
  83.     // this uses the provided extension as a hint to guess the expected file
  84.     // type
  85.     static EType GetTypeFromFileName(const string& file);
  86.     // read an image from a file, returning the object for user management
  87.     static CImage* ReadImage(const string& file);
  88.     static CImage* ReadImage(CNcbiIstream& istr);
  89.     // read only part of an image from a file
  90.     static CImage* ReadSubImage(CNcbiIstream& istr,
  91.                                 size_t x, size_t y, size_t w, size_t h);
  92.     static CImage* ReadSubImage(const string& file,
  93.                                 size_t x, size_t y, size_t w, size_t h);
  94.     // write an image to a file in a specified format.  If the format type is
  95.     // eUnknown, it will be guessed from the file extension.
  96.     static bool WriteImage(const CImage& image, CNcbiOstream& ostr,
  97.                            EType type,
  98.                            ECompress compress = eCompress_Default);
  99.     static bool WriteImage(const CImage& image, const string& file,
  100.                            EType type = eUnknown,
  101.                            ECompress compress = eCompress_Default);
  102.     // write only part of an image to a file
  103.     static bool WriteSubImage(const CImage& image, CNcbiOstream& ostr,
  104.                               size_t x, size_t y, size_t w, size_t h,
  105.                               EType type,
  106.                               ECompress compress = eCompress_Default);
  107.     static bool WriteSubImage(const CImage& image, const string& file,
  108.                               size_t x, size_t y, size_t w, size_t h,
  109.                               EType type = eUnknown,
  110.                               ECompress compress = eCompress_Default);
  111. private:
  112.     // retrieve an image I/O handler for a given type
  113.     static CImageIOHandler* x_GetHandler(EType type);
  114. };
  115. END_NCBI_SCOPE
  116. /*
  117.  * ===========================================================================
  118.  * $Log: image_io.hpp,v $
  119.  * Revision 1000.2  2004/02/12 21:58:33  gouriano
  120.  * PRODUCTION: UPGRADED [CORE_001] Dev-tree R1.5
  121.  *
  122.  * Revision 1.5  2003/12/16 15:49:38  dicuccio
  123.  * Large re-write of image handling.  Added improved error-handling and support
  124.  * for streams-based i/o (via hooks into each client library).
  125.  *
  126.  * Revision 1.4  2003/11/03 15:17:29  dicuccio
  127.  * Added optional compression parameter
  128.  *
  129.  * Revision 1.3  2003/08/27 16:44:32  ivanov
  130.  * Changed class export specifier to NCBI_XIMAGE_EXPORT
  131.  *
  132.  * Revision 1.2  2003/06/03 20:04:24  dicuccio
  133.  * Added export specifiers
  134.  *
  135.  * Revision 1.1  2003/06/03 15:17:41  dicuccio
  136.  * Initial revision of image library
  137.  *
  138.  * ===========================================================================
  139.  */
  140. #endif  // GUI_IMAGE___IMAGE_READER__HPP