Files
OrcaSlicer/deps_src/libigl/igl/canonical_quaternions.h
Donovan Baarda dc5897d7b5 Update eigen to v5.0.1 and libigl to v2.6.0. (#11311)
* Update eigen from v3.3.7 to v5.0.1.

This updates eigen from v3.3.7 released on  December 11, 2018-12-11 to v5.0.1
released on 2025-11-11. There have be a large number of bug-fixes,
optimizations, and improvements between these releases. See the details at;

https://gitlab.com/libeigen/eigen/-/releases

It retains the previous custom minimal `CMakeLists.txt`, and adds a
README-OrcaSlicer.md that explains what version and parts of the upstream
eigen release have been included, and where the full release can be found.

* Update libigl from v2.0.0 (or older) to v2.6.0.

This updates libigl from what was probably v2.0.0 released on 2018-10-16 to
v2.6.0 released on 2025-05-15. It's possible the old version was even older
than that but there is no version indicators in the code and I ran out of
patience identifying missing changes and only went back as far as v2.0.0.

There have been a large number of bug-fixes, optimizations, and improvements
between these versions. See the following for details;

https://github.com/libigl/libigl/releases

I retained the minimal custom `CMakeLists.txt`, added `README.md` from the
libigl distribution which identifies the version, and added a
README-OrcaSlicer.md that details the version and parts that have been
included.

* Update libslic3r for libigl v2.6.0 changes.

This updates libslic3r for all changes moving to eigen v5.0.1 and libigl
v2.6.0. Despite the large number of updates to both dependencies, no changes
were required for the eigen update, and only one change was required for the
libigl update.

For libigl, `igl::Hit` was changed to a template taking the Scalar type to
use. Previously it was hard-coded to `float`, so to minimize possible impact
I've updated all places it is used from `igl::Hit` to `igl::Hit<float>`.

* Add compiler option `-DNOMINMAX` for libigl with MSVC.

MSVC by default defines `min(()` and `max()` macros that break
`std::numeric_limits<>::max()`. The upstream cmake that we don't include
adds `-DNOMINMAX` for the libigl module when compiling with MSVC, so we need
to add the same thing here.

* Fix src/libslic3r/TriangleMeshDeal.cpp for the unmodified upstream libigl.

This fixes `TriangleMeshDeal.cpp` to work with the unmodified upstream
libigl v2.6.0. loop.{h,cpp} implementation.

This file and feature was added in PR "BBS Port: Mesh Subdivision" (#12150)
which included changes to `loop.{h,cpp}` in the old version of libigl. This PR
avoids modifying the included dependencies, and uses the updated upstream
versions of those files without any modifications, which requires fixing
TriangleMeshDeal.cpp to work with them.

In particular, the modifications made to `loop.{h,cpp}` included changing the
return type from void to bool, adding additional validation checking of the
input meshes, and returning false if they failed validation. These added
checks looked unnecessary and would only have caught problems if the input
mesh was very corrupt.

To make `TriangleMeshDeal.cpp` work without this built-in checking
functionality, I removed checking/handling of any `false` return value.

There was also a hell of a lot of redundant copying and casting back and forth
between float and double, so I cleaned that up. The input and output meshs use
floats for the vertexes, and there would be no accuracy benefits from casting
to and from doubles for the simple weighted average operations done by
igl::loop(). So this just uses `Eigen:Map` to use the original input mesh
vertex data directly without requiring any copy or casting.

* Move eigen from included `deps_src` to externaly fetched `deps`.

This copys what PrusaSlicer did and moved it from an included dependency under
`deps_src` to an externaly fetched dependency under `deps`. This requires
updating some `CMakeList.txt` configs and removing the old and obsolete
`cmake/modules/FindEigen3.cmake`. The details of when this was done in
PrusaSlicer and the followup fixes are at;

* 21116995d7
* https://github.com/prusa3d/PrusaSlicer/issues/13608
* https://github.com/prusa3d/PrusaSlicer/pull/13609
* e3c277b9ee

For some reason I don't fully understand this also required fixing
`src/slic3r/GUI/GUI_App.cpp` by adding `#include <boost/nowide/cstdio.hpp>` to
fix an `error: ‘remove’ is not a member of ‘boost::nowide'`. The main thing I
don't understand is how it worked before. Note that this include is in the
PrusaSlicer version of this file, but it also significantly deviates from what
is currently in OrcaSlicer in many other ways.

* Whups... I missed adding the deps/Eigen/Eigen.cmake file...

* Tidy some whitespace indenting in CMakeLists.txt.

* Ugh... tabs indenting needing fixes.

* Change the include order of deps/Eigen.

It turns out that although Boost includes some references to Eigen, Eigen also
includes some references to Boost for supporting some of it's additional
numeric types.

I don't think it matters much since we are not using these features, but I
think technically its more correct to say Eigen depends on Boost than the
other way around, so I've re-ordered them.

* Add source for Eigen 5.0.1 download to flatpak yml config.

* Add explicit `DEPENDS dep_Boost to deps/Eigen.

I missed this before. This ensures we don't rely on include orders to make
sure Boost is installed before we configure Eigen.

* Add `DEPENDS dep_Boost dep_GMP dep_MPFR` to deps/Eigen.

It turns out Eigen can also use GMP and MPFR for multi-precision and
multi-precision-rounded numeric types if they are available.

Again, I don't think we are using these so it doesn't really matter, but it is
technically correct and ensures they are there if we ever do need them.

* Fix deps DEPENDENCY ordering for GMP, MPFR, Eigen, and CGAL.

I think this is finally correct. Apparently CGAL also optionally depends on
Eigen, so the correct dependency order from lowest to highest is GMP, MPFR, Eigen, and CGAL.

---------

Co-authored-by: Donovan Baarda <dbaarda@google.com>
Co-authored-by: Noisyfox <timemanager.rick@gmail.com>
2026-05-12 15:09:13 +08:00

135 lines
6.0 KiB
C++

// This file is part of libigl, a simple c++ geometry processing library.
//
// Copyright (C) 2013 Alec Jacobson <alecjacobson@gmail.com>
//
// This Source Code Form is subject to the terms of the Mozilla Public License
// v. 2.0. If a copy of the MPL was not distributed with this file, You can
// obtain one at http://mozilla.org/MPL/2.0/.
#ifndef IGL_CANONICAL_QUATERNIONS_H
#define IGL_CANONICAL_QUATERNIONS_H
#include "igl_inline.h"
/// @file canonical_quaternions
///
/// Define some canonical quaternions for floats and doubles
/// A Quaternion, q, is defined here as an arrays of four scalars (x,y,z,w),
/// such that q = x*i + y*j + z*k + w.
///
/// \see snap_to_canonical_view_quat
namespace igl
{
// Float versions
// This will get undef'd below
#define SQRT_2_OVER_2 0.707106781f
// Identity quaternion
const float IDENTITY_QUAT_F[4] = {0,0,0,1};
// The following match the Matlab canonical views
// X point right, Y pointing up and Z point out
const float XY_PLANE_QUAT_F[4] = {0,0,0,1};
// X points right, Y points *in* and Z points up
const float XZ_PLANE_QUAT_F[4] = {-SQRT_2_OVER_2,0,0,SQRT_2_OVER_2};
// X points out, Y points right, and Z points up
const float YZ_PLANE_QUAT_F[4] = {-0.5,-0.5,-0.5,0.5};
const float CANONICAL_VIEW_QUAT_F[][4] =
{
{ 0, 0, 0, 1}, // 0
{ 0, 0, SQRT_2_OVER_2, SQRT_2_OVER_2}, // 1
{ 0, 0, 1, 0}, // 2
{ 0, 0, SQRT_2_OVER_2,-SQRT_2_OVER_2}, // 3
{ 0, -1, 0, 0}, // 4
{-SQRT_2_OVER_2, SQRT_2_OVER_2, 0, 0}, // 5
{ -1, 0, 0, 0}, // 6
{-SQRT_2_OVER_2,-SQRT_2_OVER_2, 0, 0}, // 7
{ -0.5, -0.5, -0.5, 0.5}, // 8
{ 0,-SQRT_2_OVER_2, 0, SQRT_2_OVER_2}, // 9
{ 0.5, -0.5, 0.5, 0.5}, // 10
{ SQRT_2_OVER_2, 0, SQRT_2_OVER_2, 0}, // 11
{ SQRT_2_OVER_2, 0,-SQRT_2_OVER_2, 0}, // 12
{ 0.5, 0.5, -0.5, 0.5}, // 13
{ 0, SQRT_2_OVER_2, 0, SQRT_2_OVER_2}, // 14
{ -0.5, 0.5, 0.5, 0.5}, // 15
{ 0, SQRT_2_OVER_2, SQRT_2_OVER_2, 0}, // 16
{ -0.5, 0.5, 0.5, -0.5}, // 17
{-SQRT_2_OVER_2, 0, 0,-SQRT_2_OVER_2}, // 18
{ -0.5, -0.5, -0.5, -0.5}, // 19
{-SQRT_2_OVER_2, 0, 0, SQRT_2_OVER_2}, // 20
{ -0.5, -0.5, 0.5, 0.5}, // 21
{ 0,-SQRT_2_OVER_2, SQRT_2_OVER_2, 0}, // 22
{ 0.5, -0.5, 0.5, -0.5} // 23
};
#undef SQRT_2_OVER_2
// Double versions
#define SQRT_2_OVER_2 0.70710678118654757
// Identity
const double IDENTITY_QUAT_D[4] = {0,0,0,1};
// The following match the Matlab canonical views
// X point right, Y pointing up and Z point out
const double XY_PLANE_QUAT_D[4] = {0,0,0,1};
// X points right, Y points *in* and Z points up
const double XZ_PLANE_QUAT_D[4] = {-SQRT_2_OVER_2,0,0,SQRT_2_OVER_2};
// X points out, Y points right, and Z points up
const double YZ_PLANE_QUAT_D[4] = {-0.5,-0.5,-0.5,0.5};
const double CANONICAL_VIEW_QUAT_D[][4] =
{
{ 0, 0, 0, 1},
{ 0, 0, SQRT_2_OVER_2, SQRT_2_OVER_2},
{ 0, 0, 1, 0},
{ 0, 0, SQRT_2_OVER_2,-SQRT_2_OVER_2},
{ 0, -1, 0, 0},
{-SQRT_2_OVER_2, SQRT_2_OVER_2, 0, 0},
{ -1, 0, 0, 0},
{-SQRT_2_OVER_2,-SQRT_2_OVER_2, 0, 0},
{ -0.5, -0.5, -0.5, 0.5},
{ 0,-SQRT_2_OVER_2, 0, SQRT_2_OVER_2},
{ 0.5, -0.5, 0.5, 0.5},
{ SQRT_2_OVER_2, 0, SQRT_2_OVER_2, 0},
{ SQRT_2_OVER_2, 0,-SQRT_2_OVER_2, 0},
{ 0.5, 0.5, -0.5, 0.5},
{ 0, SQRT_2_OVER_2, 0, SQRT_2_OVER_2},
{ -0.5, 0.5, 0.5, 0.5},
{ 0, SQRT_2_OVER_2, SQRT_2_OVER_2, 0},
{ -0.5, 0.5, 0.5, -0.5},
{-SQRT_2_OVER_2, 0, 0,-SQRT_2_OVER_2},
{ -0.5, -0.5, -0.5, -0.5},
{-SQRT_2_OVER_2, 0, 0, SQRT_2_OVER_2},
{ -0.5, -0.5, 0.5, 0.5},
{ 0,-SQRT_2_OVER_2, SQRT_2_OVER_2, 0},
{ 0.5, -0.5, 0.5, -0.5}
};
#undef SQRT_2_OVER_2
#define NUM_CANONICAL_VIEW_QUAT 24
// NOTE: I want to rather be able to return a Q_type[][] but C++ is not
// making it easy. So instead I've written a per-element accessor
// Return element [i][j] of the corresponding CANONICAL_VIEW_QUAT_* of the
// given templated type
// Inputs:
// i index of quaternion
// j index of coordinate in quaternion i
// Returns values of CANONICAL_VIEW_QUAT_*[i][j]
template <typename Q_type>
IGL_INLINE Q_type CANONICAL_VIEW_QUAT(int i, int j);
// Template specializations for float and double
template <>
IGL_INLINE float CANONICAL_VIEW_QUAT<float>(int i, int j);
template <>
IGL_INLINE double CANONICAL_VIEW_QUAT<double>(int i, int j);
}
#ifndef IGL_STATIC_LIBRARY
# include "canonical_quaternions.cpp"
#endif
#endif