summaryrefslogtreecommitdiffstats
path: root/kig/objects/object_factory.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commitce599e4f9f94b4eb00c1b5edb85bce5431ab3df2 (patch)
treed3bb9f5d25a2dc09ca81adecf39621d871534297 /kig/objects/object_factory.h
downloadtdeedu-ce599e4f9f94b4eb00c1b5edb85bce5431ab3df2.tar.gz
tdeedu-ce599e4f9f94b4eb00c1b5edb85bce5431ab3df2.zip
Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeedu@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'kig/objects/object_factory.h')
-rw-r--r--kig/objects/object_factory.h145
1 files changed, 145 insertions, 0 deletions
diff --git a/kig/objects/object_factory.h b/kig/objects/object_factory.h
new file mode 100644
index 00000000..0ce6ce62
--- /dev/null
+++ b/kig/objects/object_factory.h
@@ -0,0 +1,145 @@
+// Copyright (C) 2002 Dominique Devriese <devriese@kde.org>
+
+// 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 2
+// 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, write to the Free Software
+// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+// 02110-1301, USA.
+
+#ifndef KIG_OBJECTS_OBJECT_FACTORY_H
+#define KIG_OBJECTS_OBJECT_FACTORY_H
+
+#include "common.h"
+
+class ObjectFactory
+{
+public:
+
+ static const ObjectFactory* instance();
+
+ /**
+ * this returns a fixed point. Note that the returned object is
+ * not added to the document..
+ */
+ ObjectHolder* fixedPoint( const Coordinate& c ) const;
+ ObjectTypeCalcer* fixedPointCalcer( const Coordinate& c ) const;
+
+ /**
+ * this returns a CursorPointType; this is used during special
+ * constructions (e.g. regular polygons) where the constructor
+ * wants to use the cursor position without actually generating
+ * an object depending on a new point there.
+ */
+ ObjectTypeCalcer* cursorPointCalcer( const Coordinate& c ) const;
+
+ /**
+ * this returns a relative point (to an object). Note that the returned object
+ * is not added to the document..
+ */
+ ObjectTypeCalcer* relativePointCalcer( ObjectCalcer* o, const Coordinate& loc ) const;
+
+ /**
+ * this returns a constrained point. Note that the returned object
+ * is not added to the document..
+ */
+ ObjectHolder* constrainedPoint( ObjectCalcer* curve, double param ) const;
+ ObjectTypeCalcer* constrainedPointCalcer( ObjectCalcer* curve, double param ) const;
+ /**
+ * \overload, changes nothing to the semantics, only calcs the param
+ * value for you..
+ */
+ ObjectTypeCalcer* constrainedPointCalcer(
+ ObjectCalcer* curve, const Coordinate& c, const KigDocument& ) const;
+ ObjectHolder* constrainedPoint(
+ ObjectCalcer* curve, const Coordinate& c, const KigDocument& ) const;
+
+ /**
+ * this returns a "sensible point".
+ * By a "sensible point", I mean a point that would be about what
+ * the user expects when he asks for a point at point \p c . This is a
+ * constrained point if \p c is on a curve, and otherwise a fixed
+ * point. I might add the possibility for an intersection point
+ * sometime.. Note that the returned object is not added to
+ * the document..
+ */
+ ObjectTypeCalcer* sensiblePointCalcer(
+ const Coordinate& c, const KigDocument& d, const KigWidget& w ) const;
+ ObjectHolder* sensiblePoint(
+ const Coordinate& c, const KigDocument& d, const KigWidget& w ) const;
+
+ /**
+ * set point to what sensiblePoint would have returned..
+ */
+ void redefinePoint( ObjectTypeCalcer* point, const Coordinate& c,
+ KigDocument& d, const KigWidget& w ) const;
+
+ /**
+ * return a locus, defined by the two points ( one constrained, and
+ * one following ) \p a and \p b . \p a should be the constrained point,
+ * and thus, it has to be of type ObjectTypeCalcer where a->type() is of
+ * type ConstrainedPointType. The semantics of LocusType are a bit
+ * weird ( but I believe correct :) ), so this function takes care
+ * of the complication there..
+ */
+ ObjectTypeCalcer* locusCalcer( ObjectCalcer* a, ObjectCalcer* b ) const;
+ ObjectHolder* locus( ObjectCalcer* a, ObjectCalcer* b ) const;
+
+ /**
+ * returns a label with text \p s at point \p c .. It ( and its parents )
+ * is calced already...
+ */
+ ObjectHolder* label(
+ const QString& s, const Coordinate& loc,
+ bool needframe, const std::vector<ObjectCalcer*>& parents,
+ const KigDocument& doc ) const;
+ ObjectTypeCalcer* labelCalcer(
+ const QString& s, const Coordinate& loc,
+ bool needframe, const std::vector<ObjectCalcer*>& parents,
+ const KigDocument& doc ) const;
+
+ /**
+ * this one does the same as the above, only that the new label is
+ * attached to locationparent if it is non-null..
+ */
+ ObjectTypeCalcer* attachedLabelCalcer(
+ const QString& s, ObjectCalcer* locationparent,
+ const Coordinate& loc, bool needframe,
+ const std::vector<ObjectCalcer*>& parents,
+ const KigDocument& doc ) const;
+ /**
+ * this has been added because it comes handy when redefining
+ * a text label, we move here all the code for getting an
+ * attach point from the method above
+ */
+ ObjectCalcer* getAttachPoint(
+ ObjectCalcer* locationparent,
+ const Coordinate& loc,
+ const KigDocument& doc ) const;
+ ObjectHolder* attachedLabel(
+ const QString& s, ObjectCalcer* locationparent,
+ const Coordinate& loc, bool needframe,
+ const std::vector<ObjectCalcer*>& parents,
+ const KigDocument& doc ) const;
+
+ /**
+ * returns a property object for the property \p p of object \p o .
+ *
+ * \note
+ * \p o should have already been calc'd, or this will fail and
+ * return 0.. The returned object also needs to be calced after
+ * this..
+ */
+ ObjectPropertyCalcer* propertyObjectCalcer( ObjectCalcer* o, const char* p ) const;
+ ObjectHolder* propertyObject( ObjectCalcer* o, const char* p ) const;
+};
+
+#endif