#include <ossimGpkgTileMatrixRecord.h>

Inheritance diagram for ossimGpkgTileMatrixRecord:

Public Member Functions
	ossimGpkgTileMatrixRecord ()
	default constructor More...

	ossimGpkgTileMatrixRecord (const ossimGpkgTileMatrixRecord &obj)

const ossimGpkgTileMatrixRecord &	operator= (const ossimGpkgTileMatrixRecord &obj)

virtual	~ossimGpkgTileMatrixRecord ()
	destructor More...

virtual bool	init (sqlite3_stmt *pStmt)
	Initialize from database. More...

bool	init (const std::string &tableName, ossim_int32 zoom_level, const ossimIpt &matrixSize, const ossimIpt &tileSize, const ossimDpt &gsd)
	Initialize method. More...

bool	insert (sqlite3 *db)
	Inserst this record into gpkg_spatial_ref_sys table. More...

virtual void	saveState (ossimKeywordlist &kwl, const std::string &prefix) const
	Saves the state of object. More...

void	getMatrixSize (ossimIpt &size) const
	Get matrix size. More...

void	getTileSize (ossimIpt &size) const
	Get tile size. More...

void	getGsd (ossimDpt &gsd) const
	Get gsd. More...

Public Member Functions inherited from ossimGpkgDatabaseRecordBase
	ossimGpkgDatabaseRecordBase ()
	default constructor More...

virtual	~ossimGpkgDatabaseRecordBase ()
	virtual destructor. More...

virtual std::ostream &	print (std::ostream &out) const
	Print method. More...

Public Member Functions inherited from ossimReferenced
	ossimReferenced ()

	ossimReferenced (const ossimReferenced &)

ossimReferenced &	operator= (const ossimReferenced &)

void	ref () const
	increment the reference count by one, indicating that this object has another pointer which is referencing it. More...

void	unref () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...

void	unref_nodelete () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...

int	referenceCount () const

Static Public Member Functions
static const std::string &	getTableName ()
	Get the table name "gpkg_tile_matrix". More...

static bool	createTable (sqlite3 *db)
	Creates table in database. More...

Public Attributes
std::string	m_table_name

ossim_int32	m_zoom_level

ossim_int32	m_matrix_width

ossim_int32	m_matrix_height

ossim_int32	m_tile_width

ossim_int32	m_tile_height

ossim_float64	m_pixel_x_size

ossim_float64	m_pixel_y_size

Additional Inherited Members
Protected Member Functions inherited from ossimReferenced
virtual	~ossimReferenced ()

Detailed Description

Definition at line 24 of file ossimGpkgTileMatrixRecord.h.

Constructor & Destructor Documentation

◆ ossimGpkgTileMatrixRecord() [1/2]

ossimGpkgTileMatrixRecord::ossimGpkgTileMatrixRecord ( )

default constructor

Definition at line 26 of file ossimGpkgTileMatrixRecord.cpp.

    :
    ossimGpkgDatabaseRecordBase(),   
    m_table_name(),
    m_zoom_level(0),
    m_matrix_width(0),
    m_matrix_height(0),   
    m_tile_width(0),
    m_tile_height(0),   
    m_pixel_x_size(ossim::nan()),
    m_pixel_y_size(ossim::nan())
 {
 }

◆ ossimGpkgTileMatrixRecord() [2/2]

ossimGpkgTileMatrixRecord::ossimGpkgTileMatrixRecord ( const ossimGpkgTileMatrixRecord & obj )

Definition at line 40 of file ossimGpkgTileMatrixRecord.cpp.

    :
    ossimGpkgDatabaseRecordBase(),
    m_table_name(obj.m_table_name),
    m_zoom_level(obj.m_zoom_level),
    m_matrix_width(obj.m_matrix_width),
    m_matrix_height(obj.m_matrix_height),
    m_tile_width(obj.m_tile_width),
    m_tile_height(obj.m_tile_height),   
    m_pixel_x_size(obj.m_pixel_x_size),
    m_pixel_y_size(obj.m_pixel_y_size)
 {
 }

◆ ~ossimGpkgTileMatrixRecord()

ossimGpkgTileMatrixRecord::~ossimGpkgTileMatrixRecord ( )

virtual

destructor

