DotFilePatcher Class Reference

Helper class to insert a set of map file into an output file. More...

#include <src/dotfilepatcher.h>

Collaboration diagram for DotFilePatcher:

Classes
struct	Map

Public Member Functions
	DotFilePatcher (const DString &patchFile)
int	addMap (const DString &mapFile, const DString &relPath, bool urlOnly, const DString &context, const DString &label)
int	addFigure (const DString &baseName, const DString &figureName, bool heightCheck)
int	addSVGConversion (const DString &relPath, bool urlOnly, const DString &context, bool zoomable, int graphId)
int	addSVGObject (const DString &baseName, const DString &figureName, const DString &relPath)
bool	run () const
bool	isSVGFile () const

Static Public Member Functions
static bool	convertMapFile (TextStream &t, const DString &mapName, const DString &relPath, bool urlOnly=false, const DString &context=DString())
static bool	writeSVGFigureLink (TextStream &out, const DString &relPath, const DString &baseName, const DString &absImgName)
	Check if a reference to a SVG figure can be written and do so if possible.
static bool	writeVecGfxFigure (TextStream &out, const DString &baseName, const DString &figureName)
static DString	mapLabelToId (const DString &mapLabel)

Private Attributes
std::vector< Map >	m_maps
DString	m_patchFile

Detailed Description

Helper class to insert a set of map file into an output file.

Definition at line 26 of file dotfilepatcher.h.

Constructor & Destructor Documentation

DotFilePatcher()

DotFilePatcher::DotFilePatcher

(

const DString &

patchFile

)

Definition at line 256 of file dotfilepatcher.cpp.

  : m_patchFile(patchFile)
{
}

References m_patchFile.

Member Function Documentation

addFigure()

int DotFilePatcher::addFigure	(	const DString &	baseName,
		const DString &	figureName,
		bool	heightCheck )

Definition at line 274 of file dotfilepatcher.cpp.

{
  size_t id = m_maps.size();
  m_maps.emplace_back(figureName,"",heightCheck,"",baseName);
  return static_cast<int>(id);
}

References m_maps.

addMap()

int DotFilePatcher::addMap	(	const DString &	mapFile,
		const DString &	relPath,
		bool	urlOnly,
		const DString &	context,
		const DString &	label )

Definition at line 266 of file dotfilepatcher.cpp.

{
  size_t id = m_maps.size();
  m_maps.emplace_back(mapFile,relPath,urlOnly,context,label);
  return static_cast<int>(id);
}

References m_maps.

addSVGConversion()

int DotFilePatcher::addSVGConversion	(	const DString &	relPath,
		bool	urlOnly,
		const DString &	context,
		bool	zoomable,
		int	graphId )

Definition at line 282 of file dotfilepatcher.cpp.

{
  size_t id = m_maps.size();
  m_maps.emplace_back("",relPath,urlOnly,context,"",zoomable,graphId);
  return static_cast<int>(id);
}

References m_maps.

Referenced by writeDotImageMapFromFile().

addSVGObject()

int DotFilePatcher::addSVGObject	(	const DString &	baseName,
		const DString &	figureName,
		const DString &	relPath )

Definition at line 291 of file dotfilepatcher.cpp.

{
  size_t id = m_maps.size();
  m_maps.emplace_back(absImgName,relPath,false,"",baseName);
  return static_cast<int>(id);
}

References m_maps.

convertMapFile()

bool DotFilePatcher::convertMapFile ( TextStream & t, const DString & mapName, const DString & relPath, bool urlOnly = false, const DString & context = DString() )

static

converts the rectangles in a client site image map into a stream

Parameters

t	the stream to which the result is written.
mapName	the name of the map file.
relPath	the relative path to the root of the output directory (used in case CREATE_SUBDIRS is enabled).
urlOnly	if false the url field in the map contains an external references followed by a $ and then the URL.
context	the context (file, class, or namespace) in which the map file was found

Returns

true if successful.

Definition at line 215 of file dotfilepatcher.cpp.

