PlantumlManager Class Reference

Singleton that manages plantuml relation actions. More...

#include <src/plantuml.h>

Public Types
enum	OutputFormat { PUML_BITMAP , PUML_EPS , PUML_SVG }
	Plant UML output image formats. More...
using	FilesMap = std::map< std::string, StringVector >
using	ContentMap = std::map< std::string, PlantumlContent >

Public Member Functions
void	run ()
	Run plant UML tool for all images.
StringVector	writePlantUMLSource (const QCString &outDirArg, const QCString &fileName, const QCString &content, OutputFormat format, const QCString &engine, const QCString &srcFile, int srcLine, bool inlineCode)
	Write a PlantUML compatible file.
void	generatePlantUMLOutput (const QCString &baseName, const QCString &outDir, OutputFormat format)
	Convert a PlantUML file to an image.

Static Public Member Functions
static PlantumlManager &	instance ()

Private Member Functions
	PlantumlManager ()
void	insert (const std::string &key, const std::string &value, const QCString &outDir, OutputFormat format, const QCString &puContent, const QCString &srcFile, int srcLine)
void	generatePlantUmlFileNames (const QCString &fileName, OutputFormat format, const QCString &outDir, QCString &baseName, QCString &puName, QCString &imgName)

Private Attributes
FilesMap	m_pngPlantumlFiles
FilesMap	m_svgPlantumlFiles
FilesMap	m_epsPlantumlFiles
ContentMap	m_pngPlantumlContent
ContentMap	m_svgPlantumlContent
ContentMap	m_epsPlantumlContent

Detailed Description

Singleton that manages plantuml relation actions.

Definition at line 40 of file plantuml.h.

Member Typedef Documentation

ContentMap

using PlantumlManager::ContentMap = std::map< std::string, PlantumlContent >

Definition at line 76 of file plantuml.h.

FilesMap

using PlantumlManager::FilesMap = std::map< std::string, StringVector >

Definition at line 75 of file plantuml.h.

Member Enumeration Documentation

OutputFormat

enum PlantumlManager::OutputFormat

Plant UML output image formats.

Enumerator
PUML_BITMAP
PUML_EPS
PUML_SVG

Definition at line 44 of file plantuml.h.

{ PUML_BITMAP, PUML_EPS, PUML_SVG };

Constructor & Destructor Documentation

PlantumlManager()

PlantumlManager::PlantumlManager ( )

private

Definition at line 237 of file plantuml.cpp.

{
}

Referenced by instance().

Member Function Documentation

generatePlantUmlFileNames()

void PlantumlManager::generatePlantUmlFileNames ( const QCString & fileName, OutputFormat format, const QCString & outDir, QCString & baseName, QCString & puName, QCString & imgName )

private

Definition at line 168 of file plantuml.cpp.

{
  static int umlindex=1;
 
  if (fileName.isEmpty()) // generate name
  {
    std::lock_guard<std::mutex> lock(g_PlantUmlMutex);
    puName = "inline_umlgraph_"+QCString().setNum(umlindex);
    baseName = outDir+"/inline_umlgraph_"+QCString().setNum(umlindex++);
  }
  else // user specified name
  {
    baseName = fileName;
    int i=baseName.findRev('.');
    if (i!=-1) baseName = baseName.left(i);
    puName = baseName;
    baseName.prepend(outDir+"/");
  }
 
  switch (format)
  {
    case PUML_BITMAP:
      imgName =puName+".png";
      break;
    case PUML_EPS:
      imgName =puName+".eps";
      break;
    case PUML_SVG:
      imgName =puName+".svg";
      break;
  }
}

References QCString::findRev(), g_PlantUmlMutex, QCString::isEmpty(), QCString::left(), QCString::prepend(), PUML_BITMAP, PUML_EPS, PUML_SVG, and QCString::setNum().

Referenced by writePlantUMLSource().

generatePlantUMLOutput()

void PlantumlManager::generatePlantUMLOutput	(	const QCString &	baseName,
		const QCString &	outDir,
		OutputFormat	format )

Convert a PlantUML file to an image.

Parameters