Definition at line 154 of file ossimGpkgTileMatrixRecord.cpp.

155 {

156 }

Member Function Documentation

◆ createTable()

bool ossimGpkgTileMatrixRecord::createTable ( sqlite3 * db )

static

Creates table in database.

Parameters

db

Returns: true on success, false on error.

Definition at line 97 of file ossimGpkgTileMatrixRecord.cpp.

References status, and ossim_sqlite::tableExists().

Referenced by ossimGpkgWriter::createTables().

 {
    bool status = false;
    if ( db )
    {
       status = ossim_sqlite::tableExists( db, TABLE_NAME );
       if ( !status )
       {
          std::ostringstream sql;
          sql << "CREATE TABLE " << TABLE_NAME << " ( "      
              << "table_name TEXT NOT NULL, "
              << "zoom_level INTEGER NOT NULL, "
              << "matrix_width INTEGER NOT NULL, "
              << "matrix_height INTEGER NOT NULL, "
              << "tile_width INTEGER NOT NULL, "
              << "tile_height INTEGER NOT NULL, "
              << "pixel_x_size DOUBLE NOT NULL, "
              << "pixel_y_size DOUBLE NOT NULL, "
              << "CONSTRAINT pk_ttm PRIMARY KEY (table_name, zoom_level), "
              << "CONSTRAINT fk_tmm_table_name FOREIGN KEY (table_name) REFERENCES gpkg_contents(table_name) "
              << ")";
          
          if ( ossim_sqlite::exec( db, sql.str() ) == SQLITE_DONE )
          {
             status = true;
          }
       }
    }
    return status;
 }

◆ getGsd()

void ossimGpkgTileMatrixRecord::getGsd ( ossimDpt & gsd ) const

Get gsd.

Parameters

gsd	Initializes with pixel_x_size and pixel_y_size.

Definition at line 308 of file ossimGpkgTileMatrixRecord.cpp.

References m_pixel_x_size, m_pixel_y_size, ossimDpt::x, and ossimDpt::y.

 {
    gsd.x = m_pixel_x_size;
    gsd.y = m_pixel_y_size;
 }

◆ getMatrixSize()

void ossimGpkgTileMatrixRecord::getMatrixSize ( ossimIpt & size ) const

Get matrix size.

Parameters

size	Initialized with matrix_width and matrix_height.

Definition at line 296 of file ossimGpkgTileMatrixRecord.cpp.

References m_matrix_height, m_matrix_width, and size.

 {
    size.x = m_matrix_width;
    size.y = m_matrix_height;
 }

◆ getTableName()

const std::string & ossimGpkgTileMatrixRecord::getTableName ( )

static

Get the table name "gpkg_tile_matrix".

Returns: table name

Definition at line 158 of file ossimGpkgTileMatrixRecord.cpp.

Referenced by ossim_gpkg::getNewTableRecord(), ossim_gpkg::getTileEntries(), and ossim_gpkg::getTileEntry().

 {
    return TABLE_NAME;
 }

◆ getTileSize()

void ossimGpkgTileMatrixRecord::getTileSize ( ossimIpt & size ) const

Get tile size.

Parameters

size	Initializes with tile_width and tile_height.

Definition at line 302 of file ossimGpkgTileMatrixRecord.cpp.

References m_tile_height, m_tile_width, and size.

 {
    size.x = m_tile_width;
    size.y = m_tile_height;
 }

◆ init() [1/2]

bool ossimGpkgTileMatrixRecord::init ( sqlite3_stmt * pStmt )

virtual

Initialize from database.

Parameters

pStmt SQL statement, i.e. result of sqlite3_prepare_v2(...) call.

Implements ossimGpkgDatabaseRecordBase.

Definition at line 163 of file ossimGpkgTileMatrixRecord.cpp.

References m_matrix_height, m_matrix_width, m_pixel_x_size, m_pixel_y_size, m_table_name, m_tile_height, m_tile_width, m_zoom_level, ossimNotify(), ossimNotifyLevel_WARN, and status.

