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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
gpu / command_buffer / client / raster_interface.h [blame]
// Copyright 2017 The Chromium Authors
// 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_RASTER_INTERFACE_H_
#define GPU_COMMAND_BUFFER_CLIENT_RASTER_INTERFACE_H_
#include <GLES2/gl2.h>
#include "base/compiler_specific.h"
#include "base/containers/flat_map.h"
#include "base/containers/span.h"
#include "base/functional/callback.h"
#include "gpu/command_buffer/client/interface_base.h"
#include "gpu/command_buffer/common/raster_cmd_enums.h"
#include "gpu/command_buffer/common/sync_token.h"
#include "third_party/skia/include/core/SkColor.h"
#include "third_party/skia/include/core/SkImageInfo.h"
#include "third_party/skia/include/core/SkPixmap.h"
#include "third_party/skia/include/core/SkYUVAInfo.h"
#include "third_party/skia/include/core/SkYUVAPixmaps.h"
#include "third_party/skia/include/gpu/ganesh/GrTypes.h"
namespace cc {
class DisplayItemList;
class ImageProvider;
struct ElementId;
} // namespace cc
namespace gfx {
class ColorSpace;
class Point;
class PointF;
class Rect;
class Size;
class Vector2dF;
enum class BufferUsage;
} // namespace gfx
extern "C" typedef struct _ClientBuffer* ClientBuffer;
extern "C" typedef const struct _GLcolorSpace* GLcolorSpace;
namespace gpu {
class ClientSharedImage;
struct Mailbox;
namespace raster {
enum RasterTexStorageFlags { kNone = 0, kOverlay = (1 << 0) };
class RasterInterface : public InterfaceBase {
public:
RasterInterface() {}
virtual ~RasterInterface() {}
// This function will not perform any color conversion during the copy.
virtual void CopySharedImage(const gpu::Mailbox& source_mailbox,
const gpu::Mailbox& dest_mailbox,
GLint xoffset,
GLint yoffset,
GLint x,
GLint y,
GLsizei width,
GLsizei height) = 0;
// Asynchronously writes pixels from caller-owned memory inside
// |src_sk_pixmap| into |dest_mailbox|.
// NOTE: This is only for single planar shared images (RGB). For multiplanar
// shared images, perform WritePixelsYUV.
virtual void WritePixels(const gpu::Mailbox& dest_mailbox,
int dst_x_offset,
int dst_y_offset,
GLenum texture_target,
const SkPixmap& src_sk_pixmap) = 0;
// Asynchronously writes YUV pixels from caller-owned memory inside
// |src_yuv_pixmaps| into |dest_mailbox| for all planes. Should be used only
// with YUV source images.
// NOTE: This does not perform color space conversions and just uploads
// pixels. For color space conversions (if needed), perform a CopySharedImage.
virtual void WritePixelsYUV(const gpu::Mailbox& dest_mailbox,
const SkYUVAPixmaps& src_yuv_pixmap) = 0;
// OOP-Raster
// msaa_sample_count has no effect unless msaa_mode is set to kMSAA
virtual void BeginRasterCHROMIUM(SkColor4f sk_color_4f,
GLboolean needs_clear,
GLuint msaa_sample_count,
MsaaMode msaa_mode,
GLboolean can_use_lcd_text,
GLboolean visible,
const gfx::ColorSpace& color_space,
float hdr_headroom,
const GLbyte* mailbox) = 0;
// Heuristic decided on UMA data. This covers 85% of the cases where we need
// to serialize ops > 512k.
static constexpr size_t kDefaultMaxOpSizeHint = 600 * 1024;
using ScrollOffsetMap = base::flat_map<cc::ElementId, gfx::PointF>;
virtual void RasterCHROMIUM(
const cc::DisplayItemList* list,
cc::ImageProvider* provider,
const gfx::Size& content_size,
const gfx::Rect& full_raster_rect,
const gfx::Rect& playback_rect,
const gfx::Vector2dF& post_translate,
const gfx::Vector2dF& post_scale,
bool requires_clear,
const ScrollOffsetMap* raster_inducing_scroll_offsets,
size_t* max_op_size_hint) = 0;
// Schedules a hardware-accelerated image decode and a sync token that's
// released when the image decode is complete. If the decode could not be
// scheduled, an empty sync token is returned. This method should only be
// called if ContextSupport::CanDecodeWithHardwareAcceleration() returns true.
virtual SyncToken ScheduleImageDecode(
base::span<const uint8_t> encoded_data,
const gfx::Size& output_size,
uint32_t transfer_cache_entry_id,
const gfx::ColorSpace& target_color_space,
bool needs_mips) = 0;
// Starts an asynchronous readback of |source_mailbox| into caller-owned
// memory |out|.
// |dst_row_bytes| is a per row stride expected in the |out| buffer.
// |source_origin| specifies texture coordinate directions, but
// pixels in |out| laid out with top-left origin.
// Currently supports the kRGBA_8888_SkColorType and
// kBGRA_8888_SkColorType color types.
// |out| must remain valid until |readback_done| is called with
// a bool indicating if the readback was successful.
// |source_size| describes dimensions of the |source_mailbox| texture.
// |dst_info| |source_starting_point| describe subregion that needs to be read
// On success |out| will contain the pixel data copied back from the GPU
// process.
virtual void ReadbackARGBPixelsAsync(
const gpu::Mailbox& source_mailbox,
GLenum source_target,
GrSurfaceOrigin source_origin,
const gfx::Size& source_size,
const gfx::Point& source_starting_point,
const SkImageInfo& dst_info,
GLuint dst_row_bytes,
unsigned char* out,
base::OnceCallback<void(bool)> readback_done) = 0;
// Starts an asynchronus readback and translation of RGBA |source_mailbox|
// into caller-owned |[yuv]_plane_data|. All provided pointers must remain
// valid until |readback_done| is called with a bool indicating if readback
// was successful. On success the provided memory will contain pixel data in
// I420 format copied from |source_mailbox| in the GPU process.
// |release_mailbox| is called when all operations requiring a valid mailbox
// have completed, indicating that the caller can perform any necessary
// cleanup.
virtual void ReadbackYUVPixelsAsync(
const gpu::Mailbox& source_mailbox,
GLenum source_target,
const gfx::Size& source_size,
const gfx::Rect& output_rect,
bool vertically_flip_texture,
int y_plane_row_stride_bytes,
unsigned char* y_plane_data,
int u_plane_row_stride_bytes,
unsigned char* u_plane_data,
int v_plane_row_stride_bytes,
unsigned char* v_plane_data,
const gfx::Point& paste_location,
base::OnceCallback<void()> release_mailbox,
base::OnceCallback<void(bool)> readback_done) = 0;
// Synchronously does a readback of SkImage pixels for given |plane_index|
// from |source_mailbox| into caller-owned memory |dst_pixels|. |plane_index|
// applies to multiplanar textures in mailboxes, for example YUV images
// produced by the VideoDecoder. |plane_index| as 0 should be passed for known
// single-plane textures.
virtual bool ReadbackImagePixels(const gpu::Mailbox& source_mailbox,
const SkImageInfo& dst_info,
GLuint dst_row_bytes,
int src_x,
int src_y,
int plane_index,
void* dst_pixels) = 0;
// Raster via GrContext.
virtual GLuint CreateAndConsumeForGpuRaster(const gpu::Mailbox& mailbox) = 0;
virtual GLuint CreateAndConsumeForGpuRaster(
const scoped_refptr<gpu::ClientSharedImage>& shared_image) = 0;
virtual void DeleteGpuRasterTexture(GLuint texture) = 0;
virtual void BeginGpuRaster() = 0;
virtual void EndGpuRaster() = 0;
virtual void BeginSharedImageAccessDirectCHROMIUM(GLuint texture,
GLenum mode) = 0;
virtual void EndSharedImageAccessDirectCHROMIUM(GLuint texture) = 0;
virtual void InitializeDiscardableTextureCHROMIUM(GLuint texture) = 0;
virtual void UnlockDiscardableTextureCHROMIUM(GLuint texture) = 0;
virtual bool LockDiscardableTextureCHROMIUM(GLuint texture) = 0;
// Include the auto-generated part of this class. We split this because
// it means we can easily edit the non-auto generated parts right here in
// this file instead of having to edit some template or the code generator.
#include "gpu/command_buffer/client/raster_interface_autogen.h"
};
} // namespace raster
} // namespace gpu
#endif // GPU_COMMAND_BUFFER_CLIENT_RASTER_INTERFACE_H_