base class for MrSID image readers
More...
#include <MrSIDImageReaderBase.h>
All the MrSID image readers (MrSIDImageReader, MG2ImageReader and MG3ImageReader) inherit from this class.
Definition at line 68 of file MrSIDImageReaderBase.h.
§ ~MrSIDImageReaderInterface()
virtual MrSIDImageReaderInterface::~MrSIDImageReaderInterface |
( |
| ) |
|
|
virtual |
§ MrSIDImageReaderInterface()
MrSIDImageReaderInterface::MrSIDImageReaderInterface |
( |
| ) |
|
|
protected |
§ getGeoCoordFromMetadata()
§ getMaxWorkerThreads()
virtual int MrSIDImageReaderInterface::getMaxWorkerThreads |
( |
| ) |
const |
|
pure virtual |
This function gets the maximun number of worker threads that can be used during a decode request.
- See also
- setMaxWorkerThreads() for details.
- Returns
- the maximum number of worker threads that may be used
Implemented in MrSIDImageReader.
§ getMrSIDGeneration() [1/4]
Returns the MrSID generation number for a specific MrSID image. This is a static function, which is passed a filename.
The gen value returned will be 2 (for MrSID/MG2), 3 (for MrSID/MG3), 4 (for MrSID/MG4) or 0 (if error).
- Parameters
-
fileSpec | the file to get the version of |
gen | the MrSID generation |
raster | is the file raster or point cloud? |
- Returns
- status code indicating success or failure
§ getMrSIDGeneration() [2/4]
Returns the MrSID generation number for a specific MrSID image. This is a static function, which is passed a stream.
The gen value returned will be 2 (for MrSID/MG2), 3 (for MrSID/MG3), 4 (for MrSID/MG4) or 0 (if error).
- Parameters
-
stream | the file to get the version of |
gen | the MrSID generation |
raster | is the file raster or point cloud? |
- Returns
- status code indicating success or failure
§ getMrSIDGeneration() [3/4]
Returns the MrSID generation number for a specific MrSID image. This is a static function, which is passed an 8-byte buffer.
The gen value returned will be 2 (for MrSID/MG2), 3 (for MrSID/MG3), 4 (for MrSID/MG4) or 0 (if error).
- Parameters
-
version | the full version signature (1st 8 bytes of the file) |
gen | the MrSID generation |
raster | is the file raster or point cloud? |
- Returns
- status code indicating success or failure
§ getMrSIDGeneration() [4/4]
LT_STATUS MrSIDImageReaderInterface::getMrSIDGeneration |
( |
lt_uint8 & |
gen, |
|
|
bool & |
raster |
|
) |
| const |
Returns the MrSID generation number for the image.
The gen value returned will be 2 (for MrSID/MG2), 3 (for MrSID/MG3), 4 (for MrSID/MG4) or 0 (if error).
- Parameters
-
gen | the major version number |
raster | is the file raster or point cloud? |
- Returns
- status code indicating success or failure
§ getMrSIDVersion()
Returns detailed version information for the MrSID image. Typical version numbers will be 1.0.1 for MG2 (the letter value is not used), 3.0.26.q for MG3, 3.4.0.a for MG4 raster, and 4.0.0.a for MG4 lidar. To avoid confusion, developers should avoid interpreting the meaning of this number, but rather use getMrSIDGeneration().
- Parameters
-
major | the major version number |
minor | the minor version number |
tweak | the revision number |
letter | the revision build number (not used by MG2) |
§ getNumLevels()
virtual lt_uint8 MrSIDImageReaderInterface::getNumLevels |
( |
| ) |
const |
|
pure virtual |
Returns the number of resolution levels supported by the image. This value returned corresponds to the LTIImage::getMinMagnification() function.
- Returns
- the number of resolution levels in the MrSID image
Implemented in MrSIDImageReader.
§ init()
§ isLocked()
virtual bool MrSIDImageReaderInterface::isLocked |
( |
| ) |
const |
|
pure virtual |
Returns true iff the image is password-protected. If the image is locked, the setPasswordDelegate() or setPassword() function must be used to provide the decoder with information to decrypt the image as decode requests are processed.
- Returns
- true, if image is password-protected
Implemented in MrSIDImageReader.
§ openWorldFileStream()
static LTIOStreamInf* MrSIDImageReaderInterface::openWorldFileStream |
( |
const LTFileSpec & |
fileSpec, |
|
|
bool |
useWorldFile |
|
) |
| |
|
staticprotected |
§ setMaxWorkerThreads()
virtual void MrSIDImageReaderInterface::setMaxWorkerThreads |
( |
int |
numThreads | ) |
|
|
pure virtual |
This function sets the maximum number of worker threads that can be used during a decode request.
- Parameters
-
numThreads | the maximum number of threads to use, including the calling thread numThreads < 1 defaults to the number of logical cores |
- Note
- : The internal decoder may use fewer threads. For example, MG2 does not use wroker threads.
-
: The internal decoder may limit the number of threads to the number of logical core on the system.
Implemented in MrSIDImageReader.
§ setPassword()
void MrSIDImageReaderInterface::setPassword |
( |
const lt_utf8 * |
password | ) |
|
This function is set the password used by the decoder logic to decode the image, if one is needed.
The password must be set prior to performing any decode (read) requests; for more flexibility, the setPasswordDelegate() function may be used.
See the isLocked() function for more details.
- Parameters
-
password | the password for the image |
§ setPasswordDelegate()
This function is used to set up a password delegate, which will be automatically called form within the internal decoder logic to obtain a text password, if one is needed for decoded the image.
Alternatively, the more direct setPassword() function may be used.
See the isLocked() function for more details.
- Parameters
-
passwordDelegate | the delegate to be called |
§ m_magic
lt_uint8 MrSIDImageReaderInterface::m_magic[8] |
|
protected |
§ m_memoryUsage
§ m_streamUsage
The documentation for this class was generated from the following file: