36 #ifndef VIGRA_BASICIMAGE_HXX
37 #define VIGRA_BASICIMAGE_HXX
41 #include "utilities.hxx"
42 #include "iteratortraits.hxx"
43 #include "accessor.hxx"
45 #include "basicimageview.hxx"
48 #ifdef VIGRA_CHECK_BOUNDS
49 #define VIGRA_ASSERT_INSIDE(diff) \
50 vigra_precondition(this->isInside(diff), "Index out of bounds")
52 #define VIGRA_ASSERT_INSIDE(diff)
57 template <
class IMAGEITERATOR>
58 class LineBasedColumnIteratorPolicy
61 typedef IMAGEITERATOR ImageIterator;
62 typedef typename IMAGEITERATOR::LineStartIterator LineStartIterator;
63 typedef typename IMAGEITERATOR::value_type value_type;
64 typedef typename IMAGEITERATOR::difference_type::MoveY
66 typedef typename IMAGEITERATOR::reference reference;
67 typedef typename IMAGEITERATOR::index_reference index_reference;
68 typedef typename IMAGEITERATOR::pointer pointer;
69 typedef std::random_access_iterator_tag iterator_category;
74 explicit BaseType(LineStartIterator c = LineStartIterator(),
75 difference_type o = 0)
76 : line_start_(c), offset_(o)
79 LineStartIterator line_start_;
80 difference_type offset_;
83 static void initialize(BaseType &) {}
85 static reference dereference(BaseType
const & d)
86 {
return const_cast<reference
>(*(*d.line_start_ + d.offset_)); }
88 static index_reference dereference(BaseType
const & d, difference_type n)
90 return const_cast<index_reference
>(*(d.line_start_[n] + d.offset_));
93 static bool equal(BaseType
const & d1, BaseType
const & d2)
94 {
return d1.line_start_ == d2.line_start_; }
96 static bool less(BaseType
const & d1, BaseType
const & d2)
97 {
return d1.line_start_ < d2.line_start_; }
99 static difference_type difference(BaseType
const & d1, BaseType
const & d2)
100 {
return d1.line_start_ - d2.line_start_; }
102 static void increment(BaseType & d)
105 static void decrement(BaseType & d)
108 static void advance(BaseType & d, difference_type n)
109 { d.line_start_ += n; }
124 template <
class IMAGEITERATOR,
class PIXELTYPE,
125 class REFERENCE,
class POINTER,
class LINESTARTITERATOR>
130 PIXELTYPE, REFERENCE, POINTER, LINESTARTITERATOR>
self_type;
132 typedef LINESTARTITERATOR LineStartIterator;
133 typedef PIXELTYPE value_type;
134 typedef PIXELTYPE PixelType;
135 typedef REFERENCE reference;
136 typedef REFERENCE index_reference;
137 typedef POINTER pointer;
138 typedef Diff2D difference_type;
139 typedef image_traverser_tag iterator_category;
140 typedef POINTER row_iterator;
145 typedef LINESTARTITERATOR MoveY;
150 IMAGEITERATOR & operator+=(difference_type
const & s)
154 return static_cast<IMAGEITERATOR &
>(*this);
157 IMAGEITERATOR & operator-=(difference_type
const & s)
161 return static_cast<IMAGEITERATOR &
>(*this);
164 IMAGEITERATOR operator+(difference_type
const & s)
const
166 IMAGEITERATOR ret(static_cast<IMAGEITERATOR const &>(*
this));
173 IMAGEITERATOR operator-(difference_type
const & s)
const
175 IMAGEITERATOR ret(static_cast<IMAGEITERATOR const &>(*
this));
190 return (x == rhs.x) && (y == rhs.y);
195 return (x != rhs.x) || (y != rhs.y);
198 reference operator*()
const
203 pointer operator->()
const
208 index_reference operator[](difference_type
const & d)
const
210 return *(*(y + d.
y) + x + d.
x);
213 index_reference operator()(
int dx,
int dy)
const
215 return *(*(y + dy) + x + dx);
218 pointer operator[](
int dy)
const
223 row_iterator rowIterator()
const
226 column_iterator columnIterator()
const
228 typedef typename column_iterator::BaseType Iter;
229 return column_iterator(Iter(y, x));
261 template <
class PIXELTYPE,
class ITERATOR>
264 PIXELTYPE, PIXELTYPE &, PIXELTYPE *, ITERATOR>
269 PIXELTYPE &, PIXELTYPE *, ITERATOR>
Base;
272 BasicImageIterator(ITERATOR line)
293 template <
class PIXELTYPE,
class ITERATOR>
296 PIXELTYPE, PIXELTYPE const &, PIXELTYPE const *, ITERATOR>
301 PIXELTYPE, PIXELTYPE
const &, PIXELTYPE
const *, ITERATOR>
Base;
304 ConstBasicImageIterator(ITERATOR line)
312 ConstBasicImageIterator()
316 ConstBasicImageIterator &
333 #ifndef NO_PARTIAL_TEMPLATE_SPECIALIZATION
337 :
public IteratorTraitsBase<BasicImageIterator<T, T**> >
342 typedef DefaultAccessor default_accessor;
343 typedef VigraTrueType hasConstantStrides;
347 struct IteratorTraits<ConstBasicImageIterator<T, T**> >
348 :
public IteratorTraitsBase<ConstBasicImageIterator<T, T**> >
350 typedef BasicImageIterator<T, T**> mutable_iterator;
351 typedef ConstBasicImageIterator<T, T**> const_iterator;
352 typedef typename AccessorTraits<T>::default_const_accessor DefaultAccessor;
353 typedef DefaultAccessor default_accessor;
354 typedef VigraTrueType hasConstantStrides;
357 #else // NO_PARTIAL_TEMPLATE_SPECIALIZATION
359 #define VIGRA_DEFINE_ITERATORTRAITS(VALUETYPE) \
361 struct IteratorTraits<BasicImageIterator<VALUETYPE, VALUETYPE **> > \
362 : public IteratorTraitsBase<BasicImageIterator<VALUETYPE, VALUETYPE **> > \
364 typedef BasicImageIterator<VALUETYPE, VALUETYPE**> mutable_iterator; \
365 typedef ConstBasicImageIterator<VALUETYPE, VALUETYPE**> const_iterator; \
366 typedef typename AccessorTraits<VALUETYPE >::default_accessor DefaultAccessor; \
367 typedef DefaultAccessor default_accessor; \
368 typedef VigraTrueType hasConstantStrides; \
372 struct IteratorTraits<ConstBasicImageIterator<VALUETYPE, VALUETYPE **> > \
373 : public IteratorTraitsBase<ConstBasicImageIterator<VALUETYPE, VALUETYPE **> > \
375 typedef BasicImageIterator<VALUETYPE, VALUETYPE**> mutable_iterator; \
376 typedef ConstBasicImageIterator<VALUETYPE, VALUETYPE**> const_iterator; \
377 typedef typename AccessorTraits<VALUETYPE >::default_const_accessor DefaultAccessor; \
378 typedef DefaultAccessor default_accessor; \
379 typedef VigraTrueType hasConstantStrides; \
382 VIGRA_DEFINE_ITERATORTRAITS(RGBValue<unsigned char>)
383 VIGRA_DEFINE_ITERATORTRAITS(RGBValue<
short>)
384 VIGRA_DEFINE_ITERATORTRAITS(RGBValue<
unsigned short>)
385 VIGRA_DEFINE_ITERATORTRAITS(RGBValue<
int>)
386 VIGRA_DEFINE_ITERATORTRAITS(RGBValue<
unsigned int>)
387 VIGRA_DEFINE_ITERATORTRAITS(RGBValue<
float>)
388 VIGRA_DEFINE_ITERATORTRAITS(RGBValue<
double>)
390 #define VIGRA_PIXELTYPE TinyVector<unsigned char, 2>
391 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
392 #undef VIGRA_PIXELTYPE
393 #define VIGRA_PIXELTYPE TinyVector<unsigned char, 3>
394 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
395 #undef VIGRA_PIXELTYPE
396 #define VIGRA_PIXELTYPE TinyVector<unsigned char, 4>
397 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
398 #undef VIGRA_PIXELTYPE
399 #define VIGRA_PIXELTYPE TinyVector<short, 2>
400 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
401 #undef VIGRA_PIXELTYPE
402 #define VIGRA_PIXELTYPE TinyVector<short, 3>
403 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
404 #undef VIGRA_PIXELTYPE
405 #define VIGRA_PIXELTYPE TinyVector<short, 4>
406 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
407 #undef VIGRA_PIXELTYPE
408 #define VIGRA_PIXELTYPE TinyVector<unsigned short, 2>
409 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
410 #undef VIGRA_PIXELTYPE
411 #define VIGRA_PIXELTYPE TinyVector<unsigned short, 3>
412 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
413 #undef VIGRA_PIXELTYPE
414 #define VIGRA_PIXELTYPE TinyVector<unsigned short, 4>
415 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
416 #undef VIGRA_PIXELTYPE
417 #define VIGRA_PIXELTYPE TinyVector<int, 2>
418 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
419 #undef VIGRA_PIXELTYPE
420 #define VIGRA_PIXELTYPE TinyVector<int, 3>
421 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
422 #undef VIGRA_PIXELTYPE
423 #define VIGRA_PIXELTYPE TinyVector<int, 4>
424 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
425 #undef VIGRA_PIXELTYPE
426 #define VIGRA_PIXELTYPE TinyVector<unsigned int, 2>
427 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
428 #undef VIGRA_PIXELTYPE
429 #define VIGRA_PIXELTYPE TinyVector<unsigned int, 3>
430 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
431 #undef VIGRA_PIXELTYPE
432 #define VIGRA_PIXELTYPE TinyVector<unsigned int, 4>
433 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
434 #undef VIGRA_PIXELTYPE
435 #define VIGRA_PIXELTYPE TinyVector<float, 2>
436 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
437 #undef VIGRA_PIXELTYPE
438 #define VIGRA_PIXELTYPE TinyVector<float, 3>
439 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
440 #undef VIGRA_PIXELTYPE
441 #define VIGRA_PIXELTYPE TinyVector<float, 4>
442 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
443 #undef VIGRA_PIXELTYPE
444 #define VIGRA_PIXELTYPE TinyVector<double, 2>
445 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
446 #undef VIGRA_PIXELTYPE
447 #define VIGRA_PIXELTYPE TinyVector<double, 3>
448 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
449 #undef VIGRA_PIXELTYPE
450 #define VIGRA_PIXELTYPE TinyVector<double, 4>
451 VIGRA_DEFINE_ITERATORTRAITS(VIGRA_PIXELTYPE)
452 #undef VIGRA_PIXELTYPE
454 #undef VIGRA_DEFINE_ITERATORTRAITS
456 #endif // NO_PARTIAL_TEMPLATE_SPECIALIZATION
472 template <
class PIXELTYPE,
class Alloc = std::allocator<PIXELTYPE> >
582 typedef Alloc Allocator;
583 typedef typename Alloc::template rebind<PIXELTYPE *>::other LineAllocator;
612 vigra_precondition((width >= 0) && (height >= 0),
613 "BasicImage::BasicImage(int width, int height): "
614 "width and height must be >= 0.\n");
628 vigra_precondition((size.
x >= 0) && (size.
y >= 0),
629 "BasicImage::BasicImage(Diff2D size): "
630 "size.x and size.y must be >= 0.\n");
632 resize(size.
x, size.
y, value_type());
640 BasicImage(
int width,
int height, value_type
const & d, Alloc
const & alloc = Alloc())
647 vigra_precondition((width >= 0) && (height >= 0),
648 "BasicImage::BasicImage(int width, int height, value_type const & ): "
649 "width and height must be >= 0.\n");
658 BasicImage(
int width,
int height, SkipInitializationTag, Alloc
const & alloc = Alloc())
665 vigra_precondition((width >= 0) && (height >= 0),
666 "BasicImage::BasicImage(int width, int height, value_type const & ): "
667 "width and height must be >= 0.\n");
669 resize(width, height, SkipInitialization);
676 explicit BasicImage(difference_type
const & size, value_type
const & d, Alloc
const & alloc = Alloc())
683 vigra_precondition((size.
x >= 0) && (size.
y >= 0),
684 "BasicImage::BasicImage(Diff2D const & size, value_type const & v): "
685 "size.x and size.y must be >= 0.\n");
693 explicit BasicImage(difference_type
const & size, SkipInitializationTag, Alloc
const & alloc = Alloc())
700 vigra_precondition((size.
x >= 0) && (size.
y >= 0),
701 "BasicImage::BasicImage(Diff2D const & size, value_type const & v): "
702 "size.x and size.y must be >= 0.\n");
704 resize(size.
x, size.
y, SkipInitialization);
711 BasicImage(
int width,
int height, const_pointer d, Alloc
const & alloc = Alloc())
718 vigra_precondition((width >= 0) && (height >= 0),
719 "BasicImage::BasicImage(int width, int height, const_pointer ): "
720 "width and height must be >= 0.\n");
728 explicit BasicImage(difference_type
const & size, const_pointer d, Alloc
const & alloc = Alloc())
735 vigra_precondition((size.
x >= 0) && (size.
y >= 0),
736 "BasicImage::BasicImage(Diff2D const & size, const_pointer): "
737 "size.x and size.y must be >= 0.\n");
748 allocator_(rhs.allocator_),
749 pallocator_(rhs.pallocator_)
778 if(width != width_ || height != height_)
785 void resize(difference_type
const & size)
787 if(size.
x != width_ || size.
y != height_)
789 resize(size.
x, size.
y, value_type());
798 void resize(
int width,
int height, value_type
const & d)
800 resizeImpl(width, height, d,
false);
814 void resize(
int width,
int height, SkipInitializationTag)
816 resizeImpl(width, height, NumericTraits<value_type>::zero(),
817 CanSkipInitialization<value_type>::value);
861 return d.
x >= 0 && d.
y >= 0 &&
870 VIGRA_ASSERT_INSIDE(d);
871 return lines_[d.
y][d.
x];
879 VIGRA_ASSERT_INSIDE(d);
880 return lines_[d.
y][d.
x];
889 return lines_[dy][dx];
898 return lines_[dy][dx];
925 vigra_precondition(data_ != 0,
926 "BasicImage::upperLeft(): image must have non-zero size.");
936 vigra_precondition(data_ != 0,
937 "BasicImage::lowerRight(): image must have non-zero size.");
945 vigra_precondition(data_ != 0,
946 "BasicImage::upperLeft(): image must have non-zero size.");
956 vigra_precondition(data_ != 0,
957 "BasicImage::lowerRight(): image must have non-zero size.");
965 vigra_precondition(data_ != 0,
966 "BasicImage::begin(): image must have non-zero size.");
974 vigra_precondition(data_ != 0,
975 "BasicImage::end(): image must have non-zero size.");
983 vigra_precondition(data_ != 0,
984 "BasicImage::begin(): image must have non-zero size.");
990 const_iterator
end()
const
992 vigra_precondition(data_ != 0,
993 "BasicImage::end(): image must have non-zero size.");
1029 typedef typename column_iterator::BaseType Iter;
1044 typedef typename const_column_iterator::BaseType Iter;
1079 void resizeImpl(
int width,
int height, value_type
const & d,
bool skipInit);
1082 value_type ** initLineStartArray(value_type *
data,
int width,
int height);
1085 PIXELTYPE ** lines_;
1086 int width_, height_;
1088 LineAllocator pallocator_;
1091 template <
class PIXELTYPE,
class Alloc>
1092 BasicImage<PIXELTYPE, Alloc> &
1097 if((width() != rhs.
width()) ||
1098 (height() != rhs.
height()))
1104 ConstScanOrderIterator is = rhs.
begin();
1105 ConstScanOrderIterator iend = rhs.
end();
1106 ScanOrderIterator
id = begin();
1108 for(; is != iend; ++is, ++id) *
id = *is;
1114 template <
class PIXELTYPE,
class Alloc>
1118 ScanOrderIterator i = begin();
1119 ScanOrderIterator iend = end();
1121 for(; i != iend; ++i) *i = pixel;
1126 template <
class PIXELTYPE,
class Alloc>
1130 ScanOrderIterator i = begin();
1131 ScanOrderIterator iend = end();
1133 for(; i != iend; ++i) *i = pixel;
1138 template <
class PIXELTYPE,
class Alloc>
1142 vigra_precondition((width >= 0) && (height >= 0),
1143 "BasicImage::resize(int width, int height, value_type const &): "
1144 "width and height must be >= 0.\n");
1145 vigra_precondition(width * height >= 0,
1146 "BasicImage::resize(int width, int height, value_type const &): "
1147 "width * height too large (integer overflow -> negative).\n");
1149 if (width_ != width || height_ != height)
1151 value_type * newdata = 0;
1152 value_type ** newlines = 0;
1153 if(width*height > 0)
1155 if (width*height != width_*height_)
1157 newdata = allocator_.allocate(
typename Alloc::size_type(width*height));
1159 std::uninitialized_fill_n(newdata, width*height, d);
1160 newlines = initLineStartArray(newdata, width, height);
1167 std::fill_n(newdata, width*height, d);
1168 newlines = initLineStartArray(newdata, width, height);
1169 pallocator_.deallocate(lines_,
typename Alloc::size_type(height_));
1182 else if(width*height > 0 && !skipInit)
1184 std::fill_n(data_, width*height, d);
1189 template <
class PIXELTYPE,
class Alloc>
1193 int newsize = width*height;
1194 if (width_ != width || height_ != height)
1196 value_type * newdata = 0;
1197 value_type ** newlines = 0;
1200 if (newsize != width_*height_)
1202 newdata = allocator_.allocate(
typename Alloc::size_type(newsize));
1203 std::uninitialized_copy(data, data + newsize, newdata);
1204 newlines = initLineStartArray(newdata, width, height);
1210 std::copy(data, data + newsize, newdata);
1211 newlines = initLineStartArray(newdata, width, height);
1212 pallocator_.deallocate(lines_,
typename Alloc::size_type(height_));
1225 else if(newsize > 0)
1227 std::copy(data, data + newsize, data_);
1231 template <
class PIXELTYPE,
class Alloc>
1237 std::swap( data_, rhs.data_ );
1238 std::swap( lines_, rhs.lines_ );
1239 std::swap( width_, rhs.width_ );
1240 std::swap( height_, rhs.height_ );
1244 template <
class PIXELTYPE,
class Alloc>
1250 ScanOrderIterator i = begin();
1251 ScanOrderIterator iend = end();
1253 for(; i != iend; ++i) (*i).~PIXELTYPE();
1255 allocator_.deallocate(data_,
typename Alloc::size_type(width()*height()));
1256 pallocator_.deallocate(lines_,
typename Alloc::size_type(height_));
1260 template <
class PIXELTYPE,
class Alloc>
1262 BasicImage<PIXELTYPE, Alloc>::initLineStartArray(value_type * data,
int width,
int height)
1264 value_type ** lines = pallocator_.allocate(
typename Alloc::size_type(height));
1265 for(
int y=0; y<height; ++y)
1266 lines[y] = data + y*width;
1276 template <
class PixelType,
class Accessor,
class Alloc>
1277 inline triple<typename BasicImage<PixelType, Alloc>::const_traverser,
1278 typename BasicImage<PixelType, Alloc>::const_traverser, Accessor>
1279 srcImageRange(BasicImage<PixelType, Alloc>
const & img, Accessor a)
1281 return triple<typename BasicImage<PixelType, Alloc>::const_traverser,
1282 typename BasicImage<PixelType, Alloc>::const_traverser,
1283 Accessor>(img.upperLeft(),
1288 template <
class PixelType,
class Accessor,
class Alloc>
1289 inline triple<typename BasicImage<PixelType, Alloc>::const_traverser,
1290 typename BasicImage<PixelType, Alloc>::const_traverser, Accessor>
1291 srcImageRange(BasicImage<PixelType, Alloc>
const & img, Rect2D
const & roi, Accessor a)
1293 vigra_precondition(roi.left() >= 0 && roi.top() >= 0 &&
1294 roi.right() <= img.width() && roi.bottom() <= img.height(),
1295 "srcImageRange(): ROI rectangle outside image.");
1296 return triple<typename BasicImage<PixelType, Alloc>::const_traverser,
1297 typename BasicImage<PixelType, Alloc>::const_traverser,
1298 Accessor>(img.upperLeft() + roi.upperLeft(),
1299 img.upperLeft() + roi.lowerRight(),
1303 template <
class PixelType,
class Accessor,
class Alloc>
1304 inline pair<typename BasicImage<PixelType, Alloc>::const_traverser, Accessor>
1305 srcImage(BasicImage<PixelType, Alloc>
const & img, Accessor a)
1307 return pair<typename BasicImage<PixelType, Alloc>::const_traverser,
1308 Accessor>(img.upperLeft(), a);
1311 template <
class PixelType,
class Accessor,
class Alloc>
1312 inline pair<typename BasicImage<PixelType, Alloc>::const_traverser, Accessor>
1313 srcImage(BasicImage<PixelType, Alloc>
const & img, Point2D
const & ul, Accessor a)
1315 vigra_precondition(img.isInside(ul),
1316 "srcImage(): ROI rectangle outside image.");
1317 return pair<typename BasicImage<PixelType, Alloc>::const_traverser,
1318 Accessor>(img.upperLeft() + ul, a);
1321 template <
class PixelType,
class Accessor,
class Alloc>
1322 inline triple<typename BasicImage<PixelType, Alloc>::traverser,
1323 typename BasicImage<PixelType, Alloc>::traverser, Accessor>
1324 destImageRange(BasicImage<PixelType, Alloc> & img, Accessor a)
1326 return triple<typename BasicImage<PixelType, Alloc>::traverser,
1327 typename BasicImage<PixelType, Alloc>::traverser,
1328 Accessor>(img.upperLeft(),
1333 template <
class PixelType,
class Accessor,
class Alloc>
1334 inline triple<typename BasicImage<PixelType, Alloc>::traverser,
1335 typename BasicImage<PixelType, Alloc>::traverser, Accessor>
1336 destImageRange(BasicImage<PixelType, Alloc> & img, Rect2D
const & roi, Accessor a)
1338 vigra_precondition(roi.left() >= 0 && roi.top() >= 0 &&
1339 roi.right() <= img.width() && roi.bottom() <= img.height(),
1340 "destImageRange(): ROI rectangle outside image.");
1341 return triple<typename BasicImage<PixelType, Alloc>::traverser,
1342 typename BasicImage<PixelType, Alloc>::traverser,
1343 Accessor>(img.upperLeft() + roi.upperLeft(),
1344 img.upperLeft() + roi.lowerRight(),
1348 template <
class PixelType,
class Accessor,
class Alloc>
1349 inline pair<typename BasicImage<PixelType, Alloc>::traverser, Accessor>
1350 destImage(BasicImage<PixelType, Alloc> & img, Accessor a)
1352 return pair<typename BasicImage<PixelType, Alloc>::traverser,
1353 Accessor>(img.upperLeft(), a);
1356 template <
class PixelType,
class Accessor,
class Alloc>
1357 inline pair<typename BasicImage<PixelType, Alloc>::traverser, Accessor>
1358 destImage(BasicImage<PixelType, Alloc> & img, Point2D
const & ul, Accessor a)
1360 vigra_precondition(img.isInside(ul),
1361 "destImage(): ROI rectangle outside image.");
1362 return pair<typename BasicImage<PixelType, Alloc>::traverser,
1363 Accessor>(img.upperLeft() + ul, a);
1366 template <
class PixelType,
class Accessor,
class Alloc>
1367 inline pair<typename BasicImage<PixelType, Alloc>::const_traverser, Accessor>
1368 maskImage(BasicImage<PixelType, Alloc>
const & img, Accessor a)
1370 return pair<typename BasicImage<PixelType, Alloc>::const_traverser,
1371 Accessor>(img.upperLeft(), a);
1374 template <
class PixelType,
class Accessor,
class Alloc>
1375 inline pair<typename BasicImage<PixelType, Alloc>::const_traverser, Accessor>
1376 maskImage(BasicImage<PixelType, Alloc>
const & img, Point2D
const & ul, Accessor a)
1378 vigra_precondition(img.isInside(ul),
1379 "maskImage(): ROI rectangle outside image.");
1380 return pair<typename BasicImage<PixelType, Alloc>::const_traverser,
1381 Accessor>(img.upperLeft() + ul, a);
1386 template <
class PixelType,
class Alloc>
1387 inline triple<typename BasicImage<PixelType, Alloc>::const_traverser,
1388 typename BasicImage<PixelType, Alloc>::const_traverser,
1389 typename BasicImage<PixelType, Alloc>::ConstAccessor>
1390 srcImageRange(BasicImage<PixelType, Alloc>
const & img)
1392 return triple<typename BasicImage<PixelType, Alloc>::const_traverser,
1393 typename BasicImage<PixelType, Alloc>::const_traverser,
1394 typename BasicImage<PixelType, Alloc>::ConstAccessor>(img.upperLeft(),
1399 template <
class PixelType,
class Alloc>
1400 inline triple<typename BasicImage<PixelType, Alloc>::const_traverser,
1401 typename BasicImage<PixelType, Alloc>::const_traverser,
1402 typename BasicImage<PixelType, Alloc>::ConstAccessor>
1403 srcImageRange(BasicImage<PixelType, Alloc>
const & img, Rect2D
const & roi)
1405 vigra_precondition(roi.left() >= 0 && roi.top() >= 0 &&
1406 roi.right() <= img.width() && roi.bottom() <= img.height(),
1407 "srcImageRange(): ROI rectangle outside image.");
1408 return triple<typename BasicImage<PixelType, Alloc>::const_traverser,
1409 typename BasicImage<PixelType, Alloc>::const_traverser,
1410 typename BasicImage<PixelType, Alloc>::ConstAccessor>(img.upperLeft() + roi.upperLeft(),
1411 img.upperLeft() + roi.lowerRight(),
1415 template <
class PixelType,
class Alloc>
1416 inline pair< typename BasicImage<PixelType, Alloc>::const_traverser,
1417 typename BasicImage<PixelType, Alloc>::ConstAccessor>
1418 srcImage(BasicImage<PixelType, Alloc>
const & img)
1420 return pair<typename BasicImage<PixelType, Alloc>::const_traverser,
1421 typename BasicImage<PixelType, Alloc>::ConstAccessor>(img.upperLeft(),
1425 template <
class PixelType,
class Alloc>
1426 inline pair< typename BasicImage<PixelType, Alloc>::const_traverser,
1427 typename BasicImage<PixelType, Alloc>::ConstAccessor>
1428 srcImage(BasicImage<PixelType, Alloc>
const & img, Point2D
const & ul)
1430 vigra_precondition(img.isInside(ul),
1431 "srcImage(): ROI rectangle outside image.");
1432 return pair<typename BasicImage<PixelType, Alloc>::const_traverser,
1433 typename BasicImage<PixelType, Alloc>::ConstAccessor>(img.upperLeft() + ul,
1437 template <
class PixelType,
class Alloc>
1438 inline triple< typename BasicImage<PixelType, Alloc>::traverser,
1439 typename BasicImage<PixelType, Alloc>::traverser,
1440 typename BasicImage<PixelType, Alloc>::Accessor>
1441 destImageRange(BasicImage<PixelType, Alloc> & img)
1443 return triple<typename BasicImage<PixelType, Alloc>::traverser,
1444 typename BasicImage<PixelType, Alloc>::traverser,
1445 typename BasicImage<PixelType, Alloc>::Accessor>(img.upperLeft(),
1450 template <
class PixelType,
class Alloc>
1451 inline triple< typename BasicImage<PixelType, Alloc>::traverser,
1452 typename BasicImage<PixelType, Alloc>::traverser,
1453 typename BasicImage<PixelType, Alloc>::Accessor>
1454 destImageRange(BasicImage<PixelType, Alloc> & img, Rect2D
const & roi)
1456 vigra_precondition(roi.left() >= 0 && roi.top() >= 0 &&
1457 roi.right() <= img.width() && roi.bottom() <= img.height(),
1458 "destImageRange(): ROI rectangle outside image.");
1459 return triple<typename BasicImage<PixelType, Alloc>::traverser,
1460 typename BasicImage<PixelType, Alloc>::traverser,
1461 typename BasicImage<PixelType, Alloc>::Accessor>(img.upperLeft() + roi.upperLeft(),
1462 img.upperLeft() + roi.lowerRight(),
1466 template <
class PixelType,
class Alloc>
1467 inline pair< typename BasicImage<PixelType, Alloc>::traverser,
1468 typename BasicImage<PixelType, Alloc>::Accessor>
1469 destImage(BasicImage<PixelType, Alloc> & img)
1471 return pair<typename BasicImage<PixelType, Alloc>::traverser,
1472 typename BasicImage<PixelType, Alloc>::Accessor>(img.upperLeft(),
1476 template <
class PixelType,
class Alloc>
1477 inline pair< typename BasicImage<PixelType, Alloc>::traverser,
1478 typename BasicImage<PixelType, Alloc>::Accessor>
1479 destImage(BasicImage<PixelType, Alloc> & img, Point2D
const & ul)
1481 vigra_precondition(img.isInside(ul),
1482 "destImage(): ROI rectangle outside image.");
1483 return pair<typename BasicImage<PixelType, Alloc>::traverser,
1484 typename BasicImage<PixelType, Alloc>::Accessor>(img.upperLeft() + ul,
1488 template <
class PixelType,
class Alloc>
1489 inline pair< typename BasicImage<PixelType, Alloc>::const_traverser,
1490 typename BasicImage<PixelType, Alloc>::ConstAccessor>
1491 maskImage(BasicImage<PixelType, Alloc>
const & img)
1493 return pair<typename BasicImage<PixelType, Alloc>::const_traverser,
1494 typename BasicImage<PixelType, Alloc>::ConstAccessor>(img.upperLeft(),
1498 template <
class PixelType,
class Alloc>
1499 inline pair< typename BasicImage<PixelType, Alloc>::const_traverser,
1500 typename BasicImage<PixelType, Alloc>::ConstAccessor>
1501 maskImage(BasicImage<PixelType, Alloc>
const & img, Point2D
const & ul)
1503 vigra_precondition(img.isInside(ul),
1504 "maskImage(): ROI rectangle outside image.");
1505 return pair<typename BasicImage<PixelType, Alloc>::const_traverser,
1506 typename BasicImage<PixelType, Alloc>::ConstAccessor>(img.upperLeft() + ul,
1511 #undef VIGRA_ASSERT_INSIDE
1512 #endif // VIGRA_BASICIMAGE_HXX
iterator end()
Definition: basicimage.hxx:972
const_row_iterator rowBegin(int y) const
Definition: basicimage.hxx:1013
iterator begin()
Definition: basicimage.hxx:963
int MoveY
Definition: diff2d.hxx:229
ConstBasicImageIterator< PIXELTYPE, PIXELTYPE ** > ConstIterator
Definition: basicimage.hxx:542
const_traverser::column_iterator const_column_iterator
Definition: basicimage.hxx:558
pointer operator[](int dy)
Definition: basicimage.hxx:905
Export associated information for each image iterator.
Definition: iteratortraits.hxx:109
void resize(int width, int height, SkipInitializationTag)
Definition: basicimage.hxx:814
Accessor accessor()
Definition: basicimage.hxx:1064
const_iterator begin() const
Definition: basicimage.hxx:981
const_iterator end() const
Definition: basicimage.hxx:990
PIXELTYPE & reference
Definition: basicimage.hxx:488
int y
Definition: diff2d.hxx:392
size_type size() const
Definition: basicimage.hxx:852
BasicImage(difference_type const &size, SkipInitializationTag, Alloc const &alloc=Alloc())
Definition: basicimage.hxx:693
row_iterator rowEnd(int y)
Definition: basicimage.hxx:1006
const_column_iterator columnBegin(int x) const
Definition: basicimage.hxx:1042
IteratorTraits< traverser >::DefaultAccessor Accessor
Definition: basicimage.hxx:571
int width() const
Definition: basicimage.hxx:838
row_iterator rowBegin(int y)
Definition: basicimage.hxx:999
BasicImage & init(value_type const &pixel)
Definition: basicimage.hxx:1128
int x
Definition: diff2d.hxx:385
const_reference operator[](difference_type const &d) const
Definition: basicimage.hxx:877
PIXELTYPE const & const_reference
Definition: basicimage.hxx:494
BasicImage(difference_type const &size, const_pointer d, Alloc const &alloc=Alloc())
Definition: basicimage.hxx:728
BasicImage()
Definition: basicimage.hxx:587
Two dimensional difference vector.
Definition: diff2d.hxx:185
PIXELTYPE * pointer
Definition: basicimage.hxx:498
traverser::column_iterator column_iterator
Definition: basicimage.hxx:554
BasicImage(int width, int height, Alloc const &alloc=Alloc())
Definition: basicimage.hxx:605
PIXELTYPE const * ConstScanOrderIterator
Definition: basicimage.hxx:522
Definition: accessor.hxx:43
BasicImageIterator< PIXELTYPE, PIXELTYPE ** > traverser
Definition: basicimage.hxx:526
Two dimensional size object.
Definition: diff2d.hxx:482
int height() const
Definition: basicimage.hxx:845
BasicImage(const BasicImage &rhs)
Definition: basicimage.hxx:744
reference operator()(int dx, int dy)
Definition: basicimage.hxx:886
Definition: basicimage.hxx:262
BasicImage(int width, int height, SkipInitializationTag, Alloc const &alloc=Alloc())
Definition: basicimage.hxx:658
BasicImageIterator< PIXELTYPE, PIXELTYPE ** > Iterator
Definition: basicimage.hxx:530
PIXELTYPE const * const_pointer
Definition: basicimage.hxx:502
void swap(BasicImage &rhs)
Definition: basicimage.hxx:1233
Alloc allocator_type
Definition: basicimage.hxx:580
Definition: basicimage.hxx:126
BasicImage(difference_type const &size, value_type const &d, Alloc const &alloc=Alloc())
Definition: basicimage.hxx:676
int MoveX
Definition: diff2d.hxx:226
void resize(int width, int height)
Definition: basicimage.hxx:776
void resize(int width, int height, value_type const &d)
Definition: basicimage.hxx:798
const_pointer data() const
Definition: basicimage.hxx:1057
bool isInside(difference_type const &d) const
Definition: basicimage.hxx:859
const_traverser::row_iterator const_row_iterator
Definition: basicimage.hxx:550
PIXELTYPE const * const_iterator
Definition: basicimage.hxx:518
Size2D size_type
Definition: basicimage.hxx:566
IteratorTraits< const_traverser >::DefaultAccessor ConstAccessor
Definition: basicimage.hxx:576
const_reference operator()(int dx, int dy) const
Definition: basicimage.hxx:895
traverser lowerRight()
Definition: basicimage.hxx:934
PIXELTYPE PixelType
Definition: basicimage.hxx:483
ConstBasicImageIterator< PIXELTYPE, PIXELTYPE ** > const_traverser
Definition: basicimage.hxx:536
const_traverser lowerRight() const
Definition: basicimage.hxx:954
BasicImage(difference_type const &size, Alloc const &alloc=Alloc())
Definition: basicimage.hxx:621
Fundamental class template for images.
Definition: basicimage.hxx:473
const_pointer operator[](int dy) const
Definition: basicimage.hxx:915
PIXELTYPE * ScanOrderIterator
Definition: basicimage.hxx:512
BasicImage(int width, int height, const_pointer d, Alloc const &alloc=Alloc())
Definition: basicimage.hxx:711
const_row_iterator rowEnd(int y) const
Definition: basicimage.hxx:1020
Definition: basicimage.hxx:294
void resizeCopy(int width, int height, const_pointer data)
Definition: basicimage.hxx:1191
column_iterator columnBegin(int x)
Definition: basicimage.hxx:1027
BasicImage(int width, int height, value_type const &d, Alloc const &alloc=Alloc())
Definition: basicimage.hxx:640
traverser::row_iterator row_iterator
Definition: basicimage.hxx:546
reference operator[](difference_type const &d)
Definition: basicimage.hxx:868
~BasicImage()
Definition: basicimage.hxx:756
void resizeCopy(const BasicImage &rhs)
Definition: basicimage.hxx:827
Diff2D difference_type
Definition: basicimage.hxx:562
column_iterator columnEnd(int x)
Definition: basicimage.hxx:1035
const_column_iterator columnEnd(int x) const
Definition: basicimage.hxx:1050
Encapsulate access to the values an iterator points to.
Definition: accessor.hxx:133
Quickly create 1-dimensional iterator adapters.
Definition: iteratoradapter.hxx:148
BasicImage & operator=(const BasicImage &rhs)
Definition: basicimage.hxx:1093
void resize(difference_type const &size)
Definition: basicimage.hxx:785
BasicImage(Alloc const &alloc)
Definition: basicimage.hxx:595
ConstAccessor accessor() const
Definition: basicimage.hxx:1071
const_traverser upperLeft() const
Definition: basicimage.hxx:943
PIXELTYPE value_type
Definition: basicimage.hxx:479
traverser upperLeft()
Definition: basicimage.hxx:923
PIXELTYPE * iterator
Definition: basicimage.hxx:508