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
|
// Copyright 2013 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_COMMON_MAILBOX_H_
#define GPU_COMMAND_BUFFER_COMMON_MAILBOX_H_
#include <stdint.h>
#include <string.h>
#include <string>
#include "base/component_export.h"
// From gl2/gl2ext.h.
#ifndef GL_MAILBOX_SIZE_CHROMIUM
#define GL_MAILBOX_SIZE_CHROMIUM 16
#endif
namespace content {
class PPB_Graphics3D_Impl;
}
namespace media {
class GLES2DecoderHelperImpl;
}
namespace gpu {
namespace gles2 {
class GLES2Implementation;
}
// Importance to use in tracing. Higher values get the memory cost attributed,
// and equal values share the cost. We want the client to "win" over the
// service, since the service is acting on its behalf.
enum class TracingImportance : int {
kNotOwner = 0,
kServiceOwner = 1,
kClientOwner = 2,
};
// A mailbox is an unguessable name that references texture image data.
// This name can be passed across processes permitting one context to share
// texture image data with another. The mailbox name consists of a random
// set of bytes, optionally with a checksum (in debug mode) to verify the
// name is valid.
// See src/gpu/GLES2/extensions/CHROMIUM/CHROMIUM_texture_mailbox.txt for more
// details.
struct COMPONENT_EXPORT(GPU_MAILBOX) Mailbox {
using Name = int8_t[GL_MAILBOX_SIZE_CHROMIUM];
Mailbox();
static Mailbox FromVolatile(const volatile Mailbox& other) {
// Because the copy constructor is trivial, const_cast is safe.
return const_cast<const Mailbox&>(other);
}
bool IsZero() const;
void SetZero();
void SetName(const int8_t* name);
// Indicates whether this mailbox is used with the SharedImage system.
bool IsSharedImage() const;
// Generate a unique unguessable mailbox name for use with the SharedImage
// system.
static Mailbox GenerateForSharedImage();
// Verify that the mailbox was created through Mailbox::Generate. This only
// works in Debug (always returns true in Release). This is not a secure
// check, only to catch bugs where clients forgot to call Mailbox::Generate.
bool Verify() const;
std::string ToDebugString() const;
Name name;
bool operator<(const Mailbox& other) const {
return memcmp(this, &other, sizeof other) < 0;
}
bool operator==(const Mailbox& other) const {
return memcmp(this, &other, sizeof other) == 0;
}
bool operator!=(const Mailbox& other) const {
return !operator==(other);
}
private:
// Generate a unique unguessable mailbox name for use with the legacy mailbox
// system.
// NOTE: We are in the process of eliminating this method. DO NOT ADD ANY NEW
// USAGES - instead, reach out to shared-image-team@ with your use case. See
// crbug.com/1273084.
static Mailbox GenerateLegacyMailbox();
friend class content::PPB_Graphics3D_Impl;
friend class gles2::GLES2Implementation;
friend class media::GLES2DecoderHelperImpl;
public:
// Generate a legacy mailbox for usage in tests of production code that
// still interacts with the legacy mailbox system.
static Mailbox GenerateLegacyMailboxForTesting() {
return GenerateLegacyMailbox();
}
};
} // namespace gpu
#endif // GPU_COMMAND_BUFFER_COMMON_MAILBOX_H_
|
