pip 0.4.0_r5 stable

git-svn-id: svn://db.shs.com.ru/pip@1 12ceb7fc-bf1f-11e4-8940-5bc7170c53b5
2015-02-28 12:42:16 +00:00
commit 68d2921c8b
106 changed files with 32496 additions and 0 deletions
--- a/piobject.cpp
+++ b/piobject.cpp
@@ -0,0 +1,115 @@
+/*
+    PIP - Platform Independent Primitives
+    Object, base class of some PIP classes, provide EVENT -> EVENT_HANDLER mechanism
+    Copyright (C) 2014  Ivan Pelipenko peri4ko@gmail.com
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU 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 General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+#include "piobject.h"
+
+PIVector<PIObject * > PIObject::objects;
+
+
+/** \class PIObject
+ * \brief This is base class for any classes which use events -> handlers mechanism.
+ * \details
+ * \section PIObject_sec0 Events and Event handlers
+ * %PIObject provide notification mechanism similar Qt but implemented
+ * on language capabilities without any special preprocessors or compilers.
+ * Any class inherits PIObject should use macro \a PIOBJECT() immediate
+ * after declaration to proper compile.
+ * 
+ * Event is a some abstract event that can be raised at any time.
+ * Event is a function but declared with special macro \a EVENT().
+ * To raise event simply execute event function.
+ * 
+ * Event handler is a function but declared with special macro
+ * \a EVENT_HANDLER(). You can use event handlers as ordinary functions.
+ * 
+ * Main goal of this mechanism is perform abstract connections between
+ * various objects. This functionality provide macro \a CONNECT() which
+ * connect some event of first object to some event handler or event of
+ * second object. Each event can be connected any times to any event handlers.
+ * 
+ * \image html events_handlers.png
+ * 
+ * Example: \snippet piobject.cpp main
+ * Result:
+\code{.cpp}
+handler B: 2 , 0.5
+handler A: event to handler
+handler A: event to event
+\endcode
+ */
+
+
+PIObject::PIObject(const PIString & name): emitter_(0) {
+	piMonitor.objects++;
+	setName(name);
+	setDebug(true);
+	objects << this;
+}
+
+
+void PIObject::piConnect(const PIString & src, const PIString & sig, void * dest, void * ev_h) {
+	PIObject * o = findByName(src);
+	if (o == 0) {
+		piCout << "[PIObject] Can`t find object with name \"" << src << "\"!";
+		return;
+	}
+	o->connections << Connection(ev_h, 0, sig, dest);
+}
+
+
+void PIObject::piConnect(PIObject * src, const PIString & sig, const PIString & dest, void * ev_h) {
+	PIObject * o = findByName(dest);
+	if (o == 0) {
+		piCout << "[PIObject] Can`t find object with name \"" << dest << "\"!";
+		return;
+	}
+	src->connections << Connection(ev_h, 0, sig, o);
+}
+
+
+void PIObject::piConnect(const PIString & src, const PIString & sig, const PIString & dest, void * ev_h) {
+	PIObject * s = findByName(src);
+	if (s == 0) {
+		piCout << "[PIObject] Can`t find object with name \"" << src << "\"!";
+		return;
+	}
+	PIObject * d = findByName(dest);
+	if (d == 0) {
+		piCout << "[PIObject] Can`t find object with name \"" << dest << "\"!";
+		return;
+	}
+	s->connections << Connection(ev_h, 0, sig, d);
+}
+
+/*
+PIStringList PIObject::events() {
+	PIStringList l;
+	for (PIMap<NamedFunction, PIString>::const_iterator i = signals_.begin(); i != signals_.end(); i++)
+		l << (*i).first;
+	return l;
+}
+
+
+PIStringList PIObject::eventHandlers() {
+	PIStringList l;
+	for (PIMap<NamedFunction, PIString>::const_iterator i = slots_.begin(); i != slots_.end(); i++)
+		l << (*i).first;
+	return l;
+}
+*/