text: ///////////////////////////////////////////////////////////////////////////////////
  /// OpenGL Image (gli.g-truc.net)
  ///
  /// Copyright (c) 2008 - 2015 G-Truc Creation (www.g-truc.net)
  /// Permission is hereby granted, free of charge, to any person obtaining a copy
  /// of this software and associated documentation files (the "Software"), to deal
  /// in the Software without restriction, including without limitation the rights
  /// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  /// copies of the Software, and to permit persons to whom the Software is
  /// furnished to do so, subject to the following conditions:
  /// 
  /// The above copyright notice and this permission notice shall be included in
  /// all copies or substantial portions of the Software.
  /// 
  /// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  /// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  /// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  /// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  /// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  /// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  /// THE SOFTWARE.
  ///
  /// @ref core
  /// @file gli/texture2d.hpp
  /// @date 2010-01-09 / 2015-08-29
  /// @author Christophe Riccio
  ///////////////////////////////////////////////////////////////////////////////////
  
  #pragma once
  
  #include "texture.hpp"
  #include "image.hpp"
  
  namespace gli
  {
  	/// texture2D
  	class texture2D : public texture
  	{
  	public:
  		typedef dim2_t dim_type;
  		typedef vec2 texcoord_type;
  
  	public:
  		/// Create an empty texture 2D.
  		texture2D();
  
  		/// Create a texture2D and allocate a new storage.
  		explicit texture2D(
  			format_type Format,
  			dim_type const & Dimensions,
  			size_type Levels);
  
  		/// Create a texture2D and allocate a new storage with a complete mipmap chain.
  		explicit texture2D(
  			format_type Format,
  			dim_type const & Dimensions);
  
  		/// Create a texture2D view with an existing storage.
  		explicit texture2D(
  			texture const & Texture);
  
  		/// Create a texture2D view with an existing storage.
  		explicit texture2D(
  			texture const & Texture,
  			format_type Format,
  			size_type BaseLayer, size_type MaxLayer,
  			size_type BaseFace, size_type MaxFace,
  			size_type BaseLevel, size_type MaxLevel);
  
  		/// Create a texture2D view, reference a subset of an existing texture2D instance.
  		explicit texture2D(
  			texture2D const & Texture,
  			size_type BaseLevel, size_type MaxLevel);
  
  		/// Create a view of the image identified by Level in the mipmap chain of the texture.
  		image operator[](size_type Level) const;
  
  		/// Return the dimensions of a texture instance: width and height.
  		dim_type dimensions() const;
  
  		template <typename genType>
  		genType fetch(texture2D::dim_type const & TexelCoord, texture2D::size_type Level);
  
  		template <typename genType>
  		void write(texture2D::dim_type const & TexelCoord, texture2D::size_type Level, genType const & Color);
  	};
  }//namespace gli
  
  #include "./core/texture2d.inl"
  