khanat-code-old/code/nel/src/gui/interface_link.cpp

// 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/>.

#include "nel/gui/interface_expr.h"
#include "nel/gui/interface_expr_node.h"
#include "nel/gui/reflect.h"
#include "nel/gui/db_manager.h"
#include "nel/misc/cdb_branch.h"
#include "nel/gui/action_handler.h"
#include "nel/gui/interface_link.h"
#include "nel/gui/interface_element.h"
#include "nel/gui/interface_group.h"
#include "nel/gui/widget_manager.h"
#include "nel/misc/algo.h"

using namespace std;
using namespace NLMISC;

namespace NLGUI
{

	/////////////
	// GLOBALS //
	/////////////

	CInterfaceLink::TLinkList CInterfaceLink::_LinkList;
	CInterfaceLink::TLinkVect CInterfaceLink::_LinksWithNoTarget;
	//
	CInterfaceLink *CInterfaceLink::_FirstTriggeredLink[2] = { NULL, NULL };
	CInterfaceLink *CInterfaceLink::_LastTriggeredLink[2] = { NULL, NULL };
	CInterfaceLink *CInterfaceLink::_CurrUpdatedLink = NULL;
	CInterfaceLink *CInterfaceLink::_NextUpdatedLink = NULL;
	uint CInterfaceLink::_CurrentTriggeredLinkList = 0;

	bool CInterfaceLink::_UpdateAllLinks = false;


	///////////////
	// FUNCTIONS //
	///////////////

	/** Tool fct : affect a value to a reflected property of an interface element.
	  */
	static bool affect(const CInterfaceExprValue &value, CInterfaceElement &destElem, const CReflectedProperty &property)
	{

		CInterfaceExprValue valueToAffect = value;
		switch(property.Type)
		{
			case CReflectedProperty::Boolean:
				if (valueToAffect.toBool())
				{
					(destElem.*(property.SetMethod.SetBool))(valueToAffect.getBool());
				}
				else
				{

					return false;
				}
			break;
			case CReflectedProperty::SInt32:
				if (valueToAffect.toInteger())
				{
					(destElem.*(property.SetMethod.SetSInt32))((sint32) valueToAffect.getInteger());
				}
				else
				{

					return false;
				}
			break;
			case CReflectedProperty::Float:
				if (valueToAffect.toDouble())
				{
					(destElem.*(property.SetMethod.SetFloat))((float) valueToAffect.getDouble());
				}
				else
				{

					return false;
				}
			break;
			case CReflectedProperty::String:
				if (valueToAffect.toString())
				{
					(destElem.*(property.SetMethod.SetString))(valueToAffect.getString());
				}
				else
				{

					return false;
				}
			break;
			case CReflectedProperty::UCString:
				if (valueToAffect.toString())
				{
					(destElem.*(property.SetMethod.SetUCString))(valueToAffect.getUCString());
				}
				else
				{

					return false;
				}
			break;
			case CReflectedProperty::RGBA:
				if (valueToAffect.toRGBA())
				{
					(destElem.*(property.SetMethod.SetRGBA))(valueToAffect.getRGBA());
				}
				else
				{

					return false;
				}
			break;
			default:
			break;
		}

		return true;
	}

	CInterfaceLink::CInterfaceLinkUpdater::CInterfaceLinkUpdater()
	{
		NLGUI::CDBManager::getInstance()->addFlushObserver( this );
	}

	CInterfaceLink::CInterfaceLinkUpdater::~CInterfaceLinkUpdater()
	{
	}

	void CInterfaceLink::CInterfaceLinkUpdater::onObserverCallFlush()
	{
		CInterfaceLink::updateTrigeredLinks();
	}

	/////////////
	// MEMBERS //
	/////////////

	//===========================================================
	CInterfaceLink::CInterfaceLink() : _On(true)
	{
		// add an entry in the links list
		_LinkList.push_front(this);
		_ListEntry = _LinkList.begin();
		_PrevTriggeredLink[0] = _PrevTriggeredLink[1] = NULL;
		_NextTriggeredLink[0] = _NextTriggeredLink[1] = NULL;
		_Triggered[0] = _Triggered[1] = false;
		_ParseTree = NULL;
	}

	//===========================================================
	CInterfaceLink::~CInterfaceLink()
	{
		if (this == _CurrUpdatedLink)
		{
			_CurrUpdatedLink = NULL;
		}
		if (this == _NextUpdatedLink)
		{
			_NextUpdatedLink = _NextUpdatedLink->_NextTriggeredLink[1 - _CurrentTriggeredLinkList];
		}
		// unlink observer from both update lists
		unlinkFromTriggerList(0);
		unlinkFromTriggerList(1);

		removeObservers(_ObservedNodes);
		// removes from the link list
		_LinkList.erase(_ListEntry);

		delete _ParseTree;
	}

	//===========================================================
	bool CInterfaceLink::init(const std::vector<CTargetInfo> &targets, const std::string &expr, const std::string &actionHandler, const std::string &ahParams, const std::string &ahCond, CInterfaceGroup *parentGroup)
	{
		CInterfaceExprValue result;
		// Build the parse tree
		nlassert(!_ParseTree);
		_ParseTree = CInterfaceExpr::buildExprTree(expr);
		if (!_ParseTree)
		{
			// wrong expression : release the link
			nlwarning("CInterfaceLink::init : can't parse expression %s", expr.c_str());
			_LinksWithNoTarget.push_back(TLinkSmartPtr(this));
			return false;
		}
		// Examine the expression, to see which database nodes it depends on
		_ParseTree->getDepends(_ObservedNodes);
		// must keep observerd node sorted (for std::set_xx ops)
		std::sort(_ObservedNodes.begin(), _ObservedNodes.end());
		if (!targets.empty())
		{
			// retrieve properties from the element
			_Targets.resize(targets.size());
			for (uint k = 0; k < targets.size(); ++k)
			{
				CInterfaceElement *elem = targets[k].Elem;
				if (!elem)
				{
					nlwarning("<CInterfaceLink::init> : Element %d is NULL", k);
					_Targets[k]._InterfaceElement = NULL;
					continue;
				}
				_Targets[k]._Property = elem->getReflectedProperty(targets[k].PropertyName);
				if (!_Targets[k]._Property)
				{
					nlwarning("<CInterfaceLink::init> : Can't retrieve property %s for element %d.", targets[k].PropertyName.c_str(), k);
					_Targets[k]._InterfaceElement = NULL;
					continue;
				}
				_Targets[k]._InterfaceElement = elem;
				elem->addLink(this);
			}
		}
		else
		{
			// There are no target for this link, so, put in a dedicated list to ensure that the link will be destroyed at exit
			_LinksWithNoTarget.push_back(TLinkSmartPtr(this));
		}

		// create observers
		createObservers(_ObservedNodes);
		_Expr = expr;
		//
		_ActionHandler = actionHandler;
		_AHParams = ahParams;
		_AHCond = ahCond;
		_AHParent = parentGroup;
		return true;
	}

	//===========================================================
	void CInterfaceLink::uninit()
	{
		for (uint32 i = 0; i < _LinksWithNoTarget.size(); i++)
		{
			CInterfaceLink *pLink = _LinksWithNoTarget[i];
			if (pLink == this)
			{
				_LinksWithNoTarget.erase(_LinksWithNoTarget.begin()+i);
				return;
			}
		}
	}

	//===========================================================
	void CInterfaceLink::update(ICDBNode * /* node */)
	{
		// mark link as triggered
		linkInTriggerList(_CurrentTriggeredLinkList);
	}

	//===========================================================
	void CInterfaceLink::createObservers(const TNodeVect &nodes)
	{
		for(std::vector<ICDBNode *>::const_iterator it = nodes.begin(); it != nodes.end(); ++it)
		{
			if ((*it)->isLeaf())
			{
				ICDBNode::CTextId textId;
				(*it)->addObserver(this, textId);
			}
			else
			{
				CCDBNodeBranch *br = static_cast<CCDBNodeBranch *>(*it);
				NLGUI::CDBManager::getInstance()->addBranchObserver( br, this );
			}
		}
	}

	//===========================================================
	void CInterfaceLink::removeObservers(const TNodeVect &nodes)
	{
		for(std::vector<ICDBNode *>::const_iterator it = nodes.begin(); it != nodes.end(); ++it)
		{
			if ((*it)->isLeaf())
			{
				ICDBNode::CTextId textId;
				(*it)->removeObserver(this, textId);
			}
			else
			{
				CCDBNodeBranch *br = static_cast<CCDBNodeBranch *>(*it);
				NLGUI::CDBManager::getInstance()->removeBranchObserver( br, this );
			}
		}
	}

	//===========================================================
	void CInterfaceLink::updateAllLinks()
	{
		nlassert(!_UpdateAllLinks);
		_UpdateAllLinks = true;
		for(TLinkList::iterator it = _LinkList.begin(); it != _LinkList.end(); ++it)
		{
			CInterfaceLink *pLink = *it;
			pLink->update();
		}
		_UpdateAllLinks = false;
	}

	//===========================================================
	void CInterfaceLink::update()
	{
		//_On = false; // prvent recursive calls
		if (!_ParseTree) return;
		static TNodeVect observedNodes; // should not be too big, so ok to keep it static.
		static TNodeVect tmpNodes;
		observedNodes.clear();
		CInterfaceExprValue result;
		_ParseTree->evalWithDepends(result, observedNodes);
		// std::set_xxx require ordered container
		std::sort(observedNodes.begin(), observedNodes.end());
		// we assume that _ObservedNode are also sorted
		// compute new observers
		tmpNodes.clear();
		std::set_difference(observedNodes.begin(), observedNodes.end(), _ObservedNodes.begin(), _ObservedNodes.end(), std::back_inserter(tmpNodes));
		// add these observers
		createObservers(tmpNodes);
		// compute lost observers
		tmpNodes.clear();
		std::set_difference(_ObservedNodes.begin(), _ObservedNodes.end(), observedNodes.begin(), observedNodes.end(), std::back_inserter(tmpNodes));
		// remove these observers
		removeObservers(tmpNodes);
		// subsitute new (sorted) list to current
		_ObservedNodes.swap(observedNodes);
		//
		for (uint k = 0; k < _Targets.size(); ++k)
		{
			CInterfaceElement *elem = _Targets[k]._InterfaceElement;
			const CReflectedProperty    *prop = _Targets[k]._Property;
			if (elem && prop)
			{
				if (!affect(result, *elem, *prop))
				{
					nlwarning("CInterfaceLink::update: Result conversion failed");
				}
			}
		}
		// if there's an action handler, execute it
		if (!_ActionHandler.empty())
		{
			// If there is a condition, test it.
			bool	launch= true;
			if(!_AHCond.empty())
			{
				launch= false;
				CInterfaceExprValue		result;
				if(CInterfaceExpr::eval(_AHCond, result))
					launch= result.getBool();
			}
			if(launch)
			{
				CAHManager::getInstance()->runActionHandler(_ActionHandler, _AHParent, _AHParams);
				// do not add any code after this line because this can be deleted !!!!
			}
		}

		//_On = true; // prevent recursive calls
	}

	// predicate to remove an element from a list
	struct CRemoveTargetPred
	{
		CInterfaceElement *Target;
		bool operator()(const CInterfaceLink::CTarget &target) const { return target._InterfaceElement == Target; }
	};

	//===========================================================
	void CInterfaceLink::removeTarget(CInterfaceElement *elem)
	{
		CRemoveTargetPred pred;
		pred.Target = elem;
		_Targets.erase(std::remove_if(_Targets.begin(), _Targets.end(), pred), _Targets.end());
	}

	//===========================================================
	bool CInterfaceLink::CTargetInfo::affect(const CInterfaceExprValue &value)
	{

		if (!Elem)
		{
			nlwarning("<CInterfaceLink::CTargetInfo::affect> : Target element is NULL");

			return false;
		}
		const CReflectedProperty    *property = Elem->getReflectedProperty(PropertyName);
		if (!property)
		{
			nlwarning("<CInterfaceLink::CTargetInfo::affect> : Can't retrieve property %s for element %s.", PropertyName.c_str(), Elem->getId().c_str());

			return false;
		}
		// try to affect the property
		if (!NLGUI::affect(value, *Elem, *property))
		{
			nlwarning("<CInterfaceLink::CTargetInfo::affect> Couldn't convert the value to affect to %s", Elem->getId().c_str());

			return false;
		}

		return true;
	}

	//===========================================================
	void CInterfaceLink::removeAllLinks()
	{
		_LinksWithNoTarget.clear();
		TLinkList::iterator curr = _LinkList.begin();
		TLinkList::iterator nextIt;
		uint k;
		while(curr != _LinkList.end())
		{
			nextIt = curr;
			++ nextIt;
			CInterfaceLink &link = **curr;
			link.checkNbRefs();
			NLMISC::CSmartPtr<CInterfaceLink> linkPtr = *curr; // must keep a smart ptr because of the test in the loop
			for (k = 0; k < link._Targets.size(); ++k)
			{
				if (link._Targets[k]._InterfaceElement)
				{
					nlinfo("InterfaceElement %s was not remove.", link._Targets[k]._InterfaceElement->getId().c_str());
					link._Targets[k]._InterfaceElement->removeLink(&link);
				}
			}
			linkPtr = NULL; // effectively destroy link
			curr = nextIt;
		}
		nlassert(_LinkList.empty());
	}

	// ***************************************************************************
	bool CInterfaceLink::splitLinkTarget(const std::string &target,  CInterfaceGroup *parentGroup, std::string &propertyName, CInterfaceElement *&targetElm)
	{
		// the last token of the target gives the name of the property
		std::string::size_type lastPos = target.find_last_of(':');
		if (lastPos == (target.length() - 1))
		{
			// todo hulud interface syntax error
			nlwarning("The target should at least contains a path and a property as follow 'path:property'");
			return false;
		}
		std::string elmPath;
		std::string elmProp;
		CInterfaceElement *elm = NULL;
		if (parentGroup)
		{
			if (lastPos == std::string::npos)
			{
				elmProp = target;
				elm = parentGroup;
				elmPath = "current";
			}
			else
			{
				elmProp = target.substr(lastPos + 1);
				elmPath = parentGroup->getId() + ":" + target.substr(0, lastPos);
				elm = parentGroup->getElement(elmPath);
			}
		}
		if (!elm)
		{
			// try the absolute adress of the element
			elmPath = target.substr(0, lastPos);
			elm = CWidgetManager::getInstance()->getElementFromId(elmPath);
			elmProp = target.substr(lastPos + 1);
		}

		if (!elm)
		{
			// todo hulud interface syntax error
			nlwarning("<splitLinkTarget> can't find target link %s", elmPath.c_str());
			return false;
		}
		targetElm = elm;
		propertyName = elmProp;
		return true;
	}


	// ***************************************************************************
	bool CInterfaceLink::splitLinkTargets(const std::string &targets, CInterfaceGroup *parentGroup,std::vector<CInterfaceLink::CTargetInfo> &targetsVect)
	{
		std::vector<std::string> targetNames;
		NLMISC::splitString(targets, ",", targetNames);
		targetsVect.clear();
		targetsVect.reserve(targetNames.size());
		bool everythingOk = true;
		for (uint k = 0; k < targetNames.size(); ++k)
		{
			CInterfaceLink::CTargetInfo ti;
			std::string::size_type startPos = targetNames[k].find_first_not_of(" ");
			if(startPos == std::string::npos)
			{
				// todo hulud interface syntax error
				nlwarning("<splitLinkTargets> empty target encountered");
				continue;
			}
			std::string::size_type lastPos = targetNames[k].find_last_not_of(" ");

			if (!splitLinkTarget(targetNames[k].substr(startPos, lastPos - startPos+1), parentGroup, ti.PropertyName, ti.Elem))
			{
				// todo hulud interface syntax error
				nlwarning("<splitLinkTargets> Can't get link target");
				everythingOk = false;
				continue;
			}
			targetsVect.push_back(ti);
		}
		return everythingOk;
	}


	//===========================================================
	void    CInterfaceLink::checkNbRefs()
	{
		uint numValidPtr = 0;
		for(uint k = 0; k < _Targets.size(); ++k)
		{
			if (_Targets[k]._InterfaceElement != NULL) ++numValidPtr;
		}
		nlassert(numValidPtr == (uint) crefs);
	}


	//===========================================================
	void    CInterfaceLink::setTargetProperty (const std::string &Target, const CInterfaceExprValue &val)
	{
		// Eval target !
		string elt = Target.substr(0,Target.rfind(':'));
		CInterfaceElement *pIE = CWidgetManager::getInstance()->getElementFromId(elt);
		CInterfaceGroup *pIG = dynamic_cast<CInterfaceGroup*>(pIE);
		if (pIG == NULL)
			pIG = pIE->getParent();

		if (pIG != NULL)
		{
			std::vector<CTargetInfo> vTargets;
			splitLinkTargets(Target, pIG, vTargets);
			if ((vTargets.size() > 0) && (vTargets[0].Elem))
			{
				vTargets[0].affect(val);
			}
		}
	}

	//-----------------------------------------------
	void CInterfaceLink::linkInTriggerList(uint list)
	{
		nlassert(list < 2);
		if (_Triggered[list]) return; // already inserted in list
		_Triggered[list] = true;
		nlassert(!_PrevTriggeredLink[list]);
		nlassert(!_NextTriggeredLink[list]);
		if (!_FirstTriggeredLink[list])
		{
			_FirstTriggeredLink[list] = _LastTriggeredLink[list] = this;
		}
		else
		{
			nlassert(!_LastTriggeredLink[list]->_NextTriggeredLink[list]);
			_LastTriggeredLink[list]->_NextTriggeredLink[list] = this;
			_PrevTriggeredLink[list] = _LastTriggeredLink[list];
			_LastTriggeredLink[list] = this;
		}
	}

	//-----------------------------------------------
	void CInterfaceLink::unlinkFromTriggerList(uint list)
	{
		nlassert(list < 2);
		if (!_Triggered[list])
		{
			// not linked in this list
			nlassert(_PrevTriggeredLink[list] == NULL);
			nlassert(_NextTriggeredLink[list] == NULL);
			return;
		}
		if (_PrevTriggeredLink[list])
		{
			_PrevTriggeredLink[list]->_NextTriggeredLink[list] = _NextTriggeredLink[list];
		}
		else
		{
			// this was the first node
			_FirstTriggeredLink[list] = _NextTriggeredLink[list];
		}
		if (_NextTriggeredLink[list])
		{
			_NextTriggeredLink[list]->_PrevTriggeredLink[list] = _PrevTriggeredLink[list];
		}
		else
		{
			// this was the last node
			_LastTriggeredLink[list] = _PrevTriggeredLink[list];
		}
		_PrevTriggeredLink[list] = NULL;
		_NextTriggeredLink[list] = NULL;
		_Triggered[list] = false;
	}





	//-----------------------------------------------
	void CInterfaceLink::updateTrigeredLinks()
	{
		static bool called = false;
		nlassert(!called);
		called = true;
		_CurrUpdatedLink = _FirstTriggeredLink[_CurrentTriggeredLinkList];
		while (_CurrUpdatedLink)
		{
			// modified node should now store them in other list when they're modified
			_CurrentTriggeredLinkList = 1 - _CurrentTriggeredLinkList;
			// switch list so that modified node are stored in the other list
			while (_CurrUpdatedLink)
			{
				_NextUpdatedLink = _CurrUpdatedLink->_NextTriggeredLink[1 - _CurrentTriggeredLinkList];
				_CurrUpdatedLink->update();
				if (_CurrUpdatedLink) // this may be modified by the call (if current observer is removed)
				{
					_CurrUpdatedLink->unlinkFromTriggerList(1 - _CurrentTriggeredLinkList);
				}
				_CurrUpdatedLink = _NextUpdatedLink;
			}
			nlassert(_FirstTriggeredLink[1 - _CurrentTriggeredLinkList] == NULL);
			nlassert(_LastTriggeredLink[1 - _CurrentTriggeredLinkList] == NULL);
			// examine other list to see if nodes have been registered
			_CurrUpdatedLink = _FirstTriggeredLink[_CurrentTriggeredLinkList];
		}
		called = false;
	}


}