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
|
/*
* Copyright 2016 Google Inc.
*
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
*/
#ifndef SkStreamBuffer_DEFINED
#define SkStreamBuffer_DEFINED
#include "SkData.h"
#include "SkStream.h"
#include "SkTypes.h"
#include "../private/SkTHash.h"
/**
* Helper class for reading from a stream that may not have all its data
* available yet.
*
* Used by GIFImageReader, and currently set up for that use case.
*
* Buffers up to 256 * 3 bytes (256 colors, with 3 bytes each) to support GIF.
* FIXME (scroggo): Make this more general purpose?
*/
class SkStreamBuffer : SkNoncopyable {
public:
// Takes ownership of the SkStream.
SkStreamBuffer(SkStream*);
~SkStreamBuffer();
/**
* Return a pointer the buffered data.
*
* The number of bytes buffered is the number passed to buffer()
* after the last call to flush().
*/
const char* get() const;
/**
* Buffer from the stream into our buffer.
*
* If this call returns true, get() can be used to access |bytes| bytes
* from the stream. In addition, markPosition() can be called to mark this
* position and enable calling getAtPosition() later to retrieve |bytes|
* bytes.
*
* @param bytes Total number of bytes desired.
*
* @return Whether all bytes were successfully buffered.
*/
bool buffer(size_t bytes);
/**
* Flush the buffer.
*
* After this call, no bytes are buffered.
*/
void flush() {
if (fHasLengthAndPosition) {
if (fTrulyBuffered < fBytesBuffered) {
fStream->move(fBytesBuffered - fTrulyBuffered);
}
fTrulyBuffered = 0;
}
fPosition += fBytesBuffered;
fBytesBuffered = 0;
}
/**
* Mark the current position in the stream to return to it later.
*
* This is the position of the start of the buffer. After this call, a
* a client can call getDataAtPosition to retrieve all the bytes currently
* buffered.
*
* @return size_t Position which can be passed to getDataAtPosition later
* to retrieve the data currently buffered.
*/
size_t markPosition();
/**
* Retrieve data at position, as previously marked by markPosition().
*
* @param position Position to retrieve data, as marked by markPosition().
* @param length Amount of data required at position.
* @return SkData The data at position.
*/
sk_sp<SkData> getDataAtPosition(size_t position, size_t length);
private:
static constexpr size_t kMaxSize = 256 * 3;
std::unique_ptr<SkStream> fStream;
size_t fPosition;
char fBuffer[kMaxSize];
size_t fBytesBuffered;
// If the stream has a length and position, we can make two optimizations:
// - We can skip buffering
// - During parsing, we can store the position and size of data that is
// needed later during decoding.
const bool fHasLengthAndPosition;
// When fHasLengthAndPosition is true, we do not need to actually buffer
// inside buffer(). We'll buffer inside get(). This keeps track of how many
// bytes we've buffered inside get(), for the (non-existent) case of:
// buffer(n)
// get()
// buffer(n + u)
// get()
// The second call to get() needs to only truly buffer the part that was
// not already buffered.
mutable size_t fTrulyBuffered;
// Only used if !fHasLengthAndPosition. In that case, markPosition will
// copy into an SkData, stored here.
SkTHashMap<size_t, SkData*> fMarkedData;
};
#endif // SkStreamBuffer_DEFINED
|
