LibreOffice Module sw (master) 1
Classes | Public Member Functions | Private Types | Private Member Functions | Static Private Member Functions | Private Attributes | List of all members
wwSectionManager Class Reference

#include <ww8par.hxx>

Collaboration diagram for wwSectionManager:
[legend]

Classes

struct  wwULSpaceData
 

Public Member Functions

 wwSectionManager (SwWW8ImplReader &rReader)
 
void SetCurrentSectionHasFootnote ()
 
void SetCurrentSectionVerticalAdjustment (const css::drawing::TextVerticalAdjust nVA)
 
bool CurrentSectionIsVertical () const
 
bool CurrentSectionIsProtected () const
 
void PrependedInlineNode (const SwPosition &rPos, const SwNode &rNode)
 
sal_uInt16 CurrentSectionColCount () const
 
bool WillHavePageDescHere (const SwNodeIndex &rIdx) const
 
void CreateSep (const tools::Long nTextPos)
 
void InsertSegments ()
 
void JoinNode (const SwPosition &rPos, const SwNode &rNode)
 
sal_uInt32 GetPageLeft () const
 
sal_uInt32 GetPageRight () const
 
sal_uInt32 GetPageWidth () const
 
sal_uInt32 GetWWPageTopMargin () const
 
sal_uInt32 GetTextAreaWidth () const
 

Private Types

typedef std::deque< wwSection >::iterator mySegIter
 

Private Member Functions

void SetSegmentToPageDesc (const wwSection &rSection, bool bIgnoreCols)
 
void GetPageULData (const wwSection &rNewSection, wwULSpaceData &rData) const
 
void SetUseOn (wwSection &rSection)
 
void SetHdFt (wwSection const &rSection, int nSect, const wwSection *pPrevious)
 
SwSectionFormat * InsertSection (SwPaM const &rMyPaM, wwSection &rSection)
 
bool SectionIsProtected (const wwSection &rSection) const
 
SwFormatPageDesc SetSwFormatPageDesc (mySegIter const &rIter, mySegIter const &rStart, bool bIgnoreCols)
 Map a word section to a writer page descriptor. More...
 
 wwSectionManager (const wwSectionManager &)=delete
 
wwSectionManager & operator= (const wwSectionManager &)=delete
 

Static Private Member Functions

static void SetPageULSpaceItems (SwFrameFormat &rFormat, wwULSpaceData const &rData, const wwSection &rSection)
 
static void SetPage (SwPageDesc &rPageDesc, SwFrameFormat &rFormat, const wwSection &rSection, bool bIgnoreCols)
 
static void SetNumberingType (const wwSection &rNewSection, SwPageDesc &rPageDesc)
 
static bool SetCols (SwFrameFormat &rFormat, const wwSection &rSection, sal_uInt32 nNetWidth)
 
static void SetLeftRight (wwSection &rSection)
 

Private Attributes

SwWW8ImplReader & mrReader
 
std::deque< wwSection > maSegments
 
sal_uInt16 mnDesc
 

Detailed Description

Definition at line 817 of file ww8par.hxx.

Member Typedef Documentation

◆ mySegIter

typedef std::deque<wwSection>::iterator wwSectionManager::mySegIter
private

Definition at line 825 of file ww8par.hxx.

Constructor & Destructor Documentation

◆ wwSectionManager() [1/2]

wwSectionManager::wwSectionManager ( const wwSectionManager &  )
privatedelete

◆ wwSectionManager() [2/2]

wwSectionManager::wwSectionManager ( SwWW8ImplReader &  rReader)
inlineexplicit

Definition at line 875 of file ww8par.hxx.

Member Function Documentation

◆ CreateSep()

void wwSectionManager::CreateSep ( const tools::Long  nTextPos)

Definition at line 858 of file ww8par6.cxx.

