/////////////////////////////////////////////////////////////////////////// // // Copyright (c) 2004, Industrial Light & Magic, a division of Lucas // Digital Ltd. LLC // // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are // met: // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above // copyright notice, this list of conditions and the following disclaimer // in the documentation and/or other materials provided with the // distribution. // * Neither the name of Industrial Light & Magic nor the names of // its contributors may be used to endorse or promote products derived // from this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // /////////////////////////////////////////////////////////////////////////// #ifndef INCLUDED_IMATHBOX_H #define INCLUDED_IMATHBOX_H //------------------------------------------------------------------- // // class Imath::Box // -------------------------------- // // This class imposes the following requirements on its // parameter class: // // 1) The class T must implement these operators: // + - < > <= >= = // with the signature (T,T) and the expected // return values for a numeric type. // // 2) The class T must implement operator= // with the signature (T,float and/or double) // // 3) The class T must have a constructor which takes // a float (and/or double) for use in initializing the box. // // 4) The class T must have a function T::dimensions() // which returns the number of dimensions in the class // (since its assumed its a vector) -- preferably, this // returns a constant expression. // //------------------------------------------------------------------- #include "ImathVec.h" namespace Imath { template class Box { public: //------------------------- // Data Members are public //------------------------- T min; T max; //----------------------------------------------------- // Constructors - an "empty" box is created by default //----------------------------------------------------- Box (); Box (const T &point); Box (const T &minT, const T &maxT); //-------------------- // Operators: ==, != //-------------------- bool operator == (const Box &src) const; bool operator != (const Box &src) const; //------------------ // Box manipulation //------------------ void makeEmpty (); void extendBy (const T &point); void extendBy (const Box &box); void makeInfinite (); //--------------------------------------------------- // Query functions - these compute results each time //--------------------------------------------------- T size () const; T center () const; bool intersects (const T &point) const; bool intersects (const Box &box) const; unsigned int majorAxis () const; //---------------- // Classification //---------------- bool isEmpty () const; bool hasVolume () const; bool isInfinite () const; }; //-------------------- // Convenient typedefs //-------------------- typedef Box Box2s; typedef Box Box2i; typedef Box Box2f; typedef Box Box2d; typedef Box Box3s; typedef Box Box3i; typedef Box Box3f; typedef Box Box3d; //---------------- // Implementation template inline Box::Box() { makeEmpty(); } template inline Box::Box (const T &point) { min = point; max = point; } template inline Box::Box (const T &minT, const T &maxT) { min = minT; max = maxT; } template inline bool Box::operator == (const Box &src) const { return (min == src.min && max == src.max); } template inline bool Box::operator != (const Box &src) const { return (min != src.min || max != src.max); } template inline void Box::makeEmpty() { min = T(T::baseTypeMax()); max = T(T::baseTypeMin()); } template inline void Box::makeInfinite() { min = T(T::baseTypeMin()); max = T(T::baseTypeMax()); } template inline void Box::extendBy(const T &point) { for (unsigned int i = 0; i < min.dimensions(); i++) { if (point[i] < min[i]) min[i] = point[i]; if (point[i] > max[i]) max[i] = point[i]; } } template inline void Box::extendBy(const Box &box) { for (unsigned int i = 0; i < min.dimensions(); i++) { if (box.min[i] < min[i]) min[i] = box.min[i]; if (box.max[i] > max[i]) max[i] = box.max[i]; } } template inline bool Box::intersects(const T &point) const { for (unsigned int i = 0; i < min.dimensions(); i++) { if (point[i] < min[i] || point[i] > max[i]) return false; } return true; } template inline bool Box::intersects(const Box &box) const { for (unsigned int i = 0; i < min.dimensions(); i++) { if (box.max[i] < min[i] || box.min[i] > max[i]) return false; } return true; } template inline T Box::size() const { if (isEmpty()) return T (0); return max - min; } template inline T Box::center() const { return (max + min) / 2; } template inline bool Box::isEmpty() const { for (unsigned int i = 0; i < min.dimensions(); i++) { if (max[i] < min[i]) return true; } return false; } template inline bool Box::isInfinite() const { for (unsigned int i = 0; i < min.dimensions(); i++) { if (min[i] != T::baseTypeMin() || max[i] != T::baseTypeMax()) return false; } return true; } template inline bool Box::hasVolume() const { for (unsigned int i = 0; i < min.dimensions(); i++) { if (max[i] <= min[i]) return false; } return true; } template inline unsigned int Box::majorAxis() const { unsigned int major = 0; T s = size(); for (unsigned int i = 1; i < min.dimensions(); i++) { if (s[i] > s[major]) major = i; } return major; } //------------------------------------------------------------------- // // Partial class specializations for Imath::Vec2 and Imath::Vec3 // //------------------------------------------------------------------- template class Box; template class Box > { public: //------------------------- // Data Members are public //------------------------- Vec2 min; Vec2 max; //----------------------------------------------------- // Constructors - an "empty" box is created by default //----------------------------------------------------- Box(); Box (const Vec2 &point); Box (const Vec2 &minT, const Vec2 &maxT); //-------------------- // Operators: ==, != //-------------------- bool operator == (const Box > &src) const; bool operator != (const Box > &src) const; //------------------ // Box manipulation //------------------ void makeEmpty(); void extendBy (const Vec2 &point); void extendBy (const Box > &box); void makeInfinite(); //--------------------------------------------------- // Query functions - these compute results each time //--------------------------------------------------- Vec2 size() const; Vec2 center() const; bool intersects (const Vec2 &point) const; bool intersects (const Box > &box) const; unsigned int majorAxis() const; //---------------- // Classification //---------------- bool isEmpty() const; bool hasVolume() const; bool isInfinite() const; }; //---------------- // Implementation template inline Box >::Box() { makeEmpty(); } template inline Box >::Box (const Vec2 &point) { min = point; max = point; } template inline Box >::Box (const Vec2 &minT, const Vec2 &maxT) { min = minT; max = maxT; } template inline bool Box >::operator == (const Box > &src) const { return (min == src.min && max == src.max); } template inline bool Box >::operator != (const Box > &src) const { return (min != src.min || max != src.max); } template inline void Box >::makeEmpty() { min = Vec2(Vec2::baseTypeMax()); max = Vec2(Vec2::baseTypeMin()); } template inline void Box >::makeInfinite() { min = Vec2(Vec2::baseTypeMin()); max = Vec2(Vec2::baseTypeMax()); } template inline void Box >::extendBy (const Vec2 &point) { if (point[0] < min[0]) min[0] = point[0]; if (point[0] > max[0]) max[0] = point[0]; if (point[1] < min[1]) min[1] = point[1]; if (point[1] > max[1]) max[1] = point[1]; } template inline void Box >::extendBy (const Box > &box) { if (box.min[0] < min[0]) min[0] = box.min[0]; if (box.max[0] > max[0]) max[0] = box.max[0]; if (box.min[1] < min[1]) min[1] = box.min[1]; if (box.max[1] > max[1]) max[1] = box.max[1]; } template inline bool Box >::intersects (const Vec2 &point) const { if (point[0] < min[0] || point[0] > max[0] || point[1] < min[1] || point[1] > max[1]) return false; return true; } template inline bool Box >::intersects (const Box > &box) const { if (box.max[0] < min[0] || box.min[0] > max[0] || box.max[1] < min[1] || box.min[1] > max[1]) return false; return true; } template inline Vec2 Box >::size() const { if (isEmpty()) return Vec2 (0); return max - min; } template inline Vec2 Box >::center() const { return (max + min) / 2; } template inline bool Box >::isEmpty() const { if (max[0] < min[0] || max[1] < min[1]) return true; return false; } template inline bool Box > ::isInfinite() const { if (min[0] != limits::min() || max[0] != limits::max() || min[1] != limits::min() || max[1] != limits::max()) return false; return true; } template inline bool Box >::hasVolume() const { if (max[0] <= min[0] || max[1] <= min[1]) return false; return true; } template inline unsigned int Box >::majorAxis() const { unsigned int major = 0; Vec2 s = size(); if (s[1] > s[major]) major = 1; return major; } template class Box > { public: //------------------------- // Data Members are public //------------------------- Vec3 min; Vec3 max; //----------------------------------------------------- // Constructors - an "empty" box is created by default //----------------------------------------------------- Box(); Box (const Vec3 &point); Box (const Vec3 &minT, const Vec3 &maxT); //-------------------- // Operators: ==, != //-------------------- bool operator == (const Box > &src) const; bool operator != (const Box > &src) const; //------------------ // Box manipulation //------------------ void makeEmpty(); void extendBy (const Vec3 &point); void extendBy (const Box > &box); void makeInfinite (); //--------------------------------------------------- // Query functions - these compute results each time //--------------------------------------------------- Vec3 size() const; Vec3 center() const; bool intersects (const Vec3 &point) const; bool intersects (const Box > &box) const; unsigned int majorAxis() const; //---------------- // Classification //---------------- bool isEmpty() const; bool hasVolume() const; bool isInfinite() const; }; //---------------- // Implementation template inline Box >::Box() { makeEmpty(); } template inline Box >::Box (const Vec3 &point) { min = point; max = point; } template inline Box >::Box (const Vec3 &minT, const Vec3 &maxT) { min = minT; max = maxT; } template inline bool Box >::operator == (const Box > &src) const { return (min == src.min && max == src.max); } template inline bool Box >::operator != (const Box > &src) const { return (min != src.min || max != src.max); } template inline void Box >::makeEmpty() { min = Vec3(Vec3::baseTypeMax()); max = Vec3(Vec3::baseTypeMin()); } template inline void Box >::makeInfinite() { min = Vec3(Vec3::baseTypeMin()); max = Vec3(Vec3::baseTypeMax()); } template inline void Box >::extendBy (const Vec3 &point) { if (point[0] < min[0]) min[0] = point[0]; if (point[0] > max[0]) max[0] = point[0]; if (point[1] < min[1]) min[1] = point[1]; if (point[1] > max[1]) max[1] = point[1]; if (point[2] < min[2]) min[2] = point[2]; if (point[2] > max[2]) max[2] = point[2]; } template inline void Box >::extendBy (const Box > &box) { if (box.min[0] < min[0]) min[0] = box.min[0]; if (box.max[0] > max[0]) max[0] = box.max[0]; if (box.min[1] < min[1]) min[1] = box.min[1]; if (box.max[1] > max[1]) max[1] = box.max[1]; if (box.min[2] < min[2]) min[2] = box.min[2]; if (box.max[2] > max[2]) max[2] = box.max[2]; } template inline bool Box >::intersects (const Vec3 &point) const { if (point[0] < min[0] || point[0] > max[0] || point[1] < min[1] || point[1] > max[1] || point[2] < min[2] || point[2] > max[2]) return false; return true; } template inline bool Box >::intersects (const Box > &box) const { if (box.max[0] < min[0] || box.min[0] > max[0] || box.max[1] < min[1] || box.min[1] > max[1] || box.max[2] < min[2] || box.min[2] > max[2]) return false; return true; } template inline Vec3 Box >::size() const { if (isEmpty()) return Vec3 (0); return max - min; } template inline Vec3 Box >::center() const { return (max + min) / 2; } template inline bool Box >::isEmpty() const { if (max[0] < min[0] || max[1] < min[1] || max[2] < min[2]) return true; return false; } template inline bool Box >::isInfinite() const { if (min[0] != limits::min() || max[0] != limits::max() || min[1] != limits::min() || max[1] != limits::max() || min[2] != limits::min() || max[2] != limits::max()) return false; return true; } template inline bool Box >::hasVolume() const { if (max[0] <= min[0] || max[1] <= min[1] || max[2] <= min[2]) return false; return true; } template inline unsigned int Box >::majorAxis() const { unsigned int major = 0; Vec3 s = size(); if (s[1] > s[major]) major = 1; if (s[2] > s[major]) major = 2; return major; } } // namespace Imath #endif