blender-archive/source/blender/blenlib/BLI_quadric.h

/* SPDX-License-Identifier: GPL-2.0-or-later
 * Copyright 2001-2002 NaN Holding BV. All rights reserved. */

#pragma once

/** \file
 * \ingroup bli
 */

#ifdef __cplusplus
extern "C" {
#endif

typedef struct Quadric {
  double a2, ab, ac, ad, b2, bc, bd, c2, cd, d2;
} Quadric;

/* Conversion. */

void BLI_quadric_from_plane(Quadric *q, const double v[4]);
void BLI_quadric_to_vector_v3(const Quadric *q, double v[3]);

void BLI_quadric_clear(Quadric *q);

/* Math operations. */

void BLI_quadric_add_qu_qu(Quadric *a, const Quadric *b);
void BLI_quadric_add_qu_ququ(Quadric *r, const Quadric *a, const Quadric *b);
void BLI_quadric_mul(Quadric *a, double scalar);

/* Solve. */

double BLI_quadric_evaluate(const Quadric *q, const double v[3]);
bool BLI_quadric_optimize(const Quadric *q, double v[3], double epsilon);

#ifdef __cplusplus
}
#endif
File headers: SPDX License migration Use a shorter/simpler license convention, stops the header taking so much space. Follow the SPDX license specification: https://spdx.org/licenses - C/C++/objc/objc++ - Python - Shell Scripts - CMake, GNUmakefile While most of the source tree has been included - `./extern/` was left out. - `./intern/cycles` & `./intern/atomic` are also excluded because they use different header conventions. doc/license/SPDX-license-identifiers.txt has been added to list SPDX all used identifiers. See P2788 for the script that automated these edits. Reviewed By: brecht, mont29, sergey Ref D14069 2022-02-11 09:07:11 +11:00			`/* SPDX-License-Identifier: GPL-2.0-or-later`
			`* Copyright 2001-2002 NaN Holding BV. All rights reserved. */`
small quadric library ported from Laurence Bourn's LOD_decimator LOD_Quadric class. not used just yet. 2012-10-19 07:20:37 +00:00
			`#pragma once`

doxygen: add newline after \file While \file doesn't need an argument, it can't have another doxy command after it. 2019-02-18 08:08:12 +11:00			`/** \file`
			`* \ingroup bli`
small quadric library ported from Laurence Bourn's LOD_decimator LOD_Quadric class. not used just yet. 2012-10-19 07:20:37 +00:00			`*/`

Cleanup: make remaining blenlib headers work in C++ Differential Revision: https://developer.blender.org/D6988 Reviewers: brecht 2020-03-02 15:04:53 +01:00			`#ifdef __cplusplus`
			`extern "C" {`
			`#endif`

small quadric library ported from Laurence Bourn's LOD_decimator LOD_Quadric class. not used just yet. 2012-10-19 07:20:37 +00:00			`typedef struct Quadric {`
Fix T44780: Decimate planar creates concave edges Float precision was causing problems for decimate, small faces that create a nearly flat surface were detected as having no 'cost' to collapse. 2015-05-21 21:00:27 +10:00			`double a2, ab, ac, ad, b2, bc, bd, c2, cd, d2;`
small quadric library ported from Laurence Bourn's LOD_decimator LOD_Quadric class. not used just yet. 2012-10-19 07:20:37 +00:00			`} Quadric;`

Docs: use doxygen formatting for BLI Differentiate doc-strings from title/section text. 2021-12-20 19:01:14 +11:00			`/* Conversion. */`

Fix T44780: Decimate planar creates concave edges Float precision was causing problems for decimate, small faces that create a nearly flat surface were detected as having no 'cost' to collapse. 2015-05-21 21:00:27 +10:00			`void BLI_quadric_from_plane(Quadric *q, const double v[4]);`
BMesh Decimate: use doubles to calculate optimized position This allows the error threshold for calculating the optimized location to be much lower. Resolves visible artifacts w/ 1m-tri happy-buddha example. 2016-06-14 16:47:05 +10:00			`void BLI_quadric_to_vector_v3(const Quadric *q, double v[3]);`
small quadric library ported from Laurence Bourn's LOD_decimator LOD_Quadric class. not used just yet. 2012-10-19 07:20:37 +00:00
			`void BLI_quadric_clear(Quadric *q);`

Docs: use doxygen formatting for BLI Differentiate doc-strings from title/section text. 2021-12-20 19:01:14 +11:00			`/* Math operations. */`

small quadric library ported from Laurence Bourn's LOD_decimator LOD_Quadric class. not used just yet. 2012-10-19 07:20:37 +00:00			`void BLI_quadric_add_qu_qu(Quadric a, const Quadric b);`
			`void BLI_quadric_add_qu_ququ(Quadric r, const Quadric a, const Quadric *b);`
Cleanup: remove redundant const qualifiers for POD types MSVC used to warn about const mismatch for arguments passed by value. Remove these as newer versions of MSVC no longer show this warning. 2022-01-07 11:38:08 +11:00			`void BLI_quadric_mul(Quadric *a, double scalar);`
small quadric library ported from Laurence Bourn's LOD_decimator LOD_Quadric class. not used just yet. 2012-10-19 07:20:37 +00:00
Docs: use doxygen formatting for BLI Differentiate doc-strings from title/section text. 2021-12-20 19:01:14 +11:00			`/* Solve. */`

BMesh Decimate: use doubles to calculate optimized position This allows the error threshold for calculating the optimized location to be much lower. Resolves visible artifacts w/ 1m-tri happy-buddha example. 2016-06-14 16:47:05 +10:00			`double BLI_quadric_evaluate(const Quadric *q, const double v[3]);`
Cleanup: remove redundant const qualifiers for POD types MSVC used to warn about const mismatch for arguments passed by value. Remove these as newer versions of MSVC no longer show this warning. 2022-01-07 11:38:08 +11:00			`bool BLI_quadric_optimize(const Quadric *q, double v[3], double epsilon);`
small quadric library ported from Laurence Bourn's LOD_decimator LOD_Quadric class. not used just yet. 2012-10-19 07:20:37 +00:00
Cleanup: make remaining blenlib headers work in C++ Differential Revision: https://developer.blender.org/D6988 Reviewers: brecht 2020-03-02 15:04:53 +01:00			`#ifdef __cplusplus`
			`}`
			`#endif`