Referenced by ossimGpkgWriter::writeGpkgTileMatrixTable().

 {
    static const char M[] = "ossimGpkgTileMatrixRecord::init";
    
    bool status = false;
    
    if ( pStmt )
    {
       const ossim_int32 EXPECTED_COLUMNS = 8;
       ossim_int32 nCol = sqlite3_column_count( pStmt );
 
       if ( nCol != EXPECTED_COLUMNS )
       {
          ossimNotify(ossimNotifyLevel_WARN)
             << M << " WARNING:\nUnexpected number of columns: " << nCol
             << "Expected column count: " << EXPECTED_COLUMNS
             << std::endl;
       }
       
       if ( nCol >= EXPECTED_COLUMNS )
       {
          ossim_int32 columnsFound = 0;
          std::string colName;
          const char* c = 0; // To catch null so not to pass to string.
          
          for ( ossim_int32 i = 0; i < nCol; ++i )
          {
             colName = sqlite3_column_name(pStmt, i);
             if ( colName.size() )
             {
                if ( colName == "table_name" )
                {
                   c = (const char*)sqlite3_column_text(pStmt, i);
                   m_table_name = (c ? c : "");
                   ++columnsFound;
                }
                else if ( colName == "zoom_level" )
                {
                   m_zoom_level = sqlite3_column_int(pStmt, i);
                   ++columnsFound;
                }
                else if ( colName == "matrix_width" )
                {
                   m_matrix_width = sqlite3_column_int(pStmt, i);
                   ++columnsFound;
                }
                else if ( colName == "matrix_height" )
                {
                   m_matrix_height = sqlite3_column_int(pStmt, i);
                   ++columnsFound;
                }
                else if ( colName == "tile_width" )
                {
                   m_tile_width = sqlite3_column_int(pStmt, i);
                   ++columnsFound;
                }
                else if ( colName == "tile_height" )
                {
                   m_tile_height = sqlite3_column_int(pStmt, i);
                   ++columnsFound;
                }
                else if ( colName == "pixel_x_size" )
                {
                   m_pixel_x_size = sqlite3_column_double(pStmt, i);
                   ++columnsFound;
                }
                else if ( colName == "pixel_y_size" )
                {
                   m_pixel_y_size = sqlite3_column_double(pStmt, i);
                   ++columnsFound;
                }
                else
                {
                   ossimNotify(ossimNotifyLevel_WARN)
                      << M << " Unhandled column name["
                      << i << "]: " << colName << std::endl;
                }
             
             } // Matches: if ( colName.size() )
          
             if ( columnsFound == EXPECTED_COLUMNS )
             {
                status = true;
                break;
             }
          
          } // Matches: for ( int i = 0; i < nCol; ++i )  
       }
    
    } // Matches: if ( pStmt )
    
    return status;
    
 } // End: ossimGpkgTileMatrixRecord::init( sqlite3_stmt* pStmt )

◆ init() [2/2]

bool ossimGpkgTileMatrixRecord::init	(	const std::string &	tableName,
		ossim_int32	zoom_level,
		const ossimIpt &	matrixSize,
		const ossimIpt &	tileSize,
		const ossimDpt &	gsd
	)

Initialize method.

Parameters

tableName	e.g. "tiles"
Zoom	level. Zero being whole Earth...
matrixSize	Size of tile matrix, i.e. number of horizontal vertical tiles.
tileSize	Size of one tile, e.g. 256 x 256.
gsd	Size of one pixel either in meters or lat lon.

Returns: true on success, false on error.

Definition at line 71 of file ossimGpkgTileMatrixRecord.cpp.

References ossimIpt::hasNans(), ossimDpt::hasNans(), m_matrix_height, m_matrix_width, m_pixel_x_size, m_pixel_y_size, m_table_name, m_tile_height, m_tile_width, m_zoom_level, status, ossimIpt::x, ossimDpt::x, ossimIpt::y, and ossimDpt::y.

 {
    bool status = false;
 
    if ( (matrixSize.hasNans() == false) && (tileSize.hasNans() == false) &&
         (gsd.hasNans() == false) )
    {
       m_table_name    = tableName;
       m_zoom_level    = zoom_level;
       m_matrix_width  = matrixSize.x;
       m_matrix_height = matrixSize.y;
       m_tile_width    = tileSize.x;
       m_tile_height   = tileSize.y;
       m_pixel_x_size  = gsd.x;
       m_pixel_y_size  = gsd.y;
       status = true;
    }
    
    return status;
    
 } // End: ossimGpkgTileMatrixRecord::init( zoom_level, ... )

