... |
... |
@@ -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;
|