RTFDocVisitor Class Reference

Concrete visitor implementation for RTF output. More...

#include <src/rtfdocvisitor.h>

Inheritance diagram for RTFDocVisitor:

Collaboration diagram for RTFDocVisitor:

Classes
struct	RTFListItemInfo

Public Member Functions
	RTFDocVisitor (TextStream &t, OutputCodeList &ci, const DString &langExt, int hierarchyLevel=0)
void	operator() (const DocWord &)
void	operator() (const DocLinkedWord &)
void	operator() (const DocWhiteSpace &)
void	operator() (const DocSymbol &)
void	operator() (const DocEmoji &)
void	operator() (const DocURL &)
void	operator() (const DocLineBreak &)
void	operator() (const DocHorRuler &)
void	operator() (const DocStyleChange &)
void	operator() (const DocVerbatim &)
void	operator() (const DocAnchor &)
void	operator() (const DocInclude &)
void	operator() (const DocIncOperator &)
void	operator() (const DocFormula &)
void	operator() (const DocIndexEntry &)
void	operator() (const DocSimpleSectSep &)
void	operator() (const DocCite &)
void	operator() (const DocSeparator &)
void	operator() (const DocAutoList &)
void	operator() (const DocAutoListItem &)
void	operator() (const DocPara &)
void	operator() (const DocRoot &)
void	operator() (const DocSimpleSect &)
void	operator() (const DocTitle &)
void	operator() (const DocSimpleList &)
void	operator() (const DocSimpleListItem &)
void	operator() (const DocSection &s)
void	operator() (const DocHtmlList &s)
void	operator() (const DocHtmlListItem &)
void	operator() (const DocHtmlDescList &)
void	operator() (const DocHtmlDescTitle &)
void	operator() (const DocHtmlDescData &)
void	operator() (const DocHtmlTable &t)
void	operator() (const DocHtmlCaption &)
void	operator() (const DocHtmlRow &)
void	operator() (const DocHtmlCell &)
void	operator() (const DocInternal &)
void	operator() (const DocHRef &)
void	operator() (const DocHtmlSummary &)
void	operator() (const DocHtmlDetails &)
void	operator() (const DocHtmlHeader &)
void	operator() (const DocImage &)
void	operator() (const DocDotFile &)
void	operator() (const DocMscFile &)
void	operator() (const DocDiaFile &)
void	operator() (const DocPlantUmlFile &)
void	operator() (const DocMermaidFile &)
void	operator() (const DocLink &)
void	operator() (const DocRef &ref)
void	operator() (const DocSecRefItem &)
void	operator() (const DocSecRefList &)
void	operator() (const DocParamSect &)
void	operator() (const DocParamList &)
void	operator() (const DocXRefItem &)
void	operator() (const DocInternalRef &)
void	operator() (const DocText &)
void	operator() (const DocHtmlBlockQuote &)
void	operator() (const DocVhdlFlow &)
void	operator() (const DocParBlock &)
Public Member Functions inherited from DocVisitor
	DocVisitor ()
virtual	~DocVisitor ()
CodeParserInterface &	getCodeParser (const DString &langExt)
void	pushHidden (bool hide)
bool	popHidden ()

Private Member Functions
template<class T>
void	visitChildren (const T &t)
void	filter (const DString &str, bool verbatim=false, const bool citeEntry=false)
void	startLink (const DString &ref, const DString &file, const DString &anchor)
void	endLink (const DString &ref)
DString	getStyle (const DString &name)
DString	getListTable (const int id)
int	indentLevel () const
void	incIndentLevel ()
void	decIndentLevel ()
void	includePicturePreRTF (const DString &name, bool isTypeRTF, bool hasCaption, bool inlineImage=false)
void	includePicturePostRTF (bool isTypeRTF, bool hasCaption, bool inlineImage=false)
void	writeDotFile (const DString &fileName, bool hasCaption, const DString &srcFile, int srcLine, bool newFile=true)
void	writeMscFile (const DString &fileName, bool hasCaption, const DString &srcFile, int srcLine, bool newFile=true)
void	writeDiaFile (const DString &fileName, bool hasCaption, const DString &srcFile, int srcLine, bool newFile=true)
void	writePlantUMLFile (const DString &fileName, bool hasCaption)
void	writeMermaidFile (const DString &fileName, bool hasCaption)

Private Attributes
TextStream &	m_t
OutputCodeList &	m_ci
bool	m_insidePre = false
bool	m_hide = false
bool	m_lastIsPara = false
DString	m_langExt
int	m_indentLevel = 0
int	m_hierarchyLevel = 0
RTFListItemInfo	m_listItemInfo [maxIndentLevels]

Static Private Attributes
static const int	maxIndentLevels = 13

Detailed Description

Concrete visitor implementation for RTF output.

Definition at line 31 of file rtfdocvisitor.h.

Constructor & Destructor Documentation

RTFDocVisitor()

RTFDocVisitor::RTFDocVisitor	(	TextStream &	t,
		OutputCodeList &	ci,
		const DString &	langExt,
		int	hierarchyLevel = 0 )

Definition at line 59 of file rtfdocvisitor.cpp.

  : m_t(t), m_ci(ci), m_langExt(langExt), m_hierarchyLevel(hierarchyLevel)
{
}

References m_ci, m_hierarchyLevel, m_langExt, and m_t.

Member Function Documentation

decIndentLevel()

void RTFDocVisitor::decIndentLevel ( )

private

Definition at line 99 of file rtfdocvisitor.cpp.

{
  if (m_indentLevel>0) m_indentLevel--;
}

References m_indentLevel.

Referenced by operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), and operator()().

endLink()

void RTFDocVisitor::endLink ( const DString & ref )

private

Definition at line 1761 of file rtfdocvisitor.cpp.

{
  if (ref.empty() && Config_getBool(RTF_HYPERLINKS))
  {
    m_t << "}}}";
  }
  else
  {
    m_t << "}";
  }
  m_lastIsPara=false;
}

References Config_getBool, DString::empty(), m_lastIsPara, and m_t.

Referenced by operator()(), operator()(), operator()(), operator()(), and operator()().

filter()

void RTFDocVisitor::filter ( const DString & str, bool verbatim = false, const bool citeEntry = false )

private

Definition at line 1695 of file rtfdocvisitor.cpp.

{
  if (!str.empty())
  {
    const char *p=str.data();
    while (*p)
    {
      char c=*p++;
      switch (c)
      {
        case '{':  m_t << "\\{";            break;
        case '}':  m_t << "\\}";            break;
        case '\\': m_t << "\\\\";           break;
        case '&':  // possibility to have a special symbol
          if (!citeEntry) { m_t << c; break;}
          p = HtmlEntityMapper::instance().writeHtmlEntity(
              m_t,
              p-1,
              [](HtmlEntityMapper::SymType symType) { return HtmlEntityMapper::instance().rtf(symType); },
              "&");
          break;
        case '\n': if (verbatim)
                   {
                     m_t << "\\par\n";
                   }
                   else
                   {
                     m_t << '\n';
                   }
                   break;
        default:   m_t << c;
      }
    }
  }
}

References DString::data(), DString::empty(), HtmlEntityMapper::instance(), m_t, HtmlEntityMapper::rtf(), and HtmlEntityMapper::writeHtmlEntity().

Referenced by operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), and operator()().

getListTable()

DString RTFDocVisitor::getListTable ( const int id )

private

Definition at line 72 of file rtfdocvisitor.cpp.

{
  for (int i=0 ; rtf_Table_Default[i].definition ; i++ )
  {
    if ((id == rtf_Table_Default[i].id) && (m_indentLevel == rtf_Table_Default[i].lvl))
    {
      return rtf_Table_Default[i].place;
    }
  }
  ASSERT(0);
  return "";
}

References ASSERT, Rtf_Table_Default::definition, m_indentLevel, Rtf_Table_Default::place, and rtf_Table_Default.

Referenced by operator()().

getStyle()

DString RTFDocVisitor::getStyle ( const DString & name )

private

Definition at line 65 of file rtfdocvisitor.cpp.

{
  DString n = name + DString().setNum(indentLevel());
  StyleData &sd = rtf_Style[n.str()];
  return sd.reference();
}

References DString::DString(), indentLevel(), StyleData::reference(), rtf_Style, DString::setNum(), and DString::str().

Referenced by operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), and operator()().

incIndentLevel()

void RTFDocVisitor::incIndentLevel ( )

private

Definition at line 90 of file rtfdocvisitor.cpp.

{
  m_indentLevel++;
  if (m_indentLevel>=maxIndentLevels)
  {
    err("Maximum indent level ({}) exceeded while generating RTF output!\n",maxIndentLevels-1);
  }
}

References err, m_indentLevel, and maxIndentLevels.

Referenced by operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), and operator()().

includePicturePostRTF()

void RTFDocVisitor::includePicturePostRTF ( bool isTypeRTF, bool hasCaption, bool inlineImage = false )

private

Definition at line 1222 of file rtfdocvisitor.cpp.

{
  if (isTypeRTF)
  {
    if (m_hide) return;
    if (inlineImage)
    {
      if (hasCaption) m_t << " }";
    }
    else
    {
      if (hasCaption)
      {
        m_t << "}\n";
        m_t << "\\par}\n";
      }
      else
      {
        m_t << "}\n";
      }
    }
  }
  else
  {
    m_hide = popHidden();
  }
}

References m_hide, m_t, and DocVisitor::popHidden().

Referenced by operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), and operator()().

includePicturePreRTF()

void RTFDocVisitor::includePicturePreRTF ( const DString & name, bool isTypeRTF, bool hasCaption, bool inlineImage = false )

private

Definition at line 1185 of file rtfdocvisitor.cpp.

{
  if (isTypeRTF)
  {
    if (!inlineImage)
    {
      m_t << "\\par\n";
      m_t << "{\n";
      m_t << rtf_Style_Reset << "\n";
      if (hasCaption || m_lastIsPara) m_t << "\\par\n";
      m_t << "\\pard \\qc ";
    }
    m_t << "{ \\field\\flddirty {\\*\\fldinst  INCLUDEPICTURE \"";
    m_t << name;
    m_t << "\" \\\\d \\\\*MERGEFORMAT}{\\fldrslt Image}}\n";
    if (!inlineImage)
    {
      m_t << "\\par\n";
      if (hasCaption)
      {
         m_t << "\\pard \\qc \\b";
         m_t << "{Image \\field\\flddirty{\\*\\fldinst { SEQ Image \\\\*Arabic }}{\\fldrslt {\\noproof 1}} ";
      }
      m_lastIsPara=true;
    }
    else
    {
      if (hasCaption) m_t << "{\\comment "; // to prevent caption to be shown
    }
  }
  else // other format -> skip
  {
    pushHidden(m_hide);
    m_hide=true;
  }
}

References m_hide, m_lastIsPara, m_t, DocVisitor::pushHidden(), and rtf_Style_Reset.

