366 lines
12 KiB
C++
366 lines
12 KiB
C++
// Ryzom - MMORPG Framework <http://dev.ryzom.com/projects/ryzom/>
|
|
// Copyright (C) 2010 Winch Gate Property Limited
|
|
//
|
|
// This program is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU Affero General Public License as
|
|
// published by the Free Software Foundation, either version 3 of the
|
|
// License, or (at your option) any later version.
|
|
//
|
|
// This program is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU Affero General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Affero General Public License
|
|
// along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
|
|
|
#ifndef RZ_INTERFACE_PARSER_H
|
|
#define RZ_INTERFACE_PARSER_H
|
|
|
|
#include "nel/misc/types_nl.h"
|
|
#include "nel/3d/u_texture.h"
|
|
#include "ctrl_sheet_selection.h"
|
|
#include "interface_link.h"
|
|
#include "nel/misc/smart_ptr.h"
|
|
#include "game_share/brick_types.h"
|
|
#include "nel/gui/lua_helper.h"
|
|
#include "widget_manager.h"
|
|
using namespace NLGUI;
|
|
|
|
// ***************************************************************************
|
|
class CInterfaceElement;
|
|
class CInterfaceGroup;
|
|
class CGroupContainer;
|
|
class CGroupList;
|
|
class CInterfaceOptions;
|
|
class CInterfaceAnim;
|
|
class CViewPointer;
|
|
class CInterfaceLink;
|
|
class CBrickJob;
|
|
class CCtrlBase;
|
|
|
|
// ***************************************************************************
|
|
/**
|
|
* class managing the interface parsing
|
|
* \author Matthieu 'TrapII' Besson
|
|
* \author Nevrax France
|
|
* \date 2002
|
|
*/
|
|
|
|
// this is the base class for CInterfaceManager
|
|
class CInterfaceParser : public IParser
|
|
{
|
|
|
|
public:
|
|
CInterfaceParser();
|
|
virtual ~CInterfaceParser();
|
|
|
|
public:
|
|
|
|
/**
|
|
* Parsing methods
|
|
*/
|
|
|
|
/** Load a set of xml files
|
|
* \param isFilename true if xmlFileNames array contains the names of the xml file, false, if each
|
|
* array is a script itself
|
|
*/
|
|
bool parseInterface (const std::vector<std::string> &xmlFileNames, bool reload, bool isFilename = true, bool checkInData = false);
|
|
|
|
bool parseXMLDocument (xmlNodePtr root, bool reload);
|
|
|
|
bool parseTemplateNode (xmlNodePtr node,xmlNodePtr instance,xmlNodePtr templ);
|
|
|
|
bool parseInstance(xmlNodePtr cur);
|
|
|
|
// bool parseDynamicList (xmlNodePtr cur, CInterfaceGroup * parentGroup);
|
|
|
|
bool parseVector (xmlNodePtr cur);
|
|
|
|
bool parseObserver (xmlNodePtr cur, CInterfaceGroup * parentGroup);
|
|
|
|
bool parseVariable (xmlNodePtr cur, CInterfaceGroup * parentGroup);
|
|
|
|
bool parseOptions (xmlNodePtr cur, CInterfaceGroup * parentGroup);
|
|
|
|
bool parseGroup (xmlNodePtr cur, CInterfaceGroup * parentGroup, bool reload);
|
|
|
|
bool parseGroupChildren(xmlNodePtr cur, CInterfaceGroup * parentGroup, bool reload);
|
|
|
|
bool parseControl (xmlNodePtr cur, CInterfaceGroup * parentGroup, bool reload);
|
|
|
|
bool parseLink (xmlNodePtr cur, CInterfaceGroup * parentGroup);
|
|
|
|
bool parseView (xmlNodePtr cur, CInterfaceGroup * parentGroup, bool reload);
|
|
|
|
bool parseTreeNode (xmlNodePtr cur, CGroupContainer *parentGroup);
|
|
|
|
bool parseTree (xmlNodePtr cur, CWidgetManager::SMasterGroup *parentGroup);
|
|
|
|
bool parseDefine(xmlNodePtr cur);
|
|
|
|
bool parseProcedure(xmlNodePtr cur, bool reload);
|
|
|
|
bool parseSheetSelection(xmlNodePtr cur);
|
|
|
|
bool parseCareerGenerator(xmlNodePtr cur);
|
|
|
|
bool parseAnim(xmlNodePtr cur, CInterfaceGroup * parentGroup);
|
|
|
|
bool parseScene3D (xmlNodePtr cur, CInterfaceGroup * parentGroup);
|
|
|
|
bool parseActionCategory (xmlNodePtr cur);
|
|
|
|
bool parseKey(xmlNodePtr cur);
|
|
|
|
bool parseMacro(xmlNodePtr cur);
|
|
|
|
bool parseCommand(xmlNodePtr cur);
|
|
|
|
bool parseBrickCareerGenerator(xmlNodePtr cur);
|
|
|
|
bool parseBrickSuffixGenerator(xmlNodePtr cur);
|
|
|
|
bool parseStyle(xmlNodePtr cur);
|
|
|
|
bool parseDDX (xmlNodePtr cur, CInterfaceGroup * parentGroup);
|
|
|
|
bool parseLUAScript (xmlNodePtr cur);
|
|
|
|
bool setupTree (xmlNodePtr cur, CWidgetManager::SMasterGroup *parentGroup);
|
|
bool setupTreeNode (xmlNodePtr cur, CGroupContainer *parentGroup);
|
|
|
|
// Called by each parse in parseXMLDocument
|
|
bool solveDefine(xmlNodePtr cur);
|
|
bool solveStyle(xmlNodePtr cur);
|
|
|
|
// Solve All define in a string. return false if some define not founs (defError contains this define)
|
|
bool solveDefine(const std::string &propVal, std::string &newPropVal, std::string &defError);
|
|
|
|
// Called after template & options parsing
|
|
virtual void setupOptions() { }
|
|
|
|
/**
|
|
* Initializer
|
|
*/
|
|
|
|
bool initCoordsAndLuaScript ();
|
|
|
|
/// Association builders : associate an element of the interface with the string ID of
|
|
/// another element used as reference for position values
|
|
void addParentPositionAssociation (CInterfaceElement *element, const std::string &parentID);
|
|
void addParentSizeAssociation (CInterfaceElement *element, const std::string &parentID);
|
|
void addParentSizeMaxAssociation (CInterfaceElement *element, const std::string &parentID);
|
|
|
|
/// LUA Class Association builder : associate a lua script to a group (called for each group after every document parsed)
|
|
void addLuaClassAssociation(CInterfaceGroup *group, const std::string &luaScript);
|
|
|
|
/**
|
|
* Accessors
|
|
*/
|
|
// access to control sheet selection
|
|
CCtrlSheetSelection &getCtrlSheetSelection() { return _CtrlSheetSelection; }
|
|
|
|
/// \name Parameter variable
|
|
// @{
|
|
const std::string &getDefine(const std::string &id) const;
|
|
bool isDefineExist(const std::string &id) const;
|
|
void setDefine(const std::string &id, const std::string &value);
|
|
// @}
|
|
|
|
/// \name Dynamic links mgt
|
|
// @{
|
|
/** Associate the given dynamic link with an ID
|
|
* \return true if succesful
|
|
*/
|
|
bool addLink(CInterfaceLink *link, const std::string &id);
|
|
/** remove the given link from its ID
|
|
* \return true if succesful
|
|
*/
|
|
bool removeLink(const std::string &id);
|
|
// @}
|
|
|
|
/** create a template from an instance consisting of a single group
|
|
* \param templateName name of the template in the xml
|
|
* \param templateParams array containing each template parameter and its name
|
|
* \param number of template parameters in the array
|
|
*/
|
|
CInterfaceGroup *createGroupInstance(const std::string &templateName, const std::string &parentID, const std::pair<std::string, std::string> *templateParams, uint numParams, bool updateLinks = true);
|
|
CInterfaceGroup *createGroupInstance(const std::string &templateName, const std::string &parentID, std::vector<std::pair<std::string, std::string> > &templateParams, bool updateLinks = true)
|
|
{
|
|
if (templateParams.size() > 0)
|
|
return createGroupInstance(templateName, parentID, &templateParams[0], (uint)templateParams.size(), updateLinks);
|
|
else
|
|
return createGroupInstance(templateName, parentID, NULL, 0, updateLinks);
|
|
}
|
|
|
|
/** create a template from an instance consisting of a single control or group
|
|
* \param templateName name of the template in the xml
|
|
* \param templateParams array containing each template parameter and its name
|
|
* \param number of template parameters in the array
|
|
*/
|
|
CInterfaceElement *createUIElement(const std::string &templateName, const std::string &parentID, const std::pair<std::string,std::string> *templateParams, uint numParams, bool updateLinks /* = true */);
|
|
CInterfaceElement *createUIElement(const std::string &templateName, const std::string &parentID, std::vector<std::pair<std::string, std::string> > &templateParams, bool updateLinks = true)
|
|
{
|
|
if (templateParams.size() > 0)
|
|
return createUIElement(templateName, parentID, &templateParams[0], (uint)templateParams.size(), updateLinks);
|
|
else
|
|
return createUIElement(templateName, parentID, NULL, 0, updateLinks);
|
|
}
|
|
|
|
static void freeXMLNodeAndSibblings(xmlNodePtr node);
|
|
|
|
// search a "tree" node in the hierarchy that match node. may return root! NULL if not found
|
|
static xmlNodePtr searchTreeNodeInHierarchy(xmlNodePtr root, const char *node);
|
|
|
|
/// \name Clearing mgt
|
|
// @{
|
|
void removeAllLinks();
|
|
void removeAllProcedures();
|
|
void removeAllDefines();
|
|
void removeAllTemplates();
|
|
void removeAllAnims();
|
|
void removeAll();
|
|
// @}
|
|
|
|
protected:
|
|
|
|
/**
|
|
* Temporary data for init
|
|
*/
|
|
|
|
/// vector storing parsed templates during init. At the end of init, only used template are kept
|
|
std::vector<xmlNodePtr> _Templates;
|
|
|
|
|
|
// map linking an element to its parent position used during init only
|
|
std::map<CInterfaceElement*,std::string> _ParentPositionsMap;
|
|
std::map<CInterfaceElement*,std::string> _ParentSizesMap;
|
|
std::map<CInterfaceElement*,std::string> _ParentSizesMaxMap;
|
|
|
|
// map linking a group to its lua script. used during init only
|
|
std::map<CInterfaceGroup*,std::string> _LuaClassAssociation;
|
|
|
|
/**
|
|
* Data of initialized interface
|
|
*/
|
|
|
|
/// Define Variable list
|
|
typedef std::map<std::string, std::string> TVarMap;
|
|
typedef TVarMap::iterator ItVarMap;
|
|
typedef TVarMap::const_iterator CstItVarMap;
|
|
TVarMap _DefineMap;
|
|
|
|
bool validDefineChar(char c) const;
|
|
|
|
/// Procedure def
|
|
class CParamBlock
|
|
{
|
|
public:
|
|
// -1 if not a param id, but a string
|
|
sint32 NumParam;
|
|
std::string String;
|
|
|
|
CParamBlock()
|
|
{
|
|
NumParam= -1;
|
|
}
|
|
};
|
|
class CAction
|
|
{
|
|
public:
|
|
// a condition to launch this action handler (is an expression)
|
|
std::vector<CParamBlock> CondBlocks;
|
|
|
|
// the action handler (may be proc!!)
|
|
std::string Action;
|
|
// A list of string/or param number => to build the final params at execution
|
|
std::vector<CParamBlock> ParamBlocks;
|
|
|
|
// build a paramBlock from a string
|
|
void buildParamBlock (const std::string ¶ms);
|
|
// from ParamBlock, and a paramList (skip the 0th), build params.
|
|
void buildParams (const std::vector<std::string> ¶mList, std::string ¶ms) const;
|
|
|
|
void buildCondBlock (const std::string ¶ms);
|
|
|
|
void buildCond (const std::vector<std::string> ¶mList, std::string &cond) const;
|
|
|
|
static void buildBlocks (const std::string &in, std::vector<CParamBlock> &out);
|
|
static void eval (const std::vector<std::string> &inArgs, const std::vector<CParamBlock> &inBlocks, std::string &out);
|
|
|
|
};
|
|
class CProcedure
|
|
{
|
|
public:
|
|
// List of the actions
|
|
std::vector<CAction> Actions;
|
|
};
|
|
class CStyleProperty
|
|
{
|
|
public:
|
|
std::string Name;
|
|
std::string Value;
|
|
};
|
|
class CStyle
|
|
{
|
|
public:
|
|
std::vector<CStyleProperty> Properties;
|
|
};
|
|
|
|
|
|
/// Procedure list
|
|
typedef std::map<std::string,CProcedure> TProcedureMap;
|
|
typedef TProcedureMap::iterator ItProcedureMap;
|
|
typedef TProcedureMap::const_iterator CstItProcedureMap;
|
|
TProcedureMap _ProcedureMap;
|
|
|
|
// mgt of sheet selections (inventory, buy, sell..)
|
|
CCtrlSheetSelection _CtrlSheetSelection;
|
|
|
|
// Map of dynamic links
|
|
typedef std::map<std::string, NLMISC::CSmartPtr<CInterfaceLink> > TLinkMap;
|
|
TLinkMap _LinkMap;
|
|
|
|
// Map of anims
|
|
typedef std::map<std::string, CInterfaceAnim *> TAnimMap;
|
|
TAnimMap _AnimMap;
|
|
|
|
// Map of styles.
|
|
typedef std::map<std::string, CStyle> TStyleMap;
|
|
TStyleMap _StyleMap;
|
|
|
|
protected:
|
|
|
|
bool parseCareerGeneratorParams(xmlNodePtr cur,
|
|
std::string &templateCareer,
|
|
std::string &templateJob,
|
|
std::string &careerWindow,
|
|
std::string &jobWindow,
|
|
xmlNodePtr &rootTreeNode,
|
|
bool &brickTypeFilter,
|
|
BRICK_TYPE::EBrickType &brickType
|
|
);
|
|
|
|
void createJobBricks(BRICK_TYPE::EBrickType brickType, xmlNodePtr &nextSibling, xmlNodePtr parentTreeNode,
|
|
const CBrickJob &job, const std::string &templateBrick, const std::string &baseWindowId, sint32 xstart);
|
|
|
|
bool parseGeneratorRootContainer(xmlNodePtr cur, xmlNodePtr &rootTreeNode);
|
|
|
|
|
|
protected:
|
|
// LUA
|
|
// ----------------------------------------------------------------------------------
|
|
// LUA Interface State. NB: The LUA environnement is not shared between Login/OutGame/InGame
|
|
NLMISC::CSmartPtr<CLuaState> _LuaState;
|
|
void initLUA();
|
|
void uninitLUA();
|
|
// List of script loaded (for reloadLua command)
|
|
std::set<std::string> _LuaFileScripts;
|
|
// Load A .lua. false if parse error. string 'error' contains the eventual error desc (but warning still displayed)
|
|
bool loadLUA(const std::string &luaFile, std::string &error);
|
|
};
|
|
|
|
#endif // RZ_INTERFACE_PARSER_H
|