image_io.hpp
上传用户:yhdzpy8989
上传日期:2007-06-13
资源大小:13604k
文件大小:6k
- /*
- * ===========================================================================
- * PRODUCTION $Log: image_io.hpp,v $
- * PRODUCTION Revision 1000.2 2004/02/12 21:58:33 gouriano
- * PRODUCTION PRODUCTION: UPGRADED [CORE_001] Dev-tree R1.5
- * PRODUCTION
- * ===========================================================================
- */
- #ifndef GUI_IMAGE___IMAGE_READER__HPP
- #define GUI_IMAGE___IMAGE_READER__HPP
- /* $Id: image_io.hpp,v 1000.2 2004/02/12 21:58:33 gouriano Exp $
- * ===========================================================================
- *
- * PUBLIC DOMAIN NOTICE
- * National Center for Biotechnology Information
- *
- * This software/database is a "United States Government Work" under the
- * terms of the United States Copyright Act. It was written as part of
- * the author's official duties as a United States Government employee and
- * thus cannot be copyrighted. This software/database is freely available
- * to the public for use. The National Library of Medicine and the U.S.
- * Government have not placed any restriction on its use or reproduction.
- *
- * Although all reasonable efforts have been taken to ensure the accuracy
- * and reliability of the software and data, the NLM and the U.S.
- * Government do not and cannot warrant the performance or results that
- * may be obtained by using this software or data. The NLM and the U.S.
- * Government disclaim all warranties, express or implied, including
- * warranties of performance, merchantability or fitness for any particular
- * purpose.
- *
- * Please cite the author in any work or product based on this material.
- *
- * ===========================================================================
- *
- * Authors: Mike DiCuccio
- *
- * File Description:
- * CImageIO -- framework for reading/writing images
- */
- #include <corelib/ncbistd.hpp>
- #include <util/image/image.hpp>
- BEGIN_NCBI_SCOPE
- class CImageIOHandler;
- //
- // class CImageIO defines a static interface for reading and writing images
- // from files.
- //
- // This class is a front end to a variety of format-specific readers and
- // writers, and supported importing and exporing images in JPEG, PNG, GIF, BMP,
- // SGI, and TIFF formats. In addition, this class supports importing and
- // exporting sub-regions of images.
- //
- class NCBI_XIMAGE_EXPORT CImageIO
- {
- public:
- // enumerated list of recognized image types
- enum EType {
- eUnknown,
- eBmp,
- eGif,
- eJpeg,
- ePng,
- eSgi,
- eTiff,
- eXpm,
- eRaw
- };
- // enumerated list of compression grades
- enum ECompress {
- eCompress_None,
- eCompress_Low,
- eCompress_Medium,
- eCompress_High,
- eCompress_Min = eCompress_None,
- eCompress_Max = eCompress_High,
- eCompress_Default = eCompress_Medium,
- };
- // retrieve an image type from its magic number
- static EType GetTypeFromMagic(CNcbiIstream& istr);
- static EType GetTypeFromMagic(const string& file);
- // retrieve an image type from its file name
- // this uses the provided extension as a hint to guess the expected file
- // type
- static EType GetTypeFromFileName(const string& file);
- // read an image from a file, returning the object for user management
- static CImage* ReadImage(const string& file);
- static CImage* ReadImage(CNcbiIstream& istr);
- // read only part of an image from a file
- static CImage* ReadSubImage(CNcbiIstream& istr,
- size_t x, size_t y, size_t w, size_t h);
- static CImage* ReadSubImage(const string& file,
- size_t x, size_t y, size_t w, size_t h);
- // write an image to a file in a specified format. If the format type is
- // eUnknown, it will be guessed from the file extension.
- static bool WriteImage(const CImage& image, CNcbiOstream& ostr,
- EType type,
- ECompress compress = eCompress_Default);
- static bool WriteImage(const CImage& image, const string& file,
- EType type = eUnknown,
- ECompress compress = eCompress_Default);
- // write only part of an image to a file
- static bool WriteSubImage(const CImage& image, CNcbiOstream& ostr,
- size_t x, size_t y, size_t w, size_t h,
- EType type,
- ECompress compress = eCompress_Default);
- static bool WriteSubImage(const CImage& image, const string& file,
- size_t x, size_t y, size_t w, size_t h,
- EType type = eUnknown,
- ECompress compress = eCompress_Default);
- private:
- // retrieve an image I/O handler for a given type
- static CImageIOHandler* x_GetHandler(EType type);
- };
- END_NCBI_SCOPE
- /*
- * ===========================================================================
- * $Log: image_io.hpp,v $
- * Revision 1000.2 2004/02/12 21:58:33 gouriano
- * PRODUCTION: UPGRADED [CORE_001] Dev-tree R1.5
- *
- * Revision 1.5 2003/12/16 15:49:38 dicuccio
- * Large re-write of image handling. Added improved error-handling and support
- * for streams-based i/o (via hooks into each client library).
- *
- * Revision 1.4 2003/11/03 15:17:29 dicuccio
- * Added optional compression parameter
- *
- * Revision 1.3 2003/08/27 16:44:32 ivanov
- * Changed class export specifier to NCBI_XIMAGE_EXPORT
- *
- * Revision 1.2 2003/06/03 20:04:24 dicuccio
- * Added export specifiers
- *
- * Revision 1.1 2003/06/03 15:17:41 dicuccio
- * Initial revision of image library
- *
- * ===========================================================================
- */
- #endif // GUI_IMAGE___IMAGE_READER__HPP