| // Copyright 2014 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_GPU_CONTROL_H_ |
| #define GPU_COMMAND_BUFFER_CLIENT_GPU_CONTROL_H_ |
| |
| #include <stddef.h> |
| #include <stdint.h> |
| |
| #include <vector> |
| |
| #include "base/callback.h" |
| #include "base/macros.h" |
| #include "gpu/command_buffer/common/capabilities.h" |
| #include "gpu/command_buffer/common/command_buffer_id.h" |
| #include "gpu/command_buffer/common/constants.h" |
| #include "gpu/command_buffer/common/mailbox.h" |
| #include "gpu/gpu_export.h" |
| |
| extern "C" typedef struct _ClientBuffer* ClientBuffer; |
| |
| namespace base { |
| class Lock; |
| } |
| |
| namespace ui { |
| class LatencyInfo; |
| } |
| |
| namespace gpu { |
| class GpuControlClient; |
| struct SyncToken; |
| |
| // Common interface for GpuControl implementations. |
| class GPU_EXPORT GpuControl { |
| public: |
| GpuControl() {} |
| virtual ~GpuControl() {} |
| |
| virtual void SetGpuControlClient(GpuControlClient* gpu_control_client) = 0; |
| |
| virtual Capabilities GetCapabilities() = 0; |
| |
| // Create an image for a client buffer with the given dimensions and |
| // format. Returns its ID or -1 on error. |
| virtual int32_t CreateImage(ClientBuffer buffer, |
| size_t width, |
| size_t height, |
| unsigned internalformat) = 0; |
| |
| // Destroy an image. The ID must be positive. |
| virtual void DestroyImage(int32_t id) = 0; |
| |
| // Runs |callback| when a query created via glCreateQueryEXT() has cleared |
| // passed the glEndQueryEXT() point. |
| virtual void SignalQuery(uint32_t query, const base::Closure& callback) = 0; |
| |
| // Sets a lock this will be held on every callback from the GPU |
| // implementation. This lock must be set and must be held on every call into |
| // the GPU implementation if it is to be used from multiple threads. This |
| // may not be supported with all implementations. |
| virtual void SetLock(base::Lock*) = 0; |
| |
| // When this function returns it ensures all previously flushed work is |
| // visible by the service. This command does this by sending a synchronous |
| // IPC. Note just because the work is visible to the server does not mean |
| // that it has been processed. This is only relevant for out of process |
| // services and will be treated as a NOP for in process command buffers. |
| virtual void EnsureWorkVisible() = 0; |
| |
| // The namespace and command buffer ID forms a unique pair for all existing |
| // GpuControl (on client) and matches for the corresponding command buffer |
| // (on server) in a single server process. The extra command buffer data can |
| // be used for extra identification purposes. One usage is to store some |
| // extra field to identify unverified sync tokens for the implementation of |
| // the CanWaitUnverifiedSyncToken() function. |
| virtual CommandBufferNamespace GetNamespaceID() const = 0; |
| virtual CommandBufferId GetCommandBufferID() const = 0; |
| |
| // Returns the stream id for this context. Only relevant for IPC command |
| // buffer proxy. Used as extra command buffer data in sync tokens. |
| virtual int32_t GetStreamId() const = 0; |
| |
| // Flush any outstanding ordering barriers on given stream. |
| virtual void FlushOrderingBarrierOnStream(int32_t stream_id) = 0; |
| |
| // Generates a fence sync which should be inserted into the GL command stream. |
| // When the service executes the fence sync it is released. Fence syncs are |
| // shared with other contexts as sync tokens which encapsulate the fence sync |
| // and the command buffer on which it was generated. Fence syncs need to be |
| // flushed before they can be used by other contexts. Furthermore, the flush |
| // must be verified before sending a sync token across channel boundaries. |
| virtual uint64_t GenerateFenceSyncRelease() = 0; |
| |
| // Returns true if the fence sync is valid. |
| virtual bool IsFenceSyncRelease(uint64_t release) = 0; |
| |
| // Returns true if the client has flushed the fence sync. |
| virtual bool IsFenceSyncFlushed(uint64_t release) = 0; |
| |
| // Returns true if the service has received the fence sync. Used for verifying |
| // sync tokens. |
| virtual bool IsFenceSyncFlushReceived(uint64_t release) = 0; |
| |
| // Returns true if the service has released (executed) the fence sync. Some |
| // implementations may support calling this from any thread without holding |
| // the lock provided by the client. |
| virtual bool IsFenceSyncReleased(uint64_t release) = 0; |
| |
| // Runs |callback| when sync token is signaled. |
| virtual void SignalSyncToken(const SyncToken& sync_token, |
| const base::Closure& callback) = 0; |
| |
| // This allows the command buffer proxy to mark the next flush with sync token |
| // dependencies for the gpu scheduler. This is used in addition to the |
| // WaitSyncToken command in the command buffer which is still needed. For |
| // example, the WaitSyncToken command is used to pull texture updates when |
| // used in conjunction with MailboxManagerSync. |
| virtual void WaitSyncTokenHint(const SyncToken& sync_token) = 0; |
| |
| // Under some circumstances a sync token may be used which has not been |
| // verified to have been flushed. For example, fence syncs queued on the same |
| // channel as the wait command guarantee that the fence sync will be enqueued |
| // first so does not need to be flushed. |
| virtual bool CanWaitUnverifiedSyncToken(const SyncToken& sync_token) = 0; |
| |
| // Add |latency_info| to be reported and augumented with GPU latency |
| // components next time there is a GPU buffer swap. |
| virtual void AddLatencyInfo( |
| const std::vector<ui::LatencyInfo>& latency_info) = 0; |
| |
| private: |
| DISALLOW_COPY_AND_ASSIGN(GpuControl); |
| }; |
| |
| } // namespace gpu |
| |
| #endif // GPU_COMMAND_BUFFER_CLIENT_GPU_CONTROL_H_ |