{
  std::ifstream f = Portable::openInputStream(mapName);
  if (!f.is_open())
  {
    err("problems opening map file {} for inclusion in the docs!\n"
      "If you installed Graphviz/dot after a previous failing run, \n"
      "try deleting the output directory and rerun doxygen.\n",mapName);
    return false;
  }
  std::string line;
  while (getline(f,line)) // foreach line
  {
    DString buf = line+'\n';
    if (buf.startsWith("<area"))
    {
      DString replBuf = replaceRef(buf,relPath,urlOnly,context);
      // in dot version 7.0.2 the alt attribute is, incorrectly, removed.
      // see https://gitlab.com/graphviz/graphviz/-/issues/265
      if (size_t indexA = replBuf.find("alt="); indexA==DString::npos)
      {
        replBuf = replBuf.left(5) + " alt=\"\"" + replBuf.mid(5);
      }
 
      // strip id="..." from replBuf since the id's are not needed and not unique.
      if (size_t indexS = replBuf.find("id=\""), indexE = 0;
          indexS!=DString::npos && indexS>0 && (indexE=replBuf.find('"',indexS+4))!=DString::npos)
      {
        t << replBuf.left(indexS-1) << replBuf.mid(indexE+1);
      }
      else
      {
        t << replBuf;
      }
    }
  }
  return true;
}

References err, DString::find(), DString::left(), DString::mid(), DString::npos, Portable::openInputStream(), replaceRef(), and DString::startsWith().

Referenced by insertMapFile(), run(), and writeDotImageMapFromFile().

isSVGFile()

bool DotFilePatcher::isSVGFile

(

)

const

Definition at line 261 of file dotfilepatcher.cpp.

{
  return m_patchFile.endsWith(".svg");
}

References DString::endsWith(), and m_patchFile.

Referenced by run().

mapLabelToId()

DString DotFilePatcher::mapLabelToId ( const DString & mapLabel )

inlinestatic

To adhere to the requirement that an id cannot have a digit at the first position always place an "a" in front

Definition at line 55 of file dotfilepatcher.h.

    {
      if (mapLabel.empty()) return mapLabel;
      return "a" + mapLabel;
    }

References DString::empty().

Referenced by DotGraph::generateCode(), and run().

run()

bool DotFilePatcher::run

(

)

const

Definition at line 300 of file dotfilepatcher.cpp.

