ossimPotraceTool Class Reference

#include <ossimPotraceTool.h>

Inheritance diagram for ossimPotraceTool:

Classes
class	Path

Public Types
enum	OutputMode { POLYGON, LINESTRING }
Public Types inherited from ossimProcessInterface
enum	ossimProcessStatus {   PROCESS_STATUS_UNKNOWN = 0, PROCESS_STATUS_EXECUTING = 1, PROCESS_STATUS_ABORTED = 2, PROCESS_STATUS_ABORT_REQUEST = 3,   PROCESS_STATUS_NOT_EXECUTING = 4 }

Public Member Functions
	ossimPotraceTool ()
virtual	~ossimPotraceTool ()
virtual void	setUsage (ossimArgumentParser &ap)
	Initializes the aurgument parser with expected parameters and options. More...
virtual bool	initialize (ossimArgumentParser &ap)
	Initial method to be ran prior to execute. More...
virtual void	initialize (const ossimKeywordlist &ap)
	This method is responsible for completely setting up the full processing chain according to the specifications given in the kwl passed in. More...
virtual bool	execute ()
	Performs the actual product write. More...
virtual ossimString	getClassName () const
virtual void	getKwlTemplate (ossimKeywordlist &kwl)
	Assigns a template keywordlist to string for initializing derived classes. More...
Public Member Functions inherited from ossimChipProcTool
	ossimChipProcTool ()
	default constructor More...
virtual	~ossimChipProcTool ()
	virtual destructor More...
virtual void	clear ()
	Disconnects and clears the dem and image layers. More...
virtual void	abort ()
virtual bool	isChipProcessor () const
	Overrides base class implementation to indicate this class supports getChip() calls. More...
virtual ossimListenerManager *	getManager ()
virtual ossimObject *	getObject ()
virtual const ossimObject *	getObject () const
virtual ossimRefPtr< ossimImageData >	getChip (const ossimIrect &img_rect)
	The meat and potatos of this class. More...
virtual ossimRefPtr< ossimImageData >	getChip (const ossimGrect &gnd_rect)
ossimRefPtr< ossimImageData >	getChip (const ossimDrect &map_bounding_rect, const ossimDpt &gsd)
ossimRefPtr< ossimImageData >	getChip ()
	Get chip method that assumes pre-initialized state. More...
const ossimFilename &	getProductFilename () const
Public Member Functions inherited from ossimTool
	ossimTool ()
virtual	~ossimTool ()
virtual void	loadJSON (const Json::Value &json_request)
	Reads processing params from JSON object provided. More...
virtual void	saveJSON (Json::Value &json) const
	Fetch product as JSON object when applicable Always returns true since using exception on error. More...
virtual const std::string &	getResponse () const
	Fetch product as string (typically JSON) when applicable, otherwise passes back empty string. More...
void	getAPI (std::string &out) const
	Outputs a JSON representation of the Utility's API. More...
std::string	getAPI () const
void	getBuildDate (std::string &s) const
	Gets build date. More...
void	getRevision (std::string &s) const
	Gets revision. More...
void	getVersion (std::string &s) const
	Gets version. More...
void	setOutputStream (std::ostream *os)
	Redirects any console output to the supplied stream for logging or JNI application. More...
bool	helpRequested () const
	Returns true when the initialization detects a "--help" option, so caller can avoid subsequent execute() call. More...
Public Member Functions inherited from ossimObject
	ossimObject ()
virtual	~ossimObject ()
virtual ossimObject *	dup () const
virtual ossimString	getShortName () const
virtual ossimString	getLongName () const
virtual ossimString	getDescription () const
virtual RTTItypeid	getType () const
virtual bool	canCastTo (ossimObject *obj) const
virtual bool	canCastTo (const RTTItypeid &id) const
virtual bool	canCastTo (const ossimString &parentClassName) const
virtual bool	saveState (ossimKeywordlist &kwl, const char *prefix=0) const
virtual bool	loadState (const ossimKeywordlist &kwl, const char *prefix=0)
virtual std::ostream &	print (std::ostream &out) const
	Generic print method. More...
virtual bool	isEqualTo (const ossimObject &obj, ossimCompareType compareType=OSSIM_COMPARE_FULL) const
virtual void	accept (ossimVisitor &visitor)
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
Public Member Functions inherited from ossim::JsonInterface
	JsonInterface ()
virtual	~JsonInterface ()
Public Member Functions inherited from ossimProcessInterface
	ossimProcessInterface ()
virtual	~ossimProcessInterface ()
bool	needsAborting () const
bool	isAbortRequested () const
bool	isAborted () const
bool	isExecuting () const
ossimProcessStatus	getProcessStatus () const
virtual void	setProcessStatus (ossimProcessStatus processStatus)
virtual double	getPercentComplete () const
virtual void	setPercentComplete (double percentComplete)
void	enableEvents ()
void	disableEvents ()
void	setCurrentMessage (const ossimString &message)
virtual std::ostream &	print (std::ostream &out) const
Public Member Functions inherited from ossimListenerManager
	ossimListenerManager ()
virtual	~ossimListenerManager ()
virtual void	fireEvent (ossimEvent &event)
virtual bool	addListener (ossimListener *listener)
virtual bool	removeListener (ossimListener *listener)
virtual bool	findListener (ossimListener *listener)

Static Public Attributes
static const char *	DESCRIPTION

Private Member Functions
virtual void	initProcessingChain ()
	Derived classes initialize their custom chains here. More...
virtual void	finalizeChain ()
	Called after initProcessingChain() to append common items to the processing chain. More...
potrace_bitmap_t *	convertToBitmap (ossimImageSource *handler)
bool	writeGeoJSON (potrace_path_t *vectorList)
bool	pixelIsMasked (const ossimIpt &image_pt, potrace_bitmap_t *bitmap) const
void	transformLineStrings (potrace_state_t *pathTree)
void	transformPolygons (potrace_state_t *pathTree)

Private Attributes
OutputMode	m_mode
double	m_alphamax
int	m_turdSize
bool	m_outputToConsole
potrace_bitmap_t *	m_maskBitmap
potrace_bitmap_t *	m_productBitmap

Additional Inherited Members
Protected Member Functions inherited from ossimChipProcTool
void	processRemainingArgs (ossimArgumentParser &ap)
	Intended to be called after derived class has picked off its own options from the parser, and arguments remain (such as input and output filenames). More...
virtual void	loadImageFiles ()
	Creates chains for image entries associated with specified keyword. More...
virtual void	loadDemFiles ()
	Loads all DEM files specified in master KWL into the elev manager's database. More...
ossimRefPtr< ossimSingleImageChain >	createInputChain (const ossimFilename &image_file, ossim_uint32 entry_index=0)
	Creates the ossimSingleImageChain from image filename and populates the chain with resampler and product output projection on view-side of resampler's IVT. More...
void	createOutputProjection ()
	Creates the output or view projection. More...
ossimRefPtr< ossimMapProjection >	newIdentityProjection ()
	Sets the single image chain for identity operations view to a ossimImageViewAffineTransform. More...
ossimRefPtr< ossimMapProjection >	newUtmProjection ()
	Convenience method to get a utm projection. More...
virtual void	initializeProjectionGsd ()
	Initializes the projection gsd. More...
virtual void	initializeAOI ()
	Initializes m_aoiViewRect with the output area of interest as specified in master KWL. More...
bool	getProjectionOrigin (ossimGpt &gpt)
	Reads the KWL for origin latitude and central meridian. More...
ossimRefPtr< ossimImageFileWriter >	newWriter ()
	Creates a new writer. More...
void	propagateGeometryToChains ()
	Loops through all chains and sets the output projection. More...
ossimRefPtr< ossimImageSource >	combineLayers (std::vector< ossimRefPtr< ossimSingleImageChain > > &layers) const
	When multiple input sources are present, this method instantiates a combiner and adds inputs. More...
void	computeAdjustedViewFromGrect ()
	Initializes m_aoiViewRect given m_aoiGroundRect. More...
void	setAoiToInputs ()
	Assigns the AOI to be the bounding rect of the union of all inputs. More...
void	getBandList (ossim_uint32 image_idx, std::vector< ossim_uint32 > &bandList) const
	Gets the band list if BANDS keyword is set. More...
void	setReaderProps (ossimImageHandler *ih) const
	Passes reader properties to single image handler if any. More...
	ossimChipProcTool (const ossimChipProcTool &obj)
	Hidden from use copy constructor. More...
const ossimChipProcTool &	operator= (const ossimChipProcTool &)
	Hidden from use assignment operator. More...
ossimRefPtr< ossimGeoPolygon >	createClipPolygon () const
void	findCenterGpt (ossimGpt &gpt)
	Tries to determine the AOI center point based on KWL entries, else returns NaNs in gpt. More...
ossimRefPtr< ossimImageSource >	mosaicDemSources ()
	Some utilities need to work on DEMs as images. More...
Protected Member Functions inherited from ossimReferenced
virtual	~ossimReferenced ()
Protected Member Functions inherited from ossimListenerManager
	ossimListenerManager (const ossimListenerManager &rhs)
Protected Attributes inherited from ossimChipProcTool
ossimRefPtr< ossimImageGeometry >	m_geom
ossimIrect	m_aoiViewRect
ossimGrect	m_aoiGroundRect
std::vector< ossimRefPtr< ossimSingleImageChain > >	m_imgLayers
std::vector< ossimFilename >	m_demSources
ossimRefPtr< ossimImageFileWriter >	m_writer
ossimRefPtr< ossimImageChain >	m_procChain
ossimRefPtr< ossimRectangleCutFilter >	m_cutRectFilter
bool	m_projIsIdentity
ossimDpt	m_gsd
bool	m_geoScaled
ossimFilename	m_productFilename
ossimScalarType	m_productScalarType
bool	m_needCutRect
Protected Attributes inherited from ossimTool
ossimKeywordlist	m_kwl
std::ostream *	m_consoleStream
bool	m_helpRequested
std::string	m_response
Protected Attributes inherited from ossimProcessInterface
double	thePercentComplete
ossimProcessStatus	theProcessStatus
ossimString	theMessage
bool	theEventFlag
Protected Attributes inherited from ossimListenerManager
std::list< ossimListener * >	theListenerList
bool	theEnabledFlag
std::list< ossimListener * >	theDelayedAdd
std::list< ossimListener * >	theDelayedRemove
bool	theFireEventFlag

Detailed Description

Definition at line 19 of file ossimPotraceTool.h.

Member Enumeration Documentation

OutputMode

enum ossimPotraceTool::OutputMode

Enumerator
POLYGON
LINESTRING

Definition at line 23 of file ossimPotraceTool.h.

{ POLYGON, LINESTRING };

Constructor & Destructor Documentation

ossimPotraceTool()

ossimPotraceTool::ossimPotraceTool

(

)

Definition at line 27 of file ossimPotraceTool.cpp.

:  m_mode (LINESTRING),
   m_alphamax (1.0),
   m_turdSize (4),
   m_outputToConsole(false),
   m_maskBitmap (0),
   m_productBitmap (0)
{
}

~ossimPotraceTool()

ossimPotraceTool::~ossimPotraceTool ( )

virtual

Definition at line 37 of file ossimPotraceTool.cpp.

References m_maskBitmap, and m_productBitmap.

{
   delete m_productBitmap;
   if (m_maskBitmap)
      delete m_maskBitmap;
}

Member Function Documentation

convertToBitmap()

potrace_bitmap_t * ossimPotraceTool::convertToBitmap ( ossimImageSource *  handler )

private

Definition at line 412 of file ossimPotraceTool.cpp.

References potrace_bitmap_s::dy, ossimImageGeometry::getBoundingRect(), ossimImageData::getHeight(), ossimImageSource::getImageGeometry(), ossimImageSourceSequencer::getNextTile(), ossimImageData::getNullPix(), ossimImageData::getOrigin(), ossimImageData::getPix(), ossimImageData::getWidth(), potrace_bitmap_s::h, ossimIrect::height(), ossimIrect::lr(), potrace_bitmap_s::map, potrace_writepbm(), ossimRefPtr< T >::valid(), potrace_bitmap_s::w, ossimIrect::width(), ossimIpt::x, and ossimIpt::y.

Referenced by execute().

{
   potrace_bitmap_t* potraceBitmap = new potrace_bitmap_t;

   // Determine output bitmap size to even word boundary:
   ossimIrect rect;
   raster->getImageGeometry()->getBoundingRect(rect);
   potraceBitmap->w = rect.width();
   potraceBitmap->h = rect.height();
   int pixelsPerWord = 8 * sizeof(int*);
   potraceBitmap->dy = (int) ceil((double)rect.width()/pixelsPerWord);

   // Allocate the bitmap memory:
   unsigned long bufLength = potraceBitmap->dy*potraceBitmap->h;
   potraceBitmap->map = new potrace_word[bufLength];

   // Prepare to sequence over all input image tiles and fill the bitmap image:
   ossimRefPtr<ossimImageSourceSequencer> sequencer = new ossimImageSourceSequencer(raster);
   ossimRefPtr<ossimImageData> tile = sequencer->getNextTile();
   double null_pix = tile->getNullPix(0);
   unsigned long offset=0;
   ossimIpt pt_ul, pt, pt_lr;

   // Loop to fill bitmap buffer:
   while (tile.valid())
   {
      pt_ul = tile->getOrigin();
      pt_lr.x = pt_ul.x + tile->getWidth();
      pt_lr.y = pt_ul.y + tile->getHeight();
      if (pt_lr.x > rect.lr().x)
         pt_lr.x = rect.lr().x;
      if (pt_lr.y > rect.lr().y)
         pt_lr.y = rect.lr().y;

      // Nested loops over all pixels in input tile:
      for (pt.y=pt_ul.y; pt.y < pt_lr.y; ++pt.y)
      {
         offset = pt_ul.x/pixelsPerWord + pt.y*potraceBitmap->dy;
         for (pt.x=pt_ul.x; pt.x<pt_lr.x; )
         {
            // Loop to pack a word buffer with pixel on (non-null) or off bit in proper positions:
            unsigned long wordBuf = 0;
            for (int bitpos=pixelsPerWord-1; bitpos>=0; --bitpos)
            {
               unsigned long pixel = (tile->getPix(pt) != null_pix) ? 1 : 0;
               wordBuf |= pixel << bitpos;
               ++pt.x;
               if (pt.x >= pt_lr.x)
                  break;
            }
            potraceBitmap->map[offset++] = wordBuf;
         }
      }

      tile = sequencer->getNextTile();
   }

#if 0
   FILE* pbm = fopen("TEMP.pbm", "w");
   potrace_writepbm(pbm, potraceBitmap);
#endif

   return potraceBitmap;
}

execute()

bool ossimPotraceTool::execute ( )

virtual

Performs the actual product write.

Note

Throws ossimException on error.

Reimplemented from ossimChipProcTool.

Definition at line 148 of file ossimPotraceTool.cpp.

References potrace_param_s::alphamax, convertToBitmap(), LINESTRING, m_alphamax, ossimChipProcTool::m_geom, ossimChipProcTool::m_imgLayers, m_maskBitmap, m_mode, m_productBitmap, m_turdSize, potrace_state_s::plist, potrace_param_default(), potrace_trace(), transformLineStrings(), transformPolygons(), potrace_param_s::turdsize, ossimRefPtr< T >::valid(), and writeGeoJSON().

{
   ostringstream xmsg;

   if (m_imgLayers.empty() || !m_geom.valid())
   {
      xmsg<<"ossimPotraceTool:"<<__LINE__<<" Null input image list encountered! ";
      throw ossimException(xmsg.str());
   }

   // Generate bitmap for input image:
   m_productBitmap = convertToBitmap(m_imgLayers[0].get());

   // If there is a mask, generate a bitmap for it as well:
   m_maskBitmap = 0;
   if (m_imgLayers.size() == 2)
   {
      m_maskBitmap = convertToBitmap(m_imgLayers[1].get());
      m_mode = LINESTRING;
   }

   // Perform vectorization:
   potrace_param_t* potraceParam = potrace_param_default();
   potraceParam->turdsize = m_turdSize;
   potraceParam->alphamax = m_alphamax;
   potrace_state_t* potraceOutput = potrace_trace(potraceParam, m_productBitmap);
   if (!potraceOutput)
   {
      xmsg <<"ossimPotraceTool:"<<__LINE__<<" Null pointer returned from potrace_trace!";
      throw ossimException(xmsg.str());
   }

   if (m_mode == LINESTRING)
      transformLineStrings(potraceOutput);
   else
      transformPolygons(potraceOutput);

   // Write to output vector file:
   if (!writeGeoJSON(potraceOutput->plist))
      return false;

   // Release memory:
   //potrace_state_free(potraceOutput);
   //free(potraceBitmap->map);
   free(potraceParam);

   return true;
}

finalizeChain()

void ossimPotraceTool::finalizeChain ( )

privatevirtual

Called after initProcessingChain() to append common items to the processing chain.

Sets up the AOI box cutter filter and related stuff and initializes area of interest(aoi). The filter is appended to the current m_procChain. Derived class should override if not applicable to its processing chain.

Reimplemented from ossimChipProcTool.

Definition at line 143 of file ossimPotraceTool.cpp.

{
   // Do nothing and avoid ossimChipProcUtil from doing its standard stuff.
}

getClassName()

virtual ossimString ossimPotraceTool::getClassName ( ) const

inlinevirtual

Reimplemented from ossimTool.

Definition at line 37 of file ossimPotraceTool.h.

{ return "ossimPotraceUtil"; }

getKwlTemplate()

void ossimPotraceTool::getKwlTemplate ( ossimKeywordlist &  kwl )

virtual

Assigns a template keywordlist to string for initializing derived classes.

Reimplemented from ossimTool.

Definition at line 393 of file ossimPotraceTool.cpp.

References ossimKeywordlist::addPair().

{
   ostringstream value;
   value << "polygon|linestring (optional, defaults to polygon)";
   kwl.addPair(MODE_KW, value.str());

   value.clear();
   value<<"<float> (optional, defaults to "<<m_alphamax<<")";
   kwl.addPair(ALPHAMAX_KW, value.str());

   value.clear();
   value<<"<int> (optional, defaults to "<<m_turdSize<<")";
   kwl.addPair(TURDSIZE_KW, value.str());

   kwl.add("image_file0", "<input-raster-file>");
   kwl.add("image_file1", "<mask-file> (optional)");
   kwl.add(ossimKeywordNames::OUTPUT_FILE_KW, "<output-vector-file>");
}

initialize() [1/2]

bool ossimPotraceTool::initialize ( ossimArgumentParser &  ap )

virtual

Initial method to be ran prior to execute.

Intended for command-line app usage.

Parameters

ap	Arg parser to initialize from.

Returns

FALSE if –help option requested or no params provided, so that derived classes can

Note

Throws ossimException on error.

A throw with an error message of "usage" is used to get out when a usage is printed.

Reimplemented from ossimChipProcTool.

Definition at line 73 of file ossimPotraceTool.cpp.

References ossimKeywordlist::addPair(), ossimTool::initialize(), ossimTool::m_kwl, and ossimArgumentParser::read().

{
   string ts1;
   ossimArgumentParser::ossimParameter sp1(ts1);

   if (!ossimTool::initialize(ap))
      return false;

   if ( ap.read("--alphamax", sp1))
      m_kwl.addPair(ALPHAMAX_KW, ts1);

   if ( ap.read("--mode", sp1))
      m_kwl.addPair(MODE_KW, ts1);

   if ( ap.read("--mask", sp1))
   {
      // Mask handled as a second image source:
      ostringstream key;
      key<<ossimKeywordNames::IMAGE_FILE_KW<<"1";
      m_kwl.addPair( key.str(), ts1 );
   }

   if ( ap.read("--turdsize", sp1))
      m_kwl.addPair(TURDSIZE_KW, ts1);

   processRemainingArgs(ap);
   return true;
}

initialize() [2/2]

void ossimPotraceTool::initialize ( const ossimKeywordlist &  kwl )

virtual

This method is responsible for completely setting up the full processing chain according to the specifications given in the kwl passed in.

If the utility is run from a command line, the initialize(ossimArgumentParser) will assign the member master KWL and pass it to this method. Web service calls will fill a KWL and pass it.

This base class implementation should be called by the derived class implementation (assuming the derived class needs to pull some parameters out of the KWL before the chains are set up.

This method will instantiate the output projection and define the output bounding rect and product size in pixels. The processing chain (stored in m_procChain) will be completely initialized and ready for calls to getTile(). Then either getChip() or execute() can be called depending on usage to fetch product.

Note

Throws ossimException on error.

Reimplemented from ossimChipProcTool.

Definition at line 102 of file ossimPotraceTool.cpp.

References ossimKeywordlist::addList(), ossimKeywordlist::clear(), ossimKeywordlist::findKey(), and ossimTool::m_kwl.

{
   ossimString value;
   ostringstream xmsg;

   // Don't copy KWL if member KWL passed in:
   if (&kwl != &m_kwl)
   {
      // Start with clean options keyword list.
      m_kwl.clear();
      m_kwl.addList( kwl, true );
   }

   value = m_kwl.findKey(ALPHAMAX_KW);
   if (!value.empty())
      m_alphamax = value.toDouble();

   value = m_kwl.findKey(TURDSIZE_KW);
   if (!value.empty())
      m_turdSize = value.toInt();

   value = m_kwl.findKey(MODE_KW);
   if (value.contains("polygon"))
      m_mode = POLYGON;
   else if (value.contains("linestring"))
      m_mode = LINESTRING;
   else if (!value.empty())
   {
      xmsg <<"ossimPotraceTool:"<<__LINE__<<" Unallowed mode requested: <"<<value<<">."
            <<endl;
      throw ossimException(xmsg.str());
   }

   ossimChipProcTool::initialize(kwl);
}

initProcessingChain()

void ossimPotraceTool::initProcessingChain ( )

privatevirtual

Derived classes initialize their custom chains here.

Implements ossimChipProcTool.

Definition at line 138 of file ossimPotraceTool.cpp.

{
   // Nothing to do.
}

pixelIsMasked()

bool ossimPotraceTool::pixelIsMasked ( const ossimIpt &  image_pt, potrace_bitmap_t *  bitmap  ) const

private

Definition at line 477 of file ossimPotraceTool.cpp.

References potrace_bitmap_s::dy, potrace_bitmap_s::map, ossimIpt::x, and ossimIpt::y.

Referenced by transformLineStrings().

{
   if (bitmap == 0)
      return false;

   int pixelsPerWord = 8 * sizeof(int*);
   unsigned long offset = image_pt.x/pixelsPerWord + image_pt.y*bitmap->dy;
   int shift = pixelsPerWord - (image_pt.x % pixelsPerWord) - 1;
   unsigned long wordBuf = bitmap->map[offset];
   unsigned long shifted = wordBuf >> shift;
   shifted = shifted & 1;
   if (shifted == 0)
      return true;
   return false;
}

setUsage()

void ossimPotraceTool::setUsage ( ossimArgumentParser &  ap )

virtual

Initializes the aurgument parser with expected parameters and options.

It does not output anything. To see the usage, the caller will need to do something like:

ap.getApplicationUsage()->write(<ostream>);

This base class has some common arguments to add. The derived class should call this implementation in addition to setting its own arguments.

Reimplemented from ossimChipProcTool.

Definition at line 44 of file ossimPotraceTool.cpp.

References ossimApplicationUsage::addCommandLineOption(), ossimArgumentParser::getApplicationName(), ossimArgumentParser::getApplicationUsage(), ossimApplicationUsage::setCommandLineUsage(), and ossimTool::setUsage().

{
   // Add global usage options. Don't include ossimChipProcUtil options as not appropriate.
   ossimTool::setUsage(ap);

   // Set the general usage:
   ossimApplicationUsage* au = ap.getApplicationUsage();
   ossimString usageString = ap.getApplicationName();
   usageString += " potrace [options] <input-raster-file> [<output-vector-file>]";
   au->setCommandLineUsage(usageString);

   // Set the command line options:
   au->addCommandLineOption("--alphamax <float>",
         "set the corner threshold parameter. The default value is 1. The smaller this value, the "
         "more sharp corners will be produced. If this parameter is 0, then no smoothing will be "
         "performed and the output is a polygon. If this parameter is greater than 1.3, then all "
         "corners are suppressed and the output is completely smooth");
   au->addCommandLineOption("--mode polygon|linestring",
         "Specifies whether to represent foreground-background boundary as polygons or line-strings"
         ". Polygons are closed regions surrounding either null or non-null pixels. Most viewers "
         "will represent polygons as solid blobs. Line-strings only outline the boundary but do not"
         " maintain sense of \"insideness\"");
   au->addCommandLineOption("--mask <filename>",
         "Use the raster file provided as a mask to exclude any vertices found within 1 pixel of "
         "a null mask pixel. Implies linestring mode since polygons may not be closed. The mask "
         "should be a single-band image, but if multi-band, only band 0 will be referenced.");
   au->addCommandLineOption("--turdsize <int>", "suppress speckles of up to this many pixels.");
}

transformLineStrings()

void ossimPotraceTool::transformLineStrings ( potrace_state_t *  pathTree )

private

Definition at line 197 of file ossimPotraceTool.cpp.

References ossimPotraceTool::Path::addPotraceCurve(), potrace_path_s::area, potrace_curve_s::c, potrace_path_s::childlist, ossimPotraceTool::Path::closed, potrace_path_s::curve, ossimIrect::expand(), ossimImageGeometry::getBoundingRect(), ossimGpt::lat, ossimImageGeometry::localToWorld(), ossimGpt::lon, ossimChipProcTool::m_geom, m_maskBitmap, potrace_curve_s::n, potrace_path_s::next, pixelIsMasked(), potrace_state_s::plist, ossimIrect::pointWithin(), POTRACE_CORNER, POTRACE_ENDPOINT, potrace_path_s::priv, potrace_path_s::sibling, potrace_path_s::sign, potrace_curve_s::tag, ossimPotraceTool::Path::vertices, potrace_dpoint_s::x, and potrace_dpoint_s::y.

Referenced by execute().

{
   // This is a fairly complex process because potrace assumes all paths are closed, i.e., the
   // last vertex of a path is the same as the first. For linestring mode, this is not always
   // true since the path may hit the border or masked region, in which case it needs to be
   // split into two or more paths.

   ossimIrect rect;
   m_geom->getBoundingRect(rect);
   rect.expand(ossimIpt(-1,-1));

   // Vector coordinates are in image space. Need geom to convert to geographic lat/lon:
   potrace_path_t* path = potraceOutput->plist;
   potrace_path_t* pathToDelete;
   ossimDpt imgPt;
   vector<Path*> originalPaths;
   vector<Path*> adjustedPaths;

   // Populate the std::vector with original list of potrace paths:
   while (path)
   {
      //cout << "\nProcessing path "<<(long)path<<endl;
      if (path->curve.n > 0)
      {
         // Start by converting all paths to C++ data structures:
         Path* p = new Path;
         for (int segment=0; segment<path->curve.n; ++segment)
         {
            //cout << "  Processing segment "<<segment;
            p->addPotraceCurve(path->curve, segment);
         }
         originalPaths.push_back(p);
      }
      potrace_path_t* delete_this_path = path;
      path = path->next;
      free(delete_this_path); // Don't need old path anymore
   }

   // All paths are now represented by line segments in convenient C++ vector structure. Now
   // need to filter out masked points, splitting up paths as they encounter the masked regions:
   for (size_t i=0; i<originalPaths.size(); ++i)
   {
      Path* original = originalPaths[i];
      bool outside = false;

      //cout << "\nProcessing originalPath["<<i<<"] with numVertices="<<original->vertices.size()<<endl;
      Path* adjusted = 0;
      for (size_t v=0; v<original->vertices.size(); ++v)
      {
         imgPt = original->vertices[v];
         if ( rect.pointWithin(imgPt) && !pixelIsMasked(imgPt, m_maskBitmap))
         {
            if (!adjusted)
            {
               adjusted = new Path;
               adjustedPaths.push_back(adjusted);
               //cout << "  Creating adjusted="<<(long)adjusted<<endl;
            }
            adjusted->vertices.push_back(imgPt);
            //cout << "  Adding to adjusted, imgPt:"<<imgPt<<endl;

            if (outside)
            {
               // Coming in from the outside, so not closed:
               adjusted->closed = false;
               outside = false;
            }
         }
         else if (!outside)
         {
            // Just went outside. Close this adjusted path and start a new one:
            //cout << "  Hit outside, end of adjusted:"<<(long)adjusted<<endl;
            if (adjusted)
               adjusted->closed = false;
            adjusted = 0;
            outside = true;
         }
      }
   }

   // The adjustedPaths list contains only vertices inside the ROI. Now need to move back into
   // potrace space to prepare potrace data structures for geojson output:
   ossimGpt gndPt;
   potrace_path_t* previous_path = 0;
   vector<Path*>::iterator path_iter = adjustedPaths.begin();
   while (path_iter != adjustedPaths.end())
   {
      // Don't bother with single-vertex "paths":
      Path* adjusted = *path_iter;
      if (adjusted->vertices.size() < 3)
      {
         ++path_iter;
         continue;
      }

      // Convert image point vertices to ground points and repopulate using potrace
      // datastructures:
      //cout << "\nProcessing adjustedPaths["<<i<<"] with numVertices="<<adjusted->vertices.size()<<endl;
      path = new potrace_path_t;
      //cout << "  Created potrace path:"<<(long)path<<endl;
      if (previous_path)
         previous_path->next = path;
      else
         potraceOutput->plist = path;

      int num_segments = (adjusted->vertices.size()+1)/2;
      path->curve.n = num_segments;
      path->curve.c = new potrace_dpoint_t[num_segments][3];
      path->curve.tag = new int[num_segments];
      path->area = 1;
      path->sign = 1;
      path->sibling = 0;
      path->childlist = 0;
      path->priv = 0;
      path->next = 0;

      // Loop to transfer the vertices to the potrace structure, transforming to lat, lon:
      int segment = 0;
      int adj_v = 0;
      while (adj_v < adjusted->vertices.size())
      {
         path->curve.tag[segment] = POTRACE_CORNER;

         // Transform:
         imgPt = adjusted->vertices[adj_v++];
         m_geom->localToWorld(imgPt, gndPt);
         path->curve.c[segment][1].x = gndPt.lon;
         path->curve.c[segment][1].y = gndPt.lat;
         //cout << "  Inserted ["<<adj_v-1<<"], imgPt:"<<imgPt<<" --> ("<<gndPt.lon<<", "<<gndPt.lat<<")"<<endl;

         if (adj_v == adjusted->vertices.size())
         {
            //cout << "  Inserted above as last"<<endl;

            path->curve.c[segment][2].x = gndPt.lon;
            path->curve.c[segment][2].y = gndPt.lat;
         }
         else
         {
            imgPt = adjusted->vertices[adj_v++];
            m_geom->localToWorld(imgPt, gndPt);
            path->curve.c[segment][2].x = gndPt.lon;
            path->curve.c[segment][2].y = gndPt.lat;
            //cout << "  Inserted ["<<adj_v-1<<"], imgPt:"<<imgPt<<" --> ("<<gndPt.lon<<", "<<gndPt.lat<<")"<<endl;
         }

         // Mark the last point as a line segment endpoint to avoid closure:
         if (adj_v == adjusted->vertices.size() && !adjusted->closed)
            path->curve.tag[segment] = POTRACE_ENDPOINT;

         //cout << "  Finished segment:"<<segment<<", tag="<<path->curve.tag[segment]<<endl;
         ++segment;
      }
      previous_path = path;

      // Don't need the adjusted path anymore:
      delete adjusted;
      adjusted = 0;
      ++path_iter;
   }
}

transformPolygons()

void ossimPotraceTool::transformPolygons ( potrace_state_t *  pathTree )

private

Definition at line 359 of file ossimPotraceTool.cpp.

References potrace_curve_s::c, potrace_path_s::curve, ossimGpt::lat, ossimImageGeometry::localToWorld(), ossimGpt::lon, ossimChipProcTool::m_geom, potrace_curve_s::n, potrace_path_s::next, potrace_state_s::plist, POTRACE_CORNER, potrace_curve_s::tag, potrace_dpoint_s::x, ossimDpt::x, potrace_dpoint_s::y, and ossimDpt::y.

Referenced by execute().

{
   // Vector coordinates are in image space. Need geom to convert to geographic lat/lon:
   potrace_path_t* path = potraceOutput->plist;
   ossimDpt imgPt;
   ossimGpt gndPt;
   while (path)
   {
      for (int segment=0; segment<path->curve.n;)
      {
         //cout << "\nWorking on path="<<(long)path<<" segment="<<segment<<", tag="<<path->curve.tag[segment]<<endl;
         // Convert up to 3 possible vertices per segment
         for (int v=0; v<3; ++v)
         {
            if ((v == 0) && (path->curve.tag[segment] == POTRACE_CORNER))
            {
               //cout << "Hit corner"<<endl;
               continue;
            }

            imgPt.x = path->curve.c[segment][v].x;
            imgPt.y = path->curve.c[segment][v].y;
            //cout << "imgPt["<<v<<"] = "<<imgPt<<endl;

            m_geom->localToWorld(imgPt, gndPt);
            path->curve.c[segment][v].x = gndPt.lon;
            path->curve.c[segment][v].y = gndPt.lat;
         }
         ++segment;
      }
      path = path->next;
   }
}

writeGeoJSON()

bool ossimPotraceTool::writeGeoJSON ( potrace_path_t *  vectorList )

private

Definition at line 493 of file ossimPotraceTool.cpp.

References ossimString::chars(), ossimTool::m_consoleStream, m_mode, m_outputToConsole, ossimChipProcTool::m_productFilename, POLYGON, and potrace_geojson().

Referenced by execute().

{
   ostringstream xmsg;

   FILE* outFile = fopen(m_productFilename.chars(), "w");
   if (!outFile)
   {
      xmsg <<"ossimPotraceTool:"<<__LINE__<<" Could not open output file <"<<m_productFilename
            <<"> for writing.";
      throw ossimException(xmsg.str());
   }

   potrace_geojson(outFile, vectorList, (int) (m_mode == POLYGON));
   fclose(outFile);

   if (m_outputToConsole && m_consoleStream)
   {
      ifstream vectorFile (m_productFilename.chars());
      if (vectorFile.fail())
      {
         xmsg <<"ossimPotraceTool:"<<__LINE__<<" Error encountered opening temporary vector file at: "
               "<"<<m_productFilename<<">.";
         throw ossimException(xmsg.str());
      }

      *m_consoleStream << vectorFile.rdbuf();
      vectorFile.close();
   }

   return true;
}

Member Data Documentation

DESCRIPTION

const char * ossimPotraceTool::DESCRIPTION

static

Initial value:

=
      "Computes vector representation of input raster image."

Definition at line 22 of file ossimPotraceTool.h.

Referenced by ossimPotraceToolFactory::getCapabilities().

m_alphamax

double ossimPotraceTool::m_alphamax

private

Definition at line 61 of file ossimPotraceTool.h.

Referenced by execute().

m_maskBitmap

potrace_bitmap_t* ossimPotraceTool::m_maskBitmap

private

Definition at line 64 of file ossimPotraceTool.h.

Referenced by execute(), transformLineStrings(), and ~ossimPotraceTool().

m_mode

OutputMode ossimPotraceTool::m_mode

private

Definition at line 60 of file ossimPotraceTool.h.

Referenced by execute(), and writeGeoJSON().

m_outputToConsole

bool ossimPotraceTool::m_outputToConsole

private

Definition at line 63 of file ossimPotraceTool.h.

Referenced by writeGeoJSON().

m_productBitmap

potrace_bitmap_t* ossimPotraceTool::m_productBitmap

private

Definition at line 65 of file ossimPotraceTool.h.

Referenced by execute(), and ~ossimPotraceTool().

m_turdSize

int ossimPotraceTool::m_turdSize

private

Definition at line 62 of file ossimPotraceTool.h.

Referenced by execute().

---

The documentation for this class was generated from the following files:

• ossimPotraceTool.h
• ossimPotraceTool.cpp