AbstractPbmPlusFile.C

Go to the documentation of this file.

/*---------------------------------------------------------------------+
 | Library QgarLib, graphics analysis and recognition                  |
 | Copyright (C) 2002  Qgar Project, LORIA                             |
 |                                                                     |
 | This library is free software; you can redistribute it and/or       |
 | modify it under the terms of the GNU Lesser General Public          |
 | License version 2.1, as published by the Free Software Foundation.  |
 |                                                                     |
 | This library is distributed in the hope that it will be useful,     |
 | but WITHOUT ANY WARRANTY; without even the implied warranty of      |
 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                |
 | See the GNU Lesser General Public License for more details.         |
 |                                                                     |
 | The GNU Lesser General Public License is included in the file       |
 | LICENSE.LGPL, in the root directory of the Qgar packaging. See      |
 | http://www.gnu.org/licenses/lgpl.html for the terms of the licence. |
 | To receive a paper copy, write to the Free Software Foundation,     |
 | Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.       |
 |                                                                     |
 | Contact Project Qgar for any information:                           |
 |   LORIA - équipe Qgar                                               |
 |   B.P. 239, 54506 Vandoeuvre-lès-Nancy Cedex, France                |
 |   email: qgar-contact@loria.fr                                      |
 |   http://www.qgar.org/                                              |
 *---------------------------------------------------------------------*/


/**
 * @file   AbstractPbmPlusFile.C
 * @brief  Implementation of class qgar::AbstractPbmPlusFile.
 *
 * See file AbstractPbmPlusFile.H for the interface.
 *
 * @author <a href="mailto:qgar-develop@loria.fr?subject=Qgar fwd Karl Tombre">Karl Tombre</a>
 * @date   Jul 3, 2001  16:32
 * @since  qgar 1.0
 */


// Most of the code in this module is an adaptation of code from the PBM
// software package. Here is the copyright notice of this package:
// +------------------------------------------------------------------------+
// | Copyright (C) 1988 by Jef Poskanzer                                    |
// |                                                                        |
// | Permission to use, copy, modify, and distribute this software and its  |
// | documentation for any purpose and without fee is hereby granted,       |
// | provided that the above copyright notice appear in all copies and that |
// | both that copyright notice and this permission notice appear in        |
// | supporting documentation.  This software is provided "as is" without   |
// | express or implied warranty.                                           |
// +------------------------------------------------------------------------+



// STL
#include <sstream>
// QGAR
#include <qgarlib/AbstractPbmPlusFile.H>
#include <qgarlib/QgarErrorInvalidArg.H>
#include <qgarlib/QgarErrorIO.H>



namespace qgar
{


// -------------------------------------------------------------------
// C O N S T R U C T O R 
// -------------------------------------------------------------------

AbstractPbmPlusFile::AbstractPbmPlusFile(const char*  aFileName,
                                         int          aRowCnt,
                                         int          aColCnt,
                                         QGEpbmFormat aFormat)
  throw(QgarErrorInvalidArg)

  : AbstractFile(aFileName),
      _format(aFormat),
      _rowCnt(aRowCnt),
      _colCnt(aColCnt),
      _pRow(0)

{
  // WARNING: Tests should be '<=' to be quite correct!
  if ((aRowCnt < 0) || (aColCnt < 0))
    {
      std::ostringstream os;
      os << "Cannot create file "
         << _fileName
         << ": Bad image size ("
         << aRowCnt
         << " rows, "
         << aColCnt
         << " columns)";
      throw QgarErrorInvalidArg(__FILE__, __LINE__,
                                "qgar::AbstractPbmPlusFile::AbstractPbmPlusFile(const char*, int, int, qgar::QGEpbmFormat)",
                                os.str());
    }
}


// -------------------------------------------------------------------
// D E S T R U C T O R 
// -------------------------------------------------------------------


AbstractPbmPlusFile::~AbstractPbmPlusFile()
{
  if (_pRow != 0)
    {
      delete [] _pRow;
    }
}


// -------------------------------------------------------------------
// I N P U T 
// -------------------------------------------------------------------


// READ A CHARACTER FROM THE FILE

char
AbstractPbmPlusFile::getChar()

  throw(QgarErrorIO)

{
  int intC = _fileStream.get();
  if (intC == EOF)
    {
      std::ostringstream os;
      os << "EOF while reading in file "
         << _fileName;
      throw QgarErrorIO(__FILE__, __LINE__,
                        "char qgar::AbstractPbmPlusFile::getChar()",
                        os.str());
    }

  char c = (char) intC;
    
  if (c == '#')
    {
      do
        {
          intC = _fileStream.get();
          if (intC == EOF)
            {
              std::ostringstream os;
              os << "EOF while reading in file "
                 << _fileName;
              throw QgarErrorIO(__FILE__, __LINE__,
                                "char qgar::AbstractPbmPlusFile::getChar()",
                                os.str());
            }
          c = (char) intC;
        }
      while ((c != '\n') && (c != '\r'));
    }

  return c;
}


// READ AN INTEGER FROM THE FILE

int
AbstractPbmPlusFile::getInt()

  throw(QgarErrorIO)

{
  char c;
  do
    {
      c = getChar();
    }
  while ((c == ' ') || (c == '\t') || (c == '\n') || (c == '\r'));

  if ((c < '0') || (c > '9'))
    {
      std::ostringstream os;
      os << "Error while reading in file "
         << _fileName
         << ": Integer in [0,9] expected";
      throw QgarErrorIO(__FILE__, __LINE__,
                        "int qgar::AbstractPbmPlusFile::getInt()",
                        os.str());
    }

  int i = 0;
  do
    {
      i = (i * 10) + c - '0';
      c = getChar();
    }
  while ((c >= '0') && (c <= '9'));

  return i;
}


// READ A RAW BYTE FROM THE FILE

unsigned char
AbstractPbmPlusFile::getRawByte()

  throw(QgarErrorIO)

{
  int iByte = _fileStream.get();

  if (iByte == EOF)
    {
      std::ostringstream os;
      os << "EOF while reading in file "
         << _fileName;
      throw QgarErrorIO(__FILE__, __LINE__,
                        "unsigned char qgar::AbstractPbmPlusFile::getRawByte()",
                        os.str());
    }

  return (unsigned char)iByte;
}


// -------------------------------------------------------------------
// M E M O R Y   S P A C E   A L L O C A T I O N 
// -------------------------------------------------------------------


void
AbstractPbmPlusFile::newRow()
{
  if (_pRow != 0)
    {
      delete [] _pRow;
    }
  _pRow = new unsigned char[_colCnt];
}


// -------------------------------------------------------------------

} // namespace qgar