Thread: [adobe-source-commits] sandbox/adobe-source/adobe/documentation/sources/gil design_guide.dox,1.1,1.2

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/adobe-source/sandbox/adobe-source/adobe/documentation/sources/gil
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv6755/adobe/documentation/sources/gil

Modified Files:
	design_guide.dox main.dox tutorial.dox 
Log Message:
asl 1.0.13

Index: main.dox
===================================================================
RCS file: /cvsroot/adobe-source/sandbox/adobe-source/adobe/documentation/sources/gil/main.dox,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** main.dox	24 Jan 2006 19:38:44 -0000	1.2
--- main.dox	3 Feb 2006 18:33:36 -0000	1.3
***************
*** 3,8 ****
  \ingroup asl_home
  \author Lubomir Bourdev and Hailin Jin \n
! 		Advanced Graphics Technology \n
! 		Adobe Systems Inc.

  \section IntroSec Introduction
--- 3,8 ----
  \ingroup asl_home
  \author Lubomir Bourdev and Hailin Jin \n
!         Advanced Graphics Technology \n
!         Adobe Systems Inc.

\section IntroSec Introduction
***************
*** 12,23 ****
 \par
 The library is designed with the following five goals in mind:
! 	- Generality: Abstracts image representations from algorithms on images. It allows for writing code once and have it work for any image type.
! 	- Performance: Speed has been instrumental to the design of the library. The generic algorithms provided in the library are comparable in speed to hand-coding the algorithm for a specific image type.
! 	- Flexibility: Compile-type parameter resolution results in faster code, but severely limits code flexibility. The library allows for any image parameter to be specified at run time (for a minor performance cost comparable to a virtual call overhead).
! 	- Extensibility: It is easy to extend the library with new color spaces and image types. Library extensions typically require no changes to the library core; at the same time existing image algorithms apply to new color spaces and image types.
! 	- Compatibility: The library is designed as an STL and Boost complement. Generic STL algorithms can be used for pixel manipulation, and they are especially optimized. The library works with existing raw pixel data from another image library and can even be integrated into a third-party reference counting mechanism.

  \section ResourcesSec Resources
! 	- \ref BeforeAfterExample "See the GIL difference!" Example of code before and after GIL.
      - A Quick, Hands-on  \ref GILTutorial "Tutorial". (In <a href="gil_tutorial.pdf">PDF</a>)
      - A Detailed \ref GILDesignGuide "Design Guide". (In <a href="gil_design_guide.pdf">PDF</a>)
--- 12,23 ----
  \par
  The library is designed with the following five goals in mind:
!     - <b>Generality:</b> Abstracts image representations from algorithms on images. It allows for writing code once and have it work for any image type.
!     - <b>Performance:</b> Speed has been instrumental to the design of the library. The generic algorithms provided in the library are comparable in speed to hand-coding the algorithm for a specific image type.
!     - <b>Flexibility:</b> Compile-type parameter resolution results in faster code, but severely limits code flexibility. The library allows for any image parameter to be specified at run time (for a minor performance cost comparable to a virtual call overhead).
!     - <b>Extensibility:</b> It is easy to extend the library with new color spaces and image types. Library extensions typically require no changes to the library core; at the same time existing image algorithms apply to new color spaces and image types.
!     - <b>Compatibility:</b> The library is designed as an STL and Boost complement. Generic STL algorithms can be used for pixel manipulation, and they are especially optimized. The library works with existing raw pixel data from another image library and can even be integrated into a third-party reference counting mechanism.

  \section ResourcesSec Resources
!     - \ref BeforeAfterExample "See the GIL difference!" Example of code before and after GIL.
      - A Quick, Hands-on  \ref GILTutorial "Tutorial". (In <a href="gil_tutorial.pdf">PDF</a>)
      - A Detailed \ref GILDesignGuide "Design Guide". (In <a href="gil_design_guide.pdf">PDF</a>)
***************
*** 29,87 ****

\section AcknowledgementsSec Acknowledgements
! 	- Jon Brandt, Mark Ruzon and Paul McJones spent significant time reviewing the library and documentation and provided valuable feedback.
! 	- Alex Stepanov's class has directly inspired this project. Alex's "start from the inside" and "bottom up" principles have been applied throughout the design.
! 	- Sean Parent and Alex Stepanov suggested splitting the image into a 'container' and 'range' classes
! 	- Bjarne Stroustrup reviewed the core library design

  \section gil_toc GIL Table of Contents