[in]	baseName	the name of the generated file (as returned by writePlantUMLSource())
[in]	outDir	the directory to write the resulting image into.
[in]	format	the image format to generate.

Definition at line 202 of file plantuml.cpp.

{
  QCString imgName = baseName;
  // The basename contains path, we need to strip the path from the filename in order
  // to create the image file name which should be included in the index.qhp (Qt help index file).
  int i = imgName.findRev('/');
  if (i!=-1) // strip path
  {
    imgName=imgName.mid(i+1);
  }
  switch (format)
  {
    case PUML_BITMAP:
      imgName+=".png";
      break;
    case PUML_EPS:
      imgName+=".eps";
      break;
    case PUML_SVG:
      imgName+=".svg";
      break;
  }
 
  Doxygen::indexList->addImageFile(imgName);
}

References QCString::findRev(), Doxygen::indexList, QCString::mid(), PUML_BITMAP, PUML_EPS, and PUML_SVG.

Referenced by FlowChart::printUmlTree(), DocbookDocVisitor::startPlantUmlFile(), LatexDocVisitor::startPlantUmlFile(), DocbookDocVisitor::writePlantUMLFile(), HtmlDocVisitor::writePlantUMLFile(), LatexDocVisitor::writePlantUMLFile(), and RTFDocVisitor::writePlantUMLFile().

insert()

void PlantumlManager::insert ( const std::string & key, const std::string & value, const QCString & outDir, OutputFormat format, const QCString & puContent, const QCString & srcFile, int srcLine )

private

Definition at line 447 of file plantuml.cpp.

{
  Debug::print(Debug::Plantuml,0,"*** PlantumlManager::insert key:{} ,value:{}\n",key,value);
 
  switch (format)
  {
    case PUML_BITMAP:
      addPlantumlFiles(m_pngPlantumlFiles,key,value);
      print(m_pngPlantumlFiles);
      addPlantumlContent(m_pngPlantumlContent,key,outDir,puContent,srcFile,srcLine);
      print(m_pngPlantumlContent);
      break;
    case PUML_EPS:
      addPlantumlFiles(m_epsPlantumlFiles,key,value);
      print(m_epsPlantumlFiles);
      addPlantumlContent(m_epsPlantumlContent,key,outDir,puContent,srcFile,srcLine);
      print(m_epsPlantumlContent);
      break;
    case PUML_SVG:
      addPlantumlFiles(m_svgPlantumlFiles,key,value);
      print(m_svgPlantumlFiles);
      addPlantumlContent(m_svgPlantumlContent,key,outDir,puContent,srcFile,srcLine);
      print(m_svgPlantumlContent);
      break;
  }
}

References addPlantumlContent(), addPlantumlFiles(), m_epsPlantumlContent, m_epsPlantumlFiles, m_pngPlantumlContent, m_pngPlantumlFiles, m_svgPlantumlContent, m_svgPlantumlFiles, Debug::Plantuml, Debug::print(), print(), PUML_BITMAP, PUML_EPS, and PUML_SVG.

Referenced by writePlantUMLSource().

instance()

PlantumlManager & PlantumlManager::instance ( )

static

Definition at line 231 of file plantuml.cpp.

{
  static PlantumlManager theInstance;
  return theInstance;
}

References PlantumlManager().

Referenced by generateOutput(), DocbookDocVisitor::operator()(), HtmlDocVisitor::operator()(), HtmlDocVisitor::operator()(), LatexDocVisitor::operator()(), RTFDocVisitor::operator()(), RTFDocVisitor::operator()(), FlowChart::printUmlTree(), DocbookDocVisitor::startPlantUmlFile(), LatexDocVisitor::startPlantUmlFile(), DocbookDocVisitor::writePlantUMLFile(), HtmlDocVisitor::writePlantUMLFile(), LatexDocVisitor::writePlantUMLFile(), RTFDocVisitor::writePlantUMLFile(), and writePlantUMLSource().

run()

void PlantumlManager::run

(

)

Run plant UML tool for all images.

Definition at line 389 of file plantuml.cpp.

