Source/System/Image/FileIO/OSGJPGImageFileType.h

   1 /*---------------------------------------------------------------------------*\
   2  *                                OpenSG                                     *
   3  *                                                                           *
   4  *                                                                           *
   5  *             Copyright (C) 2000-2002 by the OpenSG Forum                   *
   6  *                                                                           *
   7  *                            www.opensg.org                                 *
   8  *                                                                           *
   9  *   contact: dirk@opensg.org, gerrit.voss@vossg.org, jbehr@zgdv.de          *
  10  *                                                                           *
  11 \*---------------------------------------------------------------------------*/
  12 /*---------------------------------------------------------------------------*\
  13  *                                License                                    *
  14  *                                                                           *
  15  * This library is free software; you can redistribute it and/or modify it   *
  16  * under the terms of the GNU Library General Public License as published    *
  17  * by the Free Software Foundation, version 2.                               *
  18  *                                                                           *
  19  * This library is distributed in the hope that it will be useful, but       *
  20  * WITHOUT ANY WARRANTY; without even the implied warranty of                *
  21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU         *
  22  * Library General Public License for more details.                          *
  23  *                                                                           *
  24  * You should have received a copy of the GNU Library General Public         *
  25  * License along with this library; if not, write to the Free Software       *
  26  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.                 *
  27  *                                                                           *
  28 \*---------------------------------------------------------------------------*/
  29 /*---------------------------------------------------------------------------*\
  30  *                                Changes                                    *
  31  *                                                                           *
  32  *                                                                           *
  33  *                                                                           *
  34  *                                                                           *
  35  *                                                                           *
  36  *                                                                           *
  37 \*---------------------------------------------------------------------------*/
  38
  39 #ifndef _OSGJPGIMAGEFILETYPE_H_
  40 #define _OSGJPGIMAGEFILETYPE_H_
  41
  42 #ifdef  __sgi
  43 #pragma  once
  44 #endif
  45
  46 #include "OSGImageFileIODef.h"
  47 #include "OSGImageFileType.h"
  48
  49 OSG_BEGIN_NAMESPACE
  50
  51 /*! \brief JPEG File Handler. Used to read/write JPEG files.
  52     See \ref PageSystemImage for a detailed description.
  53
  54     \ingroup GrpImageFileIOJPG
  55     \ingroup GrpLibOSGImageFileIO
  56  */
  57
  58 class OSG_IMGFILEIO_DLLMAPPING JPGImageFileType : public ImageFileType
  59 {
  60     /*==========================  PUBLIC  =================================*/
  61
  62   public:
  63
  64     /*---------------------------------------------------------------------*/
  65     /*! \name                   Destructor                                 */
  66     /*! \{                                                                 */
  67
  68     virtual ~JPGImageFileType (void);
  69
  70     /*! \}                                                                 */
  71     /*---------------------------------------------------------------------*/
  72     /*! \name                  Get Method                                  */
  73     /*! \{                                                                 */
  74
  75     void   setQuality(UInt32 cl);
  76     UInt32 getQuality(void     );
  77
  78     /*! \}                                                                 */
  79     /*---------------------------------------------------------------------*/
  80     /*! \name                   Read/Write                                 */
  81     /*! \{                                                                 */
  82
  83     virtual bool read (      Image            *pImage,
  84                              std::istream     &is,
  85                        const std::string      &mimetype);
  86
  87     virtual bool write(const Image            *pImage,
  88                              std::ostream     &os,
  89                        const std::string      &mimetype);
  90
  91     /*! \}                                                                 */
  92     /*---------------------------------------------------------------------*/
  93     /*! \name                   Read/Write                                 */
  94     /*! \{                                                                 */
  95
  96     virtual bool validateHeader(const Char8   *fileName,
  97                                       bool    &implemented);
  98
  99     /*! \}                                                                 */
 100     /*---------------------------------------------------------------------*/
 101     /*! \name                   Read/Write                                 */
 102     /*! \{                                                                 */
 103
 104     virtual std::string determineMimetypeFromStream(std::istream &is);
 105
 106     /*! \}                                                                 */
 107     /*=========================  PROTECTED  ===============================*/
 108
 109   protected:
 110
 111     /*---------------------------------------------------------------------*/
 112     /*! \name                     Buffer                                   */
 113     /*! \{                                                                 */
 114
 115     virtual UInt64 restoreData(      Image            *pImage,
 116                                const UChar8           *buffer,
 117                                      Int32             memSize = -1) const;
 118
 119     virtual UInt64 storeData  (const Image            *pImage,
 120                                      UChar8           *buffer,
 121                                      Int32             memSize = -1) const;
 122
 123     /*! \}                                                                 */
 124     /*---------------------------------------------------------------------*/
 125     /*! \name               Default Constructor                            */
 126     /*! \{                                                                 */
 127
 128     JPGImageFileType(const Char8  *mimeType,
 129                      const Char8  *suffixArray[],
 130                            UInt16  suffixByteCount,
 131                            UInt32  flags          );
 132
 133     /*! \}                                                                 */
 134     /*---------------------------------------------------------------------*/
 135     /*! \name                       Copy Op                                */
 136     /*! \{                                                                 */
 137
 138           JPGImageFileType            (const JPGImageFileType &obj);
 139     const JPGImageFileType &operator =(const JPGImageFileType &obj);
 140
 141     /*! \}                                                                 */
 142     /*==========================  PRIVATE  ================================*/
 143
 144   private:
 145
 146     typedef ImageFileType Inherited;
 147
 148     UInt32 _quality;
 149
 150     static JPGImageFileType _the;
 151 };
 152
 153 typedef JPGImageFileType *JPGImageFileTypeP;
 154
 155 OSG_END_NAMESPACE
 156
 157 #endif // _OSGJPGIMAGEFILETYPE_H_