head	1.7;
access;
symbols
	PyQwt3D-0-1-6:1.7
	PyQwt3D-0-1-5:1.7
	start:1.1.1.1
	gvermeul:1.1.1;
locks; strict;
comment	@# @;


1.7
date	2006.10.29.07.59.47;	author gvermeul;	state Exp;
branches;
next	1.6;

1.6
date	2006.02.18.09.39.58;	author gvermeul;	state Exp;
branches;
next	1.5;

1.5
date	2005.02.26.02.25.31;	author gvermeul;	state Exp;
branches;
next	1.4;

1.4
date	2004.11.23.05.39.34;	author gvermeul;	state Exp;
branches;
next	1.3;

1.3
date	2004.11.16.18.58.13;	author gvermeul;	state Exp;
branches;
next	1.2;

1.2
date	2004.11.14.12.03.41;	author gvermeul;	state Exp;
branches;
next	1.1;

1.1
date	2004.11.14.06.58.30;	author gvermeul;	state Exp;
branches
	1.1.1.1;
next	;

1.1.1.1
date	2004.11.14.06.58.30;	author gvermeul;	state Exp;
branches;
next	;


desc
@@


1.7
log
@Prepare release 0.1.2.
----------------------------------------------------------------------
@
text
@INTRODUCTION

PyQwt3D is a set of Python bindings for the QwtPlot3D library.


LICENSE

GPL with an exception allowing dynamic linking with the non-free versions of
Qt and PyQt.


PREREQUISITES

See Doc/html/pyqwt3d/prerequisites.html.


INSTALLATION

See Doc/html/pyqwt3d/install.html.


Have fun -- Gerard Vermeulen


..
   Local Variables:
   mode: indented-text
   indent-tabs-mode: nil
   sentence-end-double-space: t
   fill-column: 79
   End:
@


1.6
log
@Prepare release 0.1.1.
@
text
@d8 2
a9 1
GPL. Contact me, if this poses a problem for you. 
@


1.5
log
@Do not duplicate information which can be found in Doc/html/pyqwt3d.
@
text
@d8 1
a8 2
GPL with exceptions for use with non-GPL'ed releases of Qt, PyQt and sip (see
the file COPYING.PyQwt3D
@


1.4
log
@Fix typo and formatting
@
text
@d6 6
d14 1
a14 7
- Python-2.3 or later (tested with Python-2.3.x)
- sip-4.0 or later (tested with sip-4.1.1)
- PyQt-3.10 or later (tested with PyQt-3.13)
- qwtplot3d-0.2.4 (http://qwtplot3d.sourceforge.net)
- Qt-3.0 or later (tested with Qt-3.2.x and Qt-3.3.x)
- numarray (optional, compiles with numarray-1.x but see BUGS)
- Numeric (optional, tested with Numeric-23.x)
d19 1
a19 72
If you do not have GNU make, do:
(1) cd configure
(2) python configure.py (run 'python configure.py -h' to see all options)
(3) make ('nmake' for MSVC)
(4) make install ('nmake install' for MSVC)

If you have GNU make, edit INCDIR and LIBDIR in the Makefile and do:
(1) make
(2) make install

Runtime type information (RTTI) must be enabled.


INNOVATIONS (for SIP hackers and normal users)

The virtual operater() member functions of Function and ParametricSurface have
been implemented by shadow classes, see: Qwt3D/__init__.py,
sip/qwt3d_function.sip and sip/qwt3d_parametricsurface.sip (for hackers). 
 
PyQwt3D has a partial interface to the following C++ std::vector templates (for
users):
(1) AxisVector      (std::vector<Axis>)
(2) Cell            (std::vector<unsigned>)
(3) CellField       (std::vector<Cell>)
(4) ColorVector     (std::vector<RGBA>)
(5) DoubleVector    (std::vector<double>)
(6) FreeVectorField (std::vector<FreeVectorField>)
(7) TripleField     (std::vector<Triple>)

The interface implements four constructors for each template instantianation --
taking Cell as example:
(1) Cell()
(2) Cell(size)
(3) Cell(size, item)
(4) Cell(otherCell)

and 13 member functions -- taking Cell as example:
( 1) result = cell.capacity()
( 2) cell.clear()
( 3) result = cell.empty()
( 4) result = cell.back()
( 5) result = cell.front()
( 6) result = cell.max_size()
( 7) cell.pop_back()
( 8) cell.push_back(item)
( 9) cell.reserve(size)
(10) cell.reserve(size, item = 0)
(11) cell.resize(size, item = 0)
(12) result = cell.size()
(13) cell.swap(otherCell)

Iterators are not yet implemented.  However, the implementation of the Python
slots __getitem__, __len__ and __setitem__ let you use those classes almost as
a sequence.  For instance:

tf = TripleField()
tf.push_back(Triple(0.0, 1.0, 2.0))
tf.push_back(Triple(1.0, 2.0, 3.0))
for t in tf:                                 # thanks to __getitem__
    print t.x, t.y, t.z
for i in range(len(tf)):                     # thanks to __len__
    print tf[i].x, tf[i].y, tf[i].z          # thanks to __getitem__
for i in range(len(tf)):                     # thanks to __len__
    tf[i] = Triple(i, 2*i, 3*i)              # thanks to __setitem__


BUGS

PyQwt3D may not work with numarray, possibly due to a bug in the floating point
excepion handling of glibc (occurs at least on Mandrake-10.0 and SuSE-9.0).
See http://sourceforge.net/mailarchive/message.php?msg_id=9914816 for more
information.  Your mileage may vary: PyQwt3D works with numarray on SuSE-9.1.
@


1.3
log
@PyQwt3D works with numarray on SuSE-9.1.
@
text
@d34 3
a36 4
The virtual operater() member functions of Function and
ParametricSurface have been implemented by shadow classes,
see: Qwt3D/__init__.py, sip/qwt3d_function.sip and
sip/qwt3d_parametricsurface.sip (for hackers). 
d38 2
a39 2
PyQwt3D has a partial interface to the following C++ std::vector
templates (for users):
d48 2
a49 2
The interface implements for each template instantianation four
constructors -- taking Cell as example:
d70 3
a72 3
Iterators are not yet implemented. However, the implementation of the
Python slots __getitem__, __len__ and __setitem__ let you use those
classes almost as a sequence. For instance:
d80 1
a80 1
    print t[i].x, t[i].y, t[i].z             # thanks to __getitem__
d87 4
a90 6
PyQwt3D may not work with numarray, possibly due to a bug in the
floating point excepion handling of glibc (occurs at least on
Mandrake-10.0 and SuSE-9.0).
See http://sourceforge.net/mailarchive/message.php?msg_id=9914816 for
more information.  Your mileage may vary: PyQwt3D works with numarray
on SuSE-9.1.
d94 9
@


1.2
log
@Complete README
@
text
@d92 2
a93 1
more information.  Your mileage may vary.
@


1.1
log
@Initial revision
@
text
@d13 1
a13 1
- numarray (optional, tested with numarray-1.x)
d29 1
a30 1
FEATURES
d32 52
a83 1
__call__ in PyFunction, PyParametricSurface
d88 2
a89 2
PyQwt3D may not work with libnumarray, possibly to a bug in the
floating point  excepion handling of glibc (occurs at least on
@


1.1.1.1
log
@Initial import.
@
text
@@
