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
|
// Copyright (c) 2011 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 GPU_COMMAND_BUFFER_COMMON_COMMAND_BUFFER_H_
#define GPU_COMMAND_BUFFER_COMMON_COMMAND_BUFFER_H_
#include "../common/buffer.h"
#include "../common/constants.h"
namespace base {
class SharedMemory;
}
namespace gpu {
// Common interface for CommandBuffer implementations.
class CommandBuffer {
public:
enum {
kMaxCommandBufferSize = 4 * 1024 * 1024
};
struct State {
State()
: num_entries(0),
get_offset(0),
put_offset(0),
token(-1),
error(error::kNoError),
context_lost_reason(error::kUnknown),
generation(0) {
}
// Size of the command buffer in command buffer entries.
int32 num_entries;
// The offset (in entries) from which the reader is reading.
int32 get_offset;
// The offset (in entries) at which the writer is writing.
int32 put_offset;
// The current token value. This is used by the writer to defer
// changes to shared memory objects until the reader has reached a certain
// point in the command buffer. The reader is responsible for updating the
// token value, for example in response to an asynchronous set token command
// embedded in the command buffer. The default token value is zero.
int32 token;
// Error status.
error::Error error;
// Lost context detail information.
error::ContextLostReason context_lost_reason;
// Generation index of this state. The generation index is incremented every
// time a new state is retrieved from the command processor, so that
// consistency can be kept even if IPC messages are processed out-of-order.
uint32 generation;
};
CommandBuffer() {
}
virtual ~CommandBuffer() {
}
// Initialize the command buffer with the given size.
virtual bool Initialize(int32 size) = 0;
// Initialize the command buffer using the given preallocated buffer.
virtual bool Initialize(base::SharedMemory* buffer, int32 size) = 0;
// Gets the ring buffer for the command buffer.
virtual Buffer GetRingBuffer() = 0;
// Returns the current status.
virtual State GetState() = 0;
// Returns the last state without synchronizing with the service.
virtual State GetLastState();
// The writer calls this to update its put offset. This ensures the reader
// sees the latest added commands, and will eventually process them. On the
// service side, commands are processed up to the given put_offset before
// subsequent Flushes on the same GpuChannel.
virtual void Flush(int32 put_offset) = 0;
// The writer calls this to update its put offset. This function returns the
// reader's most recent get offset. Does not return until all pending commands
// have been executed.
virtual State FlushSync(int32 put_offset, int32 last_known_get) = 0;
// Sets the current get offset. This can be called from any thread.
virtual void SetGetOffset(int32 get_offset) = 0;
// Create a transfer buffer and return a handle that uniquely
// identifies it or -1 on error. id_request lets the caller request a
// specific id for the transfer buffer, or -1 if the caller does not care.
// If the requested id can not be fulfilled, a different id will be returned.
// id_request must be either -1 or between 0 and 100.
virtual int32 CreateTransferBuffer(size_t size, int32 id_request) = 0;
// Register an existing shared memory object and get an ID that can be used
// to identify it in the command buffer. Callee dups the handle until
// DestroyTransferBuffer is called. id_request lets the caller request a
// specific id for the transfer buffer, or -1 if the caller does not care.
// If the requested id can not be fulfilled, a different id will be returned.
// id_request must be either -1 or between 0 and 100.
virtual int32 RegisterTransferBuffer(base::SharedMemory* shared_memory,
size_t size,
int32 id_request) = 0;
// Destroy a transfer buffer and recycle the handle.
virtual void DestroyTransferBuffer(int32 id) = 0;
// Get the transfer buffer associated with a handle.
virtual Buffer GetTransferBuffer(int32 handle) = 0;
// Allows the reader to update the current token value.
virtual void SetToken(int32 token) = 0;
// Allows the reader to set the current parse error.
virtual void SetParseError(error::Error) = 0;
// Allows the reader to set the current context lost reason.
// NOTE: if calling this in conjunction with SetParseError,
// call this first.
//
// TODO(kbr): this temporarily has a definition (i.e., is not pure
// virtual) to work around a difficult interdependency with the NaCl
// build. Make this pure virtual and remove the body once this is
// defined in CommandBufferNaCl and NaCl has rolled forward. See
// http://crbug.com/89127 .
virtual void SetContextLostReason(error::ContextLostReason);
private:
DISALLOW_COPY_AND_ASSIGN(CommandBuffer);
};
// Synchronizing other mechanisms (such as IPC) with the CommandBuffer requires
// inserting (writing) a token into the buffer and knowing what the last token
// read at that point was. ReadWriteTokens is a convenience struct for passing
// these pairs around. Expected usage is to compare a current token to
// [last_token_read,last_token_written).
class ReadWriteTokens {
public:
ReadWriteTokens(int32 read, int32 written);
// Required to support pickling. Use by anything else will DCHECK in InRange.
ReadWriteTokens();
// Return true iff |value| is in the range described by |tokens|, accounting
// for (up to) one wrap-around.
bool InRange(int32 token) const;
// These want to be private (and const) but can't in order to support
// pickling.
int32 last_token_read;
int32 last_token_written;
};
} // namespace gpu
#endif // GPU_COMMAND_BUFFER_COMMON_COMMAND_BUFFER_H_
|