References SwWW8ImplReader::AppendTextNode(), SEPr::bkc, SEPr::ccolM1, SEPr::clm, SEPr::cnsPgn, SwWW8ImplReader::ConvertFFileName(), SEPr::dmBinFirst, SEPr::dmBinOther, SEPr::dmOrientPage, SEPr::dxaColumns, SEPr::dxaLeft, SEPr::dxaLnn, SEPr::dxaRight, SEPr::dxtCharSpace, SEPr::dyaBottom, SEPr::dyaHdrBottom, SEPr::dyaHdrTop, SEPr::dyaLinePitch, SEPr::dyaTop, SEPr::dzaGutter, ww::eWW2, ww::eWW6, ww::eWW7, ww::eWW8, SEPr::fBiDi, SEPr::fEvenlySpaced, FileLink, SEPr::fLBetween, fnMoveBackward, SEPr::fPgnRestart, SEPr::fRTLGutter, SEPr::fTitlePage, SEPr::fUnlocked, WW8PLCFspecial::Get(), SwWW8ImplReader::GetFib(), WW8Fib::GetFIBVersion(), SwNodeIndex::GetNode(), SwPaM::GetPoint(), SvxPaperInfo::GetSloppyPaperDimension(), SwNode::GetTextNode(), GoInNode(), SEPr::grpfIhdt, SwWW8ImplReader::HandleLineNumbering(), WW8PLCFx_SEPX::HasSprm(), SEPr::iHeadingPgn, SwWW8ImplReader::InLocalApo(), SwDoc::InsertSwSection(), lcl_ReadBorders(), lLetterHeight, lLetterWidth, SEPr::lnc, SEPr::lnnMin, SwWW8ImplReader::m_aLinkStringMap, wwSection::m_brc, SwWW8ImplReader::m_bTxbxFlySection, SwWW8ImplReader::m_nInTable, wwSection::m_nPgWidth, SwWW8ImplReader::m_pLastAnchorPos, SwWW8ImplReader::m_pPaM, SwWW8ImplReader::m_rDoc, SwWW8ImplReader::m_xHdFt, SwWW8ImplReader::m_xPlcxMan, SwWW8ImplReader::m_xWDop, SwWW8ImplReader::m_xWwFib, maSegments, wwSection::maSep, MAX_NO_OF_SEP_COLUMNS, MM_200, MM_250, wwSection::mnBorders, SwPaM::Move(), mrReader, SEPr::nfcPgn, SEPr::nLnnMod, SwPosition::nNode, SprmResult::nRemainingData, pData, SEPr::pgbApplyTo, SEPr::pgbOffsetFrom, SEPr::pgbPageDepth, SEPr::pgnStart, SprmResult::pSprm, ReadBSprm(), ReadSprm(), ReadUSprm(), SEPr::rgdxaColumnWidthSpacing, WW8PLCFspecial::SeekPosExact(), wwSection::SetDirection(), SetLeftRight(), SwSectionData::SetLinkFileName(), SwSectionData::SetProtectFlag(), NS_sprm::v6::sprmSBkc, NS_sprm::v6::sprmSBOrientation, NS_sprm::v6::sprmSCcolumns, NS_sprm::v6::sprmSDmBinFirst, NS_sprm::v6::sprmSDmBinOther, NS_sprm::v6::sprmSDxaColSpacing, NS_sprm::v6::sprmSDxaColumns, NS_sprm::v6::sprmSDxaColWidth, NS_sprm::v6::sprmSDxaLeft, NS_sprm::v6::sprmSDxaLnn, NS_sprm::v6::sprmSDxaRight, NS_sprm::v6::sprmSDyaBottom, NS_sprm::v6::sprmSDyaHdrBottom, NS_sprm::v6::sprmSDyaHdrTop, NS_sprm::v6::sprmSDyaTop, NS_sprm::v6::sprmSDzaGutter, NS_sprm::v6::sprmSFEvenlySpaced, NS_sprm::v6::sprmSFPgnRestart, NS_sprm::v6::sprmSFProtected, NS_sprm::v6::sprmSFTitlePage, NS_sprm::v6::sprmSiHeadingPgn, NS_sprm::v6::sprmSLBetween, NS_sprm::v6::sprmSLnc, NS_sprm::v6::sprmSLnnMin, NS_sprm::v6::sprmSNfcPgn, NS_sprm::v6::sprmSNLnnMod, NS_sprm::v6::sprmSPgnStart, NS_sprm::v6::sprmSScnsPgn, NS_sprm::v6::sprmSXaPage, NS_sprm::v6::sprmSYaPage, NS_sprm::sprm< ispmd, fSpec, sgc, spra >::val, WW8PLCFspecial::Where(), SEPr::wTextFlow, nsHdFtFlags::WW8_FOOTER_EVEN, nsHdFtFlags::WW8_FOOTER_FIRST, nsHdFtFlags::WW8_FOOTER_ODD, nsHdFtFlags::WW8_HEADER_EVEN, nsHdFtFlags::WW8_HEADER_FIRST, nsHdFtFlags::WW8_HEADER_ODD, SEPr::xaPage, and SEPr::yaPage.

