summaryrefslogtreecommitdiffstats
path: root/scribus/plugins/scriptplugin/cmdobj.h
diff options
context:
space:
mode:
Diffstat (limited to 'scribus/plugins/scriptplugin/cmdobj.h')
-rw-r--r--scribus/plugins/scriptplugin/cmdobj.h263
1 files changed, 263 insertions, 0 deletions
diff --git a/scribus/plugins/scriptplugin/cmdobj.h b/scribus/plugins/scriptplugin/cmdobj.h
new file mode 100644
index 0000000..d44ac6f
--- /dev/null
+++ b/scribus/plugins/scriptplugin/cmdobj.h
@@ -0,0 +1,263 @@
+/*
+For general Scribus (>=1.3.2) copyright and licensing information please refer
+to the COPYING file provided with the program. Following this notice may exist
+a copyright and/or license notice that predates the release of Scribus 1.3.2
+for which a new license (GPL+exception) is in place.
+*/
+#ifndef CMDOBJ_H
+#define CMDOBJ_H
+
+// Pulls in <Python.h> first
+#include "cmdvar.h"
+
+/** Object related Commands */
+
+/*! docstring */
+PyDoc_STRVAR(scribus_newrect__doc__,
+QT_TR_NOOP("createRect(x, y, width, height, [\"name\"]) -> string\n\
+\n\
+Creates a new rectangle on the current page and returns its name. The\n\
+coordinates are given in the current measurement units of the document\n\
+(see UNIT constants). \"name\" should be a unique identifier for the object\n\
+because you need this name to reference that object in future. If \"name\"\n\
+is not given Scribus will create one for you.\n\
+\n\
+May raise NameExistsError if you explicitly pass a name that's already used.\n\
+"));
+/** Creates a rectangular with params X, Y (base position)
+ b, h (width, height) and optional name of the object.
+ */
+PyObject *scribus_newrect(PyObject * /*self*/, PyObject* args);
+
+/*! docstring */
+PyDoc_STRVAR(scribus_newellipse__doc__,
+QT_TR_NOOP("createEllipse(x, y, width, height, [\"name\"]) -> string\n\
+\n\
+Creates a new ellipse on the current page and returns its name.\n\
+The coordinates are given in the current measurement units of the document\n\
+(see UNIT constants). \"name\" should be a unique identifier for the object\n\
+because you need this name for further referencing of that object. If \"name\"\n\
+is not given Scribus will create one for you.\n\
+\n\
+May raise NameExistsError if you explicitly pass a name that's already used.\n\
+"));
+/** Creates an ellipse with x, y, b and h - name optionally
+ params.
+ */
+PyObject *scribus_newellipse(PyObject * /*self*/, PyObject* args);
+
+/*! docstring */
+PyDoc_STRVAR(scribus_newimage__doc__,
+QT_TR_NOOP("createImage(x, y, width, height, [\"name\"]) -> string\n\
+\n\
+Creates a new picture frame on the current page and returns its name. The\n\
+coordinates are given in the current measurement units of the document.\n\
+\"name\" should be a unique identifier for the object because you need this\n\
+name for further access to that object. If \"name\" is not given Scribus will\n\
+create one for you.\n\
+\n\
+May raise NameExistsError if you explicitly pass a name that's already used.\n\
+"));
+/** Creates an image frame - x, y, b, h and opt. name. */
+PyObject *scribus_newimage(PyObject * /*self*/, PyObject* args);
+
+/*! docstring */
+PyDoc_STRVAR(scribus_newtext__doc__,
+QT_TR_NOOP("createText(x, y, width, height, [\"name\"]) -> string\n\
+\n\
+Creates a new text frame on the actual page and returns its name.\n\
+The coordinates are given in the actual measurement unit of the document (see\n\
+UNIT constants). \"name\" should be a unique identifier for the object because\n\
+you need this name for further referencing of that object. If \"name\" is not\n\
+given Scribus will create one for you.\n\
+\n\
+May raise NameExistsError if you explicitly pass a name that's already used.\n\
+"));
+/** Creates a text frame - x, y, b, h and opt. name. */
+PyObject *scribus_newtext(PyObject * /*self*/, PyObject* args);
+
+/*! docstring */
+PyDoc_STRVAR(scribus_newline__doc__,
+QT_TR_NOOP("createLine(x1, y1, x2, y2, [\"name\"]) -> string\n\
+\n\
+Creates a new line from the point(x1, y1) to the point(x2, y2) and returns\n\
+its name. The coordinates are given in the current measurement unit of the\n\
+document (see UNIT constants). \"name\" should be a unique identifier for the\n\
+object because you need this name for further access to that object. If\n\
+\"name\" is not given Scribus will create one for you.\n\
+\n\
+May raise NameExistsError if you explicitly pass a name that's already used.\n\
+"));
+/** Creates a line object - x, y, b, h and opt. name. */
+PyObject *scribus_newline(PyObject * /*self*/, PyObject* args);
+
+/*! docstring */
+PyDoc_STRVAR(scribus_polyline__doc__,
+QT_TR_NOOP("createPolyLine(list, [\"name\"]) -> string\n\
+\n\
+Creates a new polyline and returns its name. The points for the polyline are\n\
+stored in the list \"list\" in the following order: [x1, y1, x2, y2...xn. yn].\n\
+The coordinates are given in the current measurement units of the document (see\n\
+UNIT constants). \"name\" should be a unique identifier for the object because\n\
+you need this name for further access to that object. If \"name\" is not given\n\
+Scribus will create one for you.\n\
+\n\
+May raise NameExistsError if you explicitly pass a name that's already used.\n\
+May raise ValueError if an insufficient number of points is passed or if\n\
+the number of values passed don't group into points without leftovers.\n\
+"));
+/** Creates a polygon line - list with points and opt. name as params. */
+PyObject *scribus_polyline(PyObject * /*self*/, PyObject* args);
+
+/*! docstring */
+PyDoc_STRVAR(scribus_polygon__doc__,
+QT_TR_NOOP("createPolygon(list, [\"name\"]) -> string\n\
+\n\
+Creates a new polygon and returns its name. The points for the polygon are\n\
+stored in the list \"list\" in the following order: [x1, y1, x2, y2...xn. yn].\n\
+At least three points are required. There is no need to repeat the first point\n\
+to close the polygon. The polygon is automatically closed by connecting the\n\
+first and the last point. The coordinates are given in the current measurement\n\
+units of the document (see UNIT constants). \"name\" should be a unique\n\
+identifier for the object because you need this name for further access to that\n\
+object. If \"name\" is not given Scribus will create one for you.\n\
+\n\
+May raise NameExistsError if you explicitly pass a name that's already used.\n\
+May raise ValueError if an insufficient number of points is passed or if\n\
+the number of values passed don't group into points without leftovers.\n\
+"));
+/** Creates a polygon - list with points and opt. name as params. */
+PyObject *scribus_polygon(PyObject * /*self*/, PyObject* args);
+
+/*! docstring */
+PyDoc_STRVAR(scribus_bezierline__doc__,
+QT_TR_NOOP("createBezierLine(list, [\"name\"]) -> string\n\
+\n\
+Creates a new bezier curve and returns its name. The points for the bezier\n\
+curve are stored in the list \"list\" in the following order:\n\
+[x1, y1, kx1, ky1, x2, y2, kx2, ky2...xn. yn, kxn. kyn]\n\
+In the points list, x and y mean the x and y coordinates of the point and kx\n\
+and ky meaning the control point for the curve. The coordinates are given in\n\
+the current measurement units of the document (see UNIT constants). \"name\"\n\
+should be a unique identifier for the object because you need this name for\n\
+further access to that object. If \"name\" is not given Scribus will create one\n\
+for you.\n\
+\n\
+May raise NameExistsError if you explicitly pass a name that's already used.\n\
+May raise ValueError if an insufficient number of points is passed or if\n\
+the number of values passed don't group into points without leftovers.\n\
+"));
+/** Creates a Bezier line - list with points and opt. name as params. */
+PyObject *scribus_bezierline(PyObject * /*self*/, PyObject* args);
+
+/*! docstring */
+PyDoc_STRVAR(scribus_pathtext__doc__,
+QT_TR_NOOP("createPathText(x, y, \"textbox\", \"beziercurve\", [\"name\"]) -> string\n\
+\n\
+Creates a new pathText by merging the two objects \"textbox\" and\n\
+\"beziercurve\" and returns its name. The coordinates are given in the current\n\
+measurement unit of the document (see UNIT constants). \"name\" should be a\n\
+unique identifier for the object because you need this name for further access\n\
+to that object. If \"name\" is not given Scribus will create one for you.\n\
+\n\
+May raise NameExistsError if you explicitly pass a name that's already used.\n\
+May raise NotFoundError if one or both of the named base object don't exist.\n\
+"));
+/** Joins 2 objects - textframe and line - into text on path.
+ Uses x, y (base of the new object), name of the text frame,
+ name of the line and opt. new name as params. */
+PyObject *scribus_pathtext(PyObject * /*self*/, PyObject* args);
+
+/*! docstring */
+PyDoc_STRVAR(scribus_deleteobj__doc__,
+QT_TR_NOOP("deleteObject([\"name\"])\n\
+\n\
+Deletes the item with the name \"name\". If \"name\" is not given the currently\n\
+selected item is deleted.\n\
+"));
+/** Deletes an object - if is the name given the named object is
+ deleted else the active object erased. */
+PyObject *scribus_deleteobj(PyObject * /*self*/, PyObject* args);
+
+/*! docstring */
+PyDoc_STRVAR(scribus_textflow__doc__,
+QT_TR_NOOP("textFlowMode(\"name\" [, state])\n\
+\n\
+Enables/disables \"Text Flows Around Frame\" feature for object \"name\".\n\
+Called with parameters string name and optional int \"state\" (0 <= state <= 3).\n\
+Setting \"state\" to 0 will disable text flow.\n\
+Setting \"state\" to 1 will make text flow around object frame.\n\
+Setting \"state\" to 2 will make text flow around bounding box.\n\
+Setting \"state\" to 3 will make text flow around contour line.\n\
+If \"state\" is not passed, text flow is toggled.\n\
+"));
+/**
+Enables/disables "Text Flows Around Object" feature for object.
+Called with params string objectName and state 0|1|2|3.
+When set to 0 disable flowing, 1 text flows around frame,
+2 around bounding box, 3 around contour line. When is second param
+empty flowing is reverted.
+02/28/2004 petr vanek
+ */
+PyObject *scribus_textflow(PyObject * /*self*/, PyObject* args);
+
+/*! docstring */
+PyDoc_STRVAR(scribus_objectexists__doc__,
+QT_TR_NOOP("objectExists([\"name\"]) -> bool\n\
+\n\
+Test if an object with specified name really exists in the document.\n\
+The optional parameter is the object name. When no object name is given,\n\
+returns True if there is something selected.\n\
+"));
+/**
+User test if an object with specified name really exists in
+the doc. Object name as param.
+03/29/2004 petr vanek
+ObjectName is now optional. When none set, search for selection...
+07/11/2004 pv
+*/
+PyObject *scribus_objectexists(PyObject * /*self*/, PyObject* args);
+
+/*! docstring */
+PyDoc_STRVAR(scribus_setstyle__doc__,
+QT_TR_NOOP("setStyle(\"style\" [, \"name\"])\n\
+\n\
+Apply the named \"style\" to the object named \"name\". If is no object name\n\
+given, it's applied on the selected object.\n\
+"));
+/**
+ Craig Ringer, 2004-09-09
+ Apply the named style to the currently selected object.
+ pv, 2004-09-13, optionaly param objectName + "check the page" stuff
+ */
+PyObject *scribus_setstyle(PyObject * /*self*/, PyObject* args);
+
+/*! docstring */
+PyDoc_STRVAR(scribus_getstylenames__doc__,
+QT_TR_NOOP("getAllStyles() -> list\n\
+\n\
+Return a list of the names of all paragraph styles in the current document.\n\
+"));
+/**
+ Craig Ringer, 2004-09-09
+ Enumerate all known paragraph styles
+*/
+PyObject *scribus_getstylenames(PyObject * /*self*/);
+
+/*! docstring */
+PyDoc_STRVAR(scribus_duplicateobject__doc__,
+QT_TR_NOOP("duplicateObject([\"name\"]) -> string\n\
+\n\
+creates a Duplicate of the selected Object (or Selection Group).\n\
+"));
+/**
+ Christian Hausknecht, 2006-07-12
+ duplicate an object
+*/
+PyObject *scribus_duplicateobject(PyObject * /* self */, PyObject *args);
+
+/* Internal function not intended for general use; no docstring */
+PyObject* scribus_getframetype(PyObject* self, PyObject* args, PyObject* kw);
+
+#endif
+