{
  Debug::print(Debug::Plantuml,0,"*** PlantumlManager::run\n");
  runPlantumlContent(m_pngPlantumlFiles, m_pngPlantumlContent, PUML_BITMAP);
  runPlantumlContent(m_svgPlantumlFiles, m_svgPlantumlContent, PUML_SVG);
  runPlantumlContent(m_epsPlantumlFiles, m_epsPlantumlContent, PUML_EPS);
}

References m_epsPlantumlContent, m_epsPlantumlFiles, m_pngPlantumlContent, m_pngPlantumlFiles, m_svgPlantumlContent, m_svgPlantumlFiles, Debug::Plantuml, Debug::print(), PUML_BITMAP, PUML_EPS, PUML_SVG, and runPlantumlContent().

Referenced by generateOutput().

writePlantUMLSource()

StringVector PlantumlManager::writePlantUMLSource	(	const QCString &	outDirArg,
		const QCString &	fileName,
		const QCString &	content,
		OutputFormat	format,
		const QCString &	engine,
		const QCString &	srcFile,
		int	srcLine,
		bool	inlineCode )

Write a PlantUML compatible file.

Parameters

[in]	outDirArg	the output directory to write the file to.
[in]	fileName	the name of the file. If empty a name will be chosen automatically.
[in]	content	the contents of the PlantUML file.
[in]	format	the image format to generate.
[in]	engine	the plantuml engine to use.
[in]	srcFile	the source file resulting in the write command.
[in]	srcLine	the line number resulting in the write command.
[in]	inlineCode	the code is coming from the \statuml ... \enduml (true) command or from the \planumlfile command (false)

Returns

The names of the generated files.

Definition at line 31 of file plantuml.cpp.

{
  StringVector baseNameVector;
  QCString baseName;
  QCString puName;
  QCString imgName;
  QCString outDir(outDirArg);
 
  Debug::print(Debug::Plantuml,0,"*** writePlantUMLSource fileName: {}\n",fileName);
  Debug::print(Debug::Plantuml,0,"*** writePlantUMLSource outDir: {}\n",outDir);
 
  // strip any trailing slashes and backslashes
  size_t l = 0;
  while ((l=outDir.length())>0 && (outDir.at(l-1)=='/' || outDir.at(l-1)=='\\'))
  {
    outDir = outDir.left(l-1);
  }
 
  generatePlantUmlFileNames(fileName,format,outDir,baseName,puName,imgName);
 
  Debug::print(Debug::Plantuml,0,"*** writePlantUMLSourcebaseName: {}\n",baseName);
  Debug::print(Debug::Plantuml,0,"*** writePlantUMLSourcebaseName puName: {}\n",puName);
  Debug::print(Debug::Plantuml,0,"*** writePlantUMLSourcebaseName imgName: {}\n",imgName);
 
  QCString text;
  if (inlineCode) text = "@start"+engine+" "+imgName+"\n";
  text.reserve(text.length()+content.length()+100); // add room for image name and end marker
  const char *p = content.data();
  if (p)
  {
    char c = 0;
    bool insideComment = false;
    QCString locEngine;
    while ((c=*p++))
    {
      text+=c;
      switch (c)
      {
        case '\'': insideComment=true; break;
        case '\n': insideComment=false; break;
        case '\t': break;
        case ' ':  break;
        case '@':
          if (!insideComment && literal_at(p,"start")) // @start...
          {
            locEngine.clear();
            p+=5;
            text += "start";
            while ((c=*p++) && isId(c))
            {
              locEngine += c;
              text+=c;
            }
            QCString inpName;
            QCString rest;
 
            // skip leading whitespace
            if (*p && (c==' ' || c=='\t'))
            {
              while ((c=*p++) && (c==' ' || c=='\t')) {}
            }
            // get everything till end or endOfLine, and split into inpName (without extension) and rest
            enum State { InName, InExt, InRest };
            State state = InName;
            while (*p && c!='\n')
            {
              switch (state)
              {
                case InName: // looking for the name part
                  if      (isId(c) || c=='-') inpName+=c;
                  else if (c=='.')            state=InExt;
                  else                        rest+=c, state=InRest;
                  break;
                case InExt: // skipping over extension part
                  if (!isId(c) && c!='-')     rest+=c, state=InRest;
                  break;
                case InRest: // gather rest until new line
                  rest+=c;
                  break;
              }
              c = *p++;
            }
            //printf("inpName='%s' rest='%s'\n",qPrint(inpName),qPrint(rest));
            generatePlantUmlFileNames(inpName,format,outDir,baseName,puName,imgName);
 
            // insert the image name
            text+=' ';
            text+=imgName;
 
            if (!rest.isEmpty())
            {
              text += '\n';
              text += rest;
            }
            if (c) text+=c;
          }
          else if (!insideComment && strncmp(p,("end"+locEngine).data(), 3+strlen(engine.data()))==0) // @end...
          {
            text += "end"+locEngine+"\n";
            p+=3+locEngine.length();
            if (!inlineCode)
            {
              QCString qcOutDir(substitute(outDir,"\\","/"));
              uint32_t pos = qcOutDir.findRev("/");
              QCString generateType(qcOutDir.right(qcOutDir.length() - (pos + 1)) );
              Debug::print(Debug::Plantuml,0,"*** writePlantUMLSource generateType: {}\n",generateType);
              PlantumlManager::instance().insert(generateType.str(),puName.str(),outDir,format,text,srcFile,srcLine);
              Debug::print(Debug::Plantuml,0,"*** writePlantUMLSource generateType: {}\n",generateType);
              baseNameVector.push_back(baseName.str());
              text.clear();
            }
          }
          break;
        default:
          break;
      }
    }
    text+='\n';
  }
  if (inlineCode)
  {
    text +="@end"+engine+"\n";
    //printf("content\n====\n%s\n=====\n->\n-----\n%s\n------\n",qPrint(content),qPrint(text));
    QCString qcOutDir(substitute(outDir,"\\","/"));
    uint32_t pos = qcOutDir.findRev("/");
    QCString generateType(qcOutDir.right(qcOutDir.length() - (pos + 1)) );
    Debug::print(Debug::Plantuml,0,"*** writePlantUMLSource generateType: {}\n",generateType);
    PlantumlManager::instance().insert(generateType.str(),puName.str(),outDir,format,text,srcFile,srcLine);
    Debug::print(Debug::Plantuml,0,"*** writePlantUMLSource generateType: {}\n",generateType);
    baseNameVector.push_back(baseName.str());
  }
 
  return baseNameVector;
}