◆ insert()

bool ossimGpkgTileMatrixRecord::insert ( sqlite3 * db )

Inserst this record into gpkg_spatial_ref_sys table.

Parameters

db

Returns: true on success, false on error.

Definition at line 128 of file ossimGpkgTileMatrixRecord.cpp.

References ossim_sqlite::exec(), m_matrix_height, m_matrix_width, m_pixel_x_size, m_pixel_y_size, m_table_name, m_tile_height, m_tile_width, m_zoom_level, and status.

Referenced by ossimGpkgWriter::writeGpkgTileMatrixTable().

 {
    bool status = false;
    if ( db )
    {
       std::ostringstream sql;
       sql << "INSERT INTO gpkg_tile_matrix VALUES ( "
           <<  "'" << m_table_name << "', "
           << m_zoom_level << ", "
           << m_matrix_width <<  ", "
           << m_matrix_height << ", "
           << m_tile_width << ", "
           << m_tile_height << ", "
           << std::setiosflags(std::ios::fixed) << std::setprecision(16)
           << m_pixel_x_size << ", "
           << m_pixel_y_size
           << " )";
 
       if ( ossim_sqlite::exec( db, sql.str() ) == SQLITE_DONE )
       {
          status = true;
       }    
    }
    return status;
 }

◆ operator=()

const ossimGpkgTileMatrixRecord & ossimGpkgTileMatrixRecord::operator= ( const ossimGpkgTileMatrixRecord & obj )

Definition at line 54 of file ossimGpkgTileMatrixRecord.cpp.

References m_matrix_height, m_matrix_width, m_pixel_x_size, m_pixel_y_size, m_table_name, m_tile_height, m_tile_width, and m_zoom_level.

 {
    if ( this != &obj )
    {
       m_table_name = obj.m_table_name;
       m_zoom_level = obj.m_zoom_level;
       m_matrix_width = obj.m_matrix_width;
       m_matrix_height = obj.m_matrix_height;
       m_tile_width = obj.m_tile_width;
       m_tile_height = obj.m_tile_height;   
       m_pixel_x_size = obj.m_pixel_x_size;
       m_pixel_y_size = obj.m_pixel_y_size;
    }
    return *this;
 }

◆ saveState()

void ossimGpkgTileMatrixRecord::saveState	(	ossimKeywordlist &	kwl,
		const std::string &	prefix
	)		const

virtual

Saves the state of object.

Parameters

kwl	Initialized by this.
prefix	e.g. "image0.". Can be empty.

Implements ossimGpkgDatabaseRecordBase.

Definition at line 258 of file ossimGpkgTileMatrixRecord.cpp.

References ossimKeywordlist::addPair(), m_matrix_height, m_matrix_width, m_pixel_x_size, m_pixel_y_size, m_table_name, m_tile_height, m_tile_width, m_zoom_level, ossimString::string(), and ossimString::toString().

 {
    std::string myPref = prefix.size() ? prefix : std::string("gpkg_tile_matrix.");
    std::string value;
    
    std::string key = "table_name";
    kwl.addPair(myPref, key, m_table_name, true);
 
    key = "zoom_level";
    value = ossimString::toString(m_zoom_level).string();
    kwl.addPair(myPref, key, value, true);
 
    key = "matrix_width";
    value = ossimString::toString(m_matrix_width).string();
    kwl.addPair(myPref, key, value, true);
 
    key = "matrix_height";
    value = ossimString::toString(m_matrix_height).string();
    kwl.addPair(myPref, key, value, true);
 
    key = "tile_width";
    value = ossimString::toString(m_tile_width).string();
    kwl.addPair(myPref, key, value, true);
 
    key = "tile_height";
    value = ossimString::toString(m_tile_height).string();
    kwl.addPair(myPref, key, value, true);
 
    key = "pixel_x_size";
    value = ossimString::toString(m_pixel_x_size, 15, true).string();
    kwl.addPair(myPref, key, value, true);
 
    key = "pixel_y_size";
    value = ossimString::toString(m_pixel_y_size, 15, true).string();
    kwl.addPair(myPref, key, value, true);
 }