1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
|
// Copyright (c) 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.
#ifndef CONTENT_BROWSER_RENDERER_HOST_IMAGE_TRANSPORT_FACTORY_H_
#define CONTENT_BROWSER_RENDERER_HOST_IMAGE_TRANSPORT_FACTORY_H_
#pragma once
#include "base/memory/ref_counted.h"
#include "ui/gfx/native_widget_types.h"
namespace content {
class GLHelper;
}
namespace gfx {
class Size;
class ScopedMakeCurrent;
}
namespace ui {
class Compositor;
class ContextFactory;
class Texture;
}
namespace WebKit {
class WebGraphicsContext3D;
}
class ImageTransportClient;
// This class provides a way to get notified when surface handles get lost.
class ImageTransportFactoryObserver {
public:
virtual ~ImageTransportFactoryObserver() {}
// Notifies that the surface handles generated by ImageTransportFactory for a
// given compositor were lost.
// When this is called, the old resources (e.g. shared context, GL helper)
// still exist, but are about to be destroyed. Getting a reference to those
// resources from the ImageTransportFactory (e.g. through GetGLHelper) will
// return newly recreated, valid resources.
virtual void OnLostResources(ui::Compositor* compositor) = 0;
};
// This class provides the interface for creating the support for the
// cross-process image transport, both for creating the shared surface handle
// (destination surface for the GPU process) and the transport client (logic for
// using that surface as a texture). The factory is a process-wide singleton.
// As this is intimately linked to the type of 3D context we use (in-process or
// command-buffer), implementations of this also implement ui::ContextFactory.
class ImageTransportFactory {
public:
virtual ~ImageTransportFactory() { }
// Initialize the global transport factory.
static void Initialize();
// Terminates the global transport factory.
static void Terminate();
// Gets the factory instance.
static ImageTransportFactory* GetInstance();
// Gets the image transport factory as a context factory for the compositor.
virtual ui::ContextFactory* AsContextFactory() = 0;
// Creates a shared surface handle, associated with the compositor.
// Note: the handle may get lost at any time, a state that an
// ImageTransportFactoryObserver gets notified of.
virtual gfx::GLSurfaceHandle CreateSharedSurfaceHandle(
ui::Compositor* compositor) = 0;
// Destroys a shared surface handle.
virtual void DestroySharedSurfaceHandle(gfx::GLSurfaceHandle surface) = 0;
// Creates a transport client of a given size, and using the opaque handle
// sent by the GPU process.
virtual scoped_refptr<ImageTransportClient> CreateTransportClient(
const gfx::Size& size,
uint64* transport_handle) = 0;
// Gets a GLHelper instance, associated with the compositor context. This
// GLHelper will get destroyed whenever the context is lost (
virtual content::GLHelper* GetGLHelper(ui::Compositor* compositor) = 0;
// Returns a ScopedMakeCurrent that can be used to make current a context that
// is shared with the compositor context, e.g. to create a texture in its
// namespace. The caller gets ownership of the object.
// This will return NULL when using out-of-process (command buffer) contexts.
virtual gfx::ScopedMakeCurrent* GetScopedMakeCurrent() = 0;
virtual void AddObserver(ImageTransportFactoryObserver* observer) = 0;
virtual void RemoveObserver(ImageTransportFactoryObserver* observer) = 0;
};
#endif // CONTENT_BROWSER_RENDERER_HOST_IMAGE_TRANSPORT_FACTORY_H_
|