Referenced by SwWW8ImplReader::ReadTextAttr().

◆ CurrentSectionColCount()

sal_uInt16 wwSectionManager::CurrentSectionColCount ( ) const

Definition at line 2964 of file ww8par5.cxx.

References maSegments.

Referenced by SwWW8ImplReader::FloatingTableConversion(), and SwWW8ImplReader::ReadChar().

◆ CurrentSectionIsProtected()

bool wwSectionManager::CurrentSectionIsProtected ( ) const

Definition at line 136 of file ww8par2.cxx.

Referenced by SwWW8ImplReader::Read_F_Tox().

◆ CurrentSectionIsVertical()

bool wwSectionManager::CurrentSectionIsVertical ( ) const

Definition at line 127 of file ww8par2.cxx.

Referenced by WW8FlySet::Init(), and SwWW8ImplReader::ProcessEscherAlign().

◆ GetPageLeft()

sal_uInt32 wwSectionManager::GetPageLeft ( ) const

Definition at line 145 of file ww8par2.cxx.

Referenced by WW8TabDesc::CreateSwTable(), SwWW8ImplReader::ImportGraf(), and SwWW8ImplReader::MiserableRTLGraphicsHack().

◆ GetPageRight()

sal_uInt32 wwSectionManager::GetPageRight ( ) const

Definition at line 150 of file ww8par2.cxx.

Referenced by WW8TabDesc::CreateSwTable(), SwWW8ImplReader::ImportGraf(), and SwWW8ImplReader::MiserableRTLGraphicsHack().

◆ GetPageULData()

void wwSectionManager::GetPageULData ( const wwSection &  rNewSection,
wwSectionManager::wwULSpaceData &  rData 
) const
private

Definition at line 582 of file ww8par6.cxx.

References abs(), cMinHdFtHeight, SEPr::dyaBottom, SEPr::dyaHdrBottom, SEPr::dyaHdrTop, SEPr::dyaTop, SEPr::dzaGutter, SEPr::fRTLGutter, SEPr::grpfIhdt, wwSection::HasTitlePage(), if(), SwWW8ImplReader::m_bVer67, SwWW8ImplReader::m_xWDop, o3tl::make_unsigned(), wwSection::maSep, mrReader, rData, nsHdFtFlags::WW8_FOOTER_EVEN, nsHdFtFlags::WW8_FOOTER_FIRST, nsHdFtFlags::WW8_FOOTER_ODD, nsHdFtFlags::WW8_HEADER_EVEN, nsHdFtFlags::WW8_HEADER_FIRST, and nsHdFtFlags::WW8_HEADER_ODD.

Referenced by SetSegmentToPageDesc().

◆ GetPageWidth()

sal_uInt32 wwSectionManager::GetPageWidth ( ) const

Definition at line 155 of file ww8par2.cxx.

Referenced by SwWW8ImplReader::ImportGraf(), and SwWW8ImplReader::MiserableRTLGraphicsHack().

◆ GetTextAreaWidth()

sal_uInt32 wwSectionManager::GetTextAreaWidth ( ) const

Definition at line 160 of file ww8par2.cxx.

Referenced by WW8TabDesc::CreateSwTable(), SwWW8ImplReader::FloatingTableConversion(), SwWW8ImplReader::StartApo(), and SwWW8ImplReader::StartTable().

◆ GetWWPageTopMargin()

sal_uInt32 wwSectionManager::GetWWPageTopMargin ( ) const

Definition at line 165 of file ww8par2.cxx.

Referenced by SwWW8ImplReader::StartApo(), and SwWW8ImplReader::StartTable().

◆ InsertSection()

SwSectionFormat * wwSectionManager::InsertSection ( SwPaM const &  rMyPaM,
wwSection &  rSection 
)
private

Definition at line 718 of file ww8par6.cxx.

