1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
|
/////////////////////////////////////////////////////////////
// //
// Copyright (c) 2007-2011 by The University of Queensland //
// Earth Systems Science Computational Centre (ESSCC) //
// http://www.uq.edu.au/esscc //
// //
// Primary Business: Brisbane, Queensland, Australia //
// Licensed under the Open Software License version 3.0 //
// http://www.opensource.org/licenses/osl-3.0.php //
// //
/////////////////////////////////////////////////////////////
#include <boost/version.hpp>
#include "Vector3Py.h"
using namespace boost::python;
void exportVector3 ()
{
// Check that Boost 1.34.0 or higher is being used.
// If so, disable auto-generation of C++ signatures for Epydoc
// (which stumbles over indentation in the auto-generated strings).
#if ((BOOST_VERSION / 100000 >= 1) \
&& (BOOST_VERSION / 100 % 1000 >= 34)) \
|| (BOOST_VERSION / 100000 >= 2)
boost::python::docstring_options no_autogen(true,false);
#endif
class_<Vector3>(
"Vector3",
"A class defining a location or vector in 3D space",
init<>()
)
.def(init<const Vector3 &>())
.def(
init<double,double,double>(
( arg("x"), arg("y"), arg("z") ),
"Constructs a vector with specifed component values.\n"
"@type x: float\n"
"@kwarg x: index 0\n"
"@type y: float\n"
"@kwarg y: index 1\n"
"@type z: float\n"
"@kwarg z: index 2\n"
)
)
.def(self == self)
.def(self - self)
.def(self + self)
.def(self * double(0.0))
.def(
"dot",
&::dot,
( arg("v") ),
"Returns the dot product of this 3-element vector with\n"
"the specified L{Vector3}.\n"
"@type v: L{Vector3}\n"
"@kwarg v: dot product with this\n"
"@rtype: float\n"
)
.def(
"cross",
&::cross,
( arg("v") ),
"Returns the cross product of this 3-element vector with\n"
"the specified L{Vector3}.\n"
"@type v: L{Vector3}\n"
"@kwarg v: cross product with this\n"
"@rtype: L{Vector3}\n"
)
.def(
"norm",
&Vector3::norm,
"Returns the magnitude of this 3-element vector.\n"
"@rtype: float\n"
"@return: math.sqrt(self.dot(self)).\n"
)
.def(
"unit",
&Vector3::unit,
"Returns the unit vector in the direction of this 3-element vector.\n"
"@rtype: L{Vector3}\n"
"@return: self/self.norm(self).\n"
)
.def(
"X",
&Vector3::x,
"Returns the x-coordinate of the vector.\n"
"@rtype: double\n"
)
.def(
"Y",
&Vector3::y,
"Returns the y-coordinate of the vector.\n"
"@rtype: double\n"
)
.def(
"Z",
&Vector3::z,
"Returns the z-coordinate of the vector.\n"
"@rtype: double\n"
)
.def(self_ns::str(self))
;
}
|
