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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
// 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 UI_GL_GL_IMAGE_H_
#define UI_GL_GL_IMAGE_H_
#include <stdint.h>
#include <string>
#include "base/macros.h"
#include "base/memory/ref_counted.h"
#include "ui/gfx/color_space.h"
#include "ui/gfx/geometry/point.h"
#include "ui/gfx/geometry/rect.h"
#include "ui/gfx/geometry/rect_f.h"
#include "ui/gfx/geometry/size.h"
#include "ui/gfx/native_widget_types.h"
#include "ui/gfx/overlay_transform.h"
#include "ui/gl/gl_export.h"
namespace base {
namespace trace_event {
class ProcessMemoryDump;
}
}
namespace gl {
// Encapsulates an image that can be bound and/or copied to a texture, hiding
// platform specific management.
class GL_EXPORT GLImage : public base::RefCounted<GLImage> {
public:
GLImage() {}
// Get the size of the image.
virtual gfx::Size GetSize() = 0;
// Get the internal format of the image.
virtual unsigned GetInternalFormat() = 0;
// Bind image to texture currently bound to |target|. Returns true on success.
// It is valid for an implementation to always return false.
virtual bool BindTexImage(unsigned target) = 0;
// Bind image to texture currently bound to |target|, forcing the texture's
// internal format to the specified one. This is a feature not available on
// all platforms. Returns true on success. It is valid for an implementation
// to always return false.
virtual bool BindTexImageWithInternalformat(unsigned target,
unsigned internalformat);
// Release image from texture currently bound to |target|.
virtual void ReleaseTexImage(unsigned target) = 0;
// Define texture currently bound to |target| by copying image into it.
// Returns true on success. It is valid for an implementation to always
// return false.
virtual bool CopyTexImage(unsigned target) = 0;
// Copy |rect| of image to |offset| in texture currently bound to |target|.
// Returns true on success. It is valid for an implementation to always
// return false.
virtual bool CopyTexSubImage(unsigned target,
const gfx::Point& offset,
const gfx::Rect& rect) = 0;
// Schedule image as an overlay plane to be shown at swap time for |widget|.
virtual bool ScheduleOverlayPlane(gfx::AcceleratedWidget widget,
int z_order,
gfx::OverlayTransform transform,
const gfx::Rect& bounds_rect,
const gfx::RectF& crop_rect) = 0;
// Flush any preceding rendering for the image.
virtual void Flush() = 0;
// Dumps information about the memory backing the GLImage to a dump named
// |dump_name|.
virtual void OnMemoryDump(base::trace_event::ProcessMemoryDump* pmd,
uint64_t process_tracing_id,
const std::string& dump_name) = 0;
// If this returns true, then the command buffer client has requested a
// CHROMIUM image with internalformat GL_RGB, but the platform only supports
// GL_RGBA. The client is responsible for implementing appropriate
// workarounds. The only support that the command buffer provides is format
// validation during calls to copyTexImage2D and copySubTexImage2D.
//
// This is a workaround that is not intended to become a permanent part of the
// GLImage API. Theoretically, when Apple fixes their drivers, this can be
// removed. https://crbug.com/581777#c36
virtual bool EmulatingRGB() const;
// An identifier for subclasses. Necessary for safe downcasting.
enum class Type { NONE, MEMORY, IOSURFACE, DXGI_IMAGE };
virtual Type GetType() const;
void SetColorSpaceForScanout(const gfx::ColorSpace& color_space) {
color_space_ = color_space;
}
const gfx::ColorSpace& color_space() const { return color_space_; }
protected:
virtual ~GLImage() {}
gfx::ColorSpace color_space_;
private:
friend class base::RefCounted<GLImage>;
DISALLOW_COPY_AND_ASSIGN(GLImage);
};
} // namespace gl
#endif // UI_GL_GL_IMAGE_H_
|
