ResourceMgr Class Reference

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

#include <resourcemgr.h>

Classes
class	Private

Public Member Functions
void	registerResources (const Resource resources[], int numResources)
bool	copyCategory (const char *categoryName, const char *targetDir) const
bool	copyResource (const char *name, const char *targetDir) const
bool	copyResourceAs (const char *name, const char *targetDir, const char *targetName) const
QCString	getAsString (const char *name) const

Static Public Member Functions
static ResourceMgr &	instance ()

Private Member Functions
const Resource *	get (const char *name) const
	ResourceMgr ()
	~ResourceMgr ()

Private Attributes
Private *	p

Detailed Description

Singleton for managing resources compiled into an executable.

Definition at line 32 of file resourcemgr.h.

Constructor & Destructor Documentation

ResourceMgr::ResourceMgr ( )

private

Definition at line 41 of file resourcemgr.cpp.

{
  p = new Private;
}

ResourceMgr::~ResourceMgr ( )

private

Definition at line 46 of file resourcemgr.cpp.

{
  delete p;
}

Member Function Documentation

bool ResourceMgr::copyCategory	(	const char *	categoryName,
		const char *	targetDir
	)		const

Copies all resource belonging to a given category to a given target directory

Definition at line 59 of file resourcemgr.cpp.

{
  QDictIterator<Resource> it(p->resources);
  const Resource *res;
  for (it.toFirst();(res=it.current());++it)
  {
    if (qstrcmp(res->category,categoryName)==0)
    {
      if (!copyResource(res->name,targetDir))
      {
        return FALSE;
      }
    }
  }
  return TRUE;
}

bool ResourceMgr::copyResource	(	const char *	name,
		const char *	targetDir
	)		const

Copies a registered resource to a given target directory

Definition at line 159 of file resourcemgr.cpp.

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

bool ResourceMgr::copyResourceAs	(	const char *	name,
		const char *	targetDir,
		const char *	targetName
	)		const

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

Definition at line 76 of file resourcemgr.cpp.

{
  QCString pathName = QCString(targetDir)+"/"+targetName;
  const Resource *res = get(name);
  if (res)
  {
    switch (res->type)
    {
      case Resource::Verbatim:
        {
          QFile f(pathName);
          if (f.open(IO_WriteOnly) && f.writeBlock((const char *)res->data,res->size)==res->size)
          {
            return TRUE;
          }
        }
        break;
      case Resource::Luminance:
        {
          QCString n = name;
          n = n.left(n.length()-4)+".png"; // replace .lum by .png
          uchar *p = (uchar*)res->data;
          int width   = (p[0]<<8)+p[1];
          int height  = (p[2]<<8)+p[3];
          ColoredImgDataItem images[2];
          images[0].name    = n;
          images[0].width   = width;
          images[0].height  = height;
          images[0].content = &p[4];
          images[0].alpha   = 0;
          images[1].name    = 0; // terminator
          writeColoredImgData(targetDir,images);
          return TRUE;
        }
        break;
      case Resource::LumAlpha:
        {
          QCString n = name;
          n = n.left(n.length()-5)+".png"; // replace .luma by .png
          uchar *p = (uchar*)res->data;
          int width   = (p[0]<<8)+p[1];
          int height  = (p[2]<<8)+p[3];
          ColoredImgDataItem images[2];
          images[0].name    = n;
          images[0].width   = width;
          images[0].height  = height;
          images[0].content = &p[4];
          images[0].alpha   = &p[4+width*height];
          images[1].name    = 0; // terminator
          writeColoredImgData(targetDir,images);
          return TRUE;
        }
        break;
      case Resource::CSS:
        {
          QFile f(pathName);
          if (f.open(IO_WriteOnly))
          {
            QCString buf(res->size+1);
            memcpy(buf.rawData(),res->data,res->size);
            FTextStream t(&f);
            buf = replaceColorMarkers(buf);
            if (qstrcmp(name,"navtree.css")==0)
            {
              t << substitute(buf,"$width",QCString().setNum(Config_getInt("TREEVIEW_WIDTH"))+"px");
            }
            else
            {
              t << substitute(buf,"$doxygenversion",versionString);
            }
            return TRUE;
          }
        }
        break;
    }
  }
  else
  {
    err("requested resource '%s' not compiled in!\n",name);
  }
  return FALSE;
}

const Resource * ResourceMgr::get ( const char *  name ) const

private

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

Definition at line 164 of file resourcemgr.cpp.

{
  return p->resources.find(name);
}

QCString ResourceMgr::getAsString

(

const char *

name

)

const

Gets the resource data as a C string

Definition at line 169 of file resourcemgr.cpp.

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

ResourceMgr & ResourceMgr::instance ( )

static

Returns the one and only instance of this class

Definition at line 35 of file resourcemgr.cpp.

{
  static ResourceMgr theInstance;
  return theInstance;
}

void ResourceMgr::registerResources	(	const Resource	resources[],
		int	numResources
	)

Registers an array of resources

Definition at line 51 of file resourcemgr.cpp.

{
  for (int i=0;i<numResources;i++)
  {
    p->resources.insert(resources[i].name,&resources[i]);
  }
}

Member Data Documentation

Private* ResourceMgr::p

private

Definition at line 59 of file resourcemgr.h.

---

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

• doxygen-1.8.11/src/resourcemgr.h
• doxygen-1.8.11/src/resourcemgr.cpp