Referenced by operator()(), writeDiaFile(), writeDotFile(), writeMermaidFile(), writeMscFile(), and writePlantUMLFile().

indentLevel()

int RTFDocVisitor::indentLevel ( ) const

private

Definition at line 85 of file rtfdocvisitor.cpp.

{
  return std::min(m_indentLevel,maxIndentLevels-1);
}

References m_indentLevel, and maxIndentLevels.

Referenced by getStyle(), operator()(), operator()(), operator()(), operator()(), and operator()().

operator()() [1/59]

void RTFDocVisitor::operator()

(

const DocAnchor &

anc

)

Definition at line 421 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::visit(DocAnchor)}\n");
  DString anchor;
  if (!anc.file().empty())
  {
    anchor+=stripPath(anc.file());
  }
  if (!anc.file().empty() && !anc.anchor().empty())
  {
    anchor+="_";
  }
  if (!anc.anchor().empty())
  {
    anchor+=anc.anchor();
  }
  m_t << "{\\bkmkstart " << rtfFormatBmkStr(anchor) << "}\n";
  m_t << "{\\bkmkend " << rtfFormatBmkStr(anchor) << "}\n";
  m_lastIsPara=false;
}

References DocAnchor::anchor(), DBG_RTF, DString::empty(), DocAnchor::file(), m_hide, m_lastIsPara, m_t, rtfFormatBmkStr(), and stripPath().

operator()() [2/59]

void RTFDocVisitor::operator()

(

const DocAutoList &

l

)

Definition at line 644 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocAutoList &)}\n");
  m_t << "{\n";
  int level = indentLevel();
  m_listItemInfo[level].isEnum = l.isEnumList();
  m_listItemInfo[level].isCheck = l.isCheckedList();
  m_listItemInfo[level].type   = '1';
  m_listItemInfo[level].number = 1;
  m_lastIsPara=false;
  visitChildren(l);
  if (!m_lastIsPara) m_t << "\\par";
  m_t << "}\n";
  m_lastIsPara=true;
  if (!l.isCheckedList() && indentLevel()==0) m_t << "\\par\n";
}

References DBG_RTF, indentLevel(), RTFDocVisitor::RTFListItemInfo::isCheck, DocAutoList::isCheckedList(), RTFDocVisitor::RTFListItemInfo::isEnum, DocAutoList::isEnumList(), m_hide, m_lastIsPara, m_listItemInfo, m_t, RTFDocVisitor::RTFListItemInfo::number, RTFDocVisitor::RTFListItemInfo::type, and visitChildren().

operator()() [3/59]

void RTFDocVisitor::operator()

(

const DocAutoListItem &

li

)

Definition at line 662 of file rtfdocvisitor.cpp.

{
  static int prevLevel = -1;
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocAutoListItem &)}\n");
  int level = indentLevel();
  if ((level != prevLevel-1) &&
      (!(level==prevLevel && level != 0 && m_listItemInfo[level].isCheck)) &&
      (!m_lastIsPara))
    m_t << "\\par\n";
  prevLevel= level;
  m_t << rtf_Style_Reset;
  if (m_listItemInfo[level].isEnum)
  {
    m_t << getStyle("ListEnum") << "\n";
    m_t << m_listItemInfo[level].number << ".\\tab ";
    m_listItemInfo[level].number++;
  }
  else
  {
    switch (li.itemNumber())
    {
      case DocAutoList::Unchecked: // unchecked
        m_t << getListTable(2) << "\n";
        break;
      case DocAutoList::Checked_x: // checked with x
      case DocAutoList::Checked_X: // checked with X
        m_t << getListTable(3) << "\n";
        break;
      default:
        m_t << getListTable(1) << "\n";
        break;
    }
  }
  incIndentLevel();
  m_lastIsPara=false;
  visitChildren(li);
  decIndentLevel();
}

References DocAutoList::Checked_X, DocAutoList::Checked_x, DBG_RTF, decIndentLevel(), getListTable(), getStyle(), incIndentLevel(), indentLevel(), DocAutoListItem::itemNumber(), m_hide, m_lastIsPara, m_listItemInfo, m_t, RTFDocVisitor::RTFListItemInfo::number, rtf_Style_Reset, DocAutoList::Unchecked, and visitChildren().

operator()() [4/59]

void RTFDocVisitor::operator()

(

const DocCite &

cite

)

Definition at line 616 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocCite &)}\n");
  auto opt = cite.option();
  if (!cite.file().empty())
  {
    if (!opt.noCite()) startLink(cite.ref(),cite.file(),cite.anchor());
 
    filter(cite.getText(),false, true);
 
    if (!opt.noCite()) endLink(cite.ref());
  }
  else
  {
    m_t << "{\\b";
    if (!opt.noPar()) filter("[");
    filter(cite.target());
    if (!opt.noPar()) filter("]");
    m_t << "}";
  }
}

References DocCite::anchor(), DBG_RTF, DString::empty(), endLink(), DocCite::file(), filter(), DocCite::getText(), m_hide, m_t, DocCite::option(), DocCite::ref(), startLink(), and DocCite::target().

operator()() [5/59]

void RTFDocVisitor::operator()

(

const DocDiaFile &

df

)

Definition at line 1298 of file rtfdocvisitor.cpp.

{
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocDiaFile &)}\n");
  bool exists = false;
  std::string inBuf;
  if (readInputFile(df.file(),inBuf))
  {
    auto fileName = writeInlineGraph(Config_getString(RTF_OUTPUT)+"/"+stripPath(df.file())+"_", // baseName
                                     ".dia",                                                    // extension
                                     inBuf,                                                     // contents
                                     exists);
    if (!fileName.empty())
    {
      writeDiaFile(fileName, df.hasCaption(), df.srcFile(), df.srcLine(), !exists);
      visitChildren(df);
      includePicturePostRTF(true, df.hasCaption());
    }
  }
}

References Config_getString, DBG_RTF, DocDiagramFileBase::file(), DocDiagramFileBase::hasCaption(), includePicturePostRTF(), readInputFile(), DocDiagramFileBase::srcFile(), DocDiagramFileBase::srcLine(), stripPath(), visitChildren(), writeDiaFile(), and writeInlineGraph().

operator()() [6/59]

void RTFDocVisitor::operator()

(

const DocDotFile &

df

)

Definition at line 1259 of file rtfdocvisitor.cpp.

{
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocDotFile &)}\n");
  bool exists = false;
  std::string inBuf;
  if (readInputFile(df.file(),inBuf))
  {
    auto fileName = writeInlineGraph(Config_getString(RTF_OUTPUT)+"/"+stripPath(df.file())+"_", // baseName
                                     ".dot",                                                    // extension
                                     inBuf,                                                     // contents
                                     exists);
    if (!fileName.empty())
    {
      writeDotFile(fileName, df.hasCaption(), df.srcFile(), df.srcLine(), !exists);
      visitChildren(df);
      includePicturePostRTF(true, df.hasCaption());
    }
  }
}

References Config_getString, DBG_RTF, DocDiagramFileBase::file(), DocDiagramFileBase::hasCaption(), includePicturePostRTF(), readInputFile(), DocDiagramFileBase::srcFile(), DocDiagramFileBase::srcLine(), stripPath(), visitChildren(), writeDotFile(), and writeInlineGraph().

operator()() [7/59]

void RTFDocVisitor::operator()

(

const DocEmoji &

s

)

Definition at line 157 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::visit(DocEmoji)}\n");
  const char *res = EmojiEntityMapper::instance().unicode(s.index());
  if (res)
  {
    const char *p = res;
    int val = 0;
    int val1 = 0;
    while (*p)
    {
      switch(*p)
      {
        case '&': case '#': case 'x':
          break;
        case ';':
          val1 = val;
          val = 0xd800 + ( ( val1 - 0x10000 ) & 0xffc00 ) / 0x400 - 0x10000;
          m_t << "\\u" << val << "?";
          val = 0xdC00 + ( ( val1 - 0x10000 ) & 0x3ff ) - 0x10000 ;
          m_t << "\\u" << val << "?";
          val = 0;
          break;
        case '0': case '1': case '2': case '3': case '4':
        case '5': case '6': case '7': case '8': case '9':
          val = val * 16 + *p - '0';
          break;
        case 'a': case 'b': case 'c': case 'd': case 'e': case 'f':
          val = val * 16 + *p - 'a' + 10;
          break;
      }
      p++;
    }
  }
  else
  {
    m_t << s.name();
  }
  m_lastIsPara=false;
}

References DBG_RTF, DocEmoji::index(), EmojiEntityMapper::instance(), m_hide, m_lastIsPara, m_t, DocEmoji::name(), and EmojiEntityMapper::unicode().

operator()() [8/59]

void RTFDocVisitor::operator()

(

const DocFormula &

f

)

Definition at line 583 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::visit(DocFormula)}\n");
  bool bDisplay = !f.isInline();
  if (bDisplay)
  {
    m_t << "\\par";
    m_t << "{";
    m_t << "\\pard\\plain";
    m_t << "\\pard";
    m_t << "\\qc";
  }
  m_t << "{ \\field\\flddirty {\\*\\fldinst  INCLUDEPICTURE \"" << f.relPath() << f.name() << ".png\" \\\\d \\\\*MERGEFORMAT}{\\fldrslt Image}}";
  if (bDisplay)
  {
    m_t << "\\par}";
  }
  m_lastIsPara=false;
}

References DBG_RTF, DocFormula::isInline(), m_hide, m_lastIsPara, m_t, DocFormula::name(), and DocFormula::relPath().

operator()() [9/59]

void RTFDocVisitor::operator()

(

const DocHorRuler &

)

Definition at line 237 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::visit(DocHorRuler)}\n");
  m_t << "{\\pard\\widctlpar\\brdrb\\brdrs\\brdrw5\\brsp20 \\adjustright \\par}\n";
  m_lastIsPara=true;
}

References DBG_RTF, m_hide, m_lastIsPara, and m_t.

operator()() [10/59]

void RTFDocVisitor::operator()

(

const DocHRef &

href

)

Definition at line 1084 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocHRef &)}\n");
  if (Config_getBool(RTF_HYPERLINKS))
  {
    if (href.url().startsWith("#"))
    {
      // when starting with # so a local link
      DString cite;
      cite = href.file() + "_" + href.url().right(href.url().length()-1);
      m_t << "{\\field "
               "{\\*\\fldinst "
                 "{ HYPERLINK \\\\l \"" << rtfFormatBmkStr(cite) << "\" "
                 "}{}"
               "}"
               "{\\fldrslt "
                 "{\\cs37\\ul\\cf2 ";
    }
    else
    {
      m_t << "{\\field "
                 "{\\*\\fldinst "
                 "{ HYPERLINK \"" << href.url() << "\" "
                 "}{}"
               "}"
               "{\\fldrslt "
                 "{\\cs37\\ul\\cf2 ";
    }
  }
  else
  {
    m_t << "{\\f2 ";
  }
  m_lastIsPara=false;
  visitChildren(href);
  if (Config_getBool(RTF_HYPERLINKS))
  {
    m_t <<     "}"
             "}"
           "}";
  }
  else
  {
    m_t << "}";
  }
  m_lastIsPara=false;
}

