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

• Show log

  Commit

• Hash : 7b0bb0f6
  Author :
  Date : 2023-09-01T13:52:28
  

  Properly "install" program executables
  
  According to GL:
  
  - The program has an executable
  - The executable is overwritten during link.
    - After a failed link, queries of the executable may return
      half-linked information
  - On glUseProgram, the executable is installed in the context
  - On glUseProgramStages, the executable is installed in the program
    pipeline
  - After a successful link, the executable is updated wherever the
    previous executable of the program was installed.
  
  This change implements exactly the above:
  
  - The program's and the program pipeline's executables are now
    shared_ptr.  References to an executable in the context and PPO are
    also through a shared_ptr.  Installing an executable thus translates
    to sharing the executable.
  - The context and PPOs are made to not reference the program directly,
    but work solely through the executable.  As a result, the program is
    free to create a new executable for link.
  
  With this change, the link job will be free to modify the executable as
  necessary because that will not be accessed until the link is done.
  Note that previous changes made the backend executable accessed through
  the frontend one, and moved all link results to the frontend and backend
  executables as appropriate.
  
  Bug: angleproject:6358
  Bug: angleproject:8297
  Change-Id: Ie636b23ff7420ad284d18b525ec4f5fb559dd9d1
  Reviewed-on: https://chromium-review.googlesource.com/c/angle/angle/+/4823089
  Commit-Queue: Shahbaz Youssefi <syoussefi@chromium.org>
  Reviewed-by: Geoff Lang <geofflang@chromium.org>
  Reviewed-by: Charlie Lao <cclao@google.com>
  

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/BlobCache.h"
  #include "libANGLE/Error.h"
  
  namespace gl
  {
  class Context;
  class Program;
  class ProgramState;
  
  class MemoryProgramCache final : angle::NonCopyable
  {
    public:
      explicit MemoryProgramCache(egl::BlobCache &blobCache);
      ~MemoryProgramCache();
  
      static void ComputeHash(const Context *context,
                              const Program *program,
                              egl::BlobCache::Key *hashOut);
  
      // For querying the contents of the cache.
      bool getAt(size_t index,
                 const egl::BlobCache::Key **hashOut,
                 egl::BlobCache::Value *programOut);
  
      // Evict a program from the binary cache.
      void remove(const egl::BlobCache::Key &programHash);
  
      // Helper method that serializes a program.
      angle::Result putProgram(const egl::BlobCache::Key &programHash,
                               const Context *context,
                               const Program *program);
  
      // Same as putProgram but computes the hash.
      angle::Result updateProgram(const Context *context, const Program *program);
  
      // Store a binary directly.  TODO(syoussefi): deprecated.  Will be removed once Chrome supports
      // EGL_ANDROID_blob_cache. http://anglebug.com/2516
      [[nodiscard]] bool putBinary(const egl::BlobCache::Key &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.
      angle::Result getProgram(const Context *context,
                               Program *program,
                               egl::BlobCache::Key *hashOut,
                               bool *successOut);
  
      // 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:
      egl::BlobCache &mBlobCache;
  };
  
  }  // namespace gl
  
  #endif  // LIBANGLE_MEMORY_PROGRAM_CACHE_H_
  

Download