Coverage Report

Created: 2025-08-28 06:27

/src/ProtoToGif.cpp
Line
Count
Source (jump to first uncovered line)
1
#include "ProtoToGif.h"
2
3
using namespace gifProtoFuzzer;
4
using namespace std;
5
6
constexpr unsigned char ProtoConverter::m_sig[];
7
constexpr unsigned char ProtoConverter::m_ver89a[];
8
constexpr unsigned char ProtoConverter::m_ver87a[];
9
10
string ProtoConverter::gifProtoToString(GifProto const &proto)
11
987
{
12
987
  visit(proto);
13
987
  return m_output.str();
14
987
}
15
16
void ProtoConverter::visit(GifProto const &gif)
17
987
{
18
987
  visit(gif.header());
19
987
  visit(gif.lsd());
20
987
  if (m_hasGCT)
21
186
    visit(gif.gct());
22
987
  for (auto const &chunk : gif.chunks())
23
5.03k
    visit(chunk);
24
987
  visit(gif.trailer());
25
987
}
26
27
void ProtoConverter::visit(Header const &header)
28
987
{
29
  // Signature GIF
30
987
  m_output.write((const char *)m_sig, sizeof(m_sig));
31
32
987
  switch (header.ver())
33
987
  {
34
605
  case Header::ENA:
35
605
    m_output.write((const char *)m_ver89a, sizeof(m_ver89a));
36
605
    break;
37
80
  case Header::ESA:
38
80
    m_output.write((const char *)m_ver87a, sizeof(m_ver87a));
39
80
    break;
40
  // We simply don't write anything if it's an invalid version
41
  // Bytes that follow (LSD) will be interpreted as version
42
302
  case Header::INV:
43
302
    break;
44
987
  }
45
987
}
46
47
void ProtoConverter::visit(LogicalScreenDescriptor const &lsd)
48
987
{
49
987
  writeWord(extractWordFromUInt32(lsd.screenwidth()));
50
987
  writeWord(extractWordFromUInt32(lsd.screenheight()));
51
52
987
  uint8_t packedByte = extractByteFromUInt32(lsd.packed());
53
  // If MSB of packed byte is 1, GCT follows
54
987
  if (packedByte & 0x80)
55
186
  {
56
186
    m_hasGCT = true;
57
    // N: 2^(N+1) colors in GCT
58
186
    m_globalColorExp = packedByte & 0x07;
59
186
  }
60
987
  writeByte(packedByte);
61
987
  writeByte(extractByteFromUInt32(lsd.backgroundcolor()));
62
987
  writeByte(extractByteFromUInt32(lsd.aspectratio()));
63
987
}
64
65
void ProtoConverter::visit(GlobalColorTable const &gct)
66
186
{
67
  //[TODO 27/04/2019 VU]: Should it really be exactly the same size? Or do we want some deterministic randomness here?
68
  // TODO BS: We never overflow expected table size due to the use of min
69
186
  uint32_t tableSize = min((uint32_t)gct.colors().size(), tableExpToTableSize(m_globalColorExp));
70
186
  m_output.write(gct.colors().data(), tableSize);
71
186
}
72
73
void ProtoConverter::visit(GraphicControlExtension const &gce)
74
427
{
75
427
  writeByte(0x21); // Extension Introducer
76
427
  writeByte(0xF9); // Graphic Control Label
77
427
  writeByte(4); // Block size
78
427
  uint8_t packedByte = extractByteFromUInt32(gce.packed());
79
  // packed byte
80
427
  writeByte(packedByte);
81
  // Delay time is 2 bytes
82
427
  writeWord(extractWordFromUInt32(gce.delaytime()));
83
  // Transparent color index is 1 byte
84
427
  writeByte(extractByteFromUInt32(gce.transparentcolorindex()));
85
427
  writeByte(0x0); // Block Terminator
86
427
}
87
88
void ProtoConverter::visit(ImageChunk const &chunk)
89
5.03k
{
90
5.03k
  switch (chunk.chunk_oneof_case())
91
5.03k
  {
92
1.38k
  case ImageChunk::kBasic:
93
1.38k
    visit(chunk.basic());
94
1.38k
    break;
95
1.00k
  case ImageChunk::kPlaintext:
96
1.00k
    visit(chunk.plaintext());
97
1.00k
    break;
98
1.35k
  case ImageChunk::kAppExt:
99
1.35k
    visit(chunk.appext());
100
1.35k
    break;
101
612
  case ImageChunk::kComExt:
102
612
    visit(chunk.comext());
103
612
    break;
104
691
  case ImageChunk::CHUNK_ONEOF_NOT_SET:
105
691
    break;
106
5.03k
  }
107
5.03k
}
108
109
void ProtoConverter::visit(const BasicChunk &chunk)
110
1.38k
{
111
  // Visit GCExt if necessary
112
1.38k
  if (chunk.has_gcext())
113
212
    visit(chunk.gcext());
114
1.38k
  visit(chunk.imdescriptor());
115
1.38k
  if (m_hasLCT)
116
440
    visit(chunk.lct());
117
1.38k
  visit(chunk.img());
118
1.38k
}
119
120
void ProtoConverter::visit(LocalColorTable const &lct)
121
440
{
122
  //[TODO 27/04/2019 VU]: Should it really be exactly the same size? Or do we want some deterministic randomness here?
123
  // TODO BS: We never overflow expected table size due to the use of min
124
440
  uint32_t tableSize = min((uint32_t)lct.colors().size(), tableExpToTableSize(m_localColorExp));
125
440
  m_output.write(lct.colors().data(), tableSize);
126
440
}
127
128
void ProtoConverter::visit(ImageDescriptor const &descriptor)
129
1.38k
{
130
  // TODO: Remove seperator from proto since it is always 2C
131
1.38k
  writeByte(0x2C);
132
1.38k
  writeWord(extractWordFromUInt32(descriptor.left()));
133
1.38k
  writeWord(extractWordFromUInt32(descriptor.top()));
134
1.38k
  writeWord(extractWordFromUInt32(descriptor.height()));
135
1.38k
  writeWord(extractWordFromUInt32(descriptor.width()));
136
1.38k
  uint8_t packedByte = extractByteFromUInt32(descriptor.packed());
137
1.38k
  if (packedByte & 0x80)
138
440
  {
139
440
    m_hasLCT = true;
140
440
    m_localColorExp = packedByte & 0x07;
141
440
  }
142
941
  else
143
941
    m_hasLCT = false;
144
1.38k
}
145
146
void ProtoConverter::visit(SubBlock const &block)
147
26.4k
{
148
26.4k
  uint8_t len = extractByteFromUInt32(block.len());
149
26.4k
  if (len == 0)
150
2.27k
  {
151
2.27k
    writeByte(0x00);
152
2.27k
  }
153
24.2k
  else
154
24.2k
  {
155
    // TODO BS: We never overflow expected block size due to the use of min
156
24.2k
    uint32_t write_len = min((uint32_t)len, (uint32_t)block.data().size());
157
24.2k
    m_output.write(block.data().data(), write_len);
158
24.2k
  }
159
26.4k
}
160
161
void ProtoConverter::visit(ImageData const &img)
162
1.38k
{
163
  // TODO: Verify we are writing the image data correctly
164
  // LZW
165
1.38k
  writeByte(extractByteFromUInt32(img.lzw()));
166
  // Sub-blocks
167
1.38k
  for (auto const &block : img.subs())
168
1.16k
    visit(block);
169
  // NULL sub block signals end of image data
170
1.38k
  writeByte(0x00);
171
1.38k
}
172
173
void ProtoConverter::visit(PlainTextExtension const &ptExt)
174
1.00k
{
175
  // Visit GCExt if necessary
176
1.00k
  if (ptExt.has_gcext())
177
215
    visit(ptExt.gcext());
178
179
  // First two bytes are 0x21 0x01
180
1.00k
  writeByte(0x21);
181
1.00k
  writeByte(0x01);
182
  // Skip zero bytes
183
1.00k
  writeByte(0x00);
184
1.00k
  for (auto const &block : ptExt.subs())
185
10.0k
    visit(block);
186
  // NULL sub block signals end
187
1.00k
  writeByte(0x00);
188
1.00k
}
189
190
void ProtoConverter::visit(CommentExtension const &comExt)
191
612
{
192
  // First two bytes are 0x21 0xFE
193
612
  writeByte(0x21);
194
612
  writeByte(0xFE);
195
  // Sub-blocks
196
612
  for (auto const &block : comExt.subs())
197
12.7k
    visit(block);
198
  // NULL sub block signals end of image data
199
612
  writeByte(0x00);
200
612
}
201
202
void ProtoConverter::visit(ApplicationExtension const &appExt)
203
1.35k
{
204
  // First two bytes are 0x21 0xFF
205
1.35k
  writeByte(0x21);
206
1.35k
  writeByte(0xFF);
207
  // Next, we write "11" decimal or 0x0B
208
1.35k
  writeByte(0x0B);
209
1.35k
  writeLong(appExt.appid());
210
  // We hardcode the auth code to 1.0 or 0x31 0x2E 0x30
211
1.35k
  writeByte(0x31);
212
1.35k
  writeByte(0x2E);
213
1.35k
  writeByte(0x30);
214
  // Sub-blocks
215
1.35k
  for (auto const &block : appExt.subs())
216
2.50k
    visit(block);
217
  // NULL sub block signals end of image data
218
1.35k
  writeByte(0x00);
219
1.35k
}
220
221
void ProtoConverter::visit(Trailer const &)
222
987
{
223
987
  writeByte(0x3B);
224
987
}
225
226
// =============================================================
227
// Utility functions
228
// =============================================================
229
void ProtoConverter::writeByte(uint8_t x)
230
28.2k
{
231
28.2k
  m_output.write((char *)&x, sizeof(x));
232
28.2k
}
233
234
void ProtoConverter::writeWord(uint16_t x)
235
7.92k
{
236
7.92k
  m_output.write((char *)&x, sizeof(x));
237
7.92k
}
238
239
void ProtoConverter::writeInt(uint32_t x)
240
0
{
241
0
  m_output.write((char *)&x, sizeof(x));
242
0
}
243
244
void ProtoConverter::writeLong(uint64_t x)
245
1.35k
{
246
1.35k
  m_output.write((char *)&x, sizeof(x));
247
1.35k
}
248
249
uint16_t ProtoConverter::extractWordFromUInt32(uint32_t a)
250
7.92k
{
251
7.92k
  uint16_t first_byte = (a & 0xFF);
252
7.92k
  uint16_t second_byte = ((a >> 8) & 0xFF) << 8;
253
7.92k
  return first_byte | second_byte;
254
7.92k
}
255
256
uint8_t ProtoConverter::extractByteFromUInt32(uint32_t a)
257
33.0k
{
258
33.0k
  uint8_t byte = a & 0x80;
259
33.0k
  return byte;
260
33.0k
}
261
262
/**
263
 * Given an exponent, returns the global/local color table size, given by 3*2^(exp+1)
264
 * @param tableExp The exponent
265
 * @return The actual color table size
266
 */
267
uint32_t ProtoConverter::tableExpToTableSize(uint32_t tableExp)
268
626
{
269
  // 0 <= tableExp <= 7
270
  // 6 <= tableSize <= 768
271
626
  uint32_t tableSize = 3 * (pow(2, tableExp + 1));
272
626
  return tableSize;
273
626
}