References Config_getBool, DBG_RTF, DocHRef::file(), DString::length(), m_hide, m_lastIsPara, m_t, DString::right(), rtfFormatBmkStr(), DString::startsWith(), DocHRef::url(), and visitChildren().

operator()() [11/59]

void RTFDocVisitor::operator()

(

const DocHtmlBlockQuote &

q

)

Definition at line 1662 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocHtmlBlockQuote &)}\n");
  if (!m_lastIsPara) m_t << "\\par\n";
  m_t << "{"; // start desc
  incIndentLevel();
  m_t << rtf_Style_Reset << getStyle("DescContinue");
  visitChildren(q);
  if (!m_lastIsPara) m_t << "\\par\n";
  decIndentLevel();
  m_t << "}"; // end desc
  m_lastIsPara=true;
}

References DBG_RTF, decIndentLevel(), getStyle(), incIndentLevel(), m_hide, m_lastIsPara, m_t, rtf_Style_Reset, and visitChildren().

operator()() [12/59]

void RTFDocVisitor::operator()

(

const DocHtmlCaption &

c

)

Definition at line 1026 of file rtfdocvisitor.cpp.

{
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocHtmlCaption &)}\n");
  visitChildren(c);
  m_t << "}\n\\par\n";
}

References DBG_RTF, m_t, and visitChildren().

operator()() [13/59]

void RTFDocVisitor::operator()

(

const DocHtmlCell &

c

)

Definition at line 1067 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocHtmlCell &)}\n");
  m_t << "{" << align(c);
  m_lastIsPara=false;
  visitChildren(c);
  m_t << "\\cell }";
  m_lastIsPara=false;
}

References align(), DBG_RTF, m_hide, m_lastIsPara, m_t, and visitChildren().

operator()() [14/59]

void RTFDocVisitor::operator()

(

const DocHtmlDescData &

dd

)

Definition at line 989 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocHtmlDescData &)}\n");
  incIndentLevel();
  m_t << "{" << rtf_Style_Reset << getStyle("DescContinue");
  visitChildren(dd);
  m_t << "\\par";
  m_t << "}\n";
  decIndentLevel();
  m_lastIsPara=true;
}

References DBG_RTF, decIndentLevel(), getStyle(), incIndentLevel(), m_hide, m_lastIsPara, m_t, rtf_Style_Reset, and visitChildren().

operator()() [15/59]

void RTFDocVisitor::operator()

(

const DocHtmlDescList &

dl

)

Definition at line 962 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocHtmlDescList &)}\n");
  //m_t << "{\n";
  //m_t << rtf_Style_Reset << getStyle("ListContinue");
  //m_lastIsPara=false;
  visitChildren(dl);
  //m_t << "}\n";
  //m_t << "\\par\n";
  //m_lastIsPara=true;
}

References DBG_RTF, m_hide, and visitChildren().

operator()() [16/59]

void RTFDocVisitor::operator()

(

const DocHtmlDescTitle &

dt

)

Definition at line 975 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocHtmlDescTitle &)}\n");
  //m_t << "\\par\n";
  //m_t << "{\\b ";
  m_t << "{" << rtf_Style["Heading5"].reference() << "\n";
  m_lastIsPara=false;
  visitChildren(dt);
  m_t << "\\par\n";
  m_t << "}\n";
  m_lastIsPara=true;
}

References DBG_RTF, m_hide, m_lastIsPara, m_t, rtf_Style, and visitChildren().

operator()() [17/59]

void RTFDocVisitor::operator()

(

const DocHtmlDetails &

d

)

Definition at line 1141 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocHtmlDetails &)}\n");
  if (!m_lastIsPara) m_t << "\\par\n";
  auto summary = d.summary();
  if (summary)
  {
    std::visit(*this,*summary);
    m_t << "{"; // start desc
    incIndentLevel();
    m_t << rtf_Style_Reset << getStyle("DescContinue");
  }
  visitChildren(d);
  if (!m_lastIsPara) m_t << "\\par\n";
  if (summary)
  {
    decIndentLevel();
    m_t << "}"; // end desc
  }
  m_lastIsPara=true;
}

References DBG_RTF, decIndentLevel(), getStyle(), incIndentLevel(), m_hide, m_lastIsPara, m_t, rtf_Style_Reset, DocHtmlDetails::summary(), and visitChildren().

operator()() [18/59]

void RTFDocVisitor::operator()

(

const DocHtmlHeader &

header

)

Definition at line 1164 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocHtmlHeader &)}\n");
  m_t << "{" // start section
      << rtf_Style_Reset;
  DString heading;
  int level = std::clamp(header.level()+m_hierarchyLevel,SectionType::MinLevel,SectionType::MaxLevel);
  heading.sprintf("Heading%d",level);
  // set style
  m_t << rtf_Style[heading.str()].reference();
  // make open table of contents entry that will be closed in visitPost method
  m_t << "{\\tc\\tcl" << level << " ";
  m_lastIsPara=false;
  visitChildren(header);
  // close open table of contents entry
  m_t << "} \\par";
  m_t << "}\n"; // end section
  m_lastIsPara=true;
}

References DBG_RTF, DocHtmlHeader::level(), m_hide, m_hierarchyLevel, m_lastIsPara, m_t, SectionType::MaxLevel, SectionType::MinLevel, rtf_Style, rtf_Style_Reset, DString::sprintf(), DString::str(), and visitChildren().

operator()() [19/59]

void RTFDocVisitor::operator()

(

const DocHtmlList &

s

)

Definition at line 879 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocHtmlList &)}\n");
  m_t << "{\n";
  int level = indentLevel();
  m_listItemInfo[level].isEnum = l.type()==DocHtmlList::Ordered;
  m_listItemInfo[level].isCheck = false;
  m_listItemInfo[level].number = 1;
  m_listItemInfo[level].type   = '1';
  for (const auto &opt : l.attribs())
  {
    if (opt.name=="type")
    {
      m_listItemInfo[level].type = opt.value[0];
    }
    if (opt.name=="start")
    {
      bool ok = false;
      int val = opt.value.toInt(&ok);
      if (ok) m_listItemInfo[level].number = val;
    }
  }
  m_lastIsPara=false;
  visitChildren(l);
  m_t << "\\par" << "}\n";
  m_lastIsPara=true;
}

References DocHtmlList::attribs(), DBG_RTF, indentLevel(), RTFDocVisitor::RTFListItemInfo::isCheck, RTFDocVisitor::RTFListItemInfo::isEnum, m_hide, m_lastIsPara, m_listItemInfo, m_t, RTFDocVisitor::RTFListItemInfo::number, DocHtmlList::Ordered, DocHtmlList::type(), RTFDocVisitor::RTFListItemInfo::type, and visitChildren().

operator()() [20/59]

void RTFDocVisitor::operator()

(

const DocHtmlListItem &

l

)

Definition at line 908 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocHtmlListItem &)}\n");
  m_t << "\\par\n";
  m_t << rtf_Style_Reset;
  int level = indentLevel();
  if (m_listItemInfo[level].isEnum)
  {
    for (const auto &opt : l.attribs())
    {
      if (opt.name=="value")
      {
        bool ok = false;
        int val = opt.value.toInt(&ok);
        if (ok) m_listItemInfo[level].number = val;
      }
    }
    m_t << getStyle("ListEnum") << "\n";
    switch (m_listItemInfo[level].type)
    {
      case '1':
        m_t << m_listItemInfo[level].number;
        break;
      case 'a':
        m_t << DString::integerToAlpha(m_listItemInfo[level].number,false);
        break;
      case 'A':
        m_t << DString::integerToAlpha(m_listItemInfo[level].number);
        break;
      case 'i':
        m_t << DString::integerToRoman(m_listItemInfo[level].number,false);
        break;
      case 'I':
        m_t << DString::integerToRoman(m_listItemInfo[level].number);
        break;
      default:
        m_t << m_listItemInfo[level].number;
        break;
    }
    m_t << ".\\tab ";
    m_listItemInfo[level].number++;
  }
  else
  {
    m_t << getStyle("ListBullet") << "\n";
  }
  incIndentLevel();
  m_lastIsPara=false;
  visitChildren(l);
  decIndentLevel();
  DBG_RTF("{\\comment RTFDocVisitor::visitPost(DocHtmlListItem)}\n");
}

References DocHtmlListItem::attribs(), DBG_RTF, decIndentLevel(), getStyle(), incIndentLevel(), indentLevel(), DString::integerToAlpha(), DString::integerToRoman(), m_hide, m_lastIsPara, m_listItemInfo, m_t, RTFDocVisitor::RTFListItemInfo::number, rtf_Style_Reset, and visitChildren().

operator()() [21/59]

void RTFDocVisitor::operator()

(

const DocHtmlRow &

r

)

Definition at line 1033 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocHtmlRow &)}\n");
  size_t columnWidth=r.numCells()>0 ? rtf_pageWidth/r.numCells() : 10;
  m_t << "\\trowd \\trgaph108\\trleft-108"
         "\\trbrdrt\\brdrs\\brdrw10 "
         "\\trbrdrl\\brdrs\\brdrw10 "
         "\\trbrdrb\\brdrs\\brdrw10 "
         "\\trbrdrr\\brdrs\\brdrw10 "
         "\\trbrdrh\\brdrs\\brdrw10 "
         "\\trbrdrv\\brdrs\\brdrw10 \n";
  for (size_t i=0;i<r.numCells();i++)
  {
    if (r.isHeading())
    {
      m_t << "\\clcbpat16"; // set cell shading to light grey (color 16 in the clut)
    }
    m_t << "\\clvertalt\\clbrdrt\\brdrs\\brdrw10 "
           "\\clbrdrl\\brdrs\\brdrw10 "
           "\\clbrdrb\\brdrs\\brdrw10 "
           "\\clbrdrr \\brdrs\\brdrw10 "
           "\\cltxlrtb "
           "\\cellx" << ((i+1)*columnWidth) << "\n";
  }
  m_t << "\\pard \\widctlpar\\intbl\\adjustright\n";
  m_lastIsPara=false;
  visitChildren(r);
  m_t << "\n";
  m_t << "\\pard \\widctlpar\\intbl\\adjustright\n";
  m_t << "{\\row }\n";
  m_lastIsPara=false;
}

References DBG_RTF, DocHtmlRow::isHeading(), m_hide, m_lastIsPara, m_t, DocHtmlRow::numCells(), rtf_pageWidth, and visitChildren().

operator()() [22/59]

void RTFDocVisitor::operator()

(

const DocHtmlSummary &

s

)

Definition at line 1133 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  m_t << "{\\b ";
  visitChildren(s);
  m_t << "}\\par ";
}

References m_hide, m_t, and visitChildren().

operator()() [23/59]

void RTFDocVisitor::operator()

(

const DocHtmlTable &

t

)

Definition at line 1002 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocHtmlTable &)}\n");
  if (!m_lastIsPara) m_t << "\\par\n";
  m_lastIsPara=true;
  if (t.caption())
  {
    const DocHtmlCaption &c = std::get<DocHtmlCaption>(*t.caption());
    m_t << "\\pard \\qc \\b";
    if (!c.file().empty())
    {
      m_t << "{\\bkmkstart " << rtfFormatBmkStr(stripPath(c.file())+"_"+c.anchor()) << "}\n";
      m_t << "{\\bkmkend " << rtfFormatBmkStr(stripPath(c.file())+"_"+c.anchor()) << "}\n";
    }
    m_t << "{Table \\field\\flddirty{\\*\\fldinst { SEQ Table \\\\*Arabic }}{\\fldrslt {\\noproof 1}} ";
    std::visit(*this,*t.caption());
  }
  visitChildren(t);
  m_t << "\\pard\\plain\n";
  m_t << "\\par\n";
  m_lastIsPara=true;
}

References DocHtmlCaption::anchor(), DocHtmlTable::caption(), DBG_RTF, DString::empty(), DocHtmlCaption::file(), m_hide, m_lastIsPara, m_t, rtfFormatBmkStr(), stripPath(), and visitChildren().

operator()() [24/59]

void RTFDocVisitor::operator()

(

const DocImage &

img

)

Definition at line 1250 of file rtfdocvisitor.cpp.

{
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocImage &)}\n");
  includePicturePreRTF(img.name(), img.type()==DocImage::Rtf, img.hasCaption(), img.isInlineImage());
  visitChildren(img);
  includePicturePostRTF(img.type()==DocImage::Rtf, img.hasCaption(), img.isInlineImage());
}

References DBG_RTF, DocImage::hasCaption(), includePicturePostRTF(), includePicturePreRTF(), DocImage::isInlineImage(), DocImage::name(), DocImage::Rtf, DocImage::type(), and visitChildren().

operator()() [25/59]

void RTFDocVisitor::operator()

(

const DocInclude &

inc

)

Definition at line 443 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  SrcLangExt langExt = getLanguageFromFileName(inc.extension());
  DBG_RTF("{\\comment RTFDocVisitor::visit(DocInclude)}\n");
  switch(inc.type())
  {
     case DocInclude::IncWithLines:
      {
         m_t << "{\n";
         m_t << "\\par\n";
         m_t << rtf_Style_Reset << getStyle("CodeExample");
         FileInfo cfi( inc.file().str() );
         auto fd = createFileDef( cfi.dirPath(), cfi.fileName() );
         getCodeParser(inc.extension()).parseCode(m_ci,inc.context(),
                                                  inc.text(),
                                                  langExt,
                                                  inc.stripCodeComments(),
                                                  CodeParserOptions()
                                                  .setExample(inc.isExample(),inc.exampleFile())
                                                  .setFileDef(fd.get())
                                                  .setInlineFragment(true)
                                                 );
         m_t << "\\par";
         m_t << "}\n";
      }
      break;
    case DocInclude::Include:
      m_t << "{\n";
      m_t << "\\par\n";
      m_t << rtf_Style_Reset << getStyle("CodeExample");
      getCodeParser(inc.extension()).parseCode(m_ci,inc.context(),
                                               inc.text(),langExt,
                                               inc.stripCodeComments(),
                                               CodeParserOptions()
                                               .setExample(inc.isExample(),inc.exampleFile())
                                               .setInlineFragment(true)
                                               .setShowLineNumbers(false)
                                              );
      m_t << "\\par";
      m_t << "}\n";
      break;
    case DocInclude::DontInclude:
    case DocInclude::DontIncWithLines:
    case DocInclude::HtmlInclude:
    case DocInclude::LatexInclude:
    case DocInclude::ManInclude:
    case DocInclude::XmlInclude:
    case DocInclude::DocbookInclude:
      break;
    case DocInclude::RtfInclude:
      m_t << inc.text();
      break;
    case DocInclude::VerbInclude:
      m_t << "{\n";
      m_t << "\\par\n";
      m_t << rtf_Style_Reset << getStyle("CodeExample");
      filter(inc.text());
      m_t << "\\par";
      m_t << "}\n";
      break;
    case DocInclude::Snippet:
    case DocInclude::SnippetWithLines:
      m_t << "{\n";
      if (!m_lastIsPara) m_t << "\\par\n";
      m_t << rtf_Style_Reset << getStyle("CodeExample");
      CodeFragmentManager::instance().parseCodeFragment(m_ci,
                                                        inc.file(),
                                                        inc.blockId(),
                                                        inc.context(),
                                                        inc.type()==DocInclude::SnippetWithLines,
                                                        inc.trimLeft(),
                                                        inc.stripCodeComments()
                                                       );
      m_t << "}";
      break;
  }
  m_lastIsPara=true;
}

References DocInclude::blockId(), DocInclude::context(), createFileDef(), DBG_RTF, FileInfo::dirPath(), DocInclude::DocbookInclude, DocInclude::DontInclude, DocInclude::DontIncWithLines, DocInclude::exampleFile(), DocInclude::extension(), DocInclude::file(), FileInfo::fileName(), filter(), DocVisitor::getCodeParser(), getLanguageFromFileName(), getStyle(), DocInclude::HtmlInclude, DocInclude::Include, DocInclude::IncWithLines, CodeFragmentManager::instance(), DocInclude::isExample(), DocInclude::LatexInclude, m_ci, m_hide, m_lastIsPara, m_t, DocInclude::ManInclude, CodeParserInterface::parseCode(), CodeFragmentManager::parseCodeFragment(), rtf_Style_Reset, DocInclude::RtfInclude, CodeParserOptions::setFileDef(), CodeParserOptions::setInlineFragment(), CodeParserOptions::setShowLineNumbers(), DocInclude::Snippet, DocInclude::SnippetWithLines, DString::str(), DocInclude::stripCodeComments(), DocInclude::text(), DocInclude::trimLeft(), DocInclude::type(), DocInclude::VerbInclude, and DocInclude::XmlInclude.

operator()() [26/59]

void RTFDocVisitor::operator()

(

const DocIncOperator &

op

)

Definition at line 523 of file rtfdocvisitor.cpp.

{
  //printf("DocIncOperator: type=%d first=%d, last=%d text='%s'\n",
  //    op.type(),op.isFirst(),op.isLast(),qPrint(op.text()));
  DBG_RTF("{\\comment RTFDocVisitor::visit(DocIncOperator)}\n");
  DString locLangExt = getFileNameExtension(op.includeFileName());
  if (locLangExt.empty()) locLangExt = m_langExt;
  SrcLangExt langExt = getLanguageFromFileName(locLangExt);
  if (op.isFirst())
  {
    if (!m_hide)
    {
      m_t << "{\n";
      m_t << "\\par\n";
      m_t << rtf_Style_Reset << getStyle("CodeExample");
    }
    pushHidden(m_hide);
    m_hide = true;
  }
  if (op.type()!=DocIncOperator::Skip)
  {
    m_hide = popHidden();
    if (!m_hide)
    {
      std::unique_ptr<FileDef> fd = nullptr;
      if (!op.includeFileName().empty())
      {
        FileInfo cfi( op.includeFileName().str() );
        fd = createFileDef( cfi.dirPath(), cfi.fileName() );
      }
 
      getCodeParser(locLangExt).parseCode(m_ci,op.context(),op.text(),langExt,
                                          op.stripCodeComments(),
                                          CodeParserOptions()
                                          .setExample(op.isExample(),op.exampleFile())
                                          .setFileDef(fd.get())
                                          .setStartLine(op.line())
                                          .setShowLineNumbers(op.showLineNo())
                                         );
    }
    pushHidden(m_hide);
    m_hide=true;
  }
  if (op.isLast())
  {
    m_hide = popHidden();
    if (!m_hide)
    {
      m_t << "\\par";
      m_t << "}\n";
    }
    m_lastIsPara=true;
  }
  else
  {
    if (!m_hide) m_t << "\n";
    m_lastIsPara=false;
  }
}

References DocIncOperator::context(), createFileDef(), DBG_RTF, FileInfo::dirPath(), DString::empty(), DocIncOperator::exampleFile(), FileInfo::fileName(), DocVisitor::getCodeParser(), getFileNameExtension(), getLanguageFromFileName(), getStyle(), DocIncOperator::includeFileName(), DocIncOperator::isExample(), DocIncOperator::isFirst(), DocIncOperator::isLast(), DocIncOperator::line(), m_ci, m_hide, m_langExt, m_lastIsPara, m_t, CodeParserInterface::parseCode(), DocVisitor::popHidden(), DocVisitor::pushHidden(), rtf_Style_Reset, CodeParserOptions::setFileDef(), CodeParserOptions::setShowLineNumbers(), CodeParserOptions::setStartLine(), DocIncOperator::showLineNo(), DocIncOperator::Skip, DString::str(), DocIncOperator::stripCodeComments(), DocIncOperator::text(), and DocIncOperator::type().

operator()() [27/59]

void RTFDocVisitor::operator()

(

const DocIndexEntry &

i

)

Definition at line 604 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::visit(DocIndexEntry)}\n");
  m_t << "{\\xe \\v " << i.entry() << "}\n";
  m_lastIsPara=false;
}

References DBG_RTF, DocIndexEntry::entry(), m_hide, m_lastIsPara, and m_t.

operator()() [28/59]

void RTFDocVisitor::operator()

(

const DocInternal &

i

)

Definition at line 1078 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  visitChildren(i);
}

References m_hide, and visitChildren().

operator()() [29/59]

void RTFDocVisitor::operator()

(

const DocInternalRef &

ref

)

Definition at line 1645 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocInternalRef &)}\n");
  startLink("",ref.file(),ref.anchor());
  visitChildren(ref);
  endLink("");
  m_t << " ";
}

References DocInternalRef::anchor(), DBG_RTF, endLink(), DocInternalRef::file(), m_hide, m_t, startLink(), and visitChildren().

operator()() [30/59]

void RTFDocVisitor::operator()

(

const DocLineBreak &

)

Definition at line 229 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::visit(DocLineBreak)}\n");
  m_t << "\\par\n";
  m_lastIsPara=true;
}

References DBG_RTF, m_hide, m_lastIsPara, and m_t.

operator()() [31/59]

void RTFDocVisitor::operator()

(

const DocLink &

lnk

)

Definition at line 1354 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocLink &)}\n");
  startLink(lnk.ref(),lnk.file(),lnk.anchor());
  visitChildren(lnk);
  endLink(lnk.ref());
}

References DocLink::anchor(), DBG_RTF, endLink(), DocLink::file(), m_hide, DocLink::ref(), startLink(), and visitChildren().

operator()() [32/59]

void RTFDocVisitor::operator()

(

const DocLinkedWord &

w

)

Definition at line 116 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::visit(DocLinkedWord)}\n");
  startLink(w.ref(),w.file(),w.anchor());
  filter(w.word());
  endLink(w.ref());
  m_lastIsPara=false;
}

References DocLinkedWord::anchor(), DBG_RTF, endLink(), DocLinkedWord::file(), filter(), m_hide, m_lastIsPara, DocLinkedWord::ref(), startLink(), and DocLinkedWord::word().

operator()() [33/59]

void RTFDocVisitor::operator()

(

const DocMermaidFile &

df

)

Definition at line 1336 of file rtfdocvisitor.cpp.

{
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocMermaidFile &)}\n");
  if (Config_getBool(MERMAID_RENDER_MODE)==MERMAID_RENDER_MODE_t::CLIENT_SIDE) return;
  if (!Config_getBool(DOT_CLEANUP)) copyFile(df.file(),Config_getString(RTF_OUTPUT)+"/"+stripPath(df.file()));
  std::string inBuf;
  readInputFile(df.file(),inBuf);
  auto rtfOutput    = Config_getString(RTF_OUTPUT);
  auto outputFormat = MermaidManager::OutputFormat::RTF;
  auto imageFormat  = MermaidManager::convertToImageFormat(outputFormat);
  auto baseName     = MermaidManager::instance().writeMermaidSource(
                        rtfOutput,DString(),inBuf,imageFormat,
                        df.srcFile(),df.srcLine());
  writeMermaidFile(baseName, df.hasCaption());
  visitChildren(df);
  includePicturePostRTF(true, df.hasCaption());
}

References Config_getBool, Config_getString, MermaidManager::convertToImageFormat(), copyFile(), DBG_RTF, DString::DString(), DocDiagramFileBase::file(), DocDiagramFileBase::hasCaption(), includePicturePostRTF(), MermaidManager::instance(), readInputFile(), MermaidManager::RTF, DocDiagramFileBase::srcFile(), DocDiagramFileBase::srcLine(), stripPath(), visitChildren(), writeMermaidFile(), and MermaidManager::writeMermaidSource().

operator()() [34/59]

void RTFDocVisitor::operator()

(

const DocMscFile &

df

)

Definition at line 1278 of file rtfdocvisitor.cpp.

{
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocMscFile &)}\n");
  bool exists = false;
  std::string inBuf;
  if (readInputFile(df.file(),inBuf))
  {
    auto fileName = writeInlineGraph(Config_getString(RTF_OUTPUT)+"/"+stripPath(df.file())+"_", // baseName
                                     ".msc",                                                    // extension
                                     inBuf,                                                     // contents
                                     exists);
    if (!fileName.empty())
    {
      writeMscFile(fileName, df.hasCaption(), df.srcFile(), df.srcLine(), !exists);
      visitChildren(df);
      includePicturePostRTF(true, df.hasCaption());
    }
  }
}

References Config_getString, DBG_RTF, DocDiagramFileBase::file(), DocDiagramFileBase::hasCaption(), includePicturePostRTF(), readInputFile(), DocDiagramFileBase::srcFile(), DocDiagramFileBase::srcLine(), stripPath(), visitChildren(), writeInlineGraph(), and writeMscFile().

operator()() [35/59]

void RTFDocVisitor::operator()

(

const DocPara &

p

)

Definition at line 702 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocPara &)}\n");
  visitChildren(p);
  if (!m_lastIsPara &&
      !p.isLast() &&            // omit <p> for last paragraph
      !(p.parent() &&           // and for parameters & sections
        std::get_if<DocParamSect>(p.parent())
       )
     )
  {
    m_t << "\\par\n";
    m_lastIsPara=true;
  }
}

References DBG_RTF, DocPara::isLast(), m_hide, m_lastIsPara, m_t, DocNode::parent(), and visitChildren().

operator()() [36/59]

void RTFDocVisitor::operator()

(

const DocParamList &

pl

)

Definition at line 1453 of file rtfdocvisitor.cpp.

{
  static int columnPos[4][5] =
  { { 2, 25, 100, 100, 100 }, // no inout, no type
    { 3, 14,  35, 100, 100 }, // inout, no type
    { 3, 25,  50, 100, 100 }, // no inout, type
    { 4, 14,  35, 55,  100 }, // inout, type
  };
  int config=0;
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocParamList &)}\n");
 
  DocParamSect::Type parentType = DocParamSect::Unknown;
  const DocParamSect *sect = std::get_if<DocParamSect>(pl.parent());
  if (sect)
  {
    parentType = sect->type();
  }
  bool useTable = parentType==DocParamSect::Param ||
                  parentType==DocParamSect::RetVal ||
                  parentType==DocParamSect::Exception ||
                  parentType==DocParamSect::TemplateParam;
  if (sect && sect->hasInOutSpecifier()) config+=1;
  if (sect && sect->hasTypeSpecifier())  config+=2;
  if (useTable)
  {
    m_t << "\\trowd \\trgaph108\\trleft426\\tblind426"
         "\\trbrdrt\\brdrs\\brdrw10\\brdrcf15 "
         "\\trbrdrl\\brdrs\\brdrw10\\brdrcf15 "
         "\\trbrdrb\\brdrs\\brdrw10\\brdrcf15 "
         "\\trbrdrr\\brdrs\\brdrw10\\brdrcf15 "
         "\\trbrdrh\\brdrs\\brdrw10\\brdrcf15 "
         "\\trbrdrv\\brdrs\\brdrw10\\brdrcf15 "<< "\n";
    for (int i=0;i<columnPos[config][0];i++)
    {
      m_t << "\\clvertalt\\clbrdrt\\brdrs\\brdrw10\\brdrcf15 "
           "\\clbrdrl\\brdrs\\brdrw10\\brdrcf15 "
           "\\clbrdrb\\brdrs\\brdrw10\\brdrcf15 "
           "\\clbrdrr \\brdrs\\brdrw10\\brdrcf15 "
           "\\cltxlrtb "
           "\\cellx" << (rtf_pageWidth*columnPos[config][i+1]/100) << "\n";
    }
    m_t << "\\pard \\widctlpar\\intbl\\adjustright\n";
  }
 
  if (sect && sect->hasInOutSpecifier())
  {
    if (useTable)
    {
      m_t << "{";
    }
 
    // Put in the direction: in/out/in,out if specified.
    if (pl.direction()!=DocParamSect::Unspecified)
    {
      if (pl.direction()==DocParamSect::In)
      {
        m_t << "in";
      }
      else if (pl.direction()==DocParamSect::Out)
      {
        m_t << "out";
      }
      else if (pl.direction()==DocParamSect::InOut)
      {
        m_t << "in,out";
      }
    }
 
    if (useTable)
    {
      m_t << "\\cell }";
    }
  }
 
  if (sect && sect->hasTypeSpecifier())
  {
    if (useTable)
    {
      m_t << "{";
    }
    for (const auto &type : pl.paramTypes())
    {
      std::visit(*this,type);
    }
    if (useTable)
    {
      m_t << "\\cell }";
    }
  }
 
 
  if (useTable)
  {
    m_t << "{";
  }
 
  m_t << "{\\i ";
  bool first=true;
  for (const auto &param : pl.parameters())
  {
    if (!first) m_t << ","; else first=false;
    std::visit(*this,param);
  }
  m_t << "} ";
 
  if (useTable)
  {
    m_t << "\\cell }{";
  }
  m_lastIsPara=true;
 
  for (const auto &par : pl.paragraphs())
  {
    std::visit(*this,par);
  }
 
  if (useTable)
  {
    m_t << "\\cell }\n";
    //m_t << "\\pard \\widctlpar\\intbl\\adjustright\n";
    m_t << "{\\row }\n";
  }
  else
  {
    m_t << "\\par\n";
  }
 
  m_lastIsPara=true;
}

References DBG_RTF, DocParamList::direction(), DocParamSect::Exception, DocParamSect::hasInOutSpecifier(), DocParamSect::hasTypeSpecifier(), DocParamSect::In, DocParamSect::InOut, m_hide, m_lastIsPara, m_t, DocParamSect::Out, DocParamList::paragraphs(), DocParamSect::Param, DocParamList::parameters(), DocParamList::paramTypes(), DocNode::parent(), DocParamSect::RetVal, rtf_pageWidth, DocParamSect::TemplateParam, DocParamSect::type(), DocParamSect::Unknown, and DocParamSect::Unspecified.

operator()() [37/59]

void RTFDocVisitor::operator()

(

const DocParamSect &

s

)

Definition at line 1406 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocParamSect &)}\n");
  m_t << "{"; // start param list
  if (!m_lastIsPara) m_t << "\\par\n";
  //m_t << "{\\b "; // start bold
  m_t << "{" << rtf_Style["Heading5"].reference() << "\n";
  switch(s.type())
  {
    case DocParamSect::Param:
      m_t << theTranslator->trParameters(); break;
    case DocParamSect::RetVal:
      m_t << theTranslator->trReturnValues(); break;
    case DocParamSect::Exception:
      m_t << theTranslator->trExceptions(); break;
    case DocParamSect::TemplateParam:
      m_t << theTranslator->trTemplateParameters(); break;
    default:
      ASSERT(0);
  }
  m_t << "\\par";
  m_t << "}\n";
  bool useTable = s.type()==DocParamSect::Param ||
                  s.type()==DocParamSect::RetVal ||
                  s.type()==DocParamSect::Exception ||
                  s.type()==DocParamSect::TemplateParam;
  if (!useTable)
  {
    incIndentLevel();
  }
  m_t << rtf_Style_Reset << getStyle("DescContinue");
  m_lastIsPara=true;
  visitChildren(s);
  //m_t << "\\par\n";
  if (!useTable)
  {
    decIndentLevel();
  }
  m_t << "}\n";
}

References ASSERT, DBG_RTF, decIndentLevel(), DocParamSect::Exception, getStyle(), incIndentLevel(), m_hide, m_lastIsPara, m_t, DocParamSect::Param, DocParamSect::RetVal, rtf_Style, rtf_Style_Reset, DocParamSect::TemplateParam, theTranslator, Translator::trExceptions(), Translator::trParameters(), Translator::trReturnValues(), Translator::trTemplateParameters(), DocParamSect::type(), and visitChildren().

operator()() [38/59]

void RTFDocVisitor::operator()

(

const DocParBlock &

pb

)

Definition at line 1681 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  visitChildren(pb);
}

References m_hide, and visitChildren().

operator()() [39/59]

void RTFDocVisitor::operator()

(

const DocPlantUmlFile &

df

)

Definition at line 1318 of file rtfdocvisitor.cpp.

{
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocPlantUmlFile &)}\n");
  if (!Config_getBool(DOT_CLEANUP)) copyFile(df.file(),Config_getString(RTF_OUTPUT)+"/"+stripPath(df.file()));
  DString rtfOutput = Config_getString(RTF_OUTPUT);
  std::string inBuf;
  readInputFile(df.file(),inBuf);
  auto baseNameVector = PlantumlManager::instance().writePlantUMLSource(
                       rtfOutput,DString(),inBuf,PlantumlManager::PUML_BITMAP,
                       DString(),df.srcFile(),df.srcLine(),false);
  for(const auto &baseName: baseNameVector)
  {
    writePlantUMLFile(baseName, df.hasCaption());
    visitChildren(df);
    includePicturePostRTF(true, df.hasCaption());
  }
}

References Config_getBool, Config_getString, copyFile(), DBG_RTF, DString::DString(), DocDiagramFileBase::file(), DocDiagramFileBase::hasCaption(), includePicturePostRTF(), PlantumlManager::instance(), PlantumlManager::PUML_BITMAP, readInputFile(), DocDiagramFileBase::srcFile(), DocDiagramFileBase::srcLine(), stripPath(), visitChildren(), writePlantUMLFile(), and PlantumlManager::writePlantUMLSource().

operator()() [40/59]

void RTFDocVisitor::operator()

(

const DocRef &

ref

)

Definition at line 1363 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocRef &)}\n");
  // when ref.isSubPage()==true we use ref.file() for HTML and
  // ref.anchor() for LaTeX/RTF
  if (ref.isSubPage())
  {
    startLink(ref.ref(),DString(),ref.anchor());
  }
  else
  {
    if (!ref.file().empty()) startLink(ref.ref(),ref.file(),ref.anchor());
  }
  if (!ref.hasLinkText()) filter(ref.targetTitle());
  visitChildren(ref);
  if (!ref.file().empty()) endLink(ref.ref());
  //m_t << " ";
}

References DocRef::anchor(), DBG_RTF, DString::empty(), endLink(), DocRef::file(), filter(), DocRef::hasLinkText(), DocRef::isSubPage(), m_hide, DocRef::ref(), startLink(), DocRef::targetTitle(), and visitChildren().

operator()() [41/59]

void RTFDocVisitor::operator()

(

const DocRoot &

r

)

Definition at line 719 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocRoot &)}\n");
  if (r.indent()) incIndentLevel();
  m_t << "{" << rtf_Style["BodyText"].reference() << "\n";
  visitChildren(r);
  if (!m_lastIsPara && !r.singleLine()) m_t << "\\par\n";
  m_t << "}";
  m_lastIsPara=true;
  if (r.indent()) decIndentLevel();
}

References DBG_RTF, decIndentLevel(), incIndentLevel(), DocRoot::indent(), m_hide, m_lastIsPara, m_t, rtf_Style, DocRoot::singleLine(), and visitChildren().

operator()() [42/59]

void RTFDocVisitor::operator()

(

const DocSecRefItem &

ref

)

Definition at line 1384 of file rtfdocvisitor.cpp.

{
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocSecRefItem &)}\n");
  visitChildren(ref);
}

References DBG_RTF, and visitChildren().

operator()() [43/59]

void RTFDocVisitor::operator()

(

const DocSecRefList &

l

)

Definition at line 1390 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocSecRefList &)}\n");
  m_t << "{\n";
  incIndentLevel();
  m_t << rtf_Style_Reset << getStyle("LatexTOC") << "\n";
  m_t << "\\par\n";
  m_lastIsPara=true;
  visitChildren(l);
  decIndentLevel();
  m_t << "\\par";
  m_t << "}\n";
  m_lastIsPara=true;
}

References DBG_RTF, decIndentLevel(), getStyle(), incIndentLevel(), m_hide, m_lastIsPara, m_t, rtf_Style_Reset, and visitChildren().

operator()() [44/59]

void RTFDocVisitor::operator()

(

const DocSection &

s

)

Definition at line 845 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocSection &)}\n");
  if (!m_lastIsPara) m_t << "\\par\n";
  m_t << "{\\bkmkstart " << rtfFormatBmkStr(stripPath(s.file())+"_"+s.anchor()) << "}\n";
  m_t << "{\\bkmkend " << rtfFormatBmkStr(stripPath(s.file())+"_"+s.anchor()) << "}\n";
  m_t << "{{" // start section
      << rtf_Style_Reset;
  DString heading;
  int level = std::min(s.level()+2+m_hierarchyLevel,4);
  if (level <= 0)
    level = 1;
  heading.sprintf("Heading%d",level);
  // set style
  m_t << rtf_Style[heading.str()].reference() << "\n";
  // make table of contents entry
  if (s.title())
  {
    std::visit(*this,*s.title());
  }
  m_t << "\n\\par" << "}\n";
  m_t << "{\\tc\\tcl" << level << " \\v ";
  if (s.title())
  {
    std::visit(*this,*s.title());
  }
  m_t << "}\n";
  m_lastIsPara=true;
  visitChildren(s);
  m_t << "\\par}\n"; // end section
  m_lastIsPara=true;
}

References DocSection::anchor(), DBG_RTF, DocSection::file(), DocSection::level(), m_hide, m_hierarchyLevel, m_lastIsPara, m_t, rtf_Style, rtf_Style_Reset, rtfFormatBmkStr(), DString::sprintf(), DString::str(), stripPath(), DocSection::title(), and visitChildren().

operator()() [45/59]

void RTFDocVisitor::operator()

(

const DocSeparator &

sep

)

Definition at line 1448 of file rtfdocvisitor.cpp.

{
  m_t << " " << sep.chars() << " ";
}

References DocSeparator::chars(), and m_t.

operator()() [46/59]

void RTFDocVisitor::operator()

(

const DocSimpleList &

l

)

Definition at line 816 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocSimpleSect &)}\n");
  m_t << "{\n";
  m_listItemInfo[indentLevel()].isEnum = false;
  m_listItemInfo[indentLevel()].isCheck = false;
  m_lastIsPara=false;
  visitChildren(l);
  if (!m_lastIsPara) m_t << "\\par\n";
  m_t << "}\n";
  m_lastIsPara=true;
}

References DBG_RTF, indentLevel(), RTFDocVisitor::RTFListItemInfo::isCheck, RTFDocVisitor::RTFListItemInfo::isEnum, m_hide, m_lastIsPara, m_listItemInfo, m_t, and visitChildren().

operator()() [47/59]

void RTFDocVisitor::operator()

(

const DocSimpleListItem &

li

)

Definition at line 830 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocSimpleListItem &)}\n");
  m_t << "\\par" << rtf_Style_Reset << getStyle("ListBullet") << "\n";
  m_lastIsPara=false;
  incIndentLevel();
  if (li.paragraph())
  {
    std::visit(*this,*li.paragraph());
  }
  decIndentLevel();
  DBG_RTF("{\\comment RTFDocVisitor::visitPost(DocSimpleListItem)}\n");
}

References DBG_RTF, decIndentLevel(), getStyle(), incIndentLevel(), m_hide, m_lastIsPara, m_t, DocSimpleListItem::paragraph(), and rtf_Style_Reset.

operator()() [48/59]

void RTFDocVisitor::operator()

(

const DocSimpleSect &

s

)

Definition at line 732 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocSimpleSect &)}\n");
  if (!m_lastIsPara) m_t << "\\par\n";
  m_t << "{"; // start desc
  //m_t << "{\\b "; // start bold
  m_t << "{" << rtf_Style["Heading5"].reference() << "\n";
  switch(s.type())
  {
    case DocSimpleSect::See:
      m_t << theTranslator->trSeeAlso(); break;
    case DocSimpleSect::Return:
      m_t << theTranslator->trReturns(); break;
    case DocSimpleSect::Author:
      m_t << theTranslator->trAuthor(true,true); break;
    case DocSimpleSect::Authors:
      m_t << theTranslator->trAuthor(true,false); break;
    case DocSimpleSect::Version:
      m_t << theTranslator->trVersion(); break;
    case DocSimpleSect::Since:
      m_t << theTranslator->trSince(); break;
    case DocSimpleSect::Date:
      m_t << theTranslator->trDate(); break;
    case DocSimpleSect::Note:
      m_t << theTranslator->trNote(); break;
    case DocSimpleSect::Warning:
      m_t << theTranslator->trWarning(); break;
    case DocSimpleSect::Pre:
      m_t << theTranslator->trPrecondition(); break;
    case DocSimpleSect::Post:
      m_t << theTranslator->trPostcondition(); break;
    case DocSimpleSect::Copyright:
      m_t << theTranslator->trCopyright(); break;
    case DocSimpleSect::Invar:
      m_t << theTranslator->trInvariant(); break;
    case DocSimpleSect::Remark:
      m_t << theTranslator->trRemarks(); break;
    case DocSimpleSect::Attention:
      m_t << theTranslator->trAttention(); break;
    case DocSimpleSect::Important:
      m_t << theTranslator->trImportant(); break;
    case DocSimpleSect::User: break;
    case DocSimpleSect::Rcs: break;
    case DocSimpleSect::Unknown:  break;
  }
 
  incIndentLevel();
  if (s.type()!=DocSimpleSect::User && s.type()!=DocSimpleSect::Rcs)
  {
    m_t << "\\par";
    m_t << "}"; // end bold
    m_t << rtf_Style_Reset << getStyle("DescContinue");
    m_t << "{\\s17 \\sa60 \\sb30\n";
  }
  else
  {
    if (s.title())
    {
      std::visit(*this,*s.title());
    }
    m_t << "\\par\n";
    m_t << "}"; // end bold
    m_t << rtf_Style_Reset << getStyle("DescContinue");
  }
  m_lastIsPara=false;
  visitChildren(s);
  if (!m_lastIsPara) m_t << "\\par\n";
  decIndentLevel();
  if (s.type()!=DocSimpleSect::User && s.type()!=DocSimpleSect::Rcs)
  {
    m_t << "}"; // end DescContinue
  }
  m_t << "}"; // end desc
  m_lastIsPara=true;
}

References DocSimpleSect::Attention, DocSimpleSect::Author, DocSimpleSect::Authors, DocSimpleSect::Copyright, DocSimpleSect::Date, DBG_RTF, decIndentLevel(), getStyle(), DocSimpleSect::Important, incIndentLevel(), DocSimpleSect::Invar, m_hide, m_lastIsPara, m_t, DocSimpleSect::Note, DocSimpleSect::Post, DocSimpleSect::Pre, DocSimpleSect::Rcs, DocSimpleSect::Remark, DocSimpleSect::Return, rtf_Style, rtf_Style_Reset, DocSimpleSect::See, DocSimpleSect::Since, theTranslator, DocSimpleSect::title(), Translator::trAttention(), Translator::trAuthor(), Translator::trCopyright(), Translator::trDate(), Translator::trImportant(), Translator::trInvariant(), Translator::trNote(), Translator::trPostcondition(), Translator::trPrecondition(), Translator::trRemarks(), Translator::trReturns(), Translator::trSeeAlso(), Translator::trSince(), Translator::trVersion(), Translator::trWarning(), DocSimpleSect::type(), DocSimpleSect::Unknown, DocSimpleSect::User, DocSimpleSect::Version, visitChildren(), and DocSimpleSect::Warning.

operator()() [49/59]

void RTFDocVisitor::operator()

(

const DocSimpleSectSep &

)

Definition at line 612 of file rtfdocvisitor.cpp.

{
}

operator()() [50/59]

void RTFDocVisitor::operator()

(

const DocStyleChange &

s

)

Definition at line 245 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  m_lastIsPara=false;
  DBG_RTF("{\\comment RTFDocVisitor::visit(DocStyleChange)}\n");
  switch (s.style())
  {
    case DocStyleChange::Bold:
      if (s.enable()) m_t << "{\\b ";      else m_t << "} ";
      break;
    case DocStyleChange::S:
    case DocStyleChange::Strike:
    case DocStyleChange::Del:
      if (s.enable()) m_t << "{\\strike ";      else m_t << "} ";
      break;
    case DocStyleChange::Underline:
    case DocStyleChange::Ins:
      if (s.enable()) m_t << "{\\ul ";      else m_t << "} ";
      break;
    case DocStyleChange::Italic:
      if (s.enable()) m_t << "{\\i ";     else m_t << "} ";
      break;
    case DocStyleChange::Kbd:
    case DocStyleChange::Typewriter:
    case DocStyleChange::Code:
      if (s.enable()) m_t << "{\\f2 ";   else m_t << "} ";
      break;
    case DocStyleChange::Subscript:
      if (s.enable()) m_t << "{\\sub ";    else m_t << "} ";
      break;
    case DocStyleChange::Superscript:
      if (s.enable()) m_t << "{\\super ";    else m_t << "} ";
      break;
    case DocStyleChange::Center:
      if (s.enable()) m_t << "{\\qc "; else m_t << "} ";
      break;
    case DocStyleChange::Small:
      if (s.enable()) m_t << "{\\sub ";  else m_t << "} ";
      break;
    case DocStyleChange::Cite:
      if (s.enable()) m_t << "{\\i ";     else m_t << "} ";
      break;
    case DocStyleChange::Preformatted:
      if (s.enable())
      {
        m_t << "{\n";
        m_t << "\\par\n";
        m_t << rtf_Style_Reset << getStyle("CodeExample");
        m_insidePre=true;
      }
      else
      {
        m_insidePre=false;
        m_t << "\\par";
        m_t << "}\n";
      }
      m_lastIsPara=true;
      break;
    case DocStyleChange::Div:  /* HTML only */ break;
    case DocStyleChange::Span: /* HTML only */ break;
  }
}

References DocStyleChange::Bold, DocStyleChange::Center, DocStyleChange::Cite, DocStyleChange::Code, DBG_RTF, DocStyleChange::Del, DocStyleChange::Div, DocStyleChange::enable(), getStyle(), DocStyleChange::Ins, DocStyleChange::Italic, DocStyleChange::Kbd, m_hide, m_insidePre, m_lastIsPara, m_t, DocStyleChange::Preformatted, rtf_Style_Reset, DocStyleChange::S, DocStyleChange::Small, DocStyleChange::Span, DocStyleChange::Strike, DocStyleChange::style(), DocStyleChange::Subscript, DocStyleChange::Superscript, DocStyleChange::Typewriter, and DocStyleChange::Underline.

operator()() [51/59]

void RTFDocVisitor::operator()

(

const DocSymbol &

s

)

Definition at line 141 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::visit(DocSymbol)}\n");
  const char *res = HtmlEntityMapper::instance().rtf(s.symbol());
  if (res)
  {
    m_t << res;
  }
  else
  {
    err("RTF: non supported HTML-entity found: {}\n",HtmlEntityMapper::instance().html(s.symbol(),true));
  }
  m_lastIsPara=false;
}

References DBG_RTF, err, HtmlEntityMapper::instance(), m_hide, m_lastIsPara, m_t, HtmlEntityMapper::rtf(), and DocSymbol::symbol().

operator()() [52/59]

void RTFDocVisitor::operator()

(

const DocText &

t

)

Definition at line 1655 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocText &)}\n");
  visitChildren(t);
}

References DBG_RTF, m_hide, and visitChildren().

operator()() [53/59]

void RTFDocVisitor::operator()

(

const DocTitle &

t

)

Definition at line 809 of file rtfdocvisitor.cpp.

{
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocTitle &)}\n");
  if (m_hide) return;
  visitChildren(t);
}

References DBG_RTF, m_hide, and visitChildren().

operator()() [54/59]

void RTFDocVisitor::operator()

(

const DocURL &

u

)

Definition at line 199 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::visit(DocURL)}\n");
  if (Config_getBool(RTF_HYPERLINKS))
  {
    m_t << "{\\field "
             "{\\*\\fldinst "
               "{ HYPERLINK \"";
    if (u.isEmail()) m_t << "mailto:";
    m_t << u.url();
    m_t <<  "\" }"
               "{}";
    m_t <<   "}"
             "{\\fldrslt "
               "{\\cs37\\ul\\cf2 ";
    filter(u.url());
    m_t <<     "}"
             "}"
           "}\n";
  }
  else
  {
    m_t << "{\\f2 ";
    filter(u.url());
    m_t << "}";
  }
  m_lastIsPara=false;
}

References Config_getBool, DBG_RTF, filter(), DocURL::isEmail(), m_hide, m_lastIsPara, m_t, and DocURL::url().

operator()() [55/59]

void RTFDocVisitor::operator()

(

const DocVerbatim &

s

)

Definition at line 308 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::visit(DocVerbatim)}\n");
  DString lang = m_langExt;
  if (!s.language().empty()) // explicit language setting
  {
    lang = s.language();
  }
  SrcLangExt langExt = getLanguageFromCodeLang(lang);
  switch(s.type())
  {
    case DocVerbatim::Code:
      m_t << "{\n";
      m_t << "\\par\n";
      m_t << rtf_Style_Reset << getStyle("CodeExample");
      getCodeParser(lang).parseCode(m_ci,s.context(),s.text(),langExt,
                                    Config_getBool(STRIP_CODE_COMMENTS),
                                    CodeParserOptions().setExample(s.isExample(),s.exampleFile()));
      //m_t << "\\par\n";
      m_t << "}\n";
      break;
    case DocVerbatim::JavaDocLiteral:
      filter(s.text(),true);
      break;
    case DocVerbatim::JavaDocCode:
      m_t << "{\n";
      m_t << "{\\f2 ";
      filter(s.text(),true);
      m_t << "}";
      m_t << "}\n";
      break;
    case DocVerbatim::Verbatim:
      m_t << "{\n";
      m_t << "\\par\n";
      m_t << rtf_Style_Reset << getStyle("CodeExample");
      filter(s.text(),true);
      //m_t << "\\par\n";
      m_t << "}\n";
      break;
    case DocVerbatim::RtfOnly:
      m_t << s.text();
      break;
    case DocVerbatim::HtmlOnly:
    case DocVerbatim::LatexOnly:
    case DocVerbatim::XmlOnly:
    case DocVerbatim::ManOnly:
    case DocVerbatim::DocbookOnly:
      /* nothing */
      break;
    case DocVerbatim::Dot:
      {
        bool exists = false;
        auto fileName = writeInlineGraph(Config_getString(RTF_OUTPUT)+"/inline_dotgraph_", // baseName
                                         ".dot",                                           // extension
                                         s.text(),                                         // contents
                                         exists);
        if (!fileName.empty())
        {
          writeDotFile(fileName, s.hasCaption(), s.srcFile(), s.srcLine(), !exists);
          visitChildren(s);
          includePicturePostRTF(true, s.hasCaption());
        }
      }
      break;
    case DocVerbatim::Msc:
      {
        bool exists = false;
        auto fileName = writeInlineGraph(Config_getString(RTF_OUTPUT)+"/inline_mscgraph_", // baseName
                                         ".msc",                                           // extension
                                         "msc {"+s.text()+"}",                             // contents
                                         exists);
        if (!fileName.empty())
        {
          writeMscFile(fileName, s.hasCaption(), s.srcFile(), s.srcLine(), !exists);
          visitChildren(s);
          includePicturePostRTF(true, s.hasCaption());
        }
      }
      break;
    case DocVerbatim::PlantUML:
      {
        DString rtfOutput = Config_getString(RTF_OUTPUT);
        auto baseNameVector = PlantumlManager::instance().writePlantUMLSource(
                       rtfOutput,s.exampleFile(),s.text(),PlantumlManager::PUML_BITMAP,
                       s.engine(),s.srcFile(),s.srcLine(),true);
 
        for (const auto &baseName: baseNameVector)
        {
          writePlantUMLFile(baseName, s.hasCaption());
          visitChildren(s);
          includePicturePostRTF(true, s.hasCaption());
        }
      }
      break;
    case DocVerbatim::Mermaid:
      if (Config_getBool(MERMAID_RENDER_MODE)!=MERMAID_RENDER_MODE_t::CLIENT_SIDE)
      {
        auto rtfOutput    = Config_getString(RTF_OUTPUT);
        auto outputFormat = MermaidManager::OutputFormat::RTF;
        auto imageFormat  = MermaidManager::convertToImageFormat(outputFormat);
        auto baseName     = MermaidManager::instance().writeMermaidSource(
                              rtfOutput,s.exampleFile(),s.text(),imageFormat,
                              s.srcFile(),s.srcLine());
        writeMermaidFile(baseName, s.hasCaption());
        visitChildren(s);
        includePicturePostRTF(true, s.hasCaption());
      }
      break;
  }
  m_lastIsPara=false;
}

References DocVerbatim::Code, Config_getBool, Config_getString, DocVerbatim::context(), MermaidManager::convertToImageFormat(), DBG_RTF, DocVerbatim::DocbookOnly, DocVerbatim::Dot, DString::empty(), DocVerbatim::engine(), DocVerbatim::exampleFile(), filter(), DocVisitor::getCodeParser(), getLanguageFromCodeLang(), getStyle(), DocVerbatim::hasCaption(), DocVerbatim::HtmlOnly, includePicturePostRTF(), MermaidManager::instance(), PlantumlManager::instance(), DocVerbatim::isExample(), DocVerbatim::JavaDocCode, DocVerbatim::JavaDocLiteral, DocVerbatim::language(), DocVerbatim::LatexOnly, m_ci, m_hide, m_langExt, m_lastIsPara, m_t, DocVerbatim::ManOnly, DocVerbatim::Mermaid, DocVerbatim::Msc, CodeParserInterface::parseCode(), DocVerbatim::PlantUML, PlantumlManager::PUML_BITMAP, MermaidManager::RTF, rtf_Style_Reset, DocVerbatim::RtfOnly, DocVerbatim::srcFile(), DocVerbatim::srcLine(), DocVerbatim::text(), DocVerbatim::type(), DocVerbatim::Verbatim, visitChildren(), writeDotFile(), writeInlineGraph(), writeMermaidFile(), MermaidManager::writeMermaidSource(), writeMscFile(), writePlantUMLFile(), PlantumlManager::writePlantUMLSource(), and DocVerbatim::XmlOnly.

operator()() [56/59]

void RTFDocVisitor::operator()

(

const DocVhdlFlow &

)

Definition at line 1677 of file rtfdocvisitor.cpp.

{
}

operator()() [57/59]

void RTFDocVisitor::operator()

(

const DocWhiteSpace &

w

)

Definition at line 126 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::visit(DocWhiteSpace)}\n");
  if (m_insidePre)
  {
    m_t << w.chars();
  }
  else
  {
    m_t << " ";
  }
  m_lastIsPara=false;
}

References DocWhiteSpace::chars(), DBG_RTF, m_hide, m_insidePre, m_lastIsPara, and m_t.

operator()() [58/59]

void RTFDocVisitor::operator()

(

const DocWord &

w

)

Definition at line 108 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  DBG_RTF("{\\comment RTFDocVisitor::visit(DocWord)}\n");
  filter(w.word());
  m_lastIsPara=false;
}

References DBG_RTF, filter(), m_hide, m_lastIsPara, and DocWord::word().

operator()() [59/59]

void RTFDocVisitor::operator()

(

const DocXRefItem &

x

)

Definition at line 1584 of file rtfdocvisitor.cpp.

{
  if (m_hide) return;
  if (x.title().empty()) return;
  bool anonymousEnum = x.file()=="@";
  DBG_RTF("{\\comment RTFDocVisitor::operator()(const DocXRefItem &)}\n");
  if (!m_lastIsPara)
  {
    m_t << "\\par\n";
    m_lastIsPara=true;
  }
  m_t << "{"; // start param list
  //m_t << "{\\b "; // start bold
  m_t << "{" << rtf_Style["Heading5"].reference() << "\n";
  if (Config_getBool(RTF_HYPERLINKS) && !anonymousEnum)
  {
    DString refName;
    if (!x.file().empty())
    {
      refName+=stripPath(x.file());
    }
    if (!x.file().empty() && !x.anchor().empty())
    {
      refName+="_";
    }
    if (!x.anchor().empty())
    {
      refName+=x.anchor();
    }
 
    m_t << "{\\field "
             "{\\*\\fldinst "
               "{ HYPERLINK  \\\\l \"" << rtfFormatBmkStr(refName) << "\" "
               "}{}"
             "}"
             "{\\fldrslt "
               "{\\cs37\\ul\\cf2 ";
    filter(x.title());
    m_t <<     "}"
             "}"
           "}";
  }
  else
  {
    filter(x.title());
  }
  m_t << ":";
  m_t << "\\par";
  m_t << "}"; // end bold
  incIndentLevel();
  m_t << rtf_Style_Reset << getStyle("DescContinue");
  m_lastIsPara=false;
  visitChildren(x);
  if (x.title().empty()) return;
  DBG_RTF("{\\comment RTFDocVisitor::visitPost(DocXRefItem)}\n");
  m_t << "\\par\n";
  decIndentLevel();
  m_t << "}\n"; // end xref item
  m_lastIsPara=true;
}

References DocXRefItem::anchor(), Config_getBool, DBG_RTF, decIndentLevel(), DString::empty(), DocXRefItem::file(), filter(), getStyle(), incIndentLevel(), m_hide, m_lastIsPara, m_t, rtf_Style, rtf_Style_Reset, rtfFormatBmkStr(), stripPath(), DocXRefItem::title(), and visitChildren().

startLink()

void RTFDocVisitor::startLink ( const DString & ref, const DString & file, const DString & anchor )

private

Definition at line 1731 of file rtfdocvisitor.cpp.

{
  if (ref.empty() && Config_getBool(RTF_HYPERLINKS))
  {
    DString refName;
    if (!file.empty())
    {
      refName+=stripPath(file);
    }
    if (!file.empty() && !anchor.empty())
    {
      refName+='_';
    }
    if (!anchor.empty())
    {
      refName+=anchor;
    }
 
    m_t << "{\\field {\\*\\fldinst { HYPERLINK  \\\\l \"";
    m_t << rtfFormatBmkStr(refName);
    m_t << "\" }{}";
    m_t << "}{\\fldrslt {\\cs37\\ul\\cf2 ";
  }
  else
  {
    m_t << "{\\b ";
  }
  m_lastIsPara=false;
}

References Config_getBool, DString::empty(), m_lastIsPara, m_t, rtfFormatBmkStr(), and stripPath().

Referenced by operator()(), operator()(), operator()(), operator()(), and operator()().

visitChildren()

template<class T>

void RTFDocVisitor::visitChildren ( const T & t )

inlineprivate

Definition at line 107 of file rtfdocvisitor.h.

    {
      for (const auto &child : t.children())
      {
        std::visit(*this, child);
      }
    }

Referenced by operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), and operator()().

writeDiaFile()

void RTFDocVisitor::writeDiaFile ( const DString & fileName, bool hasCaption, const DString & srcFile, int srcLine, bool newFile = true )

private

Definition at line 1793 of file rtfdocvisitor.cpp.

{
  DString baseName=makeBaseName(fileName,".dia");
  DString outDir = Config_getString(RTF_OUTPUT);
  if (newFile) writeDiaGraphFromFile(fileName,outDir,baseName,DiaOutputFormat::BITMAP,srcFile,srcLine,false);
  includePicturePreRTF(baseName + ".png", true, hasCaption);
}

References BITMAP, Config_getString, includePicturePreRTF(), makeBaseName(), and writeDiaGraphFromFile().

Referenced by operator()().

writeDotFile()

void RTFDocVisitor::writeDotFile ( const DString & fileName, bool hasCaption, const DString & srcFile, int srcLine, bool newFile = true )

private

Definition at line 1774 of file rtfdocvisitor.cpp.

{
  DString baseName=makeBaseName(filename,".dot");
  DString outDir = Config_getString(RTF_OUTPUT);
  if (newFile) writeDotGraphFromFile(filename,outDir,baseName,GraphOutputFormat::BITMAP,srcFile,srcLine,false);
  DString imgExt = getDotImageExtension();
  includePicturePreRTF(baseName + "." + imgExt, true, hasCaption);
}

References BITMAP, Config_getString, getDotImageExtension(), includePicturePreRTF(), makeBaseName(), and writeDotGraphFromFile().

Referenced by operator()(), and operator()().

writeMermaidFile()

void RTFDocVisitor::writeMermaidFile ( const DString & fileName, bool hasCaption )

private

Definition at line 1810 of file rtfdocvisitor.cpp.

{
  if (Config_getBool(MERMAID_RENDER_MODE)==MERMAID_RENDER_MODE_t::CLIENT_SIDE) return;
  auto baseName     = makeBaseName(fileName,".mmd");
  auto outDir       = Config_getString(RTF_OUTPUT);
  auto outputFormat = MermaidManager::OutputFormat::RTF;
  auto imageFormat  = MermaidManager::convertToImageFormat(outputFormat);
  auto imgExt       = MermaidManager::imageExtension(imageFormat);
  MermaidManager::instance().generateMermaidOutput(fileName,outDir,imageFormat,false);
  includePicturePreRTF(baseName + "." + imgExt, true, hasCaption);
}

References Config_getBool, Config_getString, MermaidManager::convertToImageFormat(), MermaidManager::generateMermaidOutput(), MermaidManager::imageExtension(), includePicturePreRTF(), MermaidManager::instance(), makeBaseName(), and MermaidManager::RTF.

Referenced by operator()(), and operator()().

writeMscFile()

void RTFDocVisitor::writeMscFile ( const DString & fileName, bool hasCaption, const DString & srcFile, int srcLine, bool newFile = true )

private

Definition at line 1784 of file rtfdocvisitor.cpp.

{
  DString baseName=makeBaseName(fileName,".msc");
  DString outDir = Config_getString(RTF_OUTPUT);
  if (newFile) writeMscGraphFromFile(fileName,outDir,baseName,MscOutputFormat::BITMAP,srcFile,srcLine,false);
  includePicturePreRTF(baseName + ".png", true, hasCaption);
}

References BITMAP, Config_getString, includePicturePreRTF(), makeBaseName(), and writeMscGraphFromFile().

Referenced by operator()(), and operator()().

writePlantUMLFile()

void RTFDocVisitor::writePlantUMLFile ( const DString & fileName, bool hasCaption )

private

Definition at line 1802 of file rtfdocvisitor.cpp.

{
  DString baseName=makeBaseName(fileName,".pu");
  DString outDir = Config_getString(RTF_OUTPUT);
  PlantumlManager::instance().generatePlantUMLOutput(fileName,outDir,PlantumlManager::PUML_BITMAP,false);
  includePicturePreRTF(baseName + ".png", true, hasCaption);
}

References Config_getString, PlantumlManager::generatePlantUMLOutput(), includePicturePreRTF(), PlantumlManager::instance(), makeBaseName(), and PlantumlManager::PUML_BITMAP.

Referenced by operator()(), and operator()().

Member Data Documentation

m_ci

OutputCodeList& RTFDocVisitor::m_ci

private

Definition at line 143 of file rtfdocvisitor.h.

Referenced by operator()(), operator()(), operator()(), and RTFDocVisitor().

m_hide

bool RTFDocVisitor::m_hide = false

private

Definition at line 145 of file rtfdocvisitor.h.

Referenced by includePicturePostRTF(), includePicturePreRTF(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), and operator()().

m_hierarchyLevel

int RTFDocVisitor::m_hierarchyLevel = 0

private

Definition at line 151 of file rtfdocvisitor.h.

Referenced by operator()(), operator()(), and RTFDocVisitor().

m_indentLevel

int RTFDocVisitor::m_indentLevel = 0

private

Definition at line 150 of file rtfdocvisitor.h.

Referenced by decIndentLevel(), getListTable(), incIndentLevel(), and indentLevel().

m_insidePre

bool RTFDocVisitor::m_insidePre = false

private

Definition at line 144 of file rtfdocvisitor.h.

Referenced by operator()(), and operator()().

m_langExt

DString RTFDocVisitor::m_langExt

private

Definition at line 147 of file rtfdocvisitor.h.

Referenced by operator()(), operator()(), and RTFDocVisitor().

m_lastIsPara

bool RTFDocVisitor::m_lastIsPara = false

private

Definition at line 146 of file rtfdocvisitor.h.

Referenced by endLink(), includePicturePreRTF(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), and startLink().

m_listItemInfo

RTFListItemInfo RTFDocVisitor::m_listItemInfo[maxIndentLevels]

private

Definition at line 159 of file rtfdocvisitor.h.

Referenced by operator()(), operator()(), operator()(), operator()(), and operator()().

m_t

TextStream& RTFDocVisitor::m_t

private

Definition at line 142 of file rtfdocvisitor.h.

Referenced by endLink(), filter(), includePicturePostRTF(), includePicturePreRTF(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), RTFDocVisitor(), and startLink().

maxIndentLevels

const int RTFDocVisitor::maxIndentLevels = 13

staticprivate

Definition at line 149 of file rtfdocvisitor.h.

Referenced by incIndentLevel(), and indentLevel().

---

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

• src/rtfdocvisitor.h
• src/rtfdocvisitor.cpp