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

• Show log

  Commit

• Hash : c43be720
  Author :
  Date : 2017-07-13T16:22:14
  

  Implement ANGLE_program_cache_control extensions.
  
  This will give the browsers the ability to control the cache size,
  query and populate the contents, and trim cache contents on memory
  pressure.
  
  BUG=angleproject:1897
  
  Change-Id: I6edaa7d307b890223db98792d5b074e4a7fdfaa4
  Reviewed-on: https://chromium-review.googlesource.com/563606
  Commit-Queue: Jamie Madill <jmadill@chromium.org>
  Reviewed-by: Corentin Wallez <cwallez@chromium.org>
  

Download

• src/libANGLE/MemoryProgramCache.h

• //
  // Copyright 2017 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.
  //
  // MemoryProgramCache: Stores compiled and linked programs in memory so they don't
  //   always have to be re-compiled. Can be used in conjunction with the platform
  //   layer to warm up the cache from disk.
  
  #ifndef LIBANGLE_MEMORY_PROGRAM_CACHE_H_
  #define LIBANGLE_MEMORY_PROGRAM_CACHE_H_
  
  #include <array>
  
  #include "common/MemoryBuffer.h"
  #include "libANGLE/Error.h"
  #include "libANGLE/SizedMRUCache.h"
  
  namespace gl
  {
  // 160-bit SHA-1 hash key.
  constexpr size_t kProgramHashLength = 20;
  using ProgramHash                   = std::array<uint8_t, kProgramHashLength>;
  }  // namespace gl
  
  namespace std
  {
  template <>
  struct hash<gl::ProgramHash>
  {
      // Simple routine to hash four ints.
      size_t operator()(const gl::ProgramHash &programHash) const
      {
          unsigned int hash = 0;
          for (uint32_t num : programHash)
          {
              hash *= 37;
              hash += num;
          }
          return hash;
      }
  };
  }  // namespace std
  
  namespace gl
  {
  class Context;
  class InfoLog;
  class Program;
  class ProgramState;
  
  class MemoryProgramCache final : angle::NonCopyable
  {
    public:
      MemoryProgramCache(size_t maxCacheSizeBytes);
      ~MemoryProgramCache();
  
      // Writes a program's binary to the output memory buffer.
      static void Serialize(const Context *context,
                            const Program *program,
                            angle::MemoryBuffer *binaryOut);
  
      // Loads program state according to the specified binary blob.
      static LinkResult Deserialize(const Context *context,
                                    const Program *program,
                                    ProgramState *state,
                                    const uint8_t *binary,
                                    size_t length,
                                    InfoLog &infoLog);
  
      static void ComputeHash(const Context *context, const Program *program, ProgramHash *hashOut);
  
      // Check if the cache contains a binary matching the specified program.
      bool get(const ProgramHash &programHash, const angle::MemoryBuffer **programOut);
  
      // For querying the contents of the cache.
      bool getAt(size_t index, ProgramHash *hashOut, const angle::MemoryBuffer **programOut);
  
      // Evict a program from the binary cache.
      void remove(const ProgramHash &programHash);
  
      // Helper method that serializes a program.
      void putProgram(const ProgramHash &programHash, const Context *context, const Program *program);
  
      // Store a binary directly.
      void putBinary(const ProgramHash &programHash, const uint8_t *binary, size_t length);
  
      // Check the cache, and deserialize and load the program if found. Evict existing hash if load
      // fails.
      LinkResult getProgram(const Context *context,
                            const Program *program,
                            ProgramState *state,
                            ProgramHash *hashOut);
  
      // Empty the cache.
      void clear();
  
      // Resize the cache. Discards current contents.
      void resize(size_t maxCacheSizeBytes);
  
      // Returns the number of entries in the cache.
      size_t entryCount() const;
  
      // Reduces the current cache size and returns the number of bytes freed.
      size_t trim(size_t limit);
  
      // Returns the current cache size in bytes.
      size_t size() const;
  
      // Returns the maximum cache size in bytes.
      size_t maxSize() const;
  
    private:
      // Insert or update a binary program. Program contents are transferred.
      void put(const ProgramHash &programHash,
               angle::MemoryBuffer &&binaryProgram);
  
      angle::SizedMRUCache<ProgramHash, angle::MemoryBuffer> mProgramBinaryCache;
      unsigned int mIssuedWarnings;
  };
  
  }  // namespace gl
  
  #endif  // LIBANGLE_MEMORY_PROGRAM_CACHE_H_
  

Download