COIN-OR::LEMON - Graph Library

About

Downloads

Documentation

Development

Issue Tracker

Browse Tickets

Custom Query

Roadmap

Browse Source

Local Info

Mailing Lists

Search


Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed

  • lemon/dim2.h

    r241 r253  
    2929/// a two dimensional vector with the usual operations.
    3030///
    31 /// The class \ref lemon::dim2::BoundingBox "dim2::BoundingBox"
    32 /// can be used to determine
     31/// The class \ref lemon::dim2::Box "dim2::Box" can be used to determine
    3332/// the rectangular bounding box of a set of
    3433/// \ref lemon::dim2::Point "dim2::Point"'s.
    … …  
    4544  /// @{
    4645
    47   /// A simple two dimensional vector (plain vector) implementation
     46  /// Two dimensional vector (plain vector)
    4847
    4948  /// A simple two dimensional vector (plain vector) implementation
    … …  
    222221  inline std::ostream& operator<<(std::ostream &os, const Point<T>& z)
    223222  {
    224     os << "(" << z.x << ", " << z.y << ")";
     223    os << "(" << z.x << "," << z.y << ")";
    225224    return os;
    226225  }
    … …  
    261260
    262261
    263     /// A class to calculate or store the bounding box of plain vectors.
    264 
    265     /// A class to calculate or store the bounding box of plain vectors.
    266     ///
    267     template<typename T>
    268     class BoundingBox {
     262  /// Bounding box of plain vectors (\ref Point points).
     263
     264  /// A class to calculate or store the bounding box of plain vectors
     265  /// (\ref Point points).
     266  template<typename T>
     267  class Box {
    269268      Point<T> _bottom_left, _top_right;
    270269      bool _empty;
    271270    public:
    272271
    273       ///Default constructor: creates an empty bounding box
    274       BoundingBox() { _empty = true; }
    275 
    276       ///Construct an instance from one point
    277       BoundingBox(Point<T> a) {
     272      ///Default constructor: creates an empty box
     273      Box() { _empty = true; }
     274
     275      ///Construct a box from one point
     276      Box(Point<T> a) {
    278277        _bottom_left = _top_right = a;
    279278        _empty = false;
    280279      }
    281280
    282       ///Construct an instance from two points
    283 
    284       ///Construct an instance from two points.
     281      ///Construct a box from two points
     282
     283      ///Construct a box from two points.
    285284      ///\param a The bottom left corner.
    286285      ///\param b The top right corner.
    287286      ///\warning The coordinates of the bottom left corner must be no more
    288287      ///than those of the top right one.
    289       BoundingBox(Point<T> a,Point<T> b)
     288      Box(Point<T> a,Point<T> b)
    290289      {
    291290        _bottom_left = a;
    … …  
    294293      }
    295294
    296       ///Construct an instance from four numbers
    297 
    298       ///Construct an instance from four numbers.
     295      ///Construct a box from four numbers
     296
     297      ///Construct a box from four numbers.
    299298      ///\param l The left side of the box.
    300299      ///\param b The bottom of the box.
    … …  
    303302      ///\warning The left side must be no more than the right side and
    304303      ///bottom must be no more than the top.
    305       BoundingBox(T l,T b,T r,T t)
     304      Box(T l,T b,T r,T t)
    306305      {
    307306        _bottom_left=Point<T>(l,b);
    … …  
    310309      }
    311310
    312       ///Return \c true if the bounding box is empty.
    313 
    314       ///Return \c true if the bounding box is empty (i.e. return \c false
     311      ///Return \c true if the box is empty.
     312
     313      ///Return \c true if the box is empty (i.e. return \c false
    315314      ///if at least one point was added to the box or the coordinates of
    316315      ///the box were set).
    317316      ///
    318       ///The coordinates of an empty bounding box are not defined.
     317      ///The coordinates of an empty box are not defined.
    319318      bool empty() const {
    320319        return _empty;
    321320      }
    322321
    323       ///Make the BoundingBox empty
     322      ///Make the box empty
    324323      void clear() {
    325324        _empty = true;
    … …  
    329328
    330329      ///Give back the bottom left corner of the box.
    331       ///If the bounding box is empty, then the return value is not defined.
     330      ///If the box is empty, then the return value is not defined.
    332331      Point<T> bottomLeft() const {
    333332        return _bottom_left;
    … …  
    345344
    346345      ///Give back the top right corner of the box.
    347       ///If the bounding box is empty, then the return value is not defined.
     346      ///If the box is empty, then the return value is not defined.
    348347      Point<T> topRight() const {
    349348        return _top_right;
    … …  
    361360
    362361      ///Give back the bottom right corner of the box.
    363       ///If the bounding box is empty, then the return value is not defined.
     362      ///If the box is empty, then the return value is not defined.
    364363      Point<T> bottomRight() const {
    365364        return Point<T>(_top_right.x,_bottom_left.y);
    … …  
    378377
    379378      ///Give back the top left corner of the box.
    380       ///If the bounding box is empty, then the return value is not defined.
     379      ///If the box is empty, then the return value is not defined.
    381380      Point<T> topLeft() const {
    382381        return Point<T>(_bottom_left.x,_top_right.y);
    … …  
    395394
    396395      ///Give back the bottom of the box.
    397       ///If the bounding box is empty, then the return value is not defined.
     396      ///If the box is empty, then the return value is not defined.
    398397      T bottom() const {
    399398        return _bottom_left.y;
    … …  
    411410
    412411      ///Give back the top of the box.
    413       ///If the bounding box is empty, then the return value is not defined.
     412      ///If the box is empty, then the return value is not defined.
    414413      T top() const {
    415414        return _top_right.y;
    … …  
    427426
    428427      ///Give back the left side of the box.
    429       ///If the bounding box is empty, then the return value is not defined.
     428      ///If the box is empty, then the return value is not defined.
    430429      T left() const {
    431430        return _bottom_left.x;
    … …  
    443442
    444443      /// Give back the right side of the box.
    445       ///If the bounding box is empty, then the return value is not defined.
     444      ///If the box is empty, then the return value is not defined.
    446445      T right() const {
    447446        return _top_right.x;
    … …  
    459458
    460459      ///Give back the height of the box.
    461       ///If the bounding box is empty, then the return value is not defined.
     460      ///If the box is empty, then the return value is not defined.
    462461      T height() const {
    463462        return _top_right.y-_bottom_left.y;
    … …  
    467466
    468467      ///Give back the width of the box.
    469       ///If the bounding box is empty, then the return value is not defined.
     468      ///If the box is empty, then the return value is not defined.
    470469      T width() const {
    471470        return _top_right.x-_bottom_left.x;
    472471      }
    473472
    474       ///Checks whether a point is inside a bounding box
     473      ///Checks whether a point is inside the box
    475474      bool inside(const Point<T>& u) const {
    476475        if (_empty)
    … …  
    482481      }
    483482
    484       ///Increments a bounding box with a point
    485 
    486       ///Increments a bounding box with a point.
     483      ///Increments the box with a point
     484
     485      ///Increments the box with a point.
    487486      ///
    488       BoundingBox& add(const Point<T>& u){
     487      Box& add(const Point<T>& u){
    489488        if (_empty) {
    490489          _bottom_left = _top_right = u;
    … …  
    500499      }
    501500
    502       ///Increments a bounding box to contain another bounding box
    503 
    504       ///Increments a bounding box to contain another bounding box.
     501      ///Increments the box to contain another box
     502
     503      ///Increments the box to contain another box.
    505504      ///
    506       BoundingBox& add(const BoundingBox &u){
     505      Box& add(const Box &u){
    507506        if ( !u.empty() ){
    508507          add(u._bottom_left);
    … …  
    512511      }
    513512
    514       ///Intersection of two bounding boxes
    515 
    516       ///Intersection of two bounding boxes.
     513      ///Intersection of two boxes
     514
     515      ///Intersection of two boxes.
    517516      ///
    518       BoundingBox operator&(const BoundingBox& u) const {
    519         BoundingBox b;
     517      Box operator&(const Box& u) const {
     518        Box b;
    520519        if (_empty || u._empty) {
    521520          b._empty = true;
    … …  
    531530      }
    532531
    533     };//class Boundingbox
    534 
     532  };//class Box
     533
     534
     535  ///Read a box from a stream
     536
     537  ///Read a box from a stream.
     538  ///\relates Box
     539  template<typename T>
     540  inline std::istream& operator>>(std::istream &is, Box<T>& b) {
     541    char c;
     542    Point<T> p;
     543    if (is >> c) {
     544      if (c != '(') is.putback(c);
     545    } else {
     546      is.clear();
     547    }
     548    if (!(is >> p)) return is;
     549    b.bottomLeft(p);
     550    if (is >> c) {
     551      if (c != ',') is.putback(c);
     552    } else {
     553      is.clear();
     554    }
     555    if (!(is >> p)) return is;
     556    b.topRight(p);
     557    if (is >> c) {
     558      if (c != ')') is.putback(c);
     559    } else {
     560      is.clear();
     561    }
     562    return is;
     563  }
     564
     565  ///Write a box to a stream
     566
     567  ///Write a box to a stream.
     568  ///\relates Box
     569  template<typename T>
     570  inline std::ostream& operator<<(std::ostream &os, const Box<T>& b)
     571  {
     572    os << "(" << b.bottomLeft() << "," << b.topRight() << ")";
     573    return os;
     574  }
    535575
    536576  ///Map of x-coordinates of a \ref Point "Point"-map
Note: See TracChangeset for help on using the changeset viewer.