blob: a463b770007a9047d774022898f60c75290f94e1 [file] [log] [blame]
// Copyright 2012 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.
#include "base/callback.h"
#include "base/memory/ref_counted.h"
#include "base/time/time.h"
#include "cc/cc_export.h"
#include "components/viz/common/resources/returned_resource.h"
#include "gpu/command_buffer/common/texture_in_use_response.h"
#include "ui/gfx/geometry/rect.h"
namespace gfx {
class Transform;
namespace viz {
class BeginFrameSource;
namespace cc {
struct ManagedMemoryPolicy;
class CC_EXPORT LayerTreeFrameSinkClient {
// Pass the begin frame source for the client to observe. Client does not own
// the viz::BeginFrameSource. LayerTreeFrameSink should call this once after
// binding to the client and then call again with a null while detaching.
virtual void SetBeginFrameSource(viz::BeginFrameSource* source) = 0;
// Returns resources sent to SubmitCompositorFrame to be reused or freed.
virtual void ReclaimResources(
const std::vector<viz::ReturnedResource>& resources) = 0;
// If set, |callback| will be called subsequent to each new tree activation,
// regardless of the compositor visibility or damage. |callback| must remain
// valid for the lifetime of the LayerTreeFrameSinkClient or until
// unregistered by giving a null base::Closure.
virtual void SetTreeActivationCallback(const base::Closure& callback) = 0;
// Notification that the previous CompositorFrame given to
// SubmitCompositorFrame() has been processed and that another frame
// can be submitted. This provides backpressure from the display compositor
// so that frames are submitted only at the rate it can handle them.
virtual void DidReceiveCompositorFrameAck() = 0;
// See ui/gfx/presentation_feedback.h for details on args. |time| is always
// non-zero.
virtual void DidPresentCompositorFrame(uint32_t presentation_token,
base::TimeTicks time,
base::TimeDelta refresh,
uint32_t flags) = 0;
virtual void DidDiscardCompositorFrame(uint32_t presentation_token) = 0;
// The LayerTreeFrameSink is lost when the viz::ContextProviders held by it
// encounter an error. In this case the LayerTreeFrameSink (and the
// viz::ContextProviders) must be recreated.
virtual void DidLoseLayerTreeFrameSink() = 0;
// For SynchronousCompositor (WebView) to ask the layer compositor to submit
// a new CompositorFrame synchronously.
virtual void OnDraw(const gfx::Transform& transform,
const gfx::Rect& viewport,
bool resourceless_software_draw) = 0;
// For SynchronousCompositor (WebView) to set how much memory the compositor
// can use without changing visibility.
virtual void SetMemoryPolicy(const ManagedMemoryPolicy& policy) = 0;
// For SynchronousCompositor (WebView) to change which tiles should be
// included in submitted CompositorFrames independently of what the viewport
// is.
virtual void SetExternalTilePriorityConstraints(
const gfx::Rect& viewport_rect,
const gfx::Transform& transform) = 0;
virtual ~LayerTreeFrameSinkClient() {}
} // namespace cc