{
  //printf("DotFilePatcher::run(): %s\n",qPrint(m_patchFile));
  bool interactiveSVG = Config_getBool(INTERACTIVE_SVG);
  bool isSVGFile = m_patchFile.endsWith(".svg");
  int graphId = -1;
  DString relPath;
  if (isSVGFile)
  {
    const Map &map = m_maps.front(); // there is only one 'map' for a SVG file
    interactiveSVG = interactiveSVG && map.zoomable;
    graphId = map.graphId;
    relPath = map.relPath;
    //printf("DotFilePatcher::addSVGConversion: file=%s zoomable=%d\n",
    //    qPrint(m_patchFile),map->zoomable);
  }
  DString tmpName = m_patchFile+".tmp";
  Dir thisDir;
  if (!thisDir.rename(m_patchFile.str(),tmpName.str()))
  {
    err("Failed to rename file {} to {}!\n",m_patchFile,tmpName);
    return false;
  }
  std::ifstream fi = Portable::openInputStream(tmpName);
  std::ofstream fo = Portable::openOutputStream(m_patchFile);
  if (!fi.is_open())
  {
    err("problem opening file {} for patching!\n",tmpName);
    thisDir.rename(tmpName.str(),m_patchFile.str());
    return false;
  }
  if (!fo.is_open())
  {
    err("problem opening file {} for patching!\n",m_patchFile);
    thisDir.rename(tmpName.str(),m_patchFile.str());
    return false;
  }
  TextStream t(&fo);
  int width=0,height=0;
  bool insideHeader=false;
  bool replacedHeader=false;
  bool useNagivation=false;
  std::string lineStr;
  static const reg::Ex reSVG(R"([\‍[<]!-- SVG [0-9]+)");
  static const reg::Ex reMAP(R"(<!-- MAP [0-9]+)");
  static const reg::Ex reFIG(R"(% FIG [0-9]+)");
 
  while (getline(fi,lineStr))
  {
    // replace id="page0,1_graph0" with id="graph0" to work around graphviz page numbering bug
    {
      auto pos = lineStr.find("id=\"page0,1_graph0\"");
      if (pos != std::string::npos)
        lineStr.replace(pos, 19, "id=\"graph0\"");
    }
    DString line = lineStr+'\n';
    //printf("line=[%s]\n",qPrint(line.stripWhiteSpace()));
    size_t i = 0;
    if (isSVGFile)
    {
      if (interactiveSVG)
      {
        if (line.find("<svg")!=DString::npos && !replacedHeader)
        {
          int count = sscanf(line.data(),"<svg width=\"%dpt\" height=\"%dpt\"",&width,&height);
          if (count != 2) count = sscanf(line.data(),"<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"%d\" height=\"%d\"",&width,&height);
          //printf("width=%d height=%d\n",width,height);
          useNagivation = count==2 && (width>500 || height>450);
          insideHeader = count==2;
        }
        else if (insideHeader && !replacedHeader && line.find("<g id=\"graph")!=DString::npos)
        {
          if (useNagivation)
          {
            // insert special replacement header for interactive SVGs
            t << "<!--zoomable " << height << " -->\n";
            t << svgZoomHeader0;
          }
          else
          {
            t << svgZoomHeader0_noinit;
          }
          t << svgZoomHeader1;
          if (useNagivation)
          {
            t << svgZoomHeader2;
          }
          t << "<script type=\"application/ecmascript\" xlink:href=\"" << relPath << "svg.min.js\"/>\n";
          t << "<svg id=\"graph\" class=\"graph\"";
          if (useNagivation)
          {
            t << " data-view-width=\"" << width << "\" data-view-height=\"" << height << "\"";
            if (graphId>=0)
            {
               t << " data-section-id=\"dynsection-" << graphId << "\"";
            }
          }
          t << ">\n";
 
          if (useNagivation)
          {
            t << "<g id=\"viewport\">\n";
          }
          else
          {
            t << line;
          }
          line="";
          insideHeader=false;
          replacedHeader=true;
        }
      }
      if (!insideHeader || !useNagivation) // copy SVG and replace refs,
                                       // unless we are inside the header of the SVG.
                                       // Then we replace it with another header.
      {
        const Map &map = m_maps.front(); // there is only one 'map' for a SVG file
        t << replaceRef(line,map.relPath,map.urlOnly,map.context,"_top");
      }
    }
    else if (line.find("SVG")!=DString::npos && (i=findIndex(line.str(),reSVG))!=std::string::npos)
    {
      //printf("Found marker at %d\n",i);
      int mapId=-1;
      t << line.left(i);
      int n = sscanf(line.data()+i+1,"!-- SVG %d",&mapId);
      if (n==1 && mapId>=0 && mapId<static_cast<int>(m_maps.size()))
      {
        size_t e0 = line.find("--]");
        size_t e1 = line.find("-->");
        size_t e = e0!=DString::npos && e1!=DString::npos ? std::max(e0,e1) :
                   e0!=DString::npos ? e0 : e1;
        const Map &map = m_maps.at(mapId);
        //printf("DotFilePatcher::writeSVGFigure: file=%s zoomable=%d\n",
        //  qPrint(m_patchFile),map.zoomable);
        if (!writeSVGFigureLink(t,map.relPath,map.label,map.mapFile))
        {
          err("Problem extracting size from SVG file {}\n",map.mapFile);
        }
        if (e!=DString::npos) t << line.mid(e+3);
      }
      else // error invalid map id!
      {
        err("Found invalid SVG id in file {}!\n",m_patchFile);
        t << line.mid(i);
      }
    }
    else if (line.find("MAP")!=DString::npos && (i=findIndex(line.str(),reMAP))!=std::string::npos)
    {
      int mapId=-1;
      t << line.left(i);
      int n = sscanf(line.data()+i,"<!-- MAP %d",&mapId);
      if (n==1 && mapId>=0 && mapId<static_cast<int>(m_maps.size()))
      {
        TextStream tt;
        const Map &map = m_maps.at(mapId);
        //printf("patching MAP %d in file %s with contents of %s\n",
        //   mapId,qPrint(m_patchFile),qPrint(map.mapFile));
        convertMapFile(tt,map.mapFile,map.relPath,map.urlOnly,map.context);
        if (!tt.empty())
        {
          t << "<map name=\"" << mapLabelToId(map.label) << "\" id=\"" << mapLabelToId(map.label) << "\">\n";
          t << tt.str();
          t << "</map>\n";
        }
      }
      else // error invalid map id!
      {
        err("Found invalid MAP id in file {}!\n",m_patchFile);
        t << line.mid(i);
      }
    }
    else if (line.find("FIG")!=DString::npos && (i=findIndex(line.str(),reFIG))!=std::string::npos)
    {
      int mapId=-1;
      int n = sscanf(line.data()+i+2,"FIG %d",&mapId);
      //printf("line='%s' n=%d\n",qPrint(line)+i,n);
      if (n==1 && mapId>=0 && mapId<static_cast<int>(m_maps.size()))
      {
        const Map &map = m_maps.at(mapId);
        //printf("patching FIG %d in file %s with contents of %s\n",
        //   mapId,qPrint(m_patchFile),qPrint(map.mapFile));
        if (!writeVecGfxFigure(t,map.label,map.mapFile))
        {
          err("problem writing FIG {} figure!\n",mapId);
          return false;
        }
      }
      else // error invalid map id!
      {
        err("Found invalid bounding FIG {} in file {}!\n",mapId,m_patchFile);
        t << line;
      }
    }
    else
    {
      t << line;
    }
  }
  if (isSVGFile && interactiveSVG && !useNagivation) t << "</svg>\n";
 
  fi.close();
  if (isSVGFile && interactiveSVG && replacedHeader)
  {
    DString orgName=m_patchFile.left(m_patchFile.length()-4)+"_org.svg";
    if (useNagivation)
    {
      t << substitute(svgZoomFooter1,"$orgname",stripPath(orgName));
    }
    t << svgZoomFooter2;
    t.flush();
    fo.close();
    // keep original SVG file so we can refer to it, we do need to replace
    // dummy link by real ones
    fi = Portable::openInputStream(tmpName);
    fo = Portable::openOutputStream(orgName);
    if (!fi.is_open())
    {
      err("problem opening file {} for reading!\n",tmpName);
      return false;
    }
    if (!fo.is_open())
    {
      err("problem opening file {} for writing!\n",orgName);
      return false;
    }
    t.setStream(&fo);
    while (getline(fi,lineStr)) // foreach line
    {
      DString line = lineStr+'\n';
      const Map &map = m_maps.front(); // there is only one 'map' for a SVG file
      t << replaceRef(line,map.relPath,map.urlOnly,map.context,"_top");
    }
    t.flush();
    fi.close();
    fo.close();
  }
  // remove temporary file
  thisDir.remove(tmpName.str());
  return true;
}

