MrSIDImageReaderBase.h

Go to the documentation of this file.

/* $Id$ */
/* //////////////////////////////////////////////////////////////////////////
//                                                                         //
// This code is Copyright (c) 2004 LizardTech, Inc, 1008 Western Avenue,   //
// Suite 200, Seattle, WA 98104.  Unauthorized use or distribution         //
// prohibited.  Access to and use of this code is permitted only under     //
// license from LizardTech, Inc.  Portions of the code are protected by    //
// US and foreign patents and other filings. All Rights Reserved.          //
//                                                                         //
/* PUBLIC */

#ifndef MRSIDIMAGEREADERBASE_H
#define MRSIDIMAGEREADERBASE_H

// lt_lib_mrsid_core
#include "lti_types.h"
#include "lti_geoImageReader.h"

LT_BEGIN_NAMESPACE(LizardTech)

class MrSIDImageStageManager;
class MrSIDPasswordDelegate;
class MrSIDSimplePasswordDelegate;


/*
 * memory settings for creating MrSID decoders
 *
 * "Small", "medium", and "large" refer to how much memory the
 * decoder will use when opening the image and constructing certain
 * internal data structures and tables.  In general, decode
 * performance will increase if more memory can be used.
 */
enum MrSIDMemoryUsage
{
   MRSID_MEMORY_USAGE_INVALID    = 0,
   MRSID_MEMORY_USAGE_DEFAULT    = 1,
   MRSID_MEMORY_USAGE_SMALL      = 2,
   MRSID_MEMORY_USAGE_MEDIUM     = 3,
   MRSID_MEMORY_USAGE_LARGE      = 4
};

/*
 * stream settings for creating MrSID decoders
 *
 * Normally, the stream used by the decoder is
 * only opened when doing actual decode work, as resources like
 * file handles can be a scarce resource in some environments.  This
 * obviously incurs a performance penalty; the "KeepStreamOpen" modes
 * can be used to change the behaviour.
 */
enum MrSIDStreamUsage
{
   MRSID_STREAM_USAGE_INVALID    = 0,
   MRSID_STREAM_USAGE_KEEPOPEN   = 2,
   MRSID_STREAM_USAGE_KEEPCLOSED = 3,
   MRSID_STREAM_USAGE_DEFAULT    = MRSID_STREAM_USAGE_KEEPCLOSED
};


class MrSIDImageReaderInterface
{
   LT_DISALLOW_COPY_CONSTRUCTOR(MrSIDImageReaderInterface);
public:
   virtual ~MrSIDImageReaderInterface();

   virtual lt_uint8 getNumLevels() const = 0;

   virtual bool isLocked() const = 0;

   void setPasswordDelegate(MrSIDPasswordDelegate* passwordDelegate);

   void setPassword(const lt_utf8* password);

public:
   virtual void setMaxWorkerThreads(int numThreads) = 0;

   virtual int getMaxWorkerThreads() const = 0;

public:
   static LT_STATUS getMrSIDGeneration(const LTFileSpec& fileSpec, lt_uint8& gen, bool &raster);

   static LT_STATUS getMrSIDGeneration(LTIOStreamInf& stream, lt_uint8 &gen, bool &raster);

   static LT_STATUS getMrSIDGeneration(const lt_uint8 version[8], lt_uint8& gen, bool &raster);

   LT_STATUS getMrSIDGeneration(lt_uint8 &gen, bool &raster) const;

   LT_STATUS getMrSIDVersion(lt_uint8& major, lt_uint8& minor,
                             lt_uint8& tweak, char& letter) const;

protected:
   MrSIDImageReaderInterface();
   LT_STATUS init(MrSIDMemoryUsage memoryUsage,
                  MrSIDStreamUsage streamUsage,
                  const lt_uint8 preamble[8]);

   static LT_STATUS getGeoCoordFromMetadata(LTIMetadataDatabase &metadata,
                                            LTIGeoCoord &geoCoord,
                                            bool &hasGeo);

   static LTIOStreamInf *openWorldFileStream(const LTFileSpec &fileSpec,
                                             bool useWorldFile);

   MrSIDMemoryUsage m_memoryUsage;
   MrSIDStreamUsage m_streamUsage;
   lt_uint8 m_magic[8];

private:
   MrSIDPasswordDelegate* m_pwdDelegate;
   MrSIDSimplePasswordDelegate* m_localPwdDelegate;
};


class MrSIDSingleImageReaderBase : public LTIGeoImageReader,
                                   public MrSIDImageReaderInterface
{
   LT_DISALLOW_COPY_CONSTRUCTOR(MrSIDSingleImageReaderBase);
public:
   // LTIImageStage
   virtual lt_int64 getEncodingCost(const LTIScene& scene) const;
   virtual lt_uint32 getModifications(const LTIScene &scene) const;

protected:
   MrSIDSingleImageReaderBase(bool supportBandSelection);
   ~MrSIDSingleImageReaderBase(void);

   LT_STATUS init(MrSIDImageStageManager *manager);

   MrSIDImageStageManager *m_manager;
};

LT_END_NAMESPACE(LizardTech)

#endif // MRSIDIMAGEREADERBASE_H