Information Home Overview Documentation Getting Started Release Notes ASL Wiki License Indices Success Stories Contributors Media Download ASL Perforce Depots Support ASL SourceForge Home Mailing Lists Discussion Forums Report Bugs Suggest Features Contributing to ASL RSS Short-text news Full-text news File releases Other Adobe Projects Adobe XMP Adobe Labs Other Resources Boost SGI STL

locator.hpp Go to the documentation of this file. /* Copyright 2005-2006 Adobe Systems Incorporated Distributed under the MIT License (see accompanying file LICENSE_1_0_0.txt or a copy at http://opensource.adobe.com/licenses.html) */ /*************************************************************************************************/ #ifndef GIL_LOCATOR_H #define GIL_LOCATOR_H #include <cstddef> #include <iterator> ADOBE_GIL_NAMESPACE_BEGIN //forward declarations template <typename P> struct pixel_iterator_traits; template <typename P> ptrdiff_t byte_step(const P*); template <typename P> P* byte_advanced(const P* p, ptrdiff_t byteDiff); template <typename P> P& byte_advanced_ref(P* p, ptrdiff_t byteDiff); namespace detail { // helper class specialized for each axis of pixel_2d_locator template <std::size_t D, typename LOC> class pixel_2d_locator_axis; } template <typename S_IT> // Models PixelStepIteratorConcept. In addition, it must have dynamic_step_base_t member typedef class pixel_2d_locator { GIL_CLASS_REQUIRE(S_IT, GIL, PixelStepIteratorConcept); typedef typename pixel_iterator_traits<S_IT>::base_t X_IT; public: // typedefs required by ConstRandomAccessNDLocatorConcept static const std::size_t num_dimensions=2; typedef typename std::iterator_traits<X_IT>::value_type value_type; typedef value_type pixel_t; typedef typename std::iterator_traits<X_IT>::reference reference; // result of dereferencing typedef typename std::iterator_traits<X_IT>::difference_type coord_t; // 1D difference type (same for all dimensions) typedef point2<coord_t> difference_type; // result of operator-(locator,locator) typedef value_type domain_t; typedef difference_type point_t; typedef std::ptrdiff_t cached_location_t; // type used to store relative location (to allow for more efficient repeated access) typedef pixel_2d_locator<typename pixel_iterator_traits<S_IT>::const_t> const_t; // same as this type, but over const values template <std::size_t D> struct axis { typedef typename detail::pixel_2d_locator_axis<D,pixel_2d_locator>::coord_t coord_t; typedef typename detail::pixel_2d_locator_axis<D,pixel_2d_locator>::iterator iterator; }; // typedefs required by ConstRandomAccess2DLocatorConcept typedef X_IT x_iterator; typedef S_IT y_iterator; typedef typename point_t::template axis<0>::coord_t x_coord_t; typedef typename point_t::template axis<1>::coord_t y_coord_t; // typedefs required by PixelLocatorConcept typedef pixel_2d_locator<typename pixel_iterator_traits<S_IT>::dynamic_step_base_t> dynamic_step_t; typedef typename pixel_iterator_traits<X_IT>::channel_t channel_t; typedef typename pixel_iterator_traits<X_IT>::color_space_t color_space_t; BOOST_STATIC_CONSTANT(int, num_channels=color_space_t::num_channels); pixel_2d_locator(){} pixel_2d_locator(x_iterator x_it, std::ptrdiff_t row_bytes) : _p(x_it,row_bytes) {} template <typename X> pixel_2d_locator(const pixel_2d_locator<X>& pl) : _p(pl._p) {} pixel_2d_locator(const pixel_2d_locator& pl) : _p(pl._p) {} bool operator==(const pixel_2d_locator& p) const { return _p==p._p; } bool operator!=(const pixel_2d_locator& p) const { return _p!=p._p; } // axis iterator accessors x_iterator& x() { return _p.base(); } x_iterator const& x() const { return _p.base(); } y_iterator& y() { return _p; } y_iterator const& y() const { return _p; } x_iterator x_at(x_coord_t dx, y_coord_t dy) const { return byte_advanced(x(), byte_offset(dx,dy)); } x_iterator x_at(const difference_type& d) const { return byte_advanced(x(), byte_offset(d.x,d.y)); } y_iterator y_at(x_coord_t dx, y_coord_t dy) const { pixel_2d_locator tmp=*this; tmp+=point_t(dx,dy); return tmp.y(); } y_iterator y_at(const difference_type& d) const { pixel_2d_locator tmp=*this; tmp+=d; return tmp.y(); } pixel_2d_locator xy_at(const difference_type& d) const { return pixel_2d_locator(x_at( d.x, d.y), row_bytes()); } pixel_2d_locator xy_at(x_coord_t dx, y_coord_t dy)const { return pixel_2d_locator(x_at( dx , dy ), row_bytes()); } template <std::size_t D> typename axis<D>::iterator& axis_iterator() { return detail::pixel_2d_locator_axis<D,pixel_2d_locator>()(*this); } template <std::size_t D> typename axis<D>::iterator const& axis_iterator() const { return detail::pixel_2d_locator_axis<D,pixel_2d_locator>()(*this); } template <std::size_t D> typename axis<D>::iterator axis_iterator(const point_t& p) const { return detail::pixel_2d_locator_axis<D,pixel_2d_locator>()(*this,p); } std::ptrdiff_t row_bytes() const { return byte_step(y()); } // row bytes std::ptrdiff_t pix_bytestep() const { return byte_step(x()); } // distance in bytes between adjacent pixels on the same row reference operator()(x_coord_t dx, y_coord_t dy) const { return byte_advanced_ref(x(),byte_offset(dx,dy)); } reference operator[](const difference_type& d) const { return byte_advanced_ref(x(),byte_offset(d.x,d.y)); } reference operator*() const { return *_p; } cached_location_t cache_location(const difference_type& d)const { return byte_offset(d.x,d.y); } cached_location_t cache_location(x_coord_t dx, y_coord_t dy) const { return byte_offset(dx,dy); } reference operator[](const cached_location_t& loc) const { return byte_advanced_ref(x(),loc); } pixel_2d_locator& operator+=(const difference_type& d) { byte_advance(x(),byte_offset(d.x,d.y)); return *this; } pixel_2d_locator& operator-=(const difference_type& d) { byte_advance(x(),byte_offset(-d.x,-d.y)); return *this; } pixel_2d_locator operator+(const difference_type& d) const { return xy_at(d); } pixel_2d_locator operator-(const difference_type& d) const { return xy_at(-d); } private: template <typename X> friend class pixel_2d_locator; std::ptrdiff_t byte_offset(x_coord_t x, y_coord_t y) const { return y*row_bytes() + x*pix_bytestep(); } S_IT _p; }; // helper classes for each axis of pixel_2d_locator namespace detail { template <typename LOC> class pixel_2d_locator_axis<0,LOC> { typedef typename LOC::point_t point_t; public: typedef typename point_t::template axis<0>::coord_t coord_t; typedef typename LOC::x_iterator iterator; inline iterator& operator()( LOC& loc) const { return loc.x(); } inline iterator const& operator()(const LOC& loc) const { return loc.x(); } inline iterator operator()( LOC& loc, const point_t& d) const { return loc.x_at(d); } inline iterator operator()(const LOC& loc, const point_t& d) const { return loc.x_at(d); } }; template <typename LOC> class pixel_2d_locator_axis<1,LOC> { typedef typename LOC::point_t point_t; public: typedef typename point_t::template axis<1>::coord_t coord_t; typedef typename LOC::y_iterator iterator; inline iterator& operator()( LOC& loc) const { return loc.y(); } inline iterator const& operator()(const LOC& loc) const { return loc.y(); } inline iterator operator()( LOC& loc, const point_t& d) const { return loc.y_at(d); } inline iterator operator()(const LOC& loc, const point_t& d) const { return loc.y_at(d); } }; } ADOBE_GIL_NAMESPACE_END #endif

• Company | 
• Online Privacy Policy | 
• Terms of Use | 
• Contact Us | 
• Accessibility | 
• Report Piracy | 
• Permissions & Trademarks | 
• Product License Agreements | 
• Send Feedback

Copyright © 2006 Adobe Systems Incorporated.

Use of this website signifies your agreement to the Terms of Use and Online Privacy Policy.

Search powered by Google