1999-09-10 02:25:47 -04:00
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
// Name: ogl.i
|
|
|
|
// Purpose: SWIG definitions for the wxWindows Object Graphics Library
|
|
|
|
//
|
|
|
|
// Author: Robin Dunn
|
|
|
|
//
|
|
|
|
// Created: 30-June-1999
|
|
|
|
// RCS-ID: $Id$
|
|
|
|
// Copyright: (c) 1998 by Total Control Software
|
|
|
|
// Licence: wxWindows license
|
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
2004-05-14 17:25:33 -04:00
|
|
|
%define DOCSTRING
|
|
|
|
"The Object Graphics Library provides for simple drawing and manipulation
|
2004-05-25 22:13:04 -04:00
|
|
|
of 2D objects. (This version is deprecated, please use wx.lib.ogl instead.)"
|
2004-05-14 17:25:33 -04:00
|
|
|
%enddef
|
2004-06-01 22:29:55 -04:00
|
|
|
|
|
|
|
%module(package="wx", docstring=DOCSTRING) ogl
|
1999-09-10 02:25:47 -04:00
|
|
|
|
|
|
|
%{
|
2003-11-12 16:34:20 -05:00
|
|
|
#include "wx/wxPython/wxPython.h"
|
|
|
|
#include "wx/wxPython/pyclasses.h"
|
1999-09-10 02:25:47 -04:00
|
|
|
#include "oglhelpers.h"
|
2003-11-12 16:34:20 -05:00
|
|
|
|
1999-09-10 02:25:47 -04:00
|
|
|
%}
|
|
|
|
|
|
|
|
//---------------------------------------------------------------------------
|
|
|
|
|
|
|
|
%import windows.i
|
2004-04-25 02:51:10 -04:00
|
|
|
%pythoncode { wx = _core }
|
2004-04-27 15:26:48 -04:00
|
|
|
%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
|
1999-09-10 02:25:47 -04:00
|
|
|
|
2004-05-25 22:13:04 -04:00
|
|
|
%pythoncode {
|
|
|
|
import warnings
|
2004-06-01 17:29:41 -04:00
|
|
|
warnings.warn("This module is deprecated. Please use the wx.lib.ogl package instead.",
|
2004-05-25 22:13:04 -04:00
|
|
|
DeprecationWarning, stacklevel=2)
|
|
|
|
}
|
|
|
|
|
2003-12-19 20:01:49 -05:00
|
|
|
|
|
|
|
MAKE_CONST_WXSTRING_NOSWIG(EmptyString);
|
|
|
|
|
2003-11-12 16:34:20 -05:00
|
|
|
%include _ogldefs.i
|
|
|
|
%include _oglbasic.i
|
|
|
|
%include _oglshapes.i
|
|
|
|
%include _oglshapes2.i
|
|
|
|
%include _oglcanvas.i
|
|
|
|
|
|
|
|
%pythoncode {
|
|
|
|
%# Aliases
|
|
|
|
ShapeCanvas = PyShapeCanvas
|
|
|
|
ShapeEvtHandler = PyShapeEvtHandler
|
|
|
|
Shape = PyShape
|
|
|
|
RectangleShape = PyRectangleShape
|
|
|
|
BitmapShape = PyBitmapShape
|
|
|
|
DrawnShape = PyDrawnShape
|
|
|
|
CompositeShape = PyCompositeShape
|
|
|
|
DividedShape = PyDividedShape
|
|
|
|
DivisionShape = PyDivisionShape
|
|
|
|
EllipseShape = PyEllipseShape
|
|
|
|
CircleShape = PyCircleShape
|
|
|
|
LineShape = PyLineShape
|
|
|
|
PolygonShape = PyPolygonShape
|
|
|
|
TextShape = PyTextShape
|
|
|
|
ControlPoint = PyControlPoint
|
|
|
|
}
|
1999-09-10 02:25:47 -04:00
|
|
|
|
|
|
|
|
|
|
|
//---------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
|
|
enum {
|
|
|
|
KEY_SHIFT,
|
|
|
|
KEY_CTRL,
|
|
|
|
ARROW_NONE,
|
|
|
|
ARROW_END,
|
|
|
|
ARROW_BOTH,
|
|
|
|
ARROW_MIDDLE,
|
|
|
|
ARROW_START,
|
|
|
|
ARROW_HOLLOW_CIRCLE,
|
|
|
|
ARROW_FILLED_CIRCLE,
|
|
|
|
ARROW_ARROW,
|
|
|
|
ARROW_SINGLE_OBLIQUE,
|
|
|
|
ARROW_DOUBLE_OBLIQUE,
|
|
|
|
ARROW_METAFILE,
|
|
|
|
ARROW_POSITION_END,
|
|
|
|
ARROW_POSITION_START,
|
|
|
|
CONTROL_POINT_VERTICAL,
|
|
|
|
CONTROL_POINT_HORIZONTAL,
|
|
|
|
CONTROL_POINT_DIAGONAL,
|
|
|
|
CONTROL_POINT_ENDPOINT_TO,
|
|
|
|
CONTROL_POINT_ENDPOINT_FROM,
|
|
|
|
CONTROL_POINT_LINE,
|
|
|
|
FORMAT_NONE,
|
|
|
|
FORMAT_CENTRE_HORIZ,
|
|
|
|
FORMAT_CENTRE_VERT,
|
|
|
|
FORMAT_SIZE_TO_CONTENTS,
|
|
|
|
LINE_ALIGNMENT_HORIZ,
|
|
|
|
LINE_ALIGNMENT_VERT,
|
|
|
|
LINE_ALIGNMENT_TO_NEXT_HANDLE,
|
|
|
|
LINE_ALIGNMENT_NONE,
|
|
|
|
SHADOW_NONE,
|
|
|
|
SHADOW_LEFT,
|
|
|
|
SHADOW_RIGHT,
|
|
|
|
// SHAPE_BASIC,
|
|
|
|
// SHAPE_RECTANGLE,
|
|
|
|
// SHAPE_ELLIPSE,
|
|
|
|
// SHAPE_POLYGON,
|
|
|
|
// SHAPE_CIRCLE,
|
|
|
|
// SHAPE_LINE,
|
|
|
|
// SHAPE_DIVIDED_RECTANGLE,
|
|
|
|
// SHAPE_COMPOSITE,
|
|
|
|
// SHAPE_CONTROL_POINT,
|
|
|
|
// SHAPE_DRAWN,
|
|
|
|
// SHAPE_DIVISION,
|
|
|
|
// SHAPE_LABEL_OBJECT,
|
|
|
|
// SHAPE_BITMAP,
|
|
|
|
// SHAPE_DIVIDED_OBJECT_CONTROL_POINT,
|
|
|
|
// OBJECT_REGION,
|
|
|
|
OP_CLICK_LEFT,
|
|
|
|
OP_CLICK_RIGHT,
|
|
|
|
OP_DRAG_LEFT,
|
|
|
|
OP_DRAG_RIGHT,
|
|
|
|
OP_ALL,
|
|
|
|
ATTACHMENT_MODE_NONE,
|
|
|
|
ATTACHMENT_MODE_EDGE,
|
|
|
|
ATTACHMENT_MODE_BRANCHING,
|
|
|
|
BRANCHING_ATTACHMENT_NORMAL,
|
|
|
|
BRANCHING_ATTACHMENT_BLOB,
|
|
|
|
|
|
|
|
gyCONSTRAINT_CENTRED_VERTICALLY,
|
|
|
|
gyCONSTRAINT_CENTRED_HORIZONTALLY,
|
|
|
|
gyCONSTRAINT_CENTRED_BOTH,
|
|
|
|
gyCONSTRAINT_LEFT_OF,
|
|
|
|
gyCONSTRAINT_RIGHT_OF,
|
|
|
|
gyCONSTRAINT_ABOVE,
|
|
|
|
gyCONSTRAINT_BELOW,
|
|
|
|
gyCONSTRAINT_ALIGNED_TOP,
|
|
|
|
gyCONSTRAINT_ALIGNED_BOTTOM,
|
|
|
|
gyCONSTRAINT_ALIGNED_LEFT,
|
|
|
|
gyCONSTRAINT_ALIGNED_RIGHT,
|
|
|
|
gyCONSTRAINT_MIDALIGNED_TOP,
|
|
|
|
gyCONSTRAINT_MIDALIGNED_BOTTOM,
|
|
|
|
gyCONSTRAINT_MIDALIGNED_LEFT,
|
|
|
|
gyCONSTRAINT_MIDALIGNED_RIGHT,
|
|
|
|
|
|
|
|
DIVISION_SIDE_NONE,
|
|
|
|
DIVISION_SIDE_LEFT,
|
|
|
|
DIVISION_SIDE_TOP,
|
|
|
|
DIVISION_SIDE_RIGHT,
|
|
|
|
DIVISION_SIDE_BOTTOM,
|
|
|
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
//---------------------------------------------------------------------------
|
|
|
|
|
2004-06-01 17:29:41 -04:00
|
|
|
MustHaveApp(wxOGLInitialize);
|
1999-09-10 02:25:47 -04:00
|
|
|
void wxOGLInitialize();
|
2004-06-01 17:29:41 -04:00
|
|
|
|
|
|
|
MustHaveApp(wxOGLCleanUp);
|
1999-09-10 02:25:47 -04:00
|
|
|
void wxOGLCleanUp();
|
|
|
|
|
|
|
|
|
2000-12-21 19:06:04 -05:00
|
|
|
%{
|
1999-09-10 02:25:47 -04:00
|
|
|
//---------------------------------------------------------------------------
|
2000-12-21 19:06:04 -05:00
|
|
|
|
2003-11-12 16:34:20 -05:00
|
|
|
// Convert from a Python list to a list of className objects. This one will
|
|
|
|
// work for any class for the VERY generic cases, but beyond that the helper
|
|
|
|
// needs to know more about the type.
|
|
|
|
wxList* wxPy_wxListHelper(PyObject* pyList, const wxChar* className) {
|
2005-03-09 17:28:52 -05:00
|
|
|
wxPyBlock_t blocked = wxPyBeginBlockThreads();
|
2000-12-21 19:06:04 -05:00
|
|
|
if (!PyList_Check(pyList)) {
|
|
|
|
PyErr_SetString(PyExc_TypeError, "Expected a list object.");
|
2004-03-24 18:09:59 -05:00
|
|
|
wxPyEndBlockThreads(blocked);
|
2000-12-21 19:06:04 -05:00
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
int count = PyList_Size(pyList);
|
|
|
|
wxList* list = new wxList;
|
|
|
|
if (! list) {
|
|
|
|
PyErr_SetString(PyExc_MemoryError, "Unable to allocate wxList object");
|
2004-03-24 18:09:59 -05:00
|
|
|
wxPyEndBlockThreads(blocked);
|
2000-12-21 19:06:04 -05:00
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
for (int x=0; x<count; x++) {
|
|
|
|
PyObject* pyo = PyList_GetItem(pyList, x);
|
|
|
|
wxObject* wxo = NULL;
|
|
|
|
|
2003-11-12 16:34:20 -05:00
|
|
|
if ( !wxPyConvertSwigPtr(pyo, (void **)&wxo, className) ) {
|
|
|
|
wxString errmsg;
|
|
|
|
errmsg.Printf(wxT("Type error, expected list of %s objects"), className);
|
|
|
|
PyErr_SetString(PyExc_TypeError, errmsg.mb_str());
|
2004-03-24 18:09:59 -05:00
|
|
|
wxPyEndBlockThreads(blocked);
|
2000-12-21 19:06:04 -05:00
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
list->Append(wxo);
|
|
|
|
}
|
2004-03-24 18:09:59 -05:00
|
|
|
wxPyEndBlockThreads(blocked);
|
2000-12-21 19:06:04 -05:00
|
|
|
return list;
|
|
|
|
}
|
|
|
|
|
1999-09-10 02:25:47 -04:00
|
|
|
//---------------------------------------------------------------------------
|
2000-12-21 19:06:04 -05:00
|
|
|
|
|
|
|
wxList* wxPy_wxRealPoint_ListHelper(PyObject* pyList) {
|
2005-03-09 17:28:52 -05:00
|
|
|
wxPyBlock_t blocked = wxPyBeginBlockThreads();
|
2000-12-21 19:06:04 -05:00
|
|
|
if (!PyList_Check(pyList)) {
|
|
|
|
PyErr_SetString(PyExc_TypeError, "Expected a list object.");
|
2004-03-24 18:09:59 -05:00
|
|
|
wxPyEndBlockThreads(blocked);
|
2000-12-21 19:06:04 -05:00
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
int count = PyList_Size(pyList);
|
|
|
|
wxList* list = new wxList;
|
|
|
|
if (! list) {
|
|
|
|
PyErr_SetString(PyExc_MemoryError, "Unable to allocate wxList object");
|
2004-03-24 18:09:59 -05:00
|
|
|
wxPyEndBlockThreads(blocked);
|
2000-12-21 19:06:04 -05:00
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
for (int x=0; x<count; x++) {
|
|
|
|
PyObject* pyo = PyList_GetItem(pyList, x);
|
|
|
|
|
|
|
|
if (PyTuple_Check(pyo)) {
|
|
|
|
PyObject* o1 = PyNumber_Float(PyTuple_GetItem(pyo, 0));
|
|
|
|
PyObject* o2 = PyNumber_Float(PyTuple_GetItem(pyo, 1));
|
|
|
|
|
|
|
|
double val1 = (o1 ? PyFloat_AsDouble(o1) : 0.0);
|
|
|
|
double val2 = (o2 ? PyFloat_AsDouble(o2) : 0.0);
|
|
|
|
|
|
|
|
list->Append((wxObject*) new wxRealPoint(val1, val2));
|
|
|
|
|
|
|
|
} else {
|
|
|
|
wxRealPoint* wxo = NULL;
|
2003-11-12 16:34:20 -05:00
|
|
|
if (wxPyConvertSwigPtr(pyo, (void **)&wxo, wxT("wxRealPoint"))) {
|
2000-12-21 19:06:04 -05:00
|
|
|
PyErr_SetString(PyExc_TypeError, "Type error, expected list of wxRealPoint objects or 2-tuples");
|
2004-03-24 18:09:59 -05:00
|
|
|
wxPyEndBlockThreads(blocked);
|
2000-12-21 19:06:04 -05:00
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
list->Append((wxObject*) new wxRealPoint(*wxo));
|
|
|
|
}
|
|
|
|
}
|
2004-03-24 18:09:59 -05:00
|
|
|
wxPyEndBlockThreads(blocked);
|
2000-12-21 19:06:04 -05:00
|
|
|
return list;
|
|
|
|
}
|
|
|
|
|
2001-11-26 21:56:59 -05:00
|
|
|
//---------------------------------------------------------------------------
|
|
|
|
|
2004-06-30 16:12:14 -04:00
|
|
|
PyObject* wxPyMake_wxShapeEvtHandler(wxShapeEvtHandler* source, bool setThisOwn) {
|
2001-11-26 21:56:59 -05:00
|
|
|
PyObject* target = NULL;
|
|
|
|
|
|
|
|
if (source && wxIsKindOf(source, wxShapeEvtHandler)) {
|
|
|
|
// If it's derived from wxShapeEvtHandler then there may
|
|
|
|
// already be a pointer to a Python object that we can use
|
|
|
|
// in the OOR data.
|
|
|
|
wxShapeEvtHandler* seh = (wxShapeEvtHandler*)source;
|
2002-04-09 18:01:45 -04:00
|
|
|
wxPyOORClientData* data = (wxPyOORClientData*)seh->GetClientObject();
|
2001-11-26 21:56:59 -05:00
|
|
|
if (data) {
|
|
|
|
target = data->m_obj;
|
|
|
|
Py_INCREF(target);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if (! target) {
|
2004-06-30 16:12:14 -04:00
|
|
|
target = wxPyMake_wxObject2(source, setThisOwn, false);
|
2001-11-26 21:56:59 -05:00
|
|
|
if (target != Py_None)
|
2002-04-09 18:01:45 -04:00
|
|
|
((wxShapeEvtHandler*)source)->SetClientObject(new wxPyOORClientData(target));
|
2001-11-26 21:56:59 -05:00
|
|
|
}
|
|
|
|
return target;
|
|
|
|
}
|
|
|
|
|
2002-04-11 19:12:02 -04:00
|
|
|
//---------------------------------------------------------------------------
|
|
|
|
|
2004-05-07 17:34:14 -04:00
|
|
|
PyObject* wxPy_ConvertRealPointList(wxListBase* listbase) {
|
|
|
|
wxList* list = (wxList*)listbase;
|
|
|
|
PyObject* pyList;
|
|
|
|
PyObject* pyObj;
|
|
|
|
wxObject* wxObj;
|
|
|
|
wxNode* node = list->GetFirst();
|
|
|
|
|
2005-03-09 17:28:52 -05:00
|
|
|
wxPyBlock_t blocked = wxPyBeginBlockThreads();
|
2004-05-07 17:34:14 -04:00
|
|
|
pyList = PyList_New(0);
|
|
|
|
while (node) {
|
|
|
|
wxObj = node->GetData();
|
|
|
|
pyObj = wxPyConstructObject(wxObj, wxT("wxRealPoint"), 0);
|
|
|
|
PyList_Append(pyList, pyObj);
|
|
|
|
node = node->GetNext();
|
|
|
|
}
|
|
|
|
wxPyEndBlockThreads(blocked);
|
|
|
|
return pyList;
|
2004-05-07 15:52:02 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
//---------------------------------------------------------------------------
|
|
|
|
|
2003-11-12 16:34:20 -05:00
|
|
|
PyObject* wxPy_ConvertShapeList(wxListBase* listbase) {
|
2003-03-25 12:10:57 -05:00
|
|
|
wxList* list = (wxList*)listbase;
|
2002-04-11 19:12:02 -04:00
|
|
|
PyObject* pyList;
|
|
|
|
PyObject* pyObj;
|
|
|
|
wxObject* wxObj;
|
2003-03-25 12:10:57 -05:00
|
|
|
wxNode* node = list->GetFirst();
|
2002-04-11 19:12:02 -04:00
|
|
|
|
2005-03-09 17:28:52 -05:00
|
|
|
wxPyBlock_t blocked = wxPyBeginBlockThreads();
|
2002-04-11 19:12:02 -04:00
|
|
|
pyList = PyList_New(0);
|
|
|
|
while (node) {
|
2003-03-25 12:10:57 -05:00
|
|
|
wxObj = node->GetData();
|
2004-06-30 16:12:14 -04:00
|
|
|
pyObj = wxPyMake_wxShapeEvtHandler((wxShapeEvtHandler*)wxObj, false);
|
2002-04-11 19:12:02 -04:00
|
|
|
PyList_Append(pyList, pyObj);
|
2003-03-25 12:10:57 -05:00
|
|
|
node = node->GetNext();
|
2002-04-11 19:12:02 -04:00
|
|
|
}
|
2004-03-24 18:09:59 -05:00
|
|
|
wxPyEndBlockThreads(blocked);
|
2002-04-11 19:12:02 -04:00
|
|
|
return pyList;
|
|
|
|
}
|
2001-11-26 21:56:59 -05:00
|
|
|
|
2000-12-21 19:06:04 -05:00
|
|
|
|
1999-09-10 02:25:47 -04:00
|
|
|
//---------------------------------------------------------------------------
|
2000-12-21 19:06:04 -05:00
|
|
|
|
2001-05-17 18:47:09 -04:00
|
|
|
IMPLEMENT_DYNAMIC_CLASS(wxPyShapeCanvas, wxShapeCanvas);
|
|
|
|
IMPLEMENT_DYNAMIC_CLASS(wxPyShapeEvtHandler, wxShapeEvtHandler);
|
|
|
|
IMPLEMENT_ABSTRACT_CLASS(wxPyShape, wxShape);
|
|
|
|
IMPLEMENT_DYNAMIC_CLASS(wxPyRectangleShape, wxRectangleShape);
|
|
|
|
IMPLEMENT_DYNAMIC_CLASS(wxPyControlPoint, wxControlPoint);
|
|
|
|
IMPLEMENT_DYNAMIC_CLASS(wxPyBitmapShape, wxBitmapShape);
|
|
|
|
IMPLEMENT_DYNAMIC_CLASS(wxPyDrawnShape, wxDrawnShape);
|
|
|
|
IMPLEMENT_DYNAMIC_CLASS(wxPyCompositeShape, wxCompositeShape);
|
|
|
|
IMPLEMENT_DYNAMIC_CLASS(wxPyDividedShape, wxDividedShape);
|
|
|
|
IMPLEMENT_DYNAMIC_CLASS(wxPyDivisionShape, wxDivisionShape);
|
|
|
|
IMPLEMENT_DYNAMIC_CLASS(wxPyEllipseShape, wxEllipseShape);
|
|
|
|
IMPLEMENT_DYNAMIC_CLASS(wxPyCircleShape, wxCircleShape);
|
|
|
|
IMPLEMENT_DYNAMIC_CLASS(wxPyLineShape, wxLineShape);
|
|
|
|
IMPLEMENT_DYNAMIC_CLASS(wxPyPolygonShape, wxPolygonShape);
|
|
|
|
IMPLEMENT_DYNAMIC_CLASS(wxPyTextShape, wxTextShape);
|
|
|
|
|
|
|
|
//---------------------------------------------------------------------------
|
2000-12-21 19:06:04 -05:00
|
|
|
|
2003-11-12 16:34:20 -05:00
|
|
|
// extern "C" SWIGEXPORT(void) initoglbasicc();
|
|
|
|
// extern "C" SWIGEXPORT(void) initoglshapesc();
|
|
|
|
// extern "C" SWIGEXPORT(void) initoglshapes2c();
|
|
|
|
// extern "C" SWIGEXPORT(void) initoglcanvasc();
|
1999-09-10 02:25:47 -04:00
|
|
|
%}
|
|
|
|
|
1999-09-13 15:28:10 -04:00
|
|
|
|
1999-09-10 02:25:47 -04:00
|
|
|
%init %{
|
|
|
|
|
2003-11-12 16:34:20 -05:00
|
|
|
// initoglbasicc();
|
|
|
|
// initoglshapesc();
|
|
|
|
// initoglshapes2c();
|
|
|
|
// initoglcanvasc();
|
1999-09-10 02:25:47 -04:00
|
|
|
|
|
|
|
|
2001-05-18 02:53:25 -04:00
|
|
|
wxPyPtrTypeMap_Add("wxControlPoint", "wxPyControlPoint");
|
|
|
|
wxPyPtrTypeMap_Add("wxShapeCanvas", "wxPyShapeCanvas");
|
|
|
|
wxPyPtrTypeMap_Add("wxShapeEvtHandler", "wxPyShapeEvtHandler");
|
|
|
|
wxPyPtrTypeMap_Add("wxShape", "wxPyShape");
|
|
|
|
wxPyPtrTypeMap_Add("wxRectangleShape", "wxPyRectangleShape");
|
|
|
|
wxPyPtrTypeMap_Add("wxDrawnShape", "wxPyDrawnShape");
|
|
|
|
wxPyPtrTypeMap_Add("wxCompositeShape", "wxPyCompositeShape");
|
|
|
|
wxPyPtrTypeMap_Add("wxDividedShape", "wxPyDividedShape");
|
|
|
|
wxPyPtrTypeMap_Add("wxDivisionShape", "wxPyDivisionShape");
|
|
|
|
wxPyPtrTypeMap_Add("wxEllipseShape", "wxPyEllipseShape");
|
|
|
|
wxPyPtrTypeMap_Add("wxCircleShape", "wxPyCircleShape");
|
|
|
|
wxPyPtrTypeMap_Add("wxLineShape", "wxPyLineShape");
|
|
|
|
wxPyPtrTypeMap_Add("wxPolygonShape", "wxPyPolygonShape");
|
|
|
|
wxPyPtrTypeMap_Add("wxTextShape", "wxPyTextShape");
|
|
|
|
|
1999-09-10 02:25:47 -04:00
|
|
|
%}
|
|
|
|
|
|
|
|
//---------------------------------------------------------------------------
|
|
|
|
//---------------------------------------------------------------------------
|