3
* ***** BEGIN GPL LICENSE BLOCK *****
5
* This program is free software; you can redistribute it and/or
6
* modify it under the terms of the GNU General Public License
7
* as published by the Free Software Foundation; either version 2
8
* of the License, or (at your option) any later version.
10
* This program is distributed in the hope that it will be useful,
11
* but WITHOUT ANY WARRANTY; without even the implied warranty of
12
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13
* GNU General Public License for more details.
15
* You should have received a copy of the GNU General Public License
16
* along with this program; if not, write to the Free Software Foundation,
17
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19
* The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
20
* All rights reserved.
22
* This is a new part of Blender.
24
* Contributor(s): Joseph Gilbert, Campbell Barton
26
* ***** END GPL LICENSE BLOCK *****
29
/** \file blender/python/mathutils/mathutils_geometry.c
30
* \ingroup pymathutils
36
#include "mathutils_geometry.h"
38
/* Used for PolyFill */
39
#ifndef MATH_STANDALONE /* define when building outside blender */
40
# include "MEM_guardedalloc.h"
41
# include "BLI_blenlib.h"
42
# include "BLI_boxpack2d.h"
43
# include "BKE_displist.h"
44
# include "BKE_curve.h"
48
#include "BLI_utildefines.h"
50
#define SWAP_FLOAT(a, b, tmp) tmp = a; a = b; b = tmp
52
/*-------------------------DOC STRINGS ---------------------------*/
53
PyDoc_STRVAR(M_Geometry_doc,
54
"The Blender geometry module"
57
//---------------------------------INTERSECTION FUNCTIONS--------------------
59
PyDoc_STRVAR(M_Geometry_intersect_ray_tri_doc,
60
".. function:: intersect_ray_tri(v1, v2, v3, ray, orig, clip=True)\n"
62
" Returns the intersection between a ray and a triangle, if possible, returns None otherwise.\n"
65
" :type v1: :class:`mathutils.Vector`\n"
67
" :type v2: :class:`mathutils.Vector`\n"
69
" :type v3: :class:`mathutils.Vector`\n"
70
" :arg ray: Direction of the projection\n"
71
" :type ray: :class:`mathutils.Vector`\n"
72
" :arg orig: Origin\n"
73
" :type orig: :class:`mathutils.Vector`\n"
74
" :arg clip: When False, don't restrict the intersection to the area of the triangle, use the infinite plane defined by the triangle.\n"
75
" :type clip: boolean\n"
76
" :return: The point of intersection or None if no intersection is found\n"
77
" :rtype: :class:`mathutils.Vector` or None\n"
79
static PyObject *M_Geometry_intersect_ray_tri(PyObject *UNUSED(self), PyObject *args)
81
VectorObject *ray, *ray_off, *vec1, *vec2, *vec3;
82
float dir[3], orig[3], v1[3], v2[3], v3[3], e1[3], e2[3], pvec[3], tvec[3], qvec[3];
83
float det, inv_det, u, v, t;
86
if (!PyArg_ParseTuple(args,
87
"O!O!O!O!O!|i:intersect_ray_tri",
92
&vector_Type, &ray_off, &clip))
96
if (vec1->size != 3 || vec2->size != 3 || vec3->size != 3 || ray->size != 3 || ray_off->size != 3) {
97
PyErr_SetString(PyExc_ValueError,
98
"only 3D vectors for all parameters");
102
if (BaseMath_ReadCallback(vec1) == -1 ||
103
BaseMath_ReadCallback(vec2) == -1 ||
104
BaseMath_ReadCallback(vec3) == -1 ||
105
BaseMath_ReadCallback(ray) == -1 ||
106
BaseMath_ReadCallback(ray_off) == -1)
111
copy_v3_v3(v1, vec1->vec);
112
copy_v3_v3(v2, vec2->vec);
113
copy_v3_v3(v3, vec3->vec);
115
copy_v3_v3(dir, ray->vec);
118
copy_v3_v3(orig, ray_off->vec);
120
/* find vectors for two edges sharing v1 */
121
sub_v3_v3v3(e1, v2, v1);
122
sub_v3_v3v3(e2, v3, v1);
124
/* begin calculating determinant - also used to calculated U parameter */
125
cross_v3_v3v3(pvec, dir, e2);
127
/* if determinant is near zero, ray lies in plane of triangle */
128
det = dot_v3v3(e1, pvec);
130
if (det > -0.000001f && det < 0.000001f) {
134
inv_det = 1.0f / det;
136
/* calculate distance from v1 to ray origin */
137
sub_v3_v3v3(tvec, orig, v1);
139
/* calculate U parameter and test bounds */
140
u = dot_v3v3(tvec, pvec) * inv_det;
141
if (clip && (u < 0.0f || u > 1.0f)) {
145
/* prepare to test the V parameter */
146
cross_v3_v3v3(qvec, tvec, e1);
148
/* calculate V parameter and test bounds */
149
v = dot_v3v3(dir, qvec) * inv_det;
151
if (clip && (v < 0.0f || u + v > 1.0f)) {
155
/* calculate t, ray intersects triangle */
156
t = dot_v3v3(e2, qvec) * inv_det;
159
add_v3_v3v3(pvec, orig, dir);
161
return Vector_CreatePyObject(pvec, 3, Py_NEW, NULL);
164
/* Line-Line intersection using algorithm from mathworld.wolfram.com */
166
PyDoc_STRVAR(M_Geometry_intersect_line_line_doc,
167
".. function:: intersect_line_line(v1, v2, v3, v4)\n"
169
" Returns a tuple with the points on each line respectively closest to the other.\n"
171
" :arg v1: First point of the first line\n"
172
" :type v1: :class:`mathutils.Vector`\n"
173
" :arg v2: Second point of the first line\n"
174
" :type v2: :class:`mathutils.Vector`\n"
175
" :arg v3: First point of the second line\n"
176
" :type v3: :class:`mathutils.Vector`\n"
177
" :arg v4: Second point of the second line\n"
178
" :type v4: :class:`mathutils.Vector`\n"
179
" :rtype: tuple of :class:`mathutils.Vector`'s\n"
181
static PyObject *M_Geometry_intersect_line_line(PyObject *UNUSED(self), PyObject *args)
184
VectorObject *vec1, *vec2, *vec3, *vec4;
185
float v1[3], v2[3], v3[3], v4[3], i1[3], i2[3];
187
if (!PyArg_ParseTuple(args, "O!O!O!O!:intersect_line_line",
191
&vector_Type, &vec4))
196
if (vec1->size != vec2->size || vec1->size != vec3->size || vec3->size != vec2->size) {
197
PyErr_SetString(PyExc_ValueError,
198
"vectors must be of the same size");
202
if (BaseMath_ReadCallback(vec1) == -1 ||
203
BaseMath_ReadCallback(vec2) == -1 ||
204
BaseMath_ReadCallback(vec3) == -1 ||
205
BaseMath_ReadCallback(vec4) == -1)
210
if (vec1->size == 3 || vec1->size == 2) {
213
if (vec1->size == 3) {
214
copy_v3_v3(v1, vec1->vec);
215
copy_v3_v3(v2, vec2->vec);
216
copy_v3_v3(v3, vec3->vec);
217
copy_v3_v3(v4, vec4->vec);
220
v1[0] = vec1->vec[0];
221
v1[1] = vec1->vec[1];
224
v2[0] = vec2->vec[0];
225
v2[1] = vec2->vec[1];
228
v3[0] = vec3->vec[0];
229
v3[1] = vec3->vec[1];
232
v4[0] = vec4->vec[0];
233
v4[1] = vec4->vec[1];
237
result = isect_line_line_v3(v1, v2, v3, v4, i1, i2);
244
tuple = PyTuple_New(2);
245
PyTuple_SET_ITEM(tuple, 0, Vector_CreatePyObject(i1, vec1->size, Py_NEW, NULL));
246
PyTuple_SET_ITEM(tuple, 1, Vector_CreatePyObject(i2, vec1->size, Py_NEW, NULL));
251
PyErr_SetString(PyExc_ValueError,
252
"2D/3D vectors only");
260
//----------------------------geometry.normal() -------------------
261
PyDoc_STRVAR(M_Geometry_normal_doc,
262
".. function:: normal(v1, v2, v3, v4=None)\n"
264
" Returns the normal of the 3D tri or quad.\n"
267
" :type v1: :class:`mathutils.Vector`\n"
269
" :type v2: :class:`mathutils.Vector`\n"
271
" :type v3: :class:`mathutils.Vector`\n"
272
" :arg v4: Point4 (optional)\n"
273
" :type v4: :class:`mathutils.Vector`\n"
274
" :rtype: :class:`mathutils.Vector`\n"
276
static PyObject *M_Geometry_normal(PyObject *UNUSED(self), PyObject *args)
278
VectorObject *vec1, *vec2, *vec3, *vec4;
281
if (PyTuple_GET_SIZE(args) == 3) {
282
if (!PyArg_ParseTuple(args, "O!O!O!:normal",
285
&vector_Type, &vec3))
290
if (vec1->size != vec2->size || vec1->size != vec3->size) {
291
PyErr_SetString(PyExc_ValueError,
292
"vectors must be of the same size");
295
if (vec1->size < 3) {
296
PyErr_SetString(PyExc_ValueError,
297
"2D vectors unsupported");
301
if (BaseMath_ReadCallback(vec1) == -1 ||
302
BaseMath_ReadCallback(vec2) == -1 ||
303
BaseMath_ReadCallback(vec3) == -1)
308
normal_tri_v3(n, vec1->vec, vec2->vec, vec3->vec);
311
if (!PyArg_ParseTuple(args, "O!O!O!O!:normal",
315
&vector_Type, &vec4))
319
if (vec1->size != vec2->size || vec1->size != vec3->size || vec1->size != vec4->size) {
320
PyErr_SetString(PyExc_ValueError,
321
"vectors must be of the same size");
324
if (vec1->size < 3) {
325
PyErr_SetString(PyExc_ValueError,
326
"2D vectors unsupported");
330
if (BaseMath_ReadCallback(vec1) == -1 ||
331
BaseMath_ReadCallback(vec2) == -1 ||
332
BaseMath_ReadCallback(vec3) == -1 ||
333
BaseMath_ReadCallback(vec4) == -1)
338
normal_quad_v3(n, vec1->vec, vec2->vec, vec3->vec, vec4->vec);
341
return Vector_CreatePyObject(n, 3, Py_NEW, NULL);
344
//--------------------------------- AREA FUNCTIONS--------------------
346
PyDoc_STRVAR(M_Geometry_area_tri_doc,
347
".. function:: area_tri(v1, v2, v3)\n"
349
" Returns the area size of the 2D or 3D triangle defined.\n"
352
" :type v1: :class:`mathutils.Vector`\n"
354
" :type v2: :class:`mathutils.Vector`\n"
356
" :type v3: :class:`mathutils.Vector`\n"
359
static PyObject *M_Geometry_area_tri(PyObject *UNUSED(self), PyObject *args)
361
VectorObject *vec1, *vec2, *vec3;
363
if (!PyArg_ParseTuple(args, "O!O!O!:area_tri",
366
&vector_Type, &vec3))
371
if (vec1->size != vec2->size || vec1->size != vec3->size) {
372
PyErr_SetString(PyExc_ValueError,
373
"vectors must be of the same size");
377
if (BaseMath_ReadCallback(vec1) == -1 ||
378
BaseMath_ReadCallback(vec2) == -1 ||
379
BaseMath_ReadCallback(vec3) == -1)
384
if (vec1->size == 3) {
385
return PyFloat_FromDouble(area_tri_v3(vec1->vec, vec2->vec, vec3->vec));
387
else if (vec1->size == 2) {
388
return PyFloat_FromDouble(area_tri_v2(vec1->vec, vec2->vec, vec3->vec));
391
PyErr_SetString(PyExc_ValueError,
392
"only 2D,3D vectors are supported");
398
PyDoc_STRVAR(M_Geometry_intersect_line_line_2d_doc,
399
".. function:: intersect_line_line_2d(lineA_p1, lineA_p2, lineB_p1, lineB_p2)\n"
401
" Takes 2 lines (as 4 vectors) and returns a vector for their point of intersection or None.\n"
403
" :arg lineA_p1: First point of the first line\n"
404
" :type lineA_p1: :class:`mathutils.Vector`\n"
405
" :arg lineA_p2: Second point of the first line\n"
406
" :type lineA_p2: :class:`mathutils.Vector`\n"
407
" :arg lineB_p1: First point of the second line\n"
408
" :type lineB_p1: :class:`mathutils.Vector`\n"
409
" :arg lineB_p2: Second point of the second line\n"
410
" :type lineB_p2: :class:`mathutils.Vector`\n"
411
" :return: The point of intersection or None when not found\n"
412
" :rtype: :class:`mathutils.Vector` or None\n"
414
static PyObject *M_Geometry_intersect_line_line_2d(PyObject *UNUSED(self), PyObject *args)
416
VectorObject *line_a1, *line_a2, *line_b1, *line_b2;
418
if (!PyArg_ParseTuple(args, "O!O!O!O!:intersect_line_line_2d",
419
&vector_Type, &line_a1,
420
&vector_Type, &line_a2,
421
&vector_Type, &line_b1,
422
&vector_Type, &line_b2))
427
if (BaseMath_ReadCallback(line_a1) == -1 ||
428
BaseMath_ReadCallback(line_a2) == -1 ||
429
BaseMath_ReadCallback(line_b1) == -1 ||
430
BaseMath_ReadCallback(line_b2) == -1)
435
if (isect_seg_seg_v2_point(line_a1->vec, line_a2->vec, line_b1->vec, line_b2->vec, vi) == 1) {
436
return Vector_CreatePyObject(vi, 2, Py_NEW, NULL);
444
PyDoc_STRVAR(M_Geometry_intersect_line_plane_doc,
445
".. function:: intersect_line_plane(line_a, line_b, plane_co, plane_no, no_flip=False)\n"
447
" Calculate the intersection between a line (as 2 vectors) and a plane.\n"
448
" Returns a vector for the intersection or None.\n"
450
" :arg line_a: First point of the first line\n"
451
" :type line_a: :class:`mathutils.Vector`\n"
452
" :arg line_b: Second point of the first line\n"
453
" :type line_b: :class:`mathutils.Vector`\n"
454
" :arg plane_co: A point on the plane\n"
455
" :type plane_co: :class:`mathutils.Vector`\n"
456
" :arg plane_no: The direction the plane is facing\n"
457
" :type plane_no: :class:`mathutils.Vector`\n"
458
" :arg no_flip: Always return an intersection on the directon defined bt line_a -> line_b\n"
459
" :type no_flip: :boolean\n"
460
" :return: The point of intersection or None when not found\n"
461
" :rtype: :class:`mathutils.Vector` or None\n"
463
static PyObject *M_Geometry_intersect_line_plane(PyObject *UNUSED(self), PyObject *args)
465
VectorObject *line_a, *line_b, *plane_co, *plane_no;
468
if (!PyArg_ParseTuple(args, "O!O!O!O!|i:intersect_line_plane",
469
&vector_Type, &line_a,
470
&vector_Type, &line_b,
471
&vector_Type, &plane_co,
472
&vector_Type, &plane_no,
478
if (BaseMath_ReadCallback(line_a) == -1 ||
479
BaseMath_ReadCallback(line_b) == -1 ||
480
BaseMath_ReadCallback(plane_co) == -1 ||
481
BaseMath_ReadCallback(plane_no) == -1)
486
if (ELEM4(2, line_a->size, line_b->size, plane_co->size, plane_no->size)) {
487
PyErr_SetString(PyExc_ValueError,
488
"geometry.intersect_line_plane(...): "
489
" can't use 2D Vectors");
493
if (isect_line_plane_v3(isect, line_a->vec, line_b->vec, plane_co->vec, plane_no->vec, no_flip) == 1) {
494
return Vector_CreatePyObject(isect, 3, Py_NEW, NULL);
501
PyDoc_STRVAR(M_Geometry_intersect_plane_plane_doc,
502
".. function:: intersect_plane_plane(plane_a_co, plane_a_no, plane_b_co, plane_b_no)\n"
504
" Return the intersection between two planes\n"
506
" :arg plane_a_co: Point on the first plane\n"
507
" :type plane_a_co: :class:`mathutils.Vector`\n"
508
" :arg plane_a_no: Normal of the first plane\n"
509
" :type plane_a_no: :class:`mathutils.Vector`\n"
510
" :arg plane_b_co: Point on the second plane\n"
511
" :type plane_b_co: :class:`mathutils.Vector`\n"
512
" :arg plane_b_no: Normal of the second plane\n"
513
" :type plane_b_no: :class:`mathutils.Vector`\n"
514
" :return: The line of the intersection represented as a point and a vector\n"
515
" :rtype: tuple pair of :class:`mathutils.Vector`\n"
517
static PyObject *M_Geometry_intersect_plane_plane(PyObject *UNUSED(self), PyObject *args)
520
VectorObject *plane_a_co, *plane_a_no, *plane_b_co, *plane_b_no;
525
if (!PyArg_ParseTuple(args, "O!O!O!O!|i:intersect_plane_plane",
526
&vector_Type, &plane_a_co,
527
&vector_Type, &plane_a_no,
528
&vector_Type, &plane_b_co,
529
&vector_Type, &plane_b_no))
534
if (BaseMath_ReadCallback(plane_a_co) == -1 ||
535
BaseMath_ReadCallback(plane_a_no) == -1 ||
536
BaseMath_ReadCallback(plane_b_co) == -1 ||
537
BaseMath_ReadCallback(plane_b_no) == -1)
542
if (ELEM4(2, plane_a_co->size, plane_a_no->size, plane_b_co->size, plane_b_no->size)) {
543
PyErr_SetString(PyExc_ValueError,
544
"geometry.intersect_plane_plane(...): "
545
" can't use 2D Vectors");
549
isect_plane_plane_v3(isect_co, isect_no,
550
plane_a_co->vec, plane_a_no->vec,
551
plane_b_co->vec, plane_b_no->vec);
553
normalize_v3(isect_no);
555
ret = PyTuple_New(2);
556
PyTuple_SET_ITEM(ret, 0, Vector_CreatePyObject(isect_co, 3, Py_NEW, NULL));
557
PyTuple_SET_ITEM(ret, 1, Vector_CreatePyObject(isect_no, 3, Py_NEW, NULL));
561
PyDoc_STRVAR(M_Geometry_intersect_line_sphere_doc,
562
".. function:: intersect_line_sphere(line_a, line_b, sphere_co, sphere_radius, clip=True)\n"
564
" Takes a lines (as 2 vectors), a sphere as a point and a radius and\n"
565
" returns the intersection\n"
567
" :arg line_a: First point of the first line\n"
568
" :type line_a: :class:`mathutils.Vector`\n"
569
" :arg line_b: Second point of the first line\n"
570
" :type line_b: :class:`mathutils.Vector`\n"
571
" :arg sphere_co: The center of the sphere\n"
572
" :type sphere_co: :class:`mathutils.Vector`\n"
573
" :arg sphere_radius: Radius of the sphere\n"
574
" :type sphere_radius: sphere_radius\n"
575
" :return: The intersection points as a pair of vectors or None when there is no intersection\n"
576
" :rtype: A tuple pair containing :class:`mathutils.Vector` or None\n"
578
static PyObject *M_Geometry_intersect_line_sphere(PyObject *UNUSED(self), PyObject *args)
580
VectorObject *line_a, *line_b, *sphere_co;
587
if (!PyArg_ParseTuple(args, "O!O!O!f|i:intersect_line_sphere",
588
&vector_Type, &line_a,
589
&vector_Type, &line_b,
590
&vector_Type, &sphere_co,
591
&sphere_radius, &clip))
596
if (BaseMath_ReadCallback(line_a) == -1 ||
597
BaseMath_ReadCallback(line_b) == -1 ||
598
BaseMath_ReadCallback(sphere_co) == -1)
603
if (ELEM3(2, line_a->size, line_b->size, sphere_co->size)) {
604
PyErr_SetString(PyExc_ValueError,
605
"geometry.intersect_line_sphere(...): "
606
" can't use 2D Vectors");
614
PyObject *ret = PyTuple_New(2);
616
switch (isect_line_sphere_v3(line_a->vec, line_b->vec, sphere_co->vec, sphere_radius, isect_a, isect_b)) {
618
if (!(!clip || (((lambda = line_point_factor_v3(isect_a, line_a->vec, line_b->vec)) >= 0.0f) && (lambda <= 1.0f)))) use_a = FALSE;
622
if (!(!clip || (((lambda = line_point_factor_v3(isect_a, line_a->vec, line_b->vec)) >= 0.0f) && (lambda <= 1.0f)))) use_a = FALSE;
623
if (!(!clip || (((lambda = line_point_factor_v3(isect_b, line_a->vec, line_b->vec)) >= 0.0f) && (lambda <= 1.0f)))) use_b = FALSE;
630
if (use_a) { PyTuple_SET_ITEM(ret, 0, Vector_CreatePyObject(isect_a, 3, Py_NEW, NULL)); }
631
else { PyTuple_SET_ITEM(ret, 0, Py_None); Py_INCREF(Py_None); }
633
if (use_b) { PyTuple_SET_ITEM(ret, 1, Vector_CreatePyObject(isect_b, 3, Py_NEW, NULL)); }
634
else { PyTuple_SET_ITEM(ret, 1, Py_None); Py_INCREF(Py_None); }
640
/* keep in sync with M_Geometry_intersect_line_sphere */
641
PyDoc_STRVAR(M_Geometry_intersect_line_sphere_2d_doc,
642
".. function:: intersect_line_sphere_2d(line_a, line_b, sphere_co, sphere_radius, clip=True)\n"
644
" Takes a lines (as 2 vectors), a sphere as a point and a radius and\n"
645
" returns the intersection\n"
647
" :arg line_a: First point of the first line\n"
648
" :type line_a: :class:`mathutils.Vector`\n"
649
" :arg line_b: Second point of the first line\n"
650
" :type line_b: :class:`mathutils.Vector`\n"
651
" :arg sphere_co: The center of the sphere\n"
652
" :type sphere_co: :class:`mathutils.Vector`\n"
653
" :arg sphere_radius: Radius of the sphere\n"
654
" :type sphere_radius: sphere_radius\n"
655
" :return: The intersection points as a pair of vectors or None when there is no intersection\n"
656
" :rtype: A tuple pair containing :class:`mathutils.Vector` or None\n"
658
static PyObject *M_Geometry_intersect_line_sphere_2d(PyObject *UNUSED(self), PyObject *args)
660
VectorObject *line_a, *line_b, *sphere_co;
667
if (!PyArg_ParseTuple(args, "O!O!O!f|i:intersect_line_sphere_2d",
668
&vector_Type, &line_a,
669
&vector_Type, &line_b,
670
&vector_Type, &sphere_co,
671
&sphere_radius, &clip))
676
if (BaseMath_ReadCallback(line_a) == -1 ||
677
BaseMath_ReadCallback(line_b) == -1 ||
678
BaseMath_ReadCallback(sphere_co) == -1)
687
PyObject *ret = PyTuple_New(2);
689
switch (isect_line_sphere_v2(line_a->vec, line_b->vec, sphere_co->vec, sphere_radius, isect_a, isect_b)) {
691
if (!(!clip || (((lambda = line_point_factor_v2(isect_a, line_a->vec, line_b->vec)) >= 0.0f) && (lambda <= 1.0f)))) use_a = FALSE;
695
if (!(!clip || (((lambda = line_point_factor_v2(isect_a, line_a->vec, line_b->vec)) >= 0.0f) && (lambda <= 1.0f)))) use_a = FALSE;
696
if (!(!clip || (((lambda = line_point_factor_v2(isect_b, line_a->vec, line_b->vec)) >= 0.0f) && (lambda <= 1.0f)))) use_b = FALSE;
703
if (use_a) { PyTuple_SET_ITEM(ret, 0, Vector_CreatePyObject(isect_a, 2, Py_NEW, NULL)); }
704
else { PyTuple_SET_ITEM(ret, 0, Py_None); Py_INCREF(Py_None); }
706
if (use_b) { PyTuple_SET_ITEM(ret, 1, Vector_CreatePyObject(isect_b, 2, Py_NEW, NULL)); }
707
else { PyTuple_SET_ITEM(ret, 1, Py_None); Py_INCREF(Py_None); }
713
PyDoc_STRVAR(M_Geometry_intersect_point_line_doc,
714
".. function:: intersect_point_line(pt, line_p1, line_p2)\n"
716
" Takes a point and a line and returns a tuple with the closest point on the line and its distance from the first point of the line as a percentage of the length of the line.\n"
719
" :type pt: :class:`mathutils.Vector`\n"
720
" :arg line_p1: First point of the line\n"
721
" :type line_p1: :class:`mathutils.Vector`\n"
722
" :arg line_p1: Second point of the line\n"
723
" :type line_p1: :class:`mathutils.Vector`\n"
724
" :rtype: (:class:`mathutils.Vector`, float)\n"
726
static PyObject *M_Geometry_intersect_point_line(PyObject *UNUSED(self), PyObject *args)
728
VectorObject *pt, *line_1, *line_2;
729
float pt_in[3], pt_out[3], l1[3], l2[3];
733
if (!PyArg_ParseTuple(args, "O!O!O!:intersect_point_line",
735
&vector_Type, &line_1,
736
&vector_Type, &line_2))
741
if (BaseMath_ReadCallback(pt) == -1 ||
742
BaseMath_ReadCallback(line_1) == -1 ||
743
BaseMath_ReadCallback(line_2) == -1)
748
/* accept 2d verts */
749
if (pt->size == 3) { copy_v3_v3(pt_in, pt->vec); }
750
else { pt_in[2] = 0.0f; copy_v2_v2(pt_in, pt->vec); }
752
if (line_1->size == 3) { copy_v3_v3(l1, line_1->vec); }
753
else { l1[2] = 0.0f; copy_v2_v2(l1, line_1->vec); }
755
if (line_2->size == 3) { copy_v3_v3(l2, line_2->vec); }
756
else { l2[2] = 0.0f; copy_v2_v2(l2, line_2->vec); }
758
/* do the calculation */
759
lambda = closest_to_line_v3(pt_out, pt_in, l1, l2);
761
ret = PyTuple_New(2);
762
PyTuple_SET_ITEM(ret, 0, Vector_CreatePyObject(pt_out, 3, Py_NEW, NULL));
763
PyTuple_SET_ITEM(ret, 1, PyFloat_FromDouble(lambda));
767
PyDoc_STRVAR(M_Geometry_intersect_point_tri_2d_doc,
768
".. function:: intersect_point_tri_2d(pt, tri_p1, tri_p2, tri_p3)\n"
770
" Takes 4 vectors (using only the x and y coordinates): one is the point and the next 3 define the triangle. Returns 1 if the point is within the triangle, otherwise 0.\n"
773
" :type v1: :class:`mathutils.Vector`\n"
774
" :arg tri_p1: First point of the triangle\n"
775
" :type tri_p1: :class:`mathutils.Vector`\n"
776
" :arg tri_p2: Second point of the triangle\n"
777
" :type tri_p2: :class:`mathutils.Vector`\n"
778
" :arg tri_p3: Third point of the triangle\n"
779
" :type tri_p3: :class:`mathutils.Vector`\n"
782
static PyObject *M_Geometry_intersect_point_tri_2d(PyObject *UNUSED(self), PyObject *args)
784
VectorObject *pt_vec, *tri_p1, *tri_p2, *tri_p3;
786
if (!PyArg_ParseTuple(args, "O!O!O!O!:intersect_point_tri_2d",
787
&vector_Type, &pt_vec,
788
&vector_Type, &tri_p1,
789
&vector_Type, &tri_p2,
790
&vector_Type, &tri_p3))
795
if (BaseMath_ReadCallback(pt_vec) == -1 ||
796
BaseMath_ReadCallback(tri_p1) == -1 ||
797
BaseMath_ReadCallback(tri_p2) == -1 ||
798
BaseMath_ReadCallback(tri_p3) == -1)
803
return PyLong_FromLong(isect_point_tri_v2(pt_vec->vec, tri_p1->vec, tri_p2->vec, tri_p3->vec));
806
PyDoc_STRVAR(M_Geometry_intersect_point_quad_2d_doc,
807
".. function:: intersect_point_quad_2d(pt, quad_p1, quad_p2, quad_p3, quad_p4)\n"
809
" Takes 5 vectors (using only the x and y coordinates): one is the point and the next 4 define the quad, \n"
810
" only the x and y are used from the vectors. Returns 1 if the point is within the quad, otherwise 0.\n"
813
" :type pt: :class:`mathutils.Vector`\n"
814
" :arg quad_p1: First point of the quad\n"
815
" :type quad_p1: :class:`mathutils.Vector`\n"
816
" :arg quad_p2: Second point of the quad\n"
817
" :type quad_p2: :class:`mathutils.Vector`\n"
818
" :arg quad_p3: Third point of the quad\n"
819
" :type quad_p3: :class:`mathutils.Vector`\n"
820
" :arg quad_p4: Forth point of the quad\n"
821
" :type quad_p4: :class:`mathutils.Vector`\n"
824
static PyObject *M_Geometry_intersect_point_quad_2d(PyObject *UNUSED(self), PyObject *args)
826
VectorObject *pt_vec, *quad_p1, *quad_p2, *quad_p3, *quad_p4;
828
if (!PyArg_ParseTuple(args, "O!O!O!O!O!:intersect_point_quad_2d",
829
&vector_Type, &pt_vec,
830
&vector_Type, &quad_p1,
831
&vector_Type, &quad_p2,
832
&vector_Type, &quad_p3,
833
&vector_Type, &quad_p4))
838
if (BaseMath_ReadCallback(pt_vec) == -1 ||
839
BaseMath_ReadCallback(quad_p1) == -1 ||
840
BaseMath_ReadCallback(quad_p2) == -1 ||
841
BaseMath_ReadCallback(quad_p3) == -1 ||
842
BaseMath_ReadCallback(quad_p4) == -1)
847
return PyLong_FromLong(isect_point_quad_v2(pt_vec->vec, quad_p1->vec, quad_p2->vec, quad_p3->vec, quad_p4->vec));
850
PyDoc_STRVAR(M_Geometry_distance_point_to_plane_doc,
851
".. function:: distance_point_to_plane(pt, plane_co, plane_no)\n"
853
" Returns the signed distance between a point and a plane "
854
" (negative when below the normal).\n"
857
" :type pt: :class:`mathutils.Vector`\n"
858
" :arg plane_co: First point of the quad\n"
859
" :type plane_co: :class:`mathutils.Vector`\n"
860
" :arg plane_no: Second point of the quad\n"
861
" :type plane_no: :class:`mathutils.Vector`\n"
864
static PyObject *M_Geometry_distance_point_to_plane(PyObject *UNUSED(self), PyObject *args)
866
VectorObject *pt, *plene_co, *plane_no;
868
if (!PyArg_ParseTuple(args, "O!O!O!:distance_point_to_plane",
870
&vector_Type, &plene_co,
871
&vector_Type, &plane_no))
876
if (BaseMath_ReadCallback(pt) == -1 ||
877
BaseMath_ReadCallback(plene_co) == -1 ||
878
BaseMath_ReadCallback(plane_no) == -1)
883
return PyFloat_FromDouble(dist_to_plane_v3(pt->vec, plene_co->vec, plane_no->vec));
886
PyDoc_STRVAR(M_Geometry_barycentric_transform_doc,
887
".. function:: barycentric_transform(point, tri_a1, tri_a2, tri_a3, tri_b1, tri_b2, tri_b3)\n"
889
" Return a transformed point, the transformation is defined by 2 triangles.\n"
891
" :arg point: The point to transform.\n"
892
" :type point: :class:`mathutils.Vector`\n"
893
" :arg tri_a1: source triangle vertex.\n"
894
" :type tri_a1: :class:`mathutils.Vector`\n"
895
" :arg tri_a2: source triangle vertex.\n"
896
" :type tri_a2: :class:`mathutils.Vector`\n"
897
" :arg tri_a3: source triangle vertex.\n"
898
" :type tri_a3: :class:`mathutils.Vector`\n"
899
" :arg tri_a1: target triangle vertex.\n"
900
" :type tri_a1: :class:`mathutils.Vector`\n"
901
" :arg tri_a2: target triangle vertex.\n"
902
" :type tri_a2: :class:`mathutils.Vector`\n"
903
" :arg tri_a3: target triangle vertex.\n"
904
" :type tri_a3: :class:`mathutils.Vector`\n"
905
" :return: The transformed point\n"
906
" :rtype: :class:`mathutils.Vector`'s\n"
908
static PyObject *M_Geometry_barycentric_transform(PyObject *UNUSED(self), PyObject *args)
910
VectorObject *vec_pt;
911
VectorObject *vec_t1_tar, *vec_t2_tar, *vec_t3_tar;
912
VectorObject *vec_t1_src, *vec_t2_src, *vec_t3_src;
915
if (!PyArg_ParseTuple(args, "O!O!O!O!O!O!O!:barycentric_transform",
916
&vector_Type, &vec_pt,
917
&vector_Type, &vec_t1_src,
918
&vector_Type, &vec_t2_src,
919
&vector_Type, &vec_t3_src,
920
&vector_Type, &vec_t1_tar,
921
&vector_Type, &vec_t2_tar,
922
&vector_Type, &vec_t3_tar))
927
if (vec_pt->size != 3 ||
928
vec_t1_src->size != 3 ||
929
vec_t2_src->size != 3 ||
930
vec_t3_src->size != 3 ||
931
vec_t1_tar->size != 3 ||
932
vec_t2_tar->size != 3 ||
933
vec_t3_tar->size != 3)
935
PyErr_SetString(PyExc_ValueError,
936
"One of more of the vector arguments wasn't a 3D vector");
940
barycentric_transform(vec, vec_pt->vec,
941
vec_t1_tar->vec, vec_t2_tar->vec, vec_t3_tar->vec,
942
vec_t1_src->vec, vec_t2_src->vec, vec_t3_src->vec);
944
return Vector_CreatePyObject(vec, 3, Py_NEW, NULL);
947
#ifndef MATH_STANDALONE
949
PyDoc_STRVAR(M_Geometry_interpolate_bezier_doc,
950
".. function:: interpolate_bezier(knot1, handle1, handle2, knot2, resolution)\n"
952
" Interpolate a bezier spline segment.\n"
954
" :arg knot1: First bezier spline point.\n"
955
" :type knot1: :class:`mathutils.Vector`\n"
956
" :arg handle1: First bezier spline handle.\n"
957
" :type handle1: :class:`mathutils.Vector`\n"
958
" :arg handle2: Second bezier spline handle.\n"
959
" :type handle2: :class:`mathutils.Vector`\n"
960
" :arg knot2: Second bezier spline point.\n"
961
" :type knot2: :class:`mathutils.Vector`\n"
962
" :arg resolution: Number of points to return.\n"
963
" :type resolution: int\n"
964
" :return: The interpolated points\n"
965
" :rtype: list of :class:`mathutils.Vector`'s\n"
967
static PyObject *M_Geometry_interpolate_bezier(PyObject *UNUSED(self), PyObject *args)
969
VectorObject *vec_k1, *vec_h1, *vec_k2, *vec_h2;
973
float *coord_array, *fp;
976
float k1[4] = {0.0, 0.0, 0.0, 0.0};
977
float h1[4] = {0.0, 0.0, 0.0, 0.0};
978
float k2[4] = {0.0, 0.0, 0.0, 0.0};
979
float h2[4] = {0.0, 0.0, 0.0, 0.0};
982
if (!PyArg_ParseTuple(args, "O!O!O!O!i:interpolate_bezier",
983
&vector_Type, &vec_k1,
984
&vector_Type, &vec_h1,
985
&vector_Type, &vec_h2,
986
&vector_Type, &vec_k2, &resolu))
992
PyErr_SetString(PyExc_ValueError,
993
"resolution must be 2 or over");
997
if (BaseMath_ReadCallback(vec_k1) == -1 ||
998
BaseMath_ReadCallback(vec_h1) == -1 ||
999
BaseMath_ReadCallback(vec_k2) == -1 ||
1000
BaseMath_ReadCallback(vec_h2) == -1)
1005
dims = MAX4(vec_k1->size, vec_h1->size, vec_h2->size, vec_k2->size);
1007
for (i = 0; i < vec_k1->size; i++) k1[i] = vec_k1->vec[i];
1008
for (i = 0; i < vec_h1->size; i++) h1[i] = vec_h1->vec[i];
1009
for (i = 0; i < vec_k2->size; i++) k2[i] = vec_k2->vec[i];
1010
for (i = 0; i < vec_h2->size; i++) h2[i] = vec_h2->vec[i];
1012
coord_array = MEM_callocN(dims * (resolu) * sizeof(float), "interpolate_bezier");
1013
for (i = 0; i < dims; i++) {
1014
forward_diff_bezier(k1[i], h1[i], h2[i], k2[i], coord_array + i, resolu - 1, sizeof(float) * dims);
1017
list = PyList_New(resolu);
1019
for (i = 0; i < resolu; i++, fp = fp + dims) {
1020
PyList_SET_ITEM(list, i, Vector_CreatePyObject(fp, dims, Py_NEW, NULL));
1022
MEM_freeN(coord_array);
1027
PyDoc_STRVAR(M_Geometry_tessellate_polygon_doc,
1028
".. function:: tessellate_polygon(veclist_list)\n"
1030
" Takes a list of polylines (each point a vector) and returns the point indices for a polyline filled with triangles.\n"
1032
" :arg veclist_list: list of polylines\n"
1035
/* PolyFill function, uses Blenders scanfill to fill multiple poly lines */
1036
static PyObject *M_Geometry_tessellate_polygon(PyObject *UNUSED(self), PyObject *polyLineSeq)
1038
PyObject *tri_list; /*return this list of tri's */
1039
PyObject *polyLine, *polyVec;
1040
int i, len_polylines, len_polypoints, ls_error = 0;
1042
/* display listbase */
1043
ListBase dispbase = {NULL, NULL};
1045
float *fp; /*pointer to the array of malloced dl->verts to set the points from the vectors */
1046
int index, *dl_face, totpoints = 0;
1048
if (!PySequence_Check(polyLineSeq)) {
1049
PyErr_SetString(PyExc_TypeError,
1050
"expected a sequence of poly lines");
1054
len_polylines = PySequence_Size(polyLineSeq);
1056
for (i = 0; i < len_polylines; i++) {
1057
polyLine = PySequence_GetItem(polyLineSeq, i);
1058
if (!PySequence_Check(polyLine)) {
1059
freedisplist(&dispbase);
1060
Py_XDECREF(polyLine); /* may be null so use Py_XDECREF*/
1061
PyErr_SetString(PyExc_TypeError,
1062
"One or more of the polylines is not a sequence of mathutils.Vector's");
1066
len_polypoints = PySequence_Size(polyLine);
1067
if (len_polypoints > 0) { /* don't bother adding edges as polylines */
1069
if (EXPP_check_sequence_consistency(polyLine, &vector_Type) != 1) {
1070
freedisplist(&dispbase);
1071
Py_DECREF(polyLine);
1072
PyErr_SetString(PyExc_TypeError,
1073
"A point in one of the polylines is not a mathutils.Vector type");
1077
dl = MEM_callocN(sizeof(DispList), "poly disp");
1078
BLI_addtail(&dispbase, dl);
1079
dl->type = DL_INDEX3;
1080
dl->nr = len_polypoints;
1082
dl->parts = 1; /* no faces, 1 edge loop */
1083
dl->col = 0; /* no material */
1084
dl->verts = fp = MEM_callocN(sizeof(float) * 3 * len_polypoints, "dl verts");
1085
dl->index = MEM_callocN(sizeof(int) * 3 * len_polypoints, "dl index");
1087
for (index = 0; index < len_polypoints; index++, fp += 3) {
1088
polyVec = PySequence_GetItem(polyLine, index);
1089
if (VectorObject_Check(polyVec)) {
1091
if (BaseMath_ReadCallback((VectorObject *)polyVec) == -1)
1094
fp[0] = ((VectorObject *)polyVec)->vec[0];
1095
fp[1] = ((VectorObject *)polyVec)->vec[1];
1096
if (((VectorObject *)polyVec)->size > 2)
1097
fp[2] = ((VectorObject *)polyVec)->vec[2];
1099
fp[2] = 0.0f; /* if its a 2d vector then set the z to be zero */
1109
Py_DECREF(polyLine);
1113
freedisplist(&dispbase); /* possible some dl was allocated */
1114
PyErr_SetString(PyExc_TypeError,
1115
"A point in one of the polylines "
1116
"is not a mathutils.Vector type");
1119
else if (totpoints) {
1120
/* now make the list to return */
1121
filldisplist(&dispbase, &dispbase, 0);
1123
/* The faces are stored in a new DisplayList
1124
* thats added to the head of the listbase */
1125
dl = dispbase.first;
1127
tri_list = PyList_New(dl->parts);
1129
freedisplist(&dispbase);
1130
PyErr_SetString(PyExc_RuntimeError,
1131
"failed to make a new list");
1136
dl_face = dl->index;
1137
while (index < dl->parts) {
1138
PyList_SET_ITEM(tri_list, index, Py_BuildValue("iii", dl_face[0], dl_face[1], dl_face[2]));
1142
freedisplist(&dispbase);
1145
/* no points, do this so scripts don't barf */
1146
freedisplist(&dispbase); /* possible some dl was allocated */
1147
tri_list = PyList_New(0);
1154
static int boxPack_FromPyObject(PyObject *value, boxPack **boxarray)
1157
PyObject *list_item, *item_1, *item_2;
1161
/* Error checking must already be done */
1162
if (!PyList_Check(value)) {
1163
PyErr_SetString(PyExc_TypeError,
1164
"can only back a list of [x, y, w, h]");
1168
len = PyList_GET_SIZE(value);
1170
*boxarray = MEM_mallocN(len * sizeof(boxPack), "boxPack box");
1173
for (i = 0; i < len; i++) {
1174
list_item = PyList_GET_ITEM(value, i);
1175
if (!PyList_Check(list_item) || PyList_GET_SIZE(list_item) < 4) {
1176
MEM_freeN(*boxarray);
1177
PyErr_SetString(PyExc_TypeError,
1178
"can only pack a list of [x, y, w, h]");
1182
box = (*boxarray) + i;
1184
item_1 = PyList_GET_ITEM(list_item, 2);
1185
item_2 = PyList_GET_ITEM(list_item, 3);
1187
box->w = (float)PyFloat_AsDouble(item_1);
1188
box->h = (float)PyFloat_AsDouble(item_2);
1191
/* accounts for error case too and overwrites with own error */
1192
if (box->w < 0.0f || box->h < 0.0f) {
1193
MEM_freeN(*boxarray);
1194
PyErr_SetString(PyExc_TypeError,
1195
"error parsing width and height values from list: "
1196
"[x, y, w, h], not numbers or below zero");
1200
/* verts will be added later */
1205
static void boxPack_ToPyObject(PyObject *value, boxPack **boxarray)
1208
PyObject *list_item;
1211
len = PyList_GET_SIZE(value);
1213
for (i = 0; i < len; i++) {
1214
box = (*boxarray) + i;
1215
list_item = PyList_GET_ITEM(value, box->index);
1216
PyList_SET_ITEM(list_item, 0, PyFloat_FromDouble(box->x));
1217
PyList_SET_ITEM(list_item, 1, PyFloat_FromDouble(box->y));
1219
MEM_freeN(*boxarray);
1222
PyDoc_STRVAR(M_Geometry_box_pack_2d_doc,
1223
".. function:: box_pack_2d(boxes)\n"
1225
" Returns the normal of the 3D tri or quad.\n"
1227
" :arg boxes: list of boxes, each box is a list where the first 4 items are [x, y, width, height, ...] other items are ignored.\n"
1228
" :type boxes: list\n"
1229
" :return: the width and height of the packed bounding box\n"
1230
" :rtype: tuple, pair of floats\n"
1232
static PyObject *M_Geometry_box_pack_2d(PyObject *UNUSED(self), PyObject *boxlist)
1234
float tot_width = 0.0f, tot_height = 0.0f;
1239
if (!PyList_Check(boxlist)) {
1240
PyErr_SetString(PyExc_TypeError,
1241
"expected a list of boxes [[x, y, w, h], ... ]");
1245
len = PyList_GET_SIZE(boxlist);
1247
boxPack *boxarray = NULL;
1248
if (boxPack_FromPyObject(boxlist, &boxarray) == -1) {
1249
return NULL; /* exception set */
1252
/* Non Python function */
1253
boxPack2D(boxarray, len, &tot_width, &tot_height);
1255
boxPack_ToPyObject(boxlist, &boxarray);
1258
ret = PyTuple_New(2);
1259
PyTuple_SET_ITEM(ret, 0, PyFloat_FromDouble(tot_width));
1260
PyTuple_SET_ITEM(ret, 1, PyFloat_FromDouble(tot_width));
1264
#endif /* MATH_STANDALONE */
1267
static PyMethodDef M_Geometry_methods[] = {
1268
{"intersect_ray_tri", (PyCFunction) M_Geometry_intersect_ray_tri, METH_VARARGS, M_Geometry_intersect_ray_tri_doc},
1269
{"intersect_point_line", (PyCFunction) M_Geometry_intersect_point_line, METH_VARARGS, M_Geometry_intersect_point_line_doc},
1270
{"intersect_point_tri_2d", (PyCFunction) M_Geometry_intersect_point_tri_2d, METH_VARARGS, M_Geometry_intersect_point_tri_2d_doc},
1271
{"intersect_point_quad_2d", (PyCFunction) M_Geometry_intersect_point_quad_2d, METH_VARARGS, M_Geometry_intersect_point_quad_2d_doc},
1272
{"intersect_line_line", (PyCFunction) M_Geometry_intersect_line_line, METH_VARARGS, M_Geometry_intersect_line_line_doc},
1273
{"intersect_line_line_2d", (PyCFunction) M_Geometry_intersect_line_line_2d, METH_VARARGS, M_Geometry_intersect_line_line_2d_doc},
1274
{"intersect_line_plane", (PyCFunction) M_Geometry_intersect_line_plane, METH_VARARGS, M_Geometry_intersect_line_plane_doc},
1275
{"intersect_plane_plane", (PyCFunction) M_Geometry_intersect_plane_plane, METH_VARARGS, M_Geometry_intersect_plane_plane_doc},
1276
{"intersect_line_sphere", (PyCFunction) M_Geometry_intersect_line_sphere, METH_VARARGS, M_Geometry_intersect_line_sphere_doc},
1277
{"intersect_line_sphere_2d", (PyCFunction) M_Geometry_intersect_line_sphere_2d, METH_VARARGS, M_Geometry_intersect_line_sphere_2d_doc},
1278
{"distance_point_to_plane", (PyCFunction) M_Geometry_distance_point_to_plane, METH_VARARGS, M_Geometry_distance_point_to_plane_doc},
1279
{"area_tri", (PyCFunction) M_Geometry_area_tri, METH_VARARGS, M_Geometry_area_tri_doc},
1280
{"normal", (PyCFunction) M_Geometry_normal, METH_VARARGS, M_Geometry_normal_doc},
1281
{"barycentric_transform", (PyCFunction) M_Geometry_barycentric_transform, METH_VARARGS, M_Geometry_barycentric_transform_doc},
1282
#ifndef MATH_STANDALONE
1283
{"interpolate_bezier", (PyCFunction) M_Geometry_interpolate_bezier, METH_VARARGS, M_Geometry_interpolate_bezier_doc},
1284
{"tessellate_polygon", (PyCFunction) M_Geometry_tessellate_polygon, METH_O, M_Geometry_tessellate_polygon_doc},
1285
{"box_pack_2d", (PyCFunction) M_Geometry_box_pack_2d, METH_O, M_Geometry_box_pack_2d_doc},
1287
{NULL, NULL, 0, NULL}
1290
static struct PyModuleDef M_Geometry_module_def = {
1291
PyModuleDef_HEAD_INIT,
1292
"mathutils.geometry", /* m_name */
1293
M_Geometry_doc, /* m_doc */
1295
M_Geometry_methods, /* m_methods */
1296
NULL, /* m_reload */
1297
NULL, /* m_traverse */
1302
/*----------------------------MODULE INIT-------------------------*/
1303
PyMODINIT_FUNC PyInit_mathutils_geometry(void)
1305
PyObject *submodule = PyModule_Create(&M_Geometry_module_def);