References aFrameFormatSetRange, Content, FTNEND_ATTXTEND, SwDoc::GetAttrPool(), SwSection::GetFormat(), SvxLRSpaceItem::GetLeft(), SwFormat::GetLRSpace(), SwPageDesc::GetMaster(), SwDoc::GetPageDesc(), wwSection::GetPageLeft(), wwSection::GetPageRight(), SvxLRSpaceItem::GetRight(), wwSection::GetTextAreaWidth(), SwDoc::GetUniqueSectionName(), SwDoc::InsertSwSection(), SwWW8ImplReader::m_rDoc, SwWW8ImplReader::m_xWDop, maSegments, wwSection::mpSection, mrReader, SfxItemSet::Put(), RES_FRAMEDIR(), RES_LR_SPACE(), SectionIsProtected(), SetCols(), SwFormat::SetFormatAttr(), and SwSectionData::SetProtectFlag().

Referenced by InsertSegments().

◆ InsertSegments()

void wwSectionManager::InsertSegments ( )

Definition at line 4486 of file ww8par.cxx.

References SwIndex::Assign(), SwNodeIndex::Assign(), IDocumentContentOperations::DelFullPara(), SwPaM::End(), SwNode::FindTableNode(), fnMoveBackward, SwPaM::GetContentNode(), SwDoc::getIDocumentContentOperations(), SwDoc::getIDocumentStylePoolAccess(), SwNodeIndex::GetIndex(), SwNodeIndex::GetNode(), SwDoc::GetNodes(), SwFormatPageDesc::GetNumOffset(), SwFormatPageDesc::GetPageDesc(), SwPaM::GetPoint(), IDocumentStylePoolAccess::GetTextCollFromPool(), SwNode::GetTextNode(), GiveNodePageDesc(), SwWW8ImplReader::HasOwnHeaderFooter(), sw::util::HasPageBreak(), IDocumentContentOperations::InsertPoolItem(), InsertSection(), Left, SwWW8ImplReader::m_pPaM, SwWW8ImplReader::m_rDoc, SwWW8ImplReader::m_xWDop, SwNodes::MakeTextNode(), maSegments, SwPaM::Move(), mrReader, SwPosition::nContent, SwPosition::nNode, RES_BREAK(), RES_POOLCOLL_TEXT, Right, SectionIsProtected(), SwPageDesc::SetFollow(), SwFormat::SetFormatAttr(), SwPaM::SetMark(), SetSwFormatPageDesc(), SwPageDesc::SetUseOn(), start, SwPaM::Start(), nsHdFtFlags::WW8_FOOTER_FIRST, and nsHdFtFlags::WW8_HEADER_FIRST.

Referenced by SwWW8ImplReader::CoreLoad().

◆ JoinNode()

void wwSectionManager::JoinNode ( const SwPosition &  rPos,
const SwNode &  rNode 
)

Definition at line 2545 of file ww8par6.cxx.

References maSegments, and SwPosition::nNode.

Referenced by SwWW8ImplReader::JoinNode().

◆ operator=()

wwSectionManager & wwSectionManager::operator= ( const wwSectionManager &  )
privatedelete

◆ PrependedInlineNode()

void wwSectionManager::PrependedInlineNode ( const SwPosition &  rPos,
const SwNode &  rNode 
)

Definition at line 2362 of file ww8par2.cxx.

References maSegments, and SwPosition::nNode.

Referenced by WW8TabDesc::CreateSwTable(), SwWW8ImplReader::Read_F_IncludeText(), and SwWW8ImplReader::Read_F_Tox().

◆ SectionIsProtected()

bool wwSectionManager::SectionIsProtected ( const wwSection &  rSection) const
private

Definition at line 2377 of file ww8par.cxx.

References wwSection::IsNotProtected(), SwWW8ImplReader::m_xWDop, and mrReader.

Referenced by InsertSection(), and InsertSegments().

◆ SetCols()

bool wwSectionManager::SetCols ( SwFrameFormat &  rFormat,
const wwSection &  rSection,
sal_uInt32  nNetWidth 
)
staticprivate

Definition at line 423 of file ww8par6.cxx.

References COL_BLACK(), COLADJ_TOP, SEPr::fEvenlySpaced, SEPr::fLBetween, SwFormatCol::GetColumns(), i, SwFormatCol::Init(), wwSection::maSep, wwSection::NoCols(), SEPr::rgdxaColumnWidthSpacing, SAL_N_ELEMENTS, SwFormat::SetFormatAttr(), SwColumn::SetLeft(), SwFormatCol::SetLineAdj(), SwFormatCol::SetLineColor(), SwFormatCol::SetLineHeight(), SwFormatCol::SetLineWidth(), SwFormatCol::SetOrtho_(), SwColumn::SetRight(), SwColumn::SetWishWidth(), SwFormatCol::SetWishWidth(), and wwSection::StandardColSeparation().

Referenced by InsertSection(), and SetPage().

◆ SetCurrentSectionHasFootnote()

void wwSectionManager::SetCurrentSectionHasFootnote ( )

Definition at line 111 of file ww8par2.cxx.

◆ SetCurrentSectionVerticalAdjustment()

void wwSectionManager::SetCurrentSectionVerticalAdjustment ( const css::drawing::TextVerticalAdjust  nVA)

Definition at line 119 of file ww8par2.cxx.

Referenced by SwWW8ImplReader::Read_TextVerticalAdjustment().

◆ SetHdFt()

void wwSectionManager::SetHdFt ( wwSection const &  rSection,
int  nSect,
const wwSection *  pPrevious 
)
private

Definition at line 2382 of file ww8par.cxx.

References SEPr::grpfIhdt, SwWW8ImplReader::m_xHdFt, wwSection::maSep, wwSection::mpPage, mrReader, and SwWW8ImplReader::Read_HdFt().

Referenced by SetSwFormatPageDesc().

◆ SetLeftRight()

void wwSectionManager::SetLeftRight ( wwSection &  rSection)
staticprivate

Definition at line 476 of file ww8par6.cxx.

References SEPr::dxaLeft, SEPr::dxaRight, SEPr::dzaGutter, SEPr::fRTLGutter, wwSection::m_bRtlGutter, wwSection::m_nPgGutter, wwSection::m_nPgLeft, wwSection::m_nPgRight, wwSection::m_nPgWidth, wwSection::maSep, MINLAY, and MSRoundTweak().

Referenced by CreateSep().

◆ SetNumberingType()

void wwSectionManager::SetNumberingType ( const wwSection &  rNewSection,
SwPageDesc &  rPageDesc 
)
staticprivate

Definition at line 838 of file ww8par6.cxx.

References wwSection::maSep, SEPr::nfcPgn, SvxNumberType::SetNumberingType(), SwPageDesc::SetNumType(), SVX_NUM_ARABIC, SVX_NUM_CHARS_LOWER_LETTER_N, SVX_NUM_CHARS_UPPER_LETTER_N, SVX_NUM_ROMAN_LOWER, and SVX_NUM_ROMAN_UPPER.

Referenced by SetSegmentToPageDesc().

◆ SetPage()

void wwSectionManager::SetPage ( SwPageDesc &  rPageDesc,
SwFrameFormat &  rFormat,
const wwSection &  rSection,
bool  bIgnoreCols 
)
staticprivate

Definition at line 517 of file ww8par6.cxx.

References SwFormat::GetFrameSize(), wwSection::GetPageHeight(), wwSection::GetPageLeft(), wwSection::GetPageRight(), wwSection::GetPageWidth(), SvxPaperInfo::GetSloppyPaperDimension(), wwSection::GetTextAreaWidth(), wwSection::IsLandScape(), wwSection::m_bRtlGutter, wwSection::m_nPgGutter, RES_LR_SPACE(), RES_RTL_GUTTER(), SetCols(), SwFormat::SetFormatAttr(), SvxLRSpaceItem::SetGutterMargin(), SvxSizeItem::SetHeight(), SwPageDesc::SetLandscape(), and SvxSizeItem::SetWidth().

Referenced by SetSegmentToPageDesc().

◆ SetPageULSpaceItems()

void wwSectionManager::SetPageULSpaceItems ( SwFrameFormat &  rFormat,
wwSectionManager::wwULSpaceData const &  rData,
const wwSection &  rSection 
)
staticprivate

Definition at line 653 of file ww8par6.cxx.

References abs(), cMinHdFtHeight, SEPr::dyaBottom, SEPr::dyaTop, Fixed, SwFormat::GetFooter(), SwFormatFooter::GetFooterFormat(), SwFormat::GetHeader(), SwFormatHeader::GetHeaderFormat(), wwSection::IsFixedHeightFooter(), wwSection::IsFixedHeightHeader(), wwSection::maSep, Minimum, rData, RES_HEADER_FOOTER_EAT_SPACING(), RES_UL_SPACE(), SwFormat::SetFormatAttr(), SvxULSpaceItem::SetLower(), and SvxULSpaceItem::SetUpper().

Referenced by SetSegmentToPageDesc().

◆ SetSegmentToPageDesc()

void wwSectionManager::SetSegmentToPageDesc ( const wwSection &  rSection,
bool  bIgnoreCols 
)
private

Definition at line 4345 of file ww8par.cxx.

References SL::aData, SdrObject::Free(), SfxItemSet::Get(), SwDoc::GetAttrPool(), SwFormat::GetDoc(), SwPageDesc::GetFirstMaster(), SwPageDesc::GetMaster(), GetPageULData(), SwWW8ImplReader::GraphicCtor(), SfxItemSet::HasItem(), SwWW8ImplReader::m_xMSDffManager, SwWW8ImplReader::m_xWDop, wwSection::maSep, SwWW8ImplReader::MatchSdrItemsIntoFlySet(), wwSection::mnVerticalAdjustment, wwSection::mpPage, mrReader, mso_lineSimple, mso_lineSolid, mso_sptRectangle, SEPr::pgbApplyTo, pObject, RES_BACKGROUND(), SwWW8ImplReader::SetDocumentGrid(), SwFormat::SetFormatAttr(), SetNumberingType(), SetPage(), SwWW8ImplReader::SetPageBorder(), SetPageULSpaceItems(), and SwPageDesc::SetVerticalAdjustment().

Referenced by SetSwFormatPageDesc().

◆ SetSwFormatPageDesc()

SwFormatPageDesc wwSectionManager::SetSwFormatPageDesc ( mySegIter const &  rIter,
mySegIter const &  rStart,
bool  bIgnoreCols 
)
private

Map a word section to a writer page descriptor.

Definition at line 4447 of file ww8par.cxx.

References SwDoc::getIDocumentStylePoolAccess(), IDocumentStylePoolAccess::GetPageDescFromPool(), SwViewShell::GetShellRes(), SwWW8ImplReader::m_bNewDoc, SwWW8ImplReader::m_rDoc, SwDoc::MakePageDesc(), mnDesc, mrReader, ShellResource::NORMAL_PAGE, RES_POOLPAGE_STANDARD, SetHdFt(), SwFormatPageDesc::SetNumOffset(), SetSegmentToPageDesc(), and SetUseOn().

Referenced by InsertSegments().

◆ SetUseOn()

void wwSectionManager::SetUseOn ( wwSection &  rSection)
private

Definition at line 4395 of file ww8par.cxx.

References All, FirstShare, FooterShare, wwSection::HasTitlePage(), HeaderShare, SwWW8ImplReader::m_xWDop, Mirror, wwSection::mpPage, mrReader, and SwPageDesc::WriteUseOn().

Referenced by SetSwFormatPageDesc().

◆ WillHavePageDescHere()

bool wwSectionManager::WillHavePageDescHere ( const SwNodeIndex &  rIdx) const

Definition at line 2974 of file ww8par5.cxx.

References maSegments.

Referenced by SwWW8ImplReader::Read_F_Tox().

Member Data Documentation

◆ maSegments

std::deque<wwSection> wwSectionManager::maSegments
private

Definition at line 824 of file ww8par.hxx.

Referenced by CreateSep(), CurrentSectionColCount(), InsertSection(), InsertSegments(), JoinNode(), PrependedInlineNode(), and WillHavePageDescHere().

◆ mnDesc

sal_uInt16 wwSectionManager::mnDesc
private

Definition at line 828 of file ww8par.hxx.

Referenced by SetSwFormatPageDesc().

◆ mrReader

SwWW8ImplReader& wwSectionManager::mrReader
private

Definition at line 823 of file ww8par.hxx.

Referenced by CreateSep(), GetPageULData(), InsertSection(), InsertSegments(), SectionIsProtected(), SetHdFt(), SetSegmentToPageDesc(), SetSwFormatPageDesc(), and SetUseOn().

The documentation for this class was generated from the following files:
Generated on Tue Jun 28 2022 21:22:36 for LibreOffice Module sw (master) by doxygen 1.9.3