Config_xmlHandler.h

/***********************************************************************
    created:    Sat Jul 25 2009
    author:     Paul D Turner <paul@cegui.org.uk>
*************************************************************************/
/***************************************************************************
 *   Copyright (C) 2004 - 2009 Paul D Turner & The CEGUI Development Team
 *
 *   Permission is hereby granted, free of charge, to any person obtaining
 *   a copy of this software and associated documentation files (the
 *   "Software"), to deal in the Software without restriction, including
 *   without limitation the rights to use, copy, modify, merge, publish,
 *   distribute, sublicense, and/or sell copies of the Software, and to
 *   permit persons to whom the Software is furnished to do so, subject to
 *   the following conditions:
 *
 *   The above copyright notice and this permission notice shall be
 *   included in all copies or substantial portions of the Software.
 *
 *   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 *   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 *   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 *   IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
 *   OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 *   ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 *   OTHER DEALINGS IN THE SOFTWARE.
 ***************************************************************************/
#ifndef _CEGUIConfig_xmlHandler_h_
#define _CEGUIConfig_xmlHandler_h_

#include "CEGUI/Base.h"
#include "CEGUI/String.h"
#include "CEGUI/Logger.h"
#include "CEGUI/XMLHandler.h"
#include <vector>

#if defined (_MSC_VER)
#   pragma warning(push)
#   pragma warning(disable : 4251)
#endif

// Start of CEGUI namespace section
namespace CEGUI
{
class Config_xmlHandler : public XMLHandler
{
public:
    static const String CEGUIConfigSchemaName;
    // xml tag names
    static const String CEGUIConfigElement;
    static const String LoggingElement;
    static const String AutoLoadElement;
    static const String ResourceDirectoryElement;
    static const String DefaultResourceGroupElement;
    static const String ScriptingElement;
    static const String XMLParserElement;
    static const String ImageCodecElement;
    static const String DefaultFontElement;
    static const String DefaultMouseCursorElement;
    static const String DefaultTooltipElement;
    // xml attribute names
    static const String FilenameAttribute;
    static const String LevelAttribute;
    static const String TypeAttribute;
    static const String GroupAttribute;
    static const String PatternAttribute;
    static const String DirectoryAttribute;
    static const String InitScriptAttribute;
    static const String TerminateScriptAttribute;
    static const String ImageAttribute;
    static const String NameAttribute;

    Config_xmlHandler();

    ~Config_xmlHandler();

    void initialiseXMLParser() const;
    void initialiseImageCodec() const;
    void initialiseLogger(const String& default_filename) const;
    void initialiseResourceGroupDirectories() const;
    void initialiseDefaultResourceGroups() const;
    void loadAutoResources() const;
    void initialiseDefaultFont() const;
    void initialiseDefaultMouseCursor() const;
    void initialiseDefaulTooltip() const;
    void executeInitScript() const;
    const String& getTerminateScriptName() const;

    // XMLHandler overrides
    const String& getSchemaName() const;
    const String& getDefaultResourceGroup() const;

    void elementStart(const String& element, const XMLAttributes& attributes);
    void elementEnd(const String& element);

private:
    enum ResourceType
    {
        RT_IMAGESET,
        RT_FONT,
        RT_SCHEME,
        RT_LOOKNFEEL,
        RT_LAYOUT,
        RT_SCRIPT,
        RT_XMLSCHEMA,
        RT_DEFAULT
    };

    struct ResourceDirectory
    {
        String group;
        String directory;
    };

    struct DefaultResourceGroup
    {
        ResourceType type;
        String group;
    };

    struct AutoLoadResource
    {
        String type_string;
        ResourceType type;
        String group;
        String pattern;
    };

    // functions to handle the various elements
    void handleCEGUIConfigElement(const XMLAttributes& attr);
    void handleLoggingElement(const XMLAttributes& attr);
    void handleAutoLoadElement(const XMLAttributes& attr);
    void handleResourceDirectoryElement(const XMLAttributes& attr);
    void handleDefaultResourceGroupElement(const XMLAttributes& attr);
    void handleScriptingElement(const XMLAttributes& attr);
    void handleXMLParserElement(const XMLAttributes& attr);
    void handleImageCodecElement(const XMLAttributes& attr);
    void handleDefaultTooltipElement(const XMLAttributes& attr);
    void handleDefaultFontElement(const XMLAttributes& attr);
    void handleDefaultMouseCursorElement(const XMLAttributes& attr);

    ResourceType stringToResourceType(const String& type) const;
    void autoLoadLookNFeels(const String& pattern, const String& group) const;
    void autoLoadImagesets(const String& pattern, const String& group) const;

    typedef std::vector<ResourceDirectory
        CEGUI_VECTOR_ALLOC(ResourceDirectory)> ResourceDirVector;
    typedef std::vector<DefaultResourceGroup
        CEGUI_VECTOR_ALLOC(DefaultResourceGroup)> DefaultGroupVector;
    typedef std::vector<AutoLoadResource
        CEGUI_VECTOR_ALLOC(AutoLoadResource)> AutoResourceVector;
    String d_logFileName;
    LoggingLevel d_logLevel;
    String d_xmlParserName;
    String d_imageCodecName;
    String d_defaultFont;
    String d_defaultMouseImage;
    String d_defaultTooltipType;
    String d_scriptingInitScript;
    String d_scriptingTerminateScript;
    ResourceDirVector d_resourceDirectories;
    DefaultGroupVector d_defaultResourceGroups;
    AutoResourceVector d_autoLoadResources;
};

} // End of  CEGUI namespace section

#if defined (_MSC_VER)
#   pragma warning(pop)
#endif

#endif // end of guard _CEGUIConfig_xmlHandler_h_