References QCString::at(), QCString::clear(), QCString::data(), QCString::findRev(), generatePlantUmlFileNames(), insert(), instance(), QCString::isEmpty(), isId(), QCString::left(), QCString::length(), literal_at(), Debug::Plantuml, Debug::print(), QCString::reserve(), QCString::right(), QCString::str(), and substitute().

Referenced by DocbookDocVisitor::operator()(), HtmlDocVisitor::operator()(), HtmlDocVisitor::operator()(), LatexDocVisitor::operator()(), RTFDocVisitor::operator()(), RTFDocVisitor::operator()(), FlowChart::printUmlTree(), DocbookDocVisitor::startPlantUmlFile(), and LatexDocVisitor::startPlantUmlFile().

Member Data Documentation

m_epsPlantumlContent

ContentMap PlantumlManager::m_epsPlantumlContent

private

Definition at line 94 of file plantuml.h.

Referenced by insert(), and run().

m_epsPlantumlFiles

FilesMap PlantumlManager::m_epsPlantumlFiles

private

Definition at line 91 of file plantuml.h.

Referenced by insert(), and run().

m_pngPlantumlContent

ContentMap PlantumlManager::m_pngPlantumlContent

private

Definition at line 92 of file plantuml.h.

Referenced by insert(), and run().

m_pngPlantumlFiles

FilesMap PlantumlManager::m_pngPlantumlFiles

private

Definition at line 89 of file plantuml.h.

Referenced by insert(), and run().

m_svgPlantumlContent

ContentMap PlantumlManager::m_svgPlantumlContent

private

Definition at line 93 of file plantuml.h.

Referenced by insert(), and run().

m_svgPlantumlFiles

FilesMap PlantumlManager::m_svgPlantumlFiles

private

Definition at line 90 of file plantuml.h.

Referenced by insert(), and run().

---

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

• src/plantuml.h
• src/plantuml.cpp