! 	- \ref GILConcepts
! 		- \ref PointConcept
! 		- \ref ChannelConcept
! 		- \ref ColorSpaceTypeConcept
! 		- \ref PixelConcept
! 		- \ref IteratorConcept
! 			- \ref IteratorAdaptorConcept
! 			- \ref StepIteratorConcept
! 			- \ref ImageIteratorConcept
! 		- \ref LocatorConcept
! 			- \ref LocatorNDConcept
! 			- \ref Locator2DConcept
! 			- \ref XYLocatorConcept
! 		- \ref ImageViewConcept
! 			- \ref ImageViewNDConcept
! 			- \ref ImageView2DConcept
! 			- \ref GILImageViewConcept
! 		- \ref ImageConcept
! 			- \ref ImageNDConcept
! 			- \ref Image2DConcept
! 			- \ref GILImageConcept
! 	- \ref GILModels
! 		- \ref Channel
! 		- \ref ColorSpaces
! 			- \ref CMYK
! 			- \ref ColorConvert
! 			- \ref GRAY
! 			- \ref LAB
! 			- \ref RGB
! 			- \ref RGBA
! 		- \ref Pixel
! 			- \ref ChannelAccessor
! 			- \ref ColorBase
! 		- \ref Iterators
! 			- \ref PlanarPtr
! 			- \ref IteratorTraits
! 			- \ref ByteOperations
! 				- \ref byte_step
! 				- \ref byte_distance
! 				- \ref byte_advance
! 				- \ref byte_advanced
! 				- \ref byte_advanced_ref
! 		- \ref ImageView
! 			- \ref ImageViewConstructors
! 		- \ref Image
! 		- \ref Variant
! 		- \ref Metafunctions
! 			- \ref type_factory
! 		- \ref Algorithms
  */

--- 29,87 ----

\section AcknowledgementsSec Acknowledgements
! - Jon Brandt, Mark Ruzon and Paul McJones spent significant time reviewing the library and documentation and provided valuable feedback.
! - Alex Stepanov's class has directly inspired this project. Alex's "start from the inside" and "bottom up" principles have been applied throughout the design.
! - Sean Parent and Alex Stepanov suggested splitting the image into a 'container' and 'range' classes
! - Bjarne Stroustrup reviewed the core library design

  \section gil_toc GIL Table of Contents
!     - \ref GILConcepts
!         - \ref PointConcept
!         - \ref ChannelConcept
!         - \ref ColorSpaceTypeConcept
!         - \ref PixelConcept
!         - \ref IteratorConcept
!             - \ref IteratorAdaptorConcept
!             - \ref StepIteratorConcept
!             - \ref ImageIteratorConcept
!         - \ref LocatorConcept
!             - \ref LocatorNDConcept
!             - \ref Locator2DConcept
!             - \ref XYLocatorConcept
!         - \ref ImageViewConcept
!             - \ref ImageViewNDConcept
!             - \ref ImageView2DConcept
!             - \ref GILImageViewConcept
!         - \ref ImageConcept
!             - \ref ImageNDConcept
!             - \ref Image2DConcept
!             - \ref GILImageConcept
!     - \ref GILModels
!         - \ref Channel
!         - \ref ColorSpaces
!             - \ref CMYK
!             - \ref ColorConvert
!             - \ref GRAY
!             - \ref LAB
!             - \ref RGB
!             - \ref RGBA
!         - \ref Pixel
!             - \ref ChannelAccessor
!             - \ref ColorBase
!         - \ref Iterators
!             - \ref PlanarPtr
!             - \ref IteratorTraits
!             - \ref ByteOperations
!                 - \ref byte_step
!                 - \ref byte_distance
!                 - \ref byte_advance
!                 - \ref byte_advanced
!                 - \ref byte_advanced_ref
!         - \ref ImageView
!             - \ref ImageViewConstructors
!         - \ref Image
!         - \ref Variant
!         - \ref Metafunctions
!             - \ref type_factory
!         - \ref Algorithms
  */

***************
*** 89,167 ****
  /// \ingroup asl_gil
  /// \brief GIL concept definitions, archetypes and concept checks
! 	/// @defgroup PointConcept Point
! 	/// @ingroup GILConcepts
! 	/// \brief Concept for N-dimensional point and refinement for 2D
  Ê
! 	/// @defgroup ChannelConcept Channel
! 	/// @ingroup GILConcepts
! 	/// \brief Concept for channel and mutable channel
  Ê
! 	/// @defgroup ColorSpaceTypeConcept Color Space
! 	/// @ingroup GILConcepts
! 	/// \brief Concept for color space type
  Ê
! 	/// @defgroup PixelConcept Pixel
! 	/// @ingroup GILConcepts
! 	/// \brief Concept for pixel and mutable pixel
  Ê
! 	/// @defgroup IteratorConcept Iterator
! 	/// @ingroup GILConcepts
! 	/// \brief Concept for iterators over pixels (fundamental, step, adaptor and image-pixel iterators over immutable/mutable pixels)
! 		/// @defgroup IteratorAdaptorConcept Iterator Adaptor
! 		/// @ingroup IteratorConcept
! 		/// \brief Concept for an iterator adaptor over a base iterator
  Ê
! 		/// @defgroup StepIteratorConcept Step Iterator
! 		/// @ingroup IteratorConcept
! 		/// \brief Concept for an iterator that has non-fundamental step
  Ê
! 		/// @defgroup ImageIteratorConcept Image Iterator
! 		/// @ingroup IteratorConcept
! 		/// \brief Concept for an iterator over all pixels in an image
  Ê
! 	/// @defgroup LocatorConcept Locator
! 	/// @ingroup GILConcepts
! 	/// \brief Concept for locator (generalization of iterator in N-dimensional space)
! 		/// @defgroup LocatorNDConcept N-Dimensional Locator
! 		/// @ingroup LocatorConcept
! 		/// \brief Concept for an N-dimensional locator over immutable/mutable values
  Ê
! 		/// @defgroup Locator2DConcept 2-Dimensional Locator
! 		/// @ingroup LocatorConcept
! 		/// \brief Concept for a 2-dimensional locator over immutable/mutable values
  Ê
! 		/// @defgroup XYLocatorConcept GIL's 2-Dimensional Pixel Locator
! 		/// @ingroup LocatorConcept
! 		/// \brief Concept for GIL's 2-dimensional locator over immutable/mutable pixels
  Ê
! 	/// @defgroup ImageViewConcept Image View
! 	/// @ingroup GILConcepts
! 	/// \brief Concept for image view (N-dimensional range)
! 		/// @defgroup ImageViewNDConcept N-Dimensional Image View
! 		/// @ingroup ImageViewConcept
! 		/// \brief Concept for an N-dimensional range over immutable/mutable values
  Ê
! 		/// @defgroup ImageView2DConcept 2-Dimensional Image View
! 		/// @ingroup ImageViewConcept
! 		/// \brief Concept for a 2-dimensional range over immutable/mutable values
  Ê
! 		/// @defgroup GILImageViewConcept GIL's 2-Dimensional Pixel Image View
! 		/// @ingroup ImageViewConcept
! 		/// \brief Concept for GIL's 2-dimensional range over immutable/mutable pixels
  Ê
! 	/// @defgroup ImageConcept Image
! 	/// @ingroup GILConcepts
! 	/// \brief Concept for image (N-dimensional container)
! 		/// @defgroup ImageNDConcept N-Dimensional Image
! 		/// @ingroup ImageConcept
! 		/// \brief Concept for an N-dimensional container of immutable/mutable values
  Ê
! 		/// @defgroup Image2DConcept 2-Dimensional Image
! 		/// @ingroup ImageConcept
! 		/// \brief Concept for a 2-dimensional container of immutable/mutable values
  Ê
! 		/// @defgroup GILImageConcept GIL's 2-Dimensional Pixel Image
! 		/// @ingroup ImageConcept
! 		/// \brief Concept for GIL's 2-dimensional container of immutable/mutable pixels
  Ê
  /// @defgroup GILModels GIL Models
--- 89,167 ----
  /// \ingroup asl_gil
  /// \brief GIL concept definitions, archetypes and concept checks
