gpu/command_buffer/client/client_transfer_cache.h

// Copyright (c) 2017 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef GPU_COMMAND_BUFFER_CLIENT_CLIENT_TRANSFER_CACHE_H_
#define GPU_COMMAND_BUFFER_CLIENT_CLIENT_TRANSFER_CACHE_H_

#include <map>

#include "base/synchronization/lock.h"
#include "cc/paint/transfer_cache_entry.h"
#include "gpu/command_buffer/client/client_discardable_manager.h"
#include "gpu/command_buffer/client/gles2_impl_export.h"
#include "gpu/command_buffer/client/gles2_interface.h"

namespace gpu {
namespace gles2 {
class GLES2CmdHelper;
}
class MappedMemoryManager;

// ClientTransferCache allows for ClientTransferCacheEntries to be inserted
// into the cache, which will send them to the ServiceTransferCache, making
// them available for consumption in the GPU process. Typical usage is:
//   1) Insert a new entry via CreateCacheEntry. It starts locked.
//   2) Use the new entry's ID in one or more commands.
//   3) Unlock the entry via UnlockTransferCacheEntries after dependent commands
//      have been issued.
//
// If an entry is needed again:
//   4) Attempt to lock the entry via LockTransferCacheEntry.
//      4a) If this fails, DeleteTransferCacheEntry then go to (1)
//      4b) If this succeeds, go to (2).
//
// If an entry is no longer needed:
//   5) DeleteTransferCacheEntry
//
// NOTE: The presence of locking on this class does not make it threadsafe.
// The underlying locking *only* allows calling LockTransferCacheEntry
// without holding the GL context lock. All other calls still require that
// the context lock be held.
class GLES2_IMPL_EXPORT ClientTransferCache {
 public:
  ClientTransferCache();
  ~ClientTransferCache();

  void CreateCacheEntry(gles2::GLES2CmdHelper* helper,
                        MappedMemoryManager* mapped_memory,
                        const cc::ClientTransferCacheEntry& entry);
  bool LockTransferCacheEntry(cc::TransferCacheEntryType type, uint32_t id);
  void UnlockTransferCacheEntries(
      gles2::GLES2CmdHelper* helper,
      const std::vector<std::pair<cc::TransferCacheEntryType, uint32_t>>&
          entries);
  void DeleteTransferCacheEntry(gles2::GLES2CmdHelper* helper,
                                cc::TransferCacheEntryType type,
                                uint32_t id);

 private:
  ClientDiscardableHandle::Id FindDiscardableHandleId(
      cc::TransferCacheEntryType type,
      uint32_t id);

  std::map<uint32_t, ClientDiscardableHandle::Id>& DiscardableHandleIdMap(
      cc::TransferCacheEntryType entry_type);

  // Access to other members must always be done with |lock_| held.
  base::Lock lock_;
  ClientDiscardableManager discardable_manager_;
  std::map<uint32_t, ClientDiscardableHandle::Id> discardable_handle_id_map_
      [static_cast<uint32_t>(cc::TransferCacheEntryType::kLast) + 1];
};

}  // namespace gpu

#endif  // GPU_COMMAND_BUFFER_CLIENT_CLIENT_TRANSFER_CACHE_H_