References Config_getBool, DotFilePatcher::Map::context, convertMapFile(), DString::data(), TextStream::empty(), DString::endsWith(), err, DString::find(), findIndex(), TextStream::flush(), DotFilePatcher::Map::graphId, isSVGFile(), DotFilePatcher::Map::label, DString::left(), DString::length(), m_maps, m_patchFile, DotFilePatcher::Map::mapFile, mapLabelToId(), DString::mid(), DString::npos, Portable::openInputStream(), Portable::openOutputStream(), DotFilePatcher::Map::relPath, Dir::remove(), Dir::rename(), replaceRef(), TextStream::setStream(), DString::str(), TextStream::str(), stripPath(), substitute(), svgZoomFooter1, svgZoomFooter2, svgZoomHeader0, svgZoomHeader0_noinit, svgZoomHeader1, svgZoomHeader2, DotFilePatcher::Map::urlOnly, writeSVGFigureLink(), writeVecGfxFigure(), and DotFilePatcher::Map::zoomable.

Referenced by writeDotImageMapFromFile().

writeSVGFigureLink()

bool DotFilePatcher::writeSVGFigureLink ( TextStream & out, const DString & relPath, const DString & baseName, const DString & absImgName )

static

Check if a reference to a SVG figure can be written and do so if possible.

Returns false if not possible (for instance because the SVG file is not yet generated).

Definition at line 583 of file dotfilepatcher.cpp.

{
  int width=600,height=600;
  if (!readSVGSize(absImgName,&width,&height))
  {
    return false;
  }
  if (width==-1)
  {
    if (height<=60) height=300; else height+=300; // add some extra space for zooming
    if (height>600) height=600; // clip to maximum height of 600 pixels
    out << "<div class=\"zoom\">";
    //out << "<object type=\"image/svg+xml\" data=\""
    //out << "<embed type=\"image/svg+xml\" src=\""
    out << "<iframe scrolling=\"no\" loading=\"lazy\" frameborder=\"0\" src=\""
        << relPath << baseName << ".svg\" width=\"100%\" height=\"" << height << "\">";
  }
  else
  {
    //out << "<object type=\"image/svg+xml\" data=\""
    //out << "<embed type=\"image/svg+xml\" src=\""
    out << "<iframe scrolling=\"no\" loading=\"lazy\" frameborder=\"0\" src=\""
        << relPath << baseName << ".svg\" width=\""
        << ((width*96+48)/72) << "\" height=\""
        << ((height*96+48)/72) << "\">";
  }
  writeSVGNotSupported(out);
  //out << "</object>";
  //out << "</embed>";
  out << "</iframe>";
  if (width==-1)
  {
    out << "</div>";
  }
 
  return true;
}

References readSVGSize(), and writeSVGNotSupported().

Referenced by DotGraph::generateCode(), run(), and writeDotImageMapFromFile().

writeVecGfxFigure()

bool DotFilePatcher::writeVecGfxFigure ( TextStream & out, const DString & baseName, const DString & figureName )

static

Definition at line 622 of file dotfilepatcher.cpp.

{
  int width=400,height=550;
  if (Config_getBool(USE_PDFLATEX))
  {
    if (!DotRunner::readBoundingBox(figureName+".pdf",&width,&height,false))
    {
      //printf("writeVecGfxFigure()=0\n");
      return false;
    }
  }
  else
  {
    if (!DotRunner::readBoundingBox(figureName+".eps",&width,&height,true))
    {
      //printf("writeVecGfxFigure()=0\n");
      return false;
    }
  }
  //printf("Got PDF/EPS size %d,%d\n",width,height);
  int maxWidth  = 350;  /* approx. page width in points, excl. margins */
  int maxHeight = 550;  /* approx. page height in points, excl. margins */
  out << "\\nopagebreak\n"
         "\\begin{figure}[H]\n"
         "\\begin{center}\n"
         "\\leavevmode\n";
  if (width>maxWidth || height>maxHeight) // figure too big for page
  {
    // c*width/maxWidth > c*height/maxHeight, where c=maxWidth*maxHeight>0
    if (width*maxHeight>height*maxWidth)
    {
      out << "\\includegraphics[width=" << maxWidth << "pt]";
    }
    else
    {
      out << "\\includegraphics[height=" << maxHeight << "pt]";
    }
  }
  else
  {
    out << "\\includegraphics[width=" << width << "pt]";
  }
 
  out << "{" << baseName << "}\n"
         "\\end{center}\n"
         "\\end{figure}\n";
 
  //printf("writeVecGfxFigure()=1\n");
  return true;
}

References Config_getBool, and DotRunner::readBoundingBox().

Referenced by DotGraph::generateCode(), and run().

Member Data Documentation

m_maps

std::vector<Map> DotFilePatcher::m_maps

private

Definition at line 76 of file dotfilepatcher.h.

Referenced by addFigure(), addMap(), addSVGConversion(), addSVGObject(), and run().

m_patchFile

DString DotFilePatcher::m_patchFile

private

Definition at line 77 of file dotfilepatcher.h.

Referenced by DotFilePatcher(), isSVGFile(), and run().

---

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

• src/dotfilepatcher.h
• src/dotfilepatcher.cpp