!     /// @defgroup PointConcept Point
!     /// @ingroup GILConcepts
!     /// \brief Concept for N-dimensional point and refinement for 2D
  Ê
!     /// @defgroup ChannelConcept Channel
!     /// @ingroup GILConcepts
!     /// \brief Concept for channel and mutable channel
  Ê
!     /// @defgroup ColorSpaceTypeConcept Color Space
!     /// @ingroup GILConcepts
!     /// \brief Concept for color space type
  Ê
!     /// @defgroup PixelConcept Pixel
!     /// @ingroup GILConcepts
!     /// \brief Concept for pixel and mutable pixel
  Ê
!     /// @defgroup IteratorConcept Iterator
!     /// @ingroup GILConcepts
!     /// \brief Concept for iterators over pixels (fundamental, step, adaptor and image-pixel iterators over immutable/mutable pixels)
!         /// @defgroup IteratorAdaptorConcept Iterator Adaptor
!         /// @ingroup IteratorConcept
!         /// \brief Concept for an iterator adaptor over a base iterator
  Ê
!         /// @defgroup StepIteratorConcept Step Iterator
!         /// @ingroup IteratorConcept
!         /// \brief Concept for an iterator that has non-fundamental step
  Ê
!         /// @defgroup ImageIteratorConcept Image Iterator
!         /// @ingroup IteratorConcept
!         /// \brief Concept for an iterator over all pixels in an image
  Ê
!     /// @defgroup LocatorConcept Locator
!     /// @ingroup GILConcepts
!     /// \brief Concept for locator (generalization of iterator in N-dimensional space)
!         /// @defgroup LocatorNDConcept N-Dimensional Locator
!         /// @ingroup LocatorConcept
!         /// \brief Concept for an N-dimensional locator over immutable/mutable values
  Ê
!         /// @defgroup Locator2DConcept 2-Dimensional Locator
!         /// @ingroup LocatorConcept
!         /// \brief Concept for a 2-dimensional locator over immutable/mutable values
  Ê
!         /// @defgroup XYLocatorConcept GIL's 2-Dimensional Pixel Locator
!         /// @ingroup LocatorConcept
!         /// \brief Concept for GIL's 2-dimensional locator over immutable/mutable pixels
  Ê
!     /// @defgroup ImageViewConcept Image View
!     /// @ingroup GILConcepts
!     /// \brief Concept for image view (N-dimensional range)
!         /// @defgroup ImageViewNDConcept N-Dimensional Image View
!         /// @ingroup ImageViewConcept
!         /// \brief Concept for an N-dimensional range over immutable/mutable values
  Ê
!         /// @defgroup ImageView2DConcept 2-Dimensional Image View
!         /// @ingroup ImageViewConcept
!         /// \brief Concept for a 2-dimensional range over immutable/mutable values
  Ê
!         /// @defgroup GILImageViewConcept GIL's 2-Dimensional Pixel Image View
!         /// @ingroup ImageViewConcept
!         /// \brief Concept for GIL's 2-dimensional range over immutable/mutable pixels
  Ê
!     /// @defgroup ImageConcept Image
!     /// @ingroup GILConcepts
!     /// \brief Concept for image (N-dimensional container)
!         /// @defgroup ImageNDConcept N-Dimensional Image
!         /// @ingroup ImageConcept
!         /// \brief Concept for an N-dimensional container of immutable/mutable values
  Ê
!         /// @defgroup Image2DConcept 2-Dimensional Image
!         /// @ingroup ImageConcept
!         /// \brief Concept for a 2-dimensional container of immutable/mutable values
  Ê
!         /// @defgroup GILImageConcept GIL's 2-Dimensional Pixel Image
!         /// @ingroup ImageConcept
!         /// \brief Concept for GIL's 2-dimensional container of immutable/mutable pixels
  Ê
  /// @defgroup GILModels GIL Models
***************
*** 169,251 ****
  /// \brief Standard models of GIL concepts
  Ê
! 	/// @defgroup Channel Channel
! 	/// @ingroup GILModels
! 	/// \brief Channel and channel operations
  Ê
! 	/// @defgroup ColorSpaces Color Space
! 	/// @ingroup GILModels
! 	/// \brief Color spaces and color space conversion
  Ê
! 	/// @defgroup Pixel Pixel
! 	/// @ingroup GILModels
! 	/// \brief Pixel and pixel-related functions
  ÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊ
! 		/// @defgroup ChannelAccessor Channel Accessor
! 		/// @ingroup Pixel
! 		/// \brief Classes allowing accessing a channel of a pixel
  Ê
! 		/// @defgroup ColorBase Color Bases
! 		/// @ingroup Pixel
! 		/// \brief A bundle of channel values/references/pointers of a given color space
  Ê
! 	/// @defgroup Iterators Pixel Iterators
! 	/// @ingroup GILModels
! 	/// \brief Iterators operating on pixels
  Ê
! 		/// @defgroup PlanarPtr Planar Pointers
! 		/// @ingroup Iterators
! 		/// \brief Implementations of pointers to planar pixels
  Ê
! 		/// @defgroup IteratorTraits Iterator Traits
! 		/// @ingroup Iterators
! 		/// \brief Traits for pixel iterators
  Ê
! 		/// @defgroup ByteOperations Byte-level operations
! 		/// @ingroup Iterators
! 		/// \brief Byte-level operations on pixel iterators
  Ê
! 			/// @defgroup byte_step byte_step
! 			/// @ingroup ByteOperations
! 			/// \brief returns the number of bytes from the current pixel of a pointer to the next
  Ê
! 			/// @defgroup byte_distance byte_distance
! 			/// @ingroup ByteOperations
! 			/// \brief Returns the distance in bytes from the first pixel iterator to the second
  Ê
! 			/// @defgroup byte_advance byte_advance
! 			/// @ingroup ByteOperations
! 			/// \brief Moves a pixel iterator a given distance in bytes
  Ê
! 			/// @defgroup byte_advanced byte_advanced
! 			/// @ingroup ByteOperations
! 			/// \brief Returns a pixel iterator a given byte distance away from a given pixel iterator
  Ê
! 			/// @defgroup byte_advanced_ref byte_advanced_ref
! 			/// @ingroup ByteOperations
! 			/// \brief Shortcut to advancing a pixel iterator by a given number of bytes and taking the reference in case the compiler is not smart enough
  Ê
! 	/// \defgroup ImageView Image View
! 	/// @ingroup GILModels
! 	/// \brief Image views and related operations
  Ê
! 		/// @defgroup ImageViewConstructors Image View Constructors
! 		/// @ingroup ImageView
! 		/// \brief Methods for constructing image views from raw data or other image views
  Ê
! 	/// \defgroup Image Image
! 	/// @ingroup GILModels
! 	/// \brief Images and related operations
  Ê
! 	/// @defgroup Variant Variant
! 	/// @ingroup GILModels
! 	/// \brief Support for concepts with run-time instantiation. Used in GIL to provide images and image views of run-time specified color space, channel depth, etc.
  Ê
! 	/// @defgroup Metafunctions Meta-functions
! 	/// @ingroup GILModels
! 	/// \brief Meta-functions that construct types or return type properties
  Ê
! 	/// @defgroup Algorithms Algorithms
! 	/// @ingroup GILModels
! 	/// \brief Some basic STL-style algorithms when applied to images (as opposed to ranges)
  Ê
  /// \brief namespace for functions not directly needed by the client
--- 169,251 ----
  /// \brief Standard models of GIL concepts
  Ê
!     /// @defgroup Channel Channel
!     /// @ingroup GILModels
!     /// \brief Channel and channel operations
  Ê
!     /// @defgroup ColorSpaces Color Space
!     /// @ingroup GILModels
!     /// \brief Color spaces and color space conversion
  Ê
!     /// @defgroup Pixel Pixel
!     /// @ingroup GILModels
!     /// \brief Pixel and pixel-related functions
  ÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊÊ
!         /// @defgroup ChannelAccessor Channel Accessor
!         /// @ingroup Pixel
!         /// \brief Classes allowing accessing a channel of a pixel
  Ê
!         /// @defgroup ColorBase Color Bases
!         /// @ingroup Pixel
!         /// \brief A bundle of channel values/references/pointers of a given color space
  Ê
!     /// @defgroup Iterators Pixel Iterators
!     /// @ingroup GILModels
!     /// \brief Iterators operating on pixels
  Ê
!         /// @defgroup PlanarPtr Planar Pointers
!         /// @ingroup Iterators
!         /// \brief Implementations of pointers to planar pixels
  Ê
!         /// @defgroup IteratorTraits Iterator Traits
!         /// @ingroup Iterators
!         /// \brief Traits for pixel iterators
  Ê
!         /// @defgroup ByteOperations Byte-level operations
!         /// @ingroup Iterators
!         /// \brief Byte-level operations on pixel iterators
  Ê
!             /// @defgroup byte_step byte_step
!             /// @ingroup ByteOperations
!             /// \brief returns the number of bytes from the current pixel of a pointer to the next
  Ê
!             /// @defgroup byte_distance byte_distance
!             /// @ingroup ByteOperations
!             /// \brief Returns the distance in bytes from the first pixel iterator to the second
  Ê
!             /// @defgroup byte_advance byte_advance
!             /// @ingroup ByteOperations
!             /// \brief Moves a pixel iterator a given distance in bytes
  Ê
!             /// @defgroup byte_advanced byte_advanced
!             /// @ingroup ByteOperations
!             /// \brief Returns a pixel iterator a given byte distance away from a given pixel iterator
  Ê
!             /// @defgroup byte_advanced_ref byte_advanced_ref
!             /// @ingroup ByteOperations
!             /// \brief Shortcut to advancing a pixel iterator by a given number of bytes and taking the reference in case the compiler is not smart enough
  Ê
!     /// \defgroup ImageView Image View
!     /// @ingroup GILModels
!     /// \brief Image views and related operations
  Ê
!         /// @defgroup ImageViewConstructors Image View Constructors
!         /// @ingroup ImageView
!         /// \brief Methods for constructing image views from raw data or other image views
  Ê
!     /// \defgroup Image Image
!     /// @ingroup GILModels
!     /// \brief Images and related operations
  Ê
!     /// @defgroup Variant Variant
!     /// @ingroup GILModels
!     /// \brief Support for concepts with run-time instantiation. Used in GIL to provide images and image views of run-time specified color space, channel depth, etc.
  Ê
!     /// @defgroup Metafunctions Meta-functions
!     /// @ingroup GILModels
!     /// \brief Meta-functions that construct types or return type properties
  Ê
!     /// @defgroup Algorithms Algorithms
!     /// @ingroup GILModels
!     /// \brief Some basic STL-style algorithms when applied to images (as opposed to ranges)
  Ê
  /// \brief namespace for functions not directly needed by the client

Index: tutorial.dox
===================================================================
RCS file: /cvsroot/adobe-source/sandbox/adobe-source/adobe/documentation/sources/gil/tutorial.dox,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** tutorial.dox	24 Jan 2006 19:38:44 -0000	1.1
--- tutorial.dox	3 Feb 2006 18:33:36 -0000	1.2
***************
*** 1,7 ****
  ////////////////////////////////////////////////////////////////////////////////////////
! /// \file 				
  /// \brief Doxygen documentation
  /// \author Lubomir Bourdev and Hailin Jin \n
! ///			Adobe Systems Incorporated
  ///
  ///
--- 1,7 ----
  ////////////////////////////////////////////////////////////////////////////////////////
! /// \file               
  /// \brief Doxygen documentation
  /// \author Lubomir Bourdev and Hailin Jin \n
! ///         Adobe Systems Incorporated
  ///
  ///
***************
*** 24,47 ****
  - \ref InstallSec
  - \ref ObjectsSec
! 	- \ref UsefulTypedefs
! 	- \ref GenericObjects
! 	- \ref RelatedTypes
  - \ref ImageAndViewSec
! 	- \ref ImageSec
! 	- \ref ImageViewSec
! 	- \ref ImageViewFactory
  - \ref ManipulatingImages
! 	- \ref ContextIndepdendentPixOp
! 	- \ref GenericAndSpecialized
! 	- \ref ContextAwareOperations
  - \ref VariantSec
  - \ref ExtendingGIL
  - \ref CodeExamples
! 	- \ref HistogramExample
! 	- \ref SafeAreaExample
! 	- \ref GDIExample

! \section InstallSec		Installation

  GIL is part of Adobe Software Library (ASL) which can be installed at http://opensource.adobe.com.
--- 24,47 ----
  - \ref InstallSec
  - \ref ObjectsSec
!     - \ref UsefulTypedefs
!     - \ref GenericObjects
!     - \ref RelatedTypes
  - \ref ImageAndViewSec
!     - \ref ImageSec
!     - \ref ImageViewSec
!     - \ref ImageViewFactory
  - \ref ManipulatingImages
!     - \ref ContextIndepdendentPixOp
!     - \ref GenericAndSpecialized
!     - \ref ContextAwareOperations
  - \ref VariantSec
  - \ref ExtendingGIL
  - \ref CodeExamples
!     - \ref HistogramExample
!     - \ref SafeAreaExample
!     - \ref GDIExample

! \section InstallSec     Installation

  GIL is part of Adobe Software Library (ASL) which can be installed at http://opensource.adobe.com.
***************
*** 49,53 ****
  There is no library to link against. Including \p image_view_factory.hpp will be sufficient for most projects.

! \section ObjectsSec		Basic Concepts

  <i>Pixels</i> are the fundamental building blocks of images. A pixel is a sequence of channels whose number and interpretation are defined by a color space.
--- 49,53 ----
  There is no library to link against. Including \p image_view_factory.hpp will be sufficient for most projects.

! \section ObjectsSec     Basic Concepts

  <i>Pixels</i> are the fundamental building blocks of images. A pixel is a sequence of channels whose number and interpretation are defined by a color space.
***************
*** 109,113 ****
  template <typename T, typename C>
  struct iterator_traits<pixel<T,C>*> {
!     typedef random_access_iterator_tag	iterator_category;
      typedef pixel<T,C>  value_type;
      typedef ptrdiff_t   difference_type;
--- 109,113 ----
  template <typename T, typename C>
  struct iterator_traits<pixel<T,C>*> {
!     typedef random_access_iterator_tag  iterator_category;
      typedef pixel<T,C>  value_type;
      typedef ptrdiff_t   difference_type;
***************
*** 169,173 ****

  \code
! template <typename IMG>		                // Models GIL Image
  void my_const_test(const IMG& img) {
      // IMG::view_type v=view(img);          // Error: can't get non-const view from const image
--- 169,173 ----

  \code
! template <typename IMG>                     // Models GIL Image
  void my_const_test(const IMG& img) {
      // IMG::view_type v=view(img);          // Error: can't get non-const view from const image
***************
*** 250,254 ****

  \code
! rgb16_image img(100,100);	// an RGB interleaved image

  // grayscale view over the green (index 1) channel of img
--- 250,254 ----

  \code
! rgb16_image img(100,100);   // an RGB interleaved image

  // grayscale view over the green (index 1) channel of img
***************
*** 284,288 ****
  void make_red(const VIEW& img) {
      typename VIEW::value_type red;
!     color_convert(rgb8_pixel(255,0,0), red);	// convert to red in the image color space and bit depth
      for (typename VIEW::iterator it=img.begin(); it!=img.end(); ++it)
          *it=red;
--- 284,288 ----
  void make_red(const VIEW& img) {
      typename VIEW::value_type red;
!     color_convert(rgb8_pixel(255,0,0), red);    // convert to red in the image color space and bit depth
      for (typename VIEW::iterator it=img.begin(); it!=img.end(); ++it)
          *it=red;

Index: design_guide.dox
===================================================================
RCS file: /cvsroot/adobe-source/sandbox/adobe-source/adobe/documentation/sources/gil/design_guide.dox,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** design_guide.dox	24 Jan 2006 19:38:44 -0000	1.1
--- design_guide.dox	3 Feb 2006 18:33:36 -0000	1.2
***************
*** 175,179 ****
      // the type of coordinate along each axis
      template <size_t D> struct axis { typedef ... coord_type; };
! 	    
      static const size_t num_dimensions=...;

--- 175,179 ----
      // the type of coordinate along each axis
      template <size_t D> struct axis { typedef ... coord_type; };
!         
      static const size_t num_dimensions=...;

***************
*** 611,615 ****
  \code
  namespace std {
!     template <typename IT>	// Models PixelIterator
      struct iterator_traits  {
          typedef random_access_iterator_tag iterator_category;
--- 611,615 ----
  \code
  namespace std {
!     template <typename IT>  // Models PixelIterator
      struct iterator_traits  {
          typedef random_access_iterator_tag iterator_category;