kc3-lang/angle/src/libANGLE/ImageIndex.h

• Show log

  Commit

• Hash : cc129377
  Author :
  Date : 2018-04-12T09:13:18
  

  ImageIndex: Consolidate layer/cube face.
  
  In terms of the Texture or Image resource, a cube face
  refers to a layer of a 2D texture. This layer has a special
  meaning for cube textures, but it is represented as a layer
  with a layer index. Cube array textures are no different,
  they just use a different indexing scheme for the array
  layers.
  
  This also cleans up the ImageIndex helper to have a class
  structure with private data, and cleans up a few cases to
  use generic Make functions and iterators where they were
  setting properties of the index directly.
  
  This will make it easier to have ImageIndexes address
  entire levels of a Cube map in the future, and makes the
  layer count logic in Vulkan cleaner.
  
  Bug: angleproject:2318
  Change-Id: Iea9842e233f974a9896282ca224cb001f7882bd1
  Reviewed-on: https://chromium-review.googlesource.com/987525
  Reviewed-by: Luc Ferron <lucferron@chromium.org>
  Reviewed-by: Yuly Novikov <ynovikov@chromium.org>
  Commit-Queue: Jamie Madill <jmadill@chromium.org>
  

Download

• src/libANGLE/ImageIndex.h

• //
  // Copyright 2014 The ANGLE Project Authors. All rights reserved.
  // Use of this source code is governed by a BSD-style license that can be
  // found in the LICENSE file.
  //
  
  // ImageIndex.h: A helper struct for indexing into an Image array
  
  #ifndef LIBANGLE_IMAGE_INDEX_H_
  #define LIBANGLE_IMAGE_INDEX_H_
  
  #include "common/mathutil.h"
  #include "libANGLE/PackedGLEnums.h"
  
  #include "angle_gl.h"
  
  namespace gl
  {
  
  class ImageIndexIterator;
  
  class ImageIndex
  {
    public:
      ImageIndex();
      ImageIndex(const ImageIndex &other);
      ImageIndex &operator=(const ImageIndex &other);
  
      TextureType getType() const { return mType; }
      GLint getLevelIndex() const { return mLevelIndex; }
      GLint getLayerIndex() const { return mLayerIndex; }
      GLint getLayerCount() const { return mLayerCount; }
  
      bool hasLayer() const;
      bool has3DLayer() const;
      bool usesTex3D() const;
      GLint cubeMapFaceIndex() const;
      bool valid() const;
      TextureTarget getTarget() const;
  
      static ImageIndex Make2D(GLint levelIndex);
      static ImageIndex MakeRectangle(GLint levelIndex);
      static ImageIndex MakeCube(TextureTarget target, GLint levelIndex);
      static ImageIndex Make2DArray(GLint levelIndex, GLint layerIndex);
      static ImageIndex Make2DArrayRange(GLint levelIndex, GLint layerIndex, GLint layerCount);
      static ImageIndex Make3D(GLint levelIndex, GLint layerIndex = kEntireLevel);
      static ImageIndex MakeFromTarget(TextureTarget target, GLint levelIndex);
      static ImageIndex MakeFromType(TextureType type,
                                     GLint levelIndex,
                                     GLint layerIndex = kEntireLevel,
                                     GLint layerCount = 1);
      static ImageIndex Make2DMultisample();
  
      static constexpr GLint kEntireLevel = static_cast<GLint>(-1);
  
      bool operator<(const ImageIndex &b) const;
      bool operator==(const ImageIndex &b) const;
      bool operator!=(const ImageIndex &b) const;
  
      // Only valid for 3D/Cube textures with layers.
      ImageIndexIterator getLayerIterator(GLint layerCount) const;
  
    private:
      friend class ImageIndexIterator;
  
      ImageIndex(TextureType type, GLint leveIndex, GLint layerIndex, GLint layerCount);
  
      TextureType mType;
      GLint mLevelIndex;
      GLint mLayerIndex;
      GLint mLayerCount;
  };
  
  // To be used like this:
  //
  // ImageIndexIterator it = ...;
  // while (it.hasNext())
  // {
  //     ImageIndex current = it.next();
  // }
  class ImageIndexIterator
  {
    public:
      ImageIndexIterator(const ImageIndexIterator &other);
  
      static ImageIndexIterator Make2D(GLint minMip, GLint maxMip);
      static ImageIndexIterator MakeRectangle(GLint minMip, GLint maxMip);
      static ImageIndexIterator MakeCube(GLint minMip, GLint maxMip);
      static ImageIndexIterator Make3D(GLint minMip, GLint maxMip, GLint minLayer, GLint maxLayer);
      static ImageIndexIterator Make2DArray(GLint minMip, GLint maxMip, const GLsizei *layerCounts);
      static ImageIndexIterator Make2DMultisample();
      static ImageIndexIterator MakeGeneric(TextureType type,
                                            GLint minMip,
                                            GLint maxMip,
                                            GLint minLayer,
                                            GLint maxLayer);
  
      ImageIndex next();
      ImageIndex current() const;
      bool hasNext() const;
  
    private:
      ImageIndexIterator(TextureType type,
                         const Range<GLint> &mipRange,
                         const Range<GLint> &layerRange,
                         const GLsizei *layerCounts);
  
      GLint maxLayer() const;
  
      const Range<GLint> mMipRange;
      const Range<GLint> mLayerRange;
      const GLsizei *const mLayerCounts;
  
      ImageIndex mCurrentIndex;
  };
  }  // namespace gl
  
  #endif // LIBANGLE_IMAGE_INDEX_H_
  

Download