libcruft-util/region.cpp

321 lines
8.0 KiB
C++
Raw Normal View History

/*
2015-04-13 18:05:28 +10:00
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
2015-04-13 18:05:28 +10:00
* http://www.apache.org/licenses/LICENSE-2.0
*
2015-04-13 18:05:28 +10:00
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* Copyright 2010-2017 Danny Robson <danny@nerdcruft.net>
*/
#include "region.hpp"
2011-05-23 17:18:52 +10:00
#include "debug.hpp"
#include "coord/iostream.hpp"
2011-05-23 17:18:52 +10:00
#include <array>
using util::region;
2015-02-20 21:53:34 +11:00
//-----------------------------------------------------------------------------
template <size_t S, typename T>
util::region<S,T>::region (extent_t _extent):
region (point_t::origin (), _extent)
2015-03-07 03:20:28 +11:00
{
debug::sanity (*this);
}
2015-02-20 21:53:34 +11:00
2015-01-15 14:01:05 +11:00
//-----------------------------------------------------------------------------
template <size_t S, typename T>
util::region<S,T>::region (point_t _p,
extent_t _e):
p (_p),
e (_e)
2015-03-07 03:20:28 +11:00
{
debug::sanity (*this);
}
2015-01-15 14:01:05 +11:00
2015-02-17 18:25:29 +11:00
//-----------------------------------------------------------------------------
template <size_t S, typename T>
util::region<S,T>::region (point_t _a,
point_t _b):
region (_a, extent_t { _b - _a })
2015-03-07 03:20:28 +11:00
{
// This check must allow for zero area (but non-zero dimension) regions.
// Some code paths need to support this degenerate case. It's ugly but
// simplifies generalisation. eg, vertical linear bezier curves.
CHECK (all (_a <= _b));
2015-03-07 03:20:28 +11:00
debug::sanity (*this);
2015-02-17 18:25:29 +11:00
}
2011-05-23 17:18:52 +10:00
//-----------------------------------------------------------------------------
template <size_t S, typename T>
T
util::region<S,T>::area (void) const
2015-01-21 23:33:35 +11:00
{
return e.area ();
2015-01-21 23:33:35 +11:00
}
2011-05-23 17:18:52 +10:00
2015-01-21 23:33:35 +11:00
//-----------------------------------------------------------------------------
template <size_t S, typename T>
T
util::region<S,T>::diameter (void) const
2015-01-21 23:33:35 +11:00
{
return e.diameter ();
}
2015-02-17 16:24:16 +11:00
//-----------------------------------------------------------------------------
template <size_t S, typename T>
typename util::region<S,T>::extent_t
util::region<S,T>::magnitude (void) const
2015-02-17 16:24:16 +11:00
{
return e;
2015-02-17 16:24:16 +11:00
}
2015-03-02 18:48:09 +11:00
//-----------------------------------------------------------------------------
template <size_t S, typename T>
typename util::region<S,T>::extent_t
util::region<S,T>::magnitude (extent_t _e)
2015-03-02 18:48:09 +11:00
{
e = _e;
return e;
2015-03-02 18:48:09 +11:00
}
2015-01-21 23:33:35 +11:00
//-----------------------------------------------------------------------------
template <size_t S, typename T>
2015-02-17 16:25:41 +11:00
bool
util::region<S,T>::empty (void) const
2015-01-21 23:33:35 +11:00
{
return almost_zero (area ());
}
2011-05-23 17:18:52 +10:00
//-----------------------------------------------------------------------------
template <size_t S, typename T>
typename util::region<S,T>::point_t
util::region<S,T>::base (void) const
2015-01-21 23:33:35 +11:00
{
return p;
2011-10-26 21:43:55 +11:00
}
2015-02-17 16:24:33 +11:00
//-----------------------------------------------------------------------------
template <size_t S, typename T>
typename util::region<S,T>::point_t
util::region<S,T>::away (void) const
2015-02-17 16:24:33 +11:00
{
return p + e;
2015-02-17 16:24:33 +11:00
}
2015-01-21 23:33:35 +11:00
//-----------------------------------------------------------------------------
template <size_t S, typename T>
typename util::region<S,T>::point_t
util::region<S,T>::centre (void) const
2015-01-21 23:33:35 +11:00
{
return p + e / T{2};
2011-10-20 23:53:18 +11:00
}
2015-01-21 23:33:35 +11:00
//-----------------------------------------------------------------------------
template <size_t S, typename T>
typename util::region<S,T>::point_t
util::region<S,T>::closest (point_t q) const
2015-01-21 23:33:35 +11:00
{
point_t out;
2013-09-18 13:52:11 +10:00
for (size_t i = 0; i < S; ++i)
out[i] = q[i] < p[i] ? p[i] :
q[i] > p[i] ? p[i] + e[i] :
q[i];
return out;
2013-09-18 13:52:11 +10:00
}
2015-01-21 23:33:35 +11:00
//-----------------------------------------------------------------------------
2012-06-15 16:38:57 +10:00
// FIXME: This will fail with an actual infinite range (NaNs will be generated
// in the conditionals).
template <size_t S, typename T>
2011-10-10 22:37:27 +11:00
bool
util::region<S,T>::intersects (region<S,T> rhs) const
2015-01-21 23:33:35 +11:00
{
for (size_t i = 0; i < S; ++i)
if ( p[i] >= rhs.p[i] + rhs.e[i] ||
rhs.p[i] >= p[i] + e[i])
{ return false; }
return true;
2011-10-10 22:37:27 +11:00
}
//-----------------------------------------------------------------------------
template <size_t S, typename T>
typename region<S,T>::point_t
region<S,T>::constrain (point_t q) const noexcept
2015-01-21 23:33:35 +11:00
{
for (size_t i = 0; i < S; ++i)
2018-05-03 21:43:48 +10:00
q[i] = clamp (q[i], p[i], p[i] + e[i]);
return q;
}
2015-01-21 23:33:35 +11:00
//-----------------------------------------------------------------------------
template<size_t S, typename T>
util::region<S,T>
util::region<S,T>::intersection (region<S,T> rhs) const
2015-01-21 23:33:35 +11:00
{
// find the intersection corners
point_t a, b;
for (size_t i = 0; i < S; ++i) {
a[i] = util::max (p[i], rhs.p[i]);
b[i] = util::min (p[i] + e[i], rhs.p[i] + rhs.e[i]);
if (b[i] < a[i])
throw std::logic_error ("no overlap");
}
return { a, b };
}
//-----------------------------------------------------------------------------
template <size_t S, typename T>
bool
util::region<S,T>::covers (region<S, T> r) const noexcept
{
return all (p <= r.p) && all (p + e >= r.p + r.e);
}
///////////////////////////////////////////////////////////////////////////////
template <size_t S, typename T>
util::region<S,T>
util::region<S,T>::inset (T mag) const
2015-01-21 23:37:00 +11:00
{
return inset (util::vector<S,T> {mag});
2015-01-21 23:37:00 +11:00
}
2015-01-22 14:58:29 +11:00
//-----------------------------------------------------------------------------
template <size_t S, typename T>
util::region<S,T>
util::region<S,T>::inset (vector<S,T> mag) const
2015-01-22 14:58:29 +11:00
{
// ensure we have enough space to trim off our total extent
2017-11-23 17:24:11 +11:00
CHECK (all (e >= T{2} * mag));
2015-01-22 14:58:29 +11:00
return {
p + mag,
e - T{2} * mag
};
2015-02-04 15:44:51 +11:00
}
2015-01-22 14:58:29 +11:00
//-----------------------------------------------------------------------------
template <size_t S, typename T>
util::region<S,T>
util::region<S,T>::expand (vector<S,T> v) const
2015-01-22 14:58:29 +11:00
{
return {
p - v,
e + v * T{2}
2015-01-22 14:58:29 +11:00
};
}
2015-02-04 15:44:51 +11:00
//-----------------------------------------------------------------------------
template <size_t S, typename T>
util::region<S,T>
util::region<S,T>::expand (T mag) const
2015-02-04 15:44:51 +11:00
{
return expand (vector<S,T> {mag});
2015-02-04 15:44:51 +11:00
}
2015-02-20 15:26:59 +11:00
///////////////////////////////////////////////////////////////////////////////
template <size_t S, typename T>
util::region<S,T>
util::region<S,T>::operator+ (vector<S,T> rhs) const
2015-02-20 15:26:59 +11:00
{
return { p + rhs, e };
2015-02-20 15:26:59 +11:00
}
//-----------------------------------------------------------------------------
template <size_t S, typename T>
util::region<S,T>
util::region<S,T>::operator- (vector<S,T> rhs) const
{
return { p - rhs, e };
}
2015-02-20 15:26:59 +11:00
///////////////////////////////////////////////////////////////////////////////
template <size_t S, typename T>
2011-05-23 17:18:52 +10:00
bool
util::region<S,T>::operator== (region rhs) const
2015-01-21 23:33:35 +11:00
{
return p == rhs.p && e == rhs.e;
2015-01-21 23:33:35 +11:00
}
2011-05-23 17:18:52 +10:00
///////////////////////////////////////////////////////////////////////////////
template <size_t S, typename T>
2011-10-20 23:53:30 +11:00
std::ostream&
util::operator<< (std::ostream &os, const util::region<S,T> &rhs) {
return os << "{ position: " << rhs.p << ", extent: " << rhs.e << " }";
2011-10-20 23:53:30 +11:00
}
2015-03-07 03:20:28 +11:00
///////////////////////////////////////////////////////////////////////////////
2017-01-05 15:06:49 +11:00
namespace util::debug {
2015-03-07 03:20:28 +11:00
template <size_t S, typename T>
struct validator<util::region<S,T>> {
2015-03-07 03:20:28 +11:00
static bool is_valid (const util::region<S,T> &r)
{
return util::debug::is_valid (r.p) && util::debug::is_valid (r.e);
2015-03-07 03:20:28 +11:00
}
};
2017-01-05 15:06:49 +11:00
}
2015-03-07 03:20:28 +11:00
///////////////////////////////////////////////////////////////////////////////
#define INSTANTIATE_S_T(S,T) \
template struct util::region<S,T>; \
template std::ostream& util::operator<< (std::ostream&, const region<S,T>&); \
template struct util::debug::validator<util::region<S,T>>;
2015-03-07 03:20:28 +11:00
#define INSTANTIATE(T) \
INSTANTIATE_S_T(2,T) \
INSTANTIATE_S_T(3,T)
2016-10-25 17:47:08 +11:00
INSTANTIATE(int16_t);
INSTANTIATE(int32_t);
INSTANTIATE(int64_t);
2015-09-22 17:24:16 +10:00
INSTANTIATE(uint16_t)
2015-03-07 03:20:28 +11:00
INSTANTIATE(uint32_t)
INSTANTIATE(uint64_t)
2016-10-25 17:47:08 +11:00
2015-03-07 03:20:28 +11:00
INSTANTIATE(float)
INSTANTIATE(double)