| ... |
... |
@@ -28,8 +28,7 @@
|
| 28 |
28 |
/// The class \ref lemon::dim2::Point "dim2::Point" implements
|
| 29 |
29 |
/// a two dimensional vector with the usual operations.
|
| 30 |
30 |
///
|
| 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
|
| 33 |
32 |
/// the rectangular bounding box of a set of
|
| 34 |
33 |
/// \ref lemon::dim2::Point "dim2::Point"'s.
|
| 35 |
34 |
|
| ... |
... |
@@ -44,7 +43,7 @@
|
| 44 |
43 |
/// \addtogroup misc
|
| 45 |
44 |
/// @{
|
| 46 |
45 |
|
| 47 |
|
/// A simple two dimensional vector (plain vector) implementation
|
|
46 |
/// Two dimensional vector (plain vector)
|
| 48 |
47 |
|
| 49 |
48 |
/// A simple two dimensional vector (plain vector) implementation
|
| 50 |
49 |
/// with the usual vector operations.
|
| ... |
... |
@@ -260,67 +259,67 @@
|
| 260 |
259 |
|
| 261 |
260 |
|
| 262 |
261 |
|
| 263 |
|
/// A class to calculate or store the bounding box of plain vectors.
|
|
262 |
/// Bounding box of plain vectors (\ref Point points).
|
| 264 |
263 |
|
| 265 |
|
/// A class to calculate or store the bounding box of plain vectors.
|
| 266 |
|
///
|
| 267 |
|
template<typename T>
|
| 268 |
|
class BoundingBox {
|
|
264 |
/// A class to calculate or store the bounding box of plain vectors
|
|
265 |
/// (\ref Point points).
|
|
266 |
template<typename T>
|
|
267 |
class Box {
|
| 269 |
268 |
Point<T> _bottom_left, _top_right;
|
| 270 |
269 |
bool _empty;
|
| 271 |
270 |
public:
|
| 272 |
271 |
|
| 273 |
|
///Default constructor: creates an empty bounding box
|
| 274 |
|
BoundingBox() { _empty = true; }
|
|
272 |
///Default constructor: creates an empty box
|
|
273 |
Box() { _empty = true; }
|
| 275 |
274 |
|
| 276 |
|
///Construct an instance from one point
|
| 277 |
|
BoundingBox(Point<T> a) {
|
|
275 |
///Construct a box from one point
|
|
276 |
Box(Point<T> a) {
|
| 278 |
277 |
_bottom_left = _top_right = a;
|
| 279 |
278 |
_empty = false;
|
| 280 |
279 |
}
|
| 281 |
280 |
|
| 282 |
|
///Construct an instance from two points
|
|
281 |
///Construct a box from two points
|
| 283 |
282 |
|
| 284 |
|
///Construct an instance from two points.
|
|
283 |
///Construct a box from two points.
|
| 285 |
284 |
///\param a The bottom left corner.
|
| 286 |
285 |
///\param b The top right corner.
|
| 287 |
286 |
///\warning The coordinates of the bottom left corner must be no more
|
| 288 |
287 |
///than those of the top right one.
|
| 289 |
|
BoundingBox(Point<T> a,Point<T> b)
|
|
288 |
Box(Point<T> a,Point<T> b)
|
| 290 |
289 |
{
|
| 291 |
290 |
_bottom_left = a;
|
| 292 |
291 |
_top_right = b;
|
| 293 |
292 |
_empty = false;
|
| 294 |
293 |
}
|
| 295 |
294 |
|
| 296 |
|
///Construct an instance from four numbers
|
|
295 |
///Construct a box from four numbers
|
| 297 |
296 |
|
| 298 |
|
///Construct an instance from four numbers.
|
|
297 |
///Construct a box from four numbers.
|
| 299 |
298 |
///\param l The left side of the box.
|
| 300 |
299 |
///\param b The bottom of the box.
|
| 301 |
300 |
///\param r The right side of the box.
|
| 302 |
301 |
///\param t The top of the box.
|
| 303 |
302 |
///\warning The left side must be no more than the right side and
|
| 304 |
303 |
///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)
|
| 306 |
305 |
{
|
| 307 |
306 |
_bottom_left=Point<T>(l,b);
|
| 308 |
307 |
_top_right=Point<T>(r,t);
|
| 309 |
308 |
_empty = false;
|
| 310 |
309 |
}
|
| 311 |
310 |
|
| 312 |
|
///Return \c true if the bounding box is empty.
|
|
311 |
///Return \c true if the box is empty.
|
| 313 |
312 |
|
| 314 |
|
///Return \c true if the bounding box is empty (i.e. return \c false
|
|
313 |
///Return \c true if the box is empty (i.e. return \c false
|
| 315 |
314 |
///if at least one point was added to the box or the coordinates of
|
| 316 |
315 |
///the box were set).
|
| 317 |
316 |
///
|
| 318 |
|
///The coordinates of an empty bounding box are not defined.
|
|
317 |
///The coordinates of an empty box are not defined.
|
| 319 |
318 |
bool empty() const {
|
| 320 |
319 |
return _empty;
|
| 321 |
320 |
}
|
| 322 |
321 |
|
| 323 |
|
///Make the BoundingBox empty
|
|
322 |
///Make the box empty
|
| 324 |
323 |
void clear() {
|
| 325 |
324 |
_empty = true;
|
| 326 |
325 |
}
|
| ... |
... |
@@ -328,7 +327,7 @@
|
| 328 |
327 |
///Give back the bottom left corner of the box
|
| 329 |
328 |
|
| 330 |
329 |
///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.
|
| 332 |
331 |
Point<T> bottomLeft() const {
|
| 333 |
332 |
return _bottom_left;
|
| 334 |
333 |
}
|
| ... |
... |
@@ -344,7 +343,7 @@
|
| 344 |
343 |
///Give back the top right corner of the box
|
| 345 |
344 |
|
| 346 |
345 |
///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.
|
| 348 |
347 |
Point<T> topRight() const {
|
| 349 |
348 |
return _top_right;
|
| 350 |
349 |
}
|
| ... |
... |
@@ -360,7 +359,7 @@
|
| 360 |
359 |
///Give back the bottom right corner of the box
|
| 361 |
360 |
|
| 362 |
361 |
///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.
|
| 364 |
363 |
Point<T> bottomRight() const {
|
| 365 |
364 |
return Point<T>(_top_right.x,_bottom_left.y);
|
| 366 |
365 |
}
|
| ... |
... |
@@ -377,7 +376,7 @@
|
| 377 |
376 |
///Give back the top left corner of the box
|
| 378 |
377 |
|
| 379 |
378 |
///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.
|
| 381 |
380 |
Point<T> topLeft() const {
|
| 382 |
381 |
return Point<T>(_bottom_left.x,_top_right.y);
|
| 383 |
382 |
}
|
| ... |
... |
@@ -394,7 +393,7 @@
|
| 394 |
393 |
///Give back the bottom of the box
|
| 395 |
394 |
|
| 396 |
395 |
///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.
|
| 398 |
397 |
T bottom() const {
|
| 399 |
398 |
return _bottom_left.y;
|
| 400 |
399 |
}
|
| ... |
... |
@@ -410,7 +409,7 @@
|
| 410 |
409 |
///Give back the top of the box
|
| 411 |
410 |
|
| 412 |
411 |
///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.
|
| 414 |
413 |
T top() const {
|
| 415 |
414 |
return _top_right.y;
|
| 416 |
415 |
}
|
| ... |
... |
@@ -426,7 +425,7 @@
|
| 426 |
425 |
///Give back the left side of the box
|
| 427 |
426 |
|
| 428 |
427 |
///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.
|
| 430 |
429 |
T left() const {
|
| 431 |
430 |
return _bottom_left.x;
|
| 432 |
431 |
}
|
| ... |
... |
@@ -442,7 +441,7 @@
|
| 442 |
441 |
/// Give back the right side of the box
|
| 443 |
442 |
|
| 444 |
443 |
/// 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.
|
| 446 |
445 |
T right() const {
|
| 447 |
446 |
return _top_right.x;
|
| 448 |
447 |
}
|
| ... |
... |
@@ -458,7 +457,7 @@
|
| 458 |
457 |
///Give back the height of the box
|
| 459 |
458 |
|
| 460 |
459 |
///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.
|
| 462 |
461 |
T height() const {
|
| 463 |
462 |
return _top_right.y-_bottom_left.y;
|
| 464 |
463 |
}
|
| ... |
... |
@@ -466,12 +465,12 @@
|
| 466 |
465 |
///Give back the width of the box
|
| 467 |
466 |
|
| 468 |
467 |
///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.
|
| 470 |
469 |
T width() const {
|
| 471 |
470 |
return _top_right.x-_bottom_left.x;
|
| 472 |
471 |
}
|
| 473 |
472 |
|
| 474 |
|
///Checks whether a point is inside a bounding box
|
|
473 |
///Checks whether a point is inside the box
|
| 475 |
474 |
bool inside(const Point<T>& u) const {
|
| 476 |
475 |
if (_empty)
|
| 477 |
476 |
return false;
|
| ... |
... |
@@ -481,11 +480,11 @@
|
| 481 |
480 |
}
|
| 482 |
481 |
}
|
| 483 |
482 |
|
| 484 |
|
///Increments a bounding box with a point
|
|
483 |
///Increments the box with a point
|
| 485 |
484 |
|
| 486 |
|
///Increments a bounding box with a point.
|
|
485 |
///Increments the box with a point.
|
| 487 |
486 |
///
|
| 488 |
|
BoundingBox& add(const Point<T>& u){
|
|
487 |
Box& add(const Point<T>& u){
|
| 489 |
488 |
if (_empty) {
|
| 490 |
489 |
_bottom_left = _top_right = u;
|
| 491 |
490 |
_empty = false;
|
| ... |
... |
@@ -499,11 +498,11 @@
|
| 499 |
498 |
return *this;
|
| 500 |
499 |
}
|
| 501 |
500 |
|
| 502 |
|
///Increments a bounding box to contain another bounding box
|
|
501 |
///Increments the box to contain another box
|
| 503 |
502 |
|
| 504 |
|
///Increments a bounding box to contain another bounding box.
|
|
503 |
///Increments the box to contain another box.
|
| 505 |
504 |
///
|
| 506 |
|
BoundingBox& add(const BoundingBox &u){
|
|
505 |
Box& add(const Box &u){
|
| 507 |
506 |
if ( !u.empty() ){
|
| 508 |
507 |
add(u._bottom_left);
|
| 509 |
508 |
add(u._top_right);
|
| ... |
... |
@@ -511,12 +510,12 @@
|
| 511 |
510 |
return *this;
|
| 512 |
511 |
}
|
| 513 |
512 |
|
| 514 |
|
///Intersection of two bounding boxes
|
|
513 |
///Intersection of two boxes
|
| 515 |
514 |
|
| 516 |
|
///Intersection of two bounding boxes.
|
|
515 |
///Intersection of two boxes.
|
| 517 |
516 |
///
|
| 518 |
|
BoundingBox operator&(const BoundingBox& u) const {
|
| 519 |
|
BoundingBox b;
|
|
517 |
Box operator&(const Box& u) const {
|
|
518 |
Box b;
|
| 520 |
519 |
if (_empty || u._empty) {
|
| 521 |
520 |
b._empty = true;
|
| 522 |
521 |
} else {
|
| ... |
... |
@@ -530,15 +529,15 @@
|
| 530 |
529 |
return b;
|
| 531 |
530 |
}
|
| 532 |
531 |
|
| 533 |
|
};//class Boundingbox
|
|
532 |
};//class Box
|
| 534 |
533 |
|
| 535 |
534 |
|
| 536 |
|
///Read a bounding box from a stream
|
|
535 |
///Read a box from a stream
|
| 537 |
536 |
|
| 538 |
|
///Read a bounding box from a stream.
|
| 539 |
|
///\relates BoundingBox
|
|
537 |
///Read a box from a stream.
|
|
538 |
///\relates Box
|
| 540 |
539 |
template<typename T>
|
| 541 |
|
inline std::istream& operator>>(std::istream &is, BoundingBox<T>& b) {
|
|
540 |
inline std::istream& operator>>(std::istream &is, Box<T>& b) {
|
| 542 |
541 |
char c;
|
| 543 |
542 |
Point<T> p;
|
| 544 |
543 |
if (is >> c) {
|
| ... |
... |
@@ -563,12 +562,12 @@
|
| 563 |
562 |
return is;
|
| 564 |
563 |
}
|
| 565 |
564 |
|
| 566 |
|
///Write a bounding box to a stream
|
|
565 |
///Write a box to a stream
|
| 567 |
566 |
|
| 568 |
|
///Write a bounding box to a stream.
|
| 569 |
|
///\relates BoundingBox
|
|
567 |
///Write a box to a stream.
|
|
568 |
///\relates Box
|
| 570 |
569 |
template<typename T>
|
| 571 |
|
inline std::ostream& operator<<(std::ostream &os, const BoundingBox<T>& b)
|
|
570 |
inline std::ostream& operator<<(std::ostream &os, const Box<T>& b)
|
| 572 |
571 |
{
|
| 573 |
572 |
os << "(" << b.bottomLeft() << "," << b.topRight() << ")";
|
| 574 |
573 |
return os;
|