ResourceMgr Class Reference

Singleton for managing resources compiled into an executable. More...

#include <src/resourcemgr.h>

Classes
class	Private

Public Member Functions
void	registerResources (std::initializer_list< Resource > resources)
	Registers an array of resources.
bool	writeCategory (const QCString &categoryName, const QCString &targetDir) const
	Writes all resource belonging to a given category to a given target directory.
bool	copyResource (const QCString &name, const QCString &targetDir) const
	Copies a registered resource to a given target directory.
bool	copyResourceAs (const QCString &name, const QCString &targetDir, const QCString &targetName, bool append=false) const
	Copies a registered resource to a given target directory under a given target name.
QCString	getAsString (const QCString &name) const
	Gets the resource data as a C string.

Static Public Member Functions
static ResourceMgr &	instance ()
	Returns the one and only instance of this class.

Private Member Functions
const Resource *	get (const QCString &name) const
	Returns a pointer to the resource object with the given name.
	ResourceMgr ()
	~ResourceMgr ()

Private Attributes
std::unique_ptr< Private >	p

Detailed Description

Singleton for managing resources compiled into an executable.

Definition at line 36 of file resourcemgr.h.

Constructor & Destructor Documentation

ResourceMgr()

ResourceMgr::ResourceMgr ( )

private

Definition at line 39 of file resourcemgr.cpp.

                         : p(std::make_unique<Private>())
{
}

References p.

Referenced by instance().

~ResourceMgr()

ResourceMgr::~ResourceMgr ( )

private

Definition at line 43 of file resourcemgr.cpp.

{
}

Member Function Documentation

copyResource()

bool ResourceMgr::copyResource	(	const QCString &	name,
		const QCString &	targetDir ) const

Copies a registered resource to a given target directory.

Definition at line 178 of file resourcemgr.cpp.

{
  return copyResourceAs(name,targetDir,name);
}

References copyResourceAs().

Referenced by CitationManager::generatePage(), FTVHelp::generateTreeViewImages(), generateXML(), HtmlGenerator::init(), HtmlGenerator::writeSearchData(), HtmlGenerator::writeSearchPage(), and HtmlGenerator::writeTabData().

copyResourceAs()

bool ResourceMgr::copyResourceAs	(	const QCString &	name,
		const QCString &	targetDir,
		const QCString &	targetName,
		bool	append = false ) const

Copies a registered resource to a given target directory under a given target name.

Definition at line 79 of file resourcemgr.cpp.

{
  QCString pathName = targetDir+"/"+targetName;
  const Resource *res = get(name);
  if (res)
  {
    switch (res->type)
    {
      case Resource::Verbatim:
        {
          std::ofstream f = Portable::openOutputStream(pathName,append);
          bool ok=false;
          if (f.is_open())
          {
            f.write(reinterpret_cast<const char *>(res->data),res->size);
            ok = !f.fail();
          }
          if (ok)
          {
            return TRUE;
          }
        }
        break;
      case Resource::Luminance:
        {
          QCString n = name;
          n = n.left(n.length()-4)+".png"; // replace .lum by .png
          const uint8_t *data = res->data;
          uint16_t width   = (data[0]<<8)+data[1];
          uint16_t height  = (data[2]<<8)+data[3];
          ColoredImgDataItem images[2];
          images[0].name    = n.data();
          images[0].width   = width;
          images[0].height  = height;
          images[0].content = &data[4];
          images[0].alpha   = nullptr;
          images[1].name    = nullptr; // terminator
          writeColoredImgData(targetDir,images);
          return TRUE;
        }
        break;
      case Resource::LumAlpha:
        {
          QCString n = name;
          n = n.left(n.length()-5)+".png"; // replace .luma by .png
          const uint8_t *data = res->data;
          uint16_t width   = (data[0]<<8)+data[1];
          uint16_t height  = (data[2]<<8)+data[3];
          ColoredImgDataItem images[2];
          images[0].name    = n.data();
          images[0].width   = width;
          images[0].height  = height;
          images[0].content = &data[4];
          images[0].alpha   = &data[4+width*height];
          images[1].name    = nullptr; // terminator
          writeColoredImgData(targetDir,images);
          return TRUE;
        }
        break;
      case Resource::CSS:
        {
          std::ofstream t = Portable::openOutputStream(pathName,append);
          if (t.is_open())
          {
            QCString buf(res->size, QCString::ExplicitSize);
            memcpy(buf.rawData(),res->data,res->size);
            buf = replaceColorMarkers(buf);
            if (name=="navtree.css")
            {
              t << substitute(buf,"$width",QCString().setNum(Config_getInt(TREEVIEW_WIDTH))+"px");
            }
            else
            {
              t << substitute(buf,"$doxygenversion",getDoxygenVersion());
            }
            return TRUE;
          }
        }
        break;
      case Resource::SVG:
        {
          std::ofstream t = Portable::openOutputStream(pathName,append);
          if (t.is_open())
          {
            QCString buf(res->size, QCString::ExplicitSize);
            memcpy(buf.rawData(),res->data,res->size);
            t << replaceColorMarkers(buf);
            return TRUE;
          }
        }
    }
  }
  else
  {
    err("requested resource '%s' not compiled in!\n",qPrint(name));
  }
  return FALSE;
}

References ColoredImgDataItem::alpha, Config_getInt, ColoredImgDataItem::content, Resource::CSS, QCString::data(), Resource::data, err, QCString::ExplicitSize, FALSE, get(), ColoredImgDataItem::height, QCString::left(), QCString::length(), Resource::LumAlpha, Resource::Luminance, ColoredImgDataItem::name, Portable::openOutputStream(), qPrint(), QCString::rawData(), replaceColorMarkers(), Resource::size, substitute(), Resource::SVG, TRUE, Resource::type, Resource::Verbatim, ColoredImgDataItem::width, and writeColoredImgData().

Referenced by copyResource().

get()

const Resource * ResourceMgr::get ( const QCString & name ) const

private

Returns a pointer to the resource object with the given name.

Definition at line 183 of file resourcemgr.cpp.

{
  auto it = p->resources.find(name.str());
  if (it!=p->resources.end()) return &it->second;
  return nullptr;
}

References p, and QCString::str().

Referenced by copyResourceAs(), and getAsString().

getAsString()

QCString ResourceMgr::getAsString

(

const QCString &

name

)

const

Gets the resource data as a C string.

Definition at line 190 of file resourcemgr.cpp.

{
  const Resource *res = get(name);
  if (res)
  {
    QCString result(res->size, QCString::ExplicitSize);
    memcpy(result.rawData(),res->data,res->size);
    return result;
  }
  else
  {
    return QCString();
  }
}

References Resource::data, QCString::ExplicitSize, get(), QCString::rawData(), and Resource::size.

Referenced by fillColorStyleMaps(), generateXML(), HtmlGenerator::getNavTreeCss(), HtmlGenerator::init(), LatexGenerator::init(), LayoutDocManager::init(), writeDefaultLayoutFile(), writeDefaultStyleSheet(), HtmlGenerator::writeExternalSearchPage(), HtmlGenerator::writeFooterFile(), LatexGenerator::writeFooterFile(), HtmlGenerator::writeHeaderFile(), LatexGenerator::writeHeaderFile(), HtmlGenerator::writeSearchData(), HtmlGenerator::writeSearchPage(), and LatexGenerator::writeStyleInfo().

instance()

ResourceMgr & ResourceMgr::instance ( )

static

Returns the one and only instance of this class.

Definition at line 33 of file resourcemgr.cpp.

{
  static ResourceMgr theInstance;
  return theInstance;
}

References ResourceMgr().

Referenced by fillColorStyleMaps(), generateJSNavTree(), CitationManager::generatePage(), FTVHelp::generateTreeViewImages(), generateXML(), HtmlGenerator::getNavTreeCss(), HtmlGenerator::init(), LatexGenerator::init(), LayoutDocManager::init(), writeDefaultLayoutFile(), writeDefaultStyleSheet(), writeDefaultStyleSheet(), HtmlGenerator::writeExternalSearchPage(), HtmlGenerator::writeFooterFile(), LatexGenerator::writeFooterFile(), HtmlGenerator::writeHeaderFile(), LatexGenerator::writeHeaderFile(), writeJavaScriptSearchIndex(), HtmlGenerator::writeSearchData(), HtmlGenerator::writeSearchPage(), LatexGenerator::writeStyleInfo(), and HtmlGenerator::writeTabData().

registerResources()

void ResourceMgr::registerResources

(

std::initializer_list< Resource >

resources

)

Registers an array of resources.

Definition at line 47 of file resourcemgr.cpp.

{
  for (auto &res : resources)
  {
    p->resources.emplace(res.name,res);
  }
}

References p.

writeCategory()

bool ResourceMgr::writeCategory	(	const QCString &	categoryName,
		const QCString &	targetDir ) const

Writes all resource belonging to a given category to a given target directory.

Definition at line 55 of file resourcemgr.cpp.

{
  for (auto &[name,res] : p->resources)
  {
    if (res.category==categoryName)
    {
      QCString pathName = targetDir+"/"+res.name;
      std::ofstream f = Portable::openOutputStream(pathName);
      bool ok=false;
      if (f.is_open())
      {
        f.write(reinterpret_cast<const char *>(res.data),res.size);
        ok = !f.fail();
      }
      if (!ok)
      {
        err("Failed to write resource '%s' to directory '%s'\n",res.name,qPrint(targetDir));
        return FALSE;
      }
    }
  }
  return TRUE;
}

References err, FALSE, Portable::openOutputStream(), p, qPrint(), and TRUE.

Member Data Documentation

p

std::unique_ptr<Private> ResourceMgr::p

private

Definition at line 66 of file resourcemgr.h.

Referenced by get(), registerResources(), ResourceMgr(), and writeCategory().

---

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

• src/resourcemgr.h
• src/resourcemgr.cpp