blob: 85c5217f99f723dd20ca3c45a814832c20b624db [file] [log] [blame]
Marek Sokolowski8f193432017-09-29 17:14:09 +00001//===-- ResourceFileWriter.cpp --------------------------------*- C++-*-===//
2//
3// The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===---------------------------------------------------------------------===//
9//
10// This implements the visitor serializing resources to a .res stream.
11//
12//===---------------------------------------------------------------------===//
13
14#include "ResourceFileWriter.h"
15
16#include "llvm/Object/WindowsResource.h"
17#include "llvm/Support/ConvertUTF.h"
18#include "llvm/Support/Endian.h"
19#include "llvm/Support/EndianStream.h"
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +000020#include "llvm/Support/Path.h"
21#include "llvm/Support/Process.h"
Marek Sokolowski8f193432017-09-29 17:14:09 +000022
23using namespace llvm::support;
24
25// Take an expression returning llvm::Error and forward the error if it exists.
26#define RETURN_IF_ERROR(Expr) \
27 if (auto Err = (Expr)) \
28 return Err;
29
30namespace llvm {
31namespace rc {
32
Zachary Turner07bc04f2017-10-06 21:26:06 +000033// Class that employs RAII to save the current FileWriter object state
Marek Sokolowski22fccd62017-09-29 19:07:44 +000034// and revert to it as soon as we leave the scope. This is useful if resources
35// declare their own resource-local statements.
36class ContextKeeper {
37 ResourceFileWriter *FileWriter;
38 ResourceFileWriter::ObjectInfo SavedInfo;
39
40public:
41 ContextKeeper(ResourceFileWriter *V)
42 : FileWriter(V), SavedInfo(V->ObjectData) {}
43 ~ContextKeeper() { FileWriter->ObjectData = SavedInfo; }
44};
45
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +000046static Error createError(const Twine &Message,
Marek Sokolowski8f193432017-09-29 17:14:09 +000047 std::errc Type = std::errc::invalid_argument) {
48 return make_error<StringError>(Message, std::make_error_code(Type));
49}
50
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +000051static Error checkNumberFits(uint32_t Number, size_t MaxBits,
52 const Twine &FieldName) {
Marek Sokolowski8f193432017-09-29 17:14:09 +000053 assert(1 <= MaxBits && MaxBits <= 32);
54 if (!(Number >> MaxBits))
55 return Error::success();
56 return createError(FieldName + " (" + Twine(Number) + ") does not fit in " +
57 Twine(MaxBits) + " bits.",
58 std::errc::value_too_large);
59}
60
61template <typename FitType>
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +000062static Error checkNumberFits(uint32_t Number, const Twine &FieldName) {
Marek Sokolowski8f193432017-09-29 17:14:09 +000063 return checkNumberFits(Number, sizeof(FitType) * 8, FieldName);
64}
65
Marek Sokolowski7f7745c2017-09-30 00:38:52 +000066// A similar function for signed integers.
67template <typename FitType>
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +000068static Error checkSignedNumberFits(uint32_t Number, const Twine &FieldName,
Marek Sokolowski7f7745c2017-09-30 00:38:52 +000069 bool CanBeNegative) {
70 int32_t SignedNum = Number;
71 if (SignedNum < std::numeric_limits<FitType>::min() ||
72 SignedNum > std::numeric_limits<FitType>::max())
73 return createError(FieldName + " (" + Twine(SignedNum) +
74 ") does not fit in " + Twine(sizeof(FitType) * 8) +
75 "-bit signed integer type.",
76 std::errc::value_too_large);
77
78 if (!CanBeNegative && SignedNum < 0)
79 return createError(FieldName + " (" + Twine(SignedNum) +
80 ") cannot be negative.");
81
82 return Error::success();
83}
84
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +000085static Error checkRCInt(RCInt Number, const Twine &FieldName) {
Zachary Turner07bc04f2017-10-06 21:26:06 +000086 if (Number.isLong())
87 return Error::success();
88 return checkNumberFits<uint16_t>(Number, FieldName);
89}
90
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +000091static Error checkIntOrString(IntOrString Value, const Twine &FieldName) {
Marek Sokolowski8f193432017-09-29 17:14:09 +000092 if (!Value.isInt())
93 return Error::success();
94 return checkNumberFits<uint16_t>(Value.getInt(), FieldName);
95}
96
97static bool stripQuotes(StringRef &Str, bool &IsLongString) {
98 if (!Str.contains('"'))
99 return false;
100
101 // Just take the contents of the string, checking if it's been marked long.
102 IsLongString = Str.startswith_lower("L");
103 if (IsLongString)
104 Str = Str.drop_front();
105
106 bool StripSuccess = Str.consume_front("\"") && Str.consume_back("\"");
107 (void)StripSuccess;
108 assert(StripSuccess && "Strings should be enclosed in quotes.");
109 return true;
110}
111
112// Describes a way to handle '\0' characters when processing the string.
113// rc.exe tool sometimes behaves in a weird way in postprocessing.
114// If the string to be output is equivalent to a C-string (e.g. in MENU
115// titles), string is (predictably) truncated after first 0-byte.
116// When outputting a string table, the behavior is equivalent to appending
117// '\0\0' at the end of the string, and then stripping the string
118// before the first '\0\0' occurrence.
119// Finally, when handling strings in user-defined resources, 0-bytes
120// aren't stripped, nor do they terminate the string.
121
122enum class NullHandlingMethod {
123 UserResource, // Don't terminate string on '\0'.
124 CutAtNull, // Terminate string on '\0'.
125 CutAtDoubleNull // Terminate string on '\0\0'; strip final '\0'.
126};
127
Zachary Turnera92eb332017-10-06 22:05:15 +0000128// Parses an identifier or string and returns a processed version of it:
129// * String the string boundary quotes.
Marek Sokolowski8f193432017-09-29 17:14:09 +0000130// * Squash "" to a single ".
131// * Replace the escape sequences with their processed version.
132// For identifiers, this is no-op.
133static Error processString(StringRef Str, NullHandlingMethod NullHandler,
134 bool &IsLongString, SmallVectorImpl<UTF16> &Result) {
Marek Sokolowski8f193432017-09-29 17:14:09 +0000135 bool IsString = stripQuotes(Str, IsLongString);
Zachary Turnera92eb332017-10-06 22:05:15 +0000136 SmallVector<UTF16, 128> Chars;
137 convertUTF8ToUTF16String(Str, Chars);
Marek Sokolowski8f193432017-09-29 17:14:09 +0000138
139 if (!IsString) {
140 // It's an identifier if it's not a string. Make all characters uppercase.
Zachary Turnera92eb332017-10-06 22:05:15 +0000141 for (UTF16 &Ch : Chars) {
Marek Sokolowski8f193432017-09-29 17:14:09 +0000142 assert(Ch <= 0x7F && "We didn't allow identifiers to be non-ASCII");
143 Ch = toupper(Ch);
144 }
Zachary Turnera92eb332017-10-06 22:05:15 +0000145 Result.swap(Chars);
Marek Sokolowski8f193432017-09-29 17:14:09 +0000146 return Error::success();
147 }
Zachary Turnera92eb332017-10-06 22:05:15 +0000148 Result.reserve(Chars.size());
149 size_t Pos = 0;
150
151 auto AddRes = [&Result, NullHandler, IsLongString](UTF16 Char) -> Error {
152 if (!IsLongString) {
153 if (NullHandler == NullHandlingMethod::UserResource) {
154 // Narrow strings in user-defined resources are *not* output in
155 // UTF-16 format.
156 if (Char > 0xFF)
157 return createError("Non-8-bit codepoint (" + Twine(Char) +
158 ") can't occur in a user-defined narrow string");
159
160 } else {
161 // In case of narrow non-user strings, Windows RC converts
162 // [0x80, 0xFF] chars according to the current codepage.
163 // There is no 'codepage' concept settled in every supported platform,
164 // so we should reject such inputs.
165 if (Char > 0x7F && Char <= 0xFF)
166 return createError("Non-ASCII 8-bit codepoint (" + Twine(Char) +
167 ") can't "
168 "occur in a non-Unicode string");
169 }
170 }
171
Zachary Turner1e2c8b12017-10-09 22:59:40 +0000172 Result.push_back(Char);
Zachary Turnera92eb332017-10-06 22:05:15 +0000173 return Error::success();
174 };
175
176 while (Pos < Chars.size()) {
177 UTF16 CurChar = Chars[Pos];
178 ++Pos;
179
180 // Strip double "".
181 if (CurChar == '"') {
182 if (Pos == Chars.size() || Chars[Pos] != '"')
183 return createError("Expected \"\"");
184 ++Pos;
185 RETURN_IF_ERROR(AddRes('"'));
186 continue;
187 }
188
189 if (CurChar == '\\') {
190 UTF16 TypeChar = Chars[Pos];
191 ++Pos;
192
193 if (TypeChar == 'x' || TypeChar == 'X') {
194 // Read a hex number. Max number of characters to read differs between
195 // narrow and wide strings.
196 UTF16 ReadInt = 0;
197 size_t RemainingChars = IsLongString ? 4 : 2;
198 // We don't want to read non-ASCII hex digits. std:: functions past
199 // 0xFF invoke UB.
200 //
201 // FIXME: actually, Microsoft version probably doesn't check this
202 // condition and uses their Unicode version of 'isxdigit'. However,
203 // there are some hex-digit Unicode character outside of ASCII, and
204 // some of these are actually accepted by rc.exe, the notable example
205 // being fullwidth forms (U+FF10..U+FF19 etc.) These can be written
206 // instead of ASCII digits in \x... escape sequence and get accepted.
207 // However, the resulting hexcodes seem totally unpredictable.
208 // We think it's infeasible to try to reproduce this behavior, nor to
209 // put effort in order to detect it.
210 while (RemainingChars && Pos < Chars.size() && Chars[Pos] < 0x80) {
211 if (!isxdigit(Chars[Pos]))
212 break;
213 char Digit = tolower(Chars[Pos]);
214 ++Pos;
215
216 ReadInt <<= 4;
217 if (isdigit(Digit))
218 ReadInt |= Digit - '0';
219 else
220 ReadInt |= Digit - 'a' + 10;
221
222 --RemainingChars;
223 }
224
225 RETURN_IF_ERROR(AddRes(ReadInt));
226 continue;
227 }
228
229 if (TypeChar >= '0' && TypeChar < '8') {
230 // Read an octal number. Note that we've already read the first digit.
231 UTF16 ReadInt = TypeChar - '0';
232 size_t RemainingChars = IsLongString ? 6 : 2;
233
234 while (RemainingChars && Pos < Chars.size() && Chars[Pos] >= '0' &&
235 Chars[Pos] < '8') {
236 ReadInt <<= 3;
237 ReadInt |= Chars[Pos] - '0';
238 --RemainingChars;
239 ++Pos;
240 }
241
242 RETURN_IF_ERROR(AddRes(ReadInt));
243
244 continue;
245 }
246
247 switch (TypeChar) {
248 case 'A':
249 case 'a':
250 // Windows '\a' translates into '\b' (Backspace).
251 RETURN_IF_ERROR(AddRes('\b'));
252 break;
253
254 case 'n': // Somehow, RC doesn't recognize '\N' and '\R'.
255 RETURN_IF_ERROR(AddRes('\n'));
256 break;
257
258 case 'r':
259 RETURN_IF_ERROR(AddRes('\r'));
260 break;
261
262 case 'T':
263 case 't':
264 RETURN_IF_ERROR(AddRes('\t'));
265 break;
266
267 case '\\':
268 RETURN_IF_ERROR(AddRes('\\'));
269 break;
270
271 case '"':
272 // RC accepts \" only if another " comes afterwards; then, \"" means
273 // a single ".
274 if (Pos == Chars.size() || Chars[Pos] != '"')
275 return createError("Expected \\\"\"");
276 ++Pos;
277 RETURN_IF_ERROR(AddRes('"'));
278 break;
279
280 default:
281 // If TypeChar means nothing, \ is should be output to stdout with
282 // following char. However, rc.exe consumes these characters when
283 // dealing with wide strings.
284 if (!IsLongString) {
285 RETURN_IF_ERROR(AddRes('\\'));
286 RETURN_IF_ERROR(AddRes(TypeChar));
287 }
288 break;
289 }
290
291 continue;
292 }
293
294 // If nothing interesting happens, just output the character.
295 RETURN_IF_ERROR(AddRes(CurChar));
296 }
Marek Sokolowski8f193432017-09-29 17:14:09 +0000297
Zachary Turnerda366692017-10-06 21:30:55 +0000298 switch (NullHandler) {
299 case NullHandlingMethod::CutAtNull:
300 for (size_t Pos = 0; Pos < Result.size(); ++Pos)
301 if (Result[Pos] == '\0')
302 Result.resize(Pos);
303 break;
Marek Sokolowski8f193432017-09-29 17:14:09 +0000304
Zachary Turnerda366692017-10-06 21:30:55 +0000305 case NullHandlingMethod::CutAtDoubleNull:
306 for (size_t Pos = 0; Pos + 1 < Result.size(); ++Pos)
307 if (Result[Pos] == '\0' && Result[Pos + 1] == '\0')
308 Result.resize(Pos);
309 if (Result.size() > 0 && Result.back() == '\0')
310 Result.pop_back();
311 break;
312
313 case NullHandlingMethod::UserResource:
314 break;
315 }
Marek Sokolowski8f193432017-09-29 17:14:09 +0000316
317 return Error::success();
318}
319
320uint64_t ResourceFileWriter::writeObject(const ArrayRef<uint8_t> Data) {
321 uint64_t Result = tell();
322 FS->write((const char *)Data.begin(), Data.size());
323 return Result;
324}
325
326Error ResourceFileWriter::writeCString(StringRef Str, bool WriteTerminator) {
327 SmallVector<UTF16, 128> ProcessedString;
328 bool IsLongString;
329 RETURN_IF_ERROR(processString(Str, NullHandlingMethod::CutAtNull,
330 IsLongString, ProcessedString));
331 for (auto Ch : ProcessedString)
332 writeInt<uint16_t>(Ch);
333 if (WriteTerminator)
334 writeInt<uint16_t>(0);
335 return Error::success();
336}
337
338Error ResourceFileWriter::writeIdentifier(const IntOrString &Ident) {
339 return writeIntOrString(Ident);
340}
341
342Error ResourceFileWriter::writeIntOrString(const IntOrString &Value) {
343 if (!Value.isInt())
344 return writeCString(Value.getString());
345
346 writeInt<uint16_t>(0xFFFF);
347 writeInt<uint16_t>(Value.getInt());
348 return Error::success();
349}
350
Zachary Turner07bc04f2017-10-06 21:26:06 +0000351void ResourceFileWriter::writeRCInt(RCInt Value) {
352 if (Value.isLong())
Zachary Turnerb12792a2017-10-06 23:21:43 +0000353 writeInt<uint32_t>(Value);
Zachary Turner07bc04f2017-10-06 21:26:06 +0000354 else
Zachary Turnerb12792a2017-10-06 23:21:43 +0000355 writeInt<uint16_t>(Value);
Zachary Turner07bc04f2017-10-06 21:26:06 +0000356}
357
Marek Sokolowski8f193432017-09-29 17:14:09 +0000358Error ResourceFileWriter::appendFile(StringRef Filename) {
359 bool IsLong;
360 stripQuotes(Filename, IsLong);
361
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +0000362 auto File = loadFile(Filename);
Marek Sokolowski8f193432017-09-29 17:14:09 +0000363 if (!File)
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +0000364 return File.takeError();
365
Marek Sokolowski8f193432017-09-29 17:14:09 +0000366 *FS << (*File)->getBuffer();
367 return Error::success();
368}
369
370void ResourceFileWriter::padStream(uint64_t Length) {
371 assert(Length > 0);
372 uint64_t Location = tell();
373 Location %= Length;
374 uint64_t Pad = (Length - Location) % Length;
375 for (uint64_t i = 0; i < Pad; ++i)
376 writeInt<uint8_t>(0);
377}
378
Zachary Turner514b7102017-10-09 18:50:29 +0000379Error ResourceFileWriter::handleError(Error Err, const RCResource *Res) {
Marek Sokolowski8f193432017-09-29 17:14:09 +0000380 if (Err)
381 return joinErrors(createError("Error in " + Res->getResourceTypeName() +
382 " statement (ID " + Twine(Res->ResName) +
383 "): "),
384 std::move(Err));
385 return Error::success();
386}
387
388Error ResourceFileWriter::visitNullResource(const RCResource *Res) {
389 return writeResource(Res, &ResourceFileWriter::writeNullBody);
390}
391
Marek Sokolowski22fccd62017-09-29 19:07:44 +0000392Error ResourceFileWriter::visitAcceleratorsResource(const RCResource *Res) {
393 return writeResource(Res, &ResourceFileWriter::writeAcceleratorsBody);
394}
395
Zachary Turnerc3ab0132017-10-06 21:25:44 +0000396Error ResourceFileWriter::visitCursorResource(const RCResource *Res) {
397 return handleError(visitIconOrCursorResource(Res), Res);
398}
399
Marek Sokolowski7f7745c2017-09-30 00:38:52 +0000400Error ResourceFileWriter::visitDialogResource(const RCResource *Res) {
401 return writeResource(Res, &ResourceFileWriter::writeDialogBody);
402}
403
Zachary Turnerc3ab0132017-10-06 21:25:44 +0000404Error ResourceFileWriter::visitIconResource(const RCResource *Res) {
405 return handleError(visitIconOrCursorResource(Res), Res);
406}
407
Zachary Turner420090a2017-10-06 20:51:20 +0000408Error ResourceFileWriter::visitCaptionStmt(const CaptionStmt *Stmt) {
409 ObjectData.Caption = Stmt->Value;
410 return Error::success();
411}
412
Marek Sokolowski8f193432017-09-29 17:14:09 +0000413Error ResourceFileWriter::visitHTMLResource(const RCResource *Res) {
414 return writeResource(Res, &ResourceFileWriter::writeHTMLBody);
415}
416
Marek Sokolowski42f494d2017-09-29 22:25:05 +0000417Error ResourceFileWriter::visitMenuResource(const RCResource *Res) {
418 return writeResource(Res, &ResourceFileWriter::writeMenuBody);
419}
420
Zachary Turnerda366692017-10-06 21:30:55 +0000421Error ResourceFileWriter::visitStringTableResource(const RCResource *Base) {
422 const auto *Res = cast<StringTableResource>(Base);
423
424 ContextKeeper RAII(this);
425 RETURN_IF_ERROR(Res->applyStmts(this));
426
427 for (auto &String : Res->Table) {
428 RETURN_IF_ERROR(checkNumberFits<uint16_t>(String.first, "String ID"));
429 uint16_t BundleID = String.first >> 4;
430 StringTableInfo::BundleKey Key(BundleID, ObjectData.LanguageInfo);
431 auto &BundleData = StringTableData.BundleData;
432 auto Iter = BundleData.find(Key);
433
434 if (Iter == BundleData.end()) {
435 // Need to create a bundle.
436 StringTableData.BundleList.push_back(Key);
437 auto EmplaceResult =
438 BundleData.emplace(Key, StringTableInfo::Bundle(ObjectData));
439 assert(EmplaceResult.second && "Could not create a bundle");
440 Iter = EmplaceResult.first;
441 }
442
443 RETURN_IF_ERROR(
444 insertStringIntoBundle(Iter->second, String.first, String.second));
445 }
446
447 return Error::success();
448}
449
Zachary Turner9d8b3582017-10-06 21:52:15 +0000450Error ResourceFileWriter::visitUserDefinedResource(const RCResource *Res) {
451 return writeResource(Res, &ResourceFileWriter::writeUserDefinedBody);
452}
453
Zachary Turner07bc04f2017-10-06 21:26:06 +0000454Error ResourceFileWriter::visitVersionInfoResource(const RCResource *Res) {
455 return writeResource(Res, &ResourceFileWriter::writeVersionInfoBody);
456}
457
Marek Sokolowski22fccd62017-09-29 19:07:44 +0000458Error ResourceFileWriter::visitCharacteristicsStmt(
459 const CharacteristicsStmt *Stmt) {
460 ObjectData.Characteristics = Stmt->Value;
461 return Error::success();
462}
463
Zachary Turner420090a2017-10-06 20:51:20 +0000464Error ResourceFileWriter::visitFontStmt(const FontStmt *Stmt) {
465 RETURN_IF_ERROR(checkNumberFits<uint16_t>(Stmt->Size, "Font size"));
466 RETURN_IF_ERROR(checkNumberFits<uint16_t>(Stmt->Weight, "Font weight"));
467 RETURN_IF_ERROR(checkNumberFits<uint8_t>(Stmt->Charset, "Font charset"));
468 ObjectInfo::FontInfo Font{Stmt->Size, Stmt->Name, Stmt->Weight, Stmt->Italic,
469 Stmt->Charset};
470 ObjectData.Font.emplace(Font);
471 return Error::success();
472}
473
Marek Sokolowski8f193432017-09-29 17:14:09 +0000474Error ResourceFileWriter::visitLanguageStmt(const LanguageResource *Stmt) {
475 RETURN_IF_ERROR(checkNumberFits(Stmt->Lang, 10, "Primary language ID"));
476 RETURN_IF_ERROR(checkNumberFits(Stmt->SubLang, 6, "Sublanguage ID"));
477 ObjectData.LanguageInfo = Stmt->Lang | (Stmt->SubLang << 10);
478 return Error::success();
479}
480
Zachary Turner420090a2017-10-06 20:51:20 +0000481Error ResourceFileWriter::visitStyleStmt(const StyleStmt *Stmt) {
482 ObjectData.Style = Stmt->Value;
483 return Error::success();
484}
485
Marek Sokolowski22fccd62017-09-29 19:07:44 +0000486Error ResourceFileWriter::visitVersionStmt(const VersionStmt *Stmt) {
487 ObjectData.VersionInfo = Stmt->Value;
488 return Error::success();
489}
490
Marek Sokolowski8f193432017-09-29 17:14:09 +0000491Error ResourceFileWriter::writeResource(
492 const RCResource *Res,
493 Error (ResourceFileWriter::*BodyWriter)(const RCResource *)) {
494 // We don't know the sizes yet.
495 object::WinResHeaderPrefix HeaderPrefix{ulittle32_t(0U), ulittle32_t(0U)};
496 uint64_t HeaderLoc = writeObject(HeaderPrefix);
497
498 auto ResType = Res->getResourceType();
499 RETURN_IF_ERROR(checkIntOrString(ResType, "Resource type"));
500 RETURN_IF_ERROR(checkIntOrString(Res->ResName, "Resource ID"));
501 RETURN_IF_ERROR(handleError(writeIdentifier(ResType), Res));
502 RETURN_IF_ERROR(handleError(writeIdentifier(Res->ResName), Res));
503
Marek Sokolowski22fccd62017-09-29 19:07:44 +0000504 // Apply the resource-local optional statements.
505 ContextKeeper RAII(this);
506 RETURN_IF_ERROR(handleError(Res->applyStmts(this), Res));
507
Marek Sokolowski8f193432017-09-29 17:14:09 +0000508 padStream(sizeof(uint32_t));
509 object::WinResHeaderSuffix HeaderSuffix{
510 ulittle32_t(0), // DataVersion; seems to always be 0
511 ulittle16_t(Res->getMemoryFlags()), ulittle16_t(ObjectData.LanguageInfo),
Marek Sokolowski22fccd62017-09-29 19:07:44 +0000512 ulittle32_t(ObjectData.VersionInfo),
513 ulittle32_t(ObjectData.Characteristics)};
Marek Sokolowski8f193432017-09-29 17:14:09 +0000514 writeObject(HeaderSuffix);
515
516 uint64_t DataLoc = tell();
517 RETURN_IF_ERROR(handleError((this->*BodyWriter)(Res), Res));
518 // RETURN_IF_ERROR(handleError(dumpResource(Ctx)));
519
520 // Update the sizes.
521 HeaderPrefix.DataSize = tell() - DataLoc;
522 HeaderPrefix.HeaderSize = DataLoc - HeaderLoc;
523 writeObjectAt(HeaderPrefix, HeaderLoc);
524 padStream(sizeof(uint32_t));
525
526 return Error::success();
527}
528
Marek Sokolowski22fccd62017-09-29 19:07:44 +0000529// --- NullResource helpers. --- //
530
Marek Sokolowski8f193432017-09-29 17:14:09 +0000531Error ResourceFileWriter::writeNullBody(const RCResource *) {
532 return Error::success();
533}
534
Marek Sokolowski22fccd62017-09-29 19:07:44 +0000535// --- AcceleratorsResource helpers. --- //
536
537Error ResourceFileWriter::writeSingleAccelerator(
538 const AcceleratorsResource::Accelerator &Obj, bool IsLastItem) {
539 using Accelerator = AcceleratorsResource::Accelerator;
540 using Opt = Accelerator::Options;
541
542 struct AccelTableEntry {
543 ulittle16_t Flags;
544 ulittle16_t ANSICode;
545 ulittle16_t Id;
546 uint16_t Padding;
547 } Entry{ulittle16_t(0), ulittle16_t(0), ulittle16_t(0), 0};
548
549 bool IsASCII = Obj.Flags & Opt::ASCII, IsVirtKey = Obj.Flags & Opt::VIRTKEY;
550
551 // Remove ASCII flags (which doesn't occur in .res files).
552 Entry.Flags = Obj.Flags & ~Opt::ASCII;
553
554 if (IsLastItem)
555 Entry.Flags |= 0x80;
556
557 RETURN_IF_ERROR(checkNumberFits<uint16_t>(Obj.Id, "ACCELERATORS entry ID"));
558 Entry.Id = ulittle16_t(Obj.Id);
559
560 auto createAccError = [&Obj](const char *Msg) {
561 return createError("Accelerator ID " + Twine(Obj.Id) + ": " + Msg);
562 };
563
564 if (IsASCII && IsVirtKey)
565 return createAccError("Accelerator can't be both ASCII and VIRTKEY");
566
567 if (!IsVirtKey && (Obj.Flags & (Opt::ALT | Opt::SHIFT | Opt::CONTROL)))
568 return createAccError("Can only apply ALT, SHIFT or CONTROL to VIRTKEY"
569 " accelerators");
570
571 if (Obj.Event.isInt()) {
572 if (!IsASCII && !IsVirtKey)
573 return createAccError(
574 "Accelerator with a numeric event must be either ASCII"
575 " or VIRTKEY");
576
577 uint32_t EventVal = Obj.Event.getInt();
578 RETURN_IF_ERROR(
579 checkNumberFits<uint16_t>(EventVal, "Numeric event key ID"));
580 Entry.ANSICode = ulittle16_t(EventVal);
581 writeObject(Entry);
582 return Error::success();
583 }
584
585 StringRef Str = Obj.Event.getString();
586 bool IsWide;
587 stripQuotes(Str, IsWide);
588
589 if (Str.size() == 0 || Str.size() > 2)
590 return createAccError(
591 "Accelerator string events should have length 1 or 2");
592
593 if (Str[0] == '^') {
594 if (Str.size() == 1)
595 return createAccError("No character following '^' in accelerator event");
596 if (IsVirtKey)
597 return createAccError(
598 "VIRTKEY accelerator events can't be preceded by '^'");
599
600 char Ch = Str[1];
601 if (Ch >= 'a' && Ch <= 'z')
602 Entry.ANSICode = ulittle16_t(Ch - 'a' + 1);
603 else if (Ch >= 'A' && Ch <= 'Z')
604 Entry.ANSICode = ulittle16_t(Ch - 'A' + 1);
605 else
606 return createAccError("Control character accelerator event should be"
607 " alphabetic");
608
609 writeObject(Entry);
610 return Error::success();
611 }
612
613 if (Str.size() == 2)
614 return createAccError("Event string should be one-character, possibly"
615 " preceded by '^'");
616
617 uint8_t EventCh = Str[0];
618 // The original tool just warns in this situation. We chose to fail.
619 if (IsVirtKey && !isalnum(EventCh))
620 return createAccError("Non-alphanumeric characters cannot describe virtual"
621 " keys");
622 if (EventCh > 0x7F)
623 return createAccError("Non-ASCII description of accelerator");
624
625 if (IsVirtKey)
626 EventCh = toupper(EventCh);
627 Entry.ANSICode = ulittle16_t(EventCh);
628 writeObject(Entry);
629 return Error::success();
630}
631
632Error ResourceFileWriter::writeAcceleratorsBody(const RCResource *Base) {
633 auto *Res = cast<AcceleratorsResource>(Base);
634 size_t AcceleratorId = 0;
635 for (auto &Acc : Res->Accelerators) {
636 ++AcceleratorId;
637 RETURN_IF_ERROR(
638 writeSingleAccelerator(Acc, AcceleratorId == Res->Accelerators.size()));
639 }
640 return Error::success();
641}
642
Zachary Turnerc3ab0132017-10-06 21:25:44 +0000643// --- CursorResource and IconResource helpers. --- //
644
645// ICONRESDIR structure. Describes a single icon in resouce group.
646//
647// Ref: msdn.microsoft.com/en-us/library/windows/desktop/ms648016.aspx
648struct IconResDir {
649 uint8_t Width;
650 uint8_t Height;
651 uint8_t ColorCount;
652 uint8_t Reserved;
653};
654
655// CURSORDIR structure. Describes a single cursor in resource group.
656//
657// Ref: msdn.microsoft.com/en-us/library/windows/desktop/ms648011(v=vs.85).aspx
658struct CursorDir {
659 ulittle16_t Width;
660 ulittle16_t Height;
661};
662
663// RESDIRENTRY structure, stripped from the last item. Stripping made
664// for compatibility with RESDIR.
665//
666// Ref: msdn.microsoft.com/en-us/library/windows/desktop/ms648026(v=vs.85).aspx
667struct ResourceDirEntryStart {
668 union {
669 CursorDir Cursor; // Used in CURSOR resources.
670 IconResDir Icon; // Used in .ico and .cur files, and ICON resources.
671 };
672 ulittle16_t Planes; // HotspotX (.cur files but not CURSOR resource).
673 ulittle16_t BitCount; // HotspotY (.cur files but not CURSOR resource).
674 ulittle32_t Size;
675 // ulittle32_t ImageOffset; // Offset to image data (ICONDIRENTRY only).
676 // ulittle16_t IconID; // Resource icon ID (RESDIR only).
677};
678
679// BITMAPINFOHEADER structure. Describes basic information about the bitmap
680// being read.
681//
682// Ref: msdn.microsoft.com/en-us/library/windows/desktop/dd183376(v=vs.85).aspx
683struct BitmapInfoHeader {
684 ulittle32_t Size;
685 ulittle32_t Width;
686 ulittle32_t Height;
687 ulittle16_t Planes;
688 ulittle16_t BitCount;
689 ulittle32_t Compression;
690 ulittle32_t SizeImage;
691 ulittle32_t XPelsPerMeter;
692 ulittle32_t YPelsPerMeter;
693 ulittle32_t ClrUsed;
694 ulittle32_t ClrImportant;
695};
696
697// Group icon directory header. Called ICONDIR in .ico/.cur files and
698// NEWHEADER in .res files.
699//
700// Ref: msdn.microsoft.com/en-us/library/windows/desktop/ms648023(v=vs.85).aspx
701struct GroupIconDir {
702 ulittle16_t Reserved; // Always 0.
703 ulittle16_t ResType; // 1 for icons, 2 for cursors.
704 ulittle16_t ResCount; // Number of items.
705};
706
707enum class IconCursorGroupType { Icon, Cursor };
708
709class SingleIconCursorResource : public RCResource {
710public:
711 IconCursorGroupType Type;
712 const ResourceDirEntryStart &Header;
713 ArrayRef<uint8_t> Image;
714
715 SingleIconCursorResource(IconCursorGroupType ResourceType,
716 const ResourceDirEntryStart &HeaderEntry,
717 ArrayRef<uint8_t> ImageData)
718 : Type(ResourceType), Header(HeaderEntry), Image(ImageData) {}
719
720 Twine getResourceTypeName() const override { return "Icon/cursor image"; }
721 IntOrString getResourceType() const override {
722 return Type == IconCursorGroupType::Icon ? RkSingleIcon : RkSingleCursor;
723 }
724 uint16_t getMemoryFlags() const override {
725 return MfDiscardable | MfMoveable;
726 }
727 ResourceKind getKind() const override { return RkSingleCursorOrIconRes; }
728 static bool classof(const RCResource *Res) {
729 return Res->getKind() == RkSingleCursorOrIconRes;
730 }
731};
732
733class IconCursorGroupResource : public RCResource {
734public:
735 IconCursorGroupType Type;
736 GroupIconDir Header;
737 std::vector<ResourceDirEntryStart> ItemEntries;
738
739 IconCursorGroupResource(IconCursorGroupType ResourceType,
740 const GroupIconDir &HeaderData,
741 std::vector<ResourceDirEntryStart> &&Entries)
742 : Type(ResourceType), Header(HeaderData),
743 ItemEntries(std::move(Entries)) {}
744
745 Twine getResourceTypeName() const override { return "Icon/cursor group"; }
746 IntOrString getResourceType() const override {
747 return Type == IconCursorGroupType::Icon ? RkIconGroup : RkCursorGroup;
748 }
749 ResourceKind getKind() const override { return RkCursorOrIconGroupRes; }
750 static bool classof(const RCResource *Res) {
751 return Res->getKind() == RkCursorOrIconGroupRes;
752 }
753};
754
755Error ResourceFileWriter::writeSingleIconOrCursorBody(const RCResource *Base) {
756 auto *Res = cast<SingleIconCursorResource>(Base);
757 if (Res->Type == IconCursorGroupType::Cursor) {
758 // In case of cursors, two WORDS are appended to the beginning
759 // of the resource: HotspotX (Planes in RESDIRENTRY),
760 // and HotspotY (BitCount).
761 //
762 // Ref: msdn.microsoft.com/en-us/library/windows/desktop/ms648026.aspx
763 // (Remarks section).
764 writeObject(Res->Header.Planes);
765 writeObject(Res->Header.BitCount);
766 }
767
768 writeObject(Res->Image);
769 return Error::success();
770}
771
772Error ResourceFileWriter::writeIconOrCursorGroupBody(const RCResource *Base) {
773 auto *Res = cast<IconCursorGroupResource>(Base);
774 writeObject(Res->Header);
775 for (auto Item : Res->ItemEntries) {
776 writeObject(Item);
Zachary Turnerb12792a2017-10-06 23:21:43 +0000777 writeInt(IconCursorID++);
Zachary Turnerc3ab0132017-10-06 21:25:44 +0000778 }
779 return Error::success();
780}
781
782Error ResourceFileWriter::visitSingleIconOrCursor(const RCResource *Res) {
783 return writeResource(Res, &ResourceFileWriter::writeSingleIconOrCursorBody);
784}
785
786Error ResourceFileWriter::visitIconOrCursorGroup(const RCResource *Res) {
787 return writeResource(Res, &ResourceFileWriter::writeIconOrCursorGroupBody);
788}
789
790Error ResourceFileWriter::visitIconOrCursorResource(const RCResource *Base) {
791 IconCursorGroupType Type;
792 StringRef FileStr;
793 IntOrString ResName = Base->ResName;
794
795 if (auto *IconRes = dyn_cast<IconResource>(Base)) {
796 FileStr = IconRes->IconLoc;
797 Type = IconCursorGroupType::Icon;
798 } else {
799 auto *CursorRes = dyn_cast<CursorResource>(Base);
800 FileStr = CursorRes->CursorLoc;
801 Type = IconCursorGroupType::Cursor;
802 }
803
804 bool IsLong;
805 stripQuotes(FileStr, IsLong);
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +0000806 auto File = loadFile(FileStr);
Zachary Turnerc3ab0132017-10-06 21:25:44 +0000807
808 if (!File)
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +0000809 return File.takeError();
Zachary Turnerc3ab0132017-10-06 21:25:44 +0000810
811 BinaryStreamReader Reader((*File)->getBuffer(), support::little);
812
813 // Read the file headers.
814 // - At the beginning, ICONDIR/NEWHEADER header.
815 // - Then, a number of RESDIR headers follow. These contain offsets
816 // to data.
817 const GroupIconDir *Header;
818
819 RETURN_IF_ERROR(Reader.readObject(Header));
820 if (Header->Reserved != 0)
821 return createError("Incorrect icon/cursor Reserved field; should be 0.");
822 uint16_t NeededType = Type == IconCursorGroupType::Icon ? 1 : 2;
823 if (Header->ResType != NeededType)
824 return createError("Incorrect icon/cursor ResType field; should be " +
825 Twine(NeededType) + ".");
826
827 uint16_t NumItems = Header->ResCount;
828
829 // Read single ico/cur headers.
830 std::vector<ResourceDirEntryStart> ItemEntries;
831 ItemEntries.reserve(NumItems);
832 std::vector<uint32_t> ItemOffsets(NumItems);
833 for (size_t ID = 0; ID < NumItems; ++ID) {
834 const ResourceDirEntryStart *Object;
835 RETURN_IF_ERROR(Reader.readObject(Object));
836 ItemEntries.push_back(*Object);
837 RETURN_IF_ERROR(Reader.readInteger(ItemOffsets[ID]));
838 }
839
840 // Now write each icon/cursors one by one. At first, all the contents
841 // without ICO/CUR header. This is described by SingleIconCursorResource.
842 for (size_t ID = 0; ID < NumItems; ++ID) {
843 // Load the fragment of file.
844 Reader.setOffset(ItemOffsets[ID]);
845 ArrayRef<uint8_t> Image;
846 RETURN_IF_ERROR(Reader.readArray(Image, ItemEntries[ID].Size));
847 SingleIconCursorResource SingleRes(Type, ItemEntries[ID], Image);
848 SingleRes.setName(IconCursorID + ID);
849 RETURN_IF_ERROR(visitSingleIconOrCursor(&SingleRes));
850 }
851
852 // Now, write all the headers concatenated into a separate resource.
853 for (size_t ID = 0; ID < NumItems; ++ID) {
854 if (Type == IconCursorGroupType::Icon) {
855 // rc.exe seems to always set NumPlanes to 1. No idea why it happens.
856 ItemEntries[ID].Planes = 1;
857 continue;
858 }
859
860 // We need to rewrite the cursor headers.
861 const auto &OldHeader = ItemEntries[ID];
862 ResourceDirEntryStart NewHeader;
863 NewHeader.Cursor.Width = OldHeader.Icon.Width;
864 // Each cursor in fact stores two bitmaps, one under another.
865 // Height provided in cursor definition describes the height of the
866 // cursor, whereas the value existing in resource definition describes
867 // the height of the bitmap. Therefore, we need to double this height.
868 NewHeader.Cursor.Height = OldHeader.Icon.Height * 2;
869
870 // Now, we actually need to read the bitmap header to find
871 // the number of planes and the number of bits per pixel.
872 Reader.setOffset(ItemOffsets[ID]);
873 const BitmapInfoHeader *BMPHeader;
874 RETURN_IF_ERROR(Reader.readObject(BMPHeader));
875 NewHeader.Planes = BMPHeader->Planes;
876 NewHeader.BitCount = BMPHeader->BitCount;
877
878 // Two WORDs were written at the beginning of the resource (hotspot
879 // location). This is reflected in Size field.
880 NewHeader.Size = OldHeader.Size + 2 * sizeof(uint16_t);
881
882 ItemEntries[ID] = NewHeader;
883 }
884
885 IconCursorGroupResource HeaderRes(Type, *Header, std::move(ItemEntries));
886 HeaderRes.setName(ResName);
887 RETURN_IF_ERROR(visitIconOrCursorGroup(&HeaderRes));
888
889 return Error::success();
890}
891
Marek Sokolowski7f7745c2017-09-30 00:38:52 +0000892// --- DialogResource helpers. --- //
Marek Sokolowski22fccd62017-09-29 19:07:44 +0000893
Marek Sokolowski7f7745c2017-09-30 00:38:52 +0000894Error ResourceFileWriter::writeSingleDialogControl(const Control &Ctl,
895 bool IsExtended) {
896 // Each control should be aligned to DWORD.
897 padStream(sizeof(uint32_t));
898
899 auto TypeInfo = Control::SupportedCtls.lookup(Ctl.Type);
900 uint32_t CtlStyle = TypeInfo.Style | Ctl.Style.getValueOr(0);
901 uint32_t CtlExtStyle = Ctl.ExtStyle.getValueOr(0);
902
903 // DIALOG(EX) item header prefix.
904 if (!IsExtended) {
905 struct {
906 ulittle32_t Style;
907 ulittle32_t ExtStyle;
908 } Prefix{ulittle32_t(CtlStyle), ulittle32_t(CtlExtStyle)};
909 writeObject(Prefix);
910 } else {
911 struct {
912 ulittle32_t HelpID;
913 ulittle32_t ExtStyle;
914 ulittle32_t Style;
915 } Prefix{ulittle32_t(Ctl.HelpID.getValueOr(0)), ulittle32_t(CtlExtStyle),
916 ulittle32_t(CtlStyle)};
917 writeObject(Prefix);
918 }
919
920 // Common fixed-length part.
921 RETURN_IF_ERROR(checkSignedNumberFits<int16_t>(
922 Ctl.X, "Dialog control x-coordinate", true));
923 RETURN_IF_ERROR(checkSignedNumberFits<int16_t>(
924 Ctl.Y, "Dialog control y-coordinate", true));
925 RETURN_IF_ERROR(
926 checkSignedNumberFits<int16_t>(Ctl.Width, "Dialog control width", false));
927 RETURN_IF_ERROR(checkSignedNumberFits<int16_t>(
928 Ctl.Height, "Dialog control height", false));
929 struct {
930 ulittle16_t X;
931 ulittle16_t Y;
932 ulittle16_t Width;
933 ulittle16_t Height;
934 } Middle{ulittle16_t(Ctl.X), ulittle16_t(Ctl.Y), ulittle16_t(Ctl.Width),
935 ulittle16_t(Ctl.Height)};
936 writeObject(Middle);
937
938 // ID; it's 16-bit in DIALOG and 32-bit in DIALOGEX.
939 if (!IsExtended) {
940 RETURN_IF_ERROR(checkNumberFits<uint16_t>(
941 Ctl.ID, "Control ID in simple DIALOG resource"));
942 writeInt<uint16_t>(Ctl.ID);
943 } else {
944 writeInt<uint32_t>(Ctl.ID);
945 }
946
947 // Window class - either 0xFFFF + 16-bit integer or a string.
948 RETURN_IF_ERROR(writeIntOrString(IntOrString(TypeInfo.CtlClass)));
949
950 // Element caption/reference ID. ID is preceded by 0xFFFF.
951 RETURN_IF_ERROR(checkIntOrString(Ctl.Title, "Control reference ID"));
952 RETURN_IF_ERROR(writeIntOrString(Ctl.Title));
953
954 // # bytes of extra creation data count. Don't pass any.
955 writeInt<uint16_t>(0);
956
957 return Error::success();
958}
959
960Error ResourceFileWriter::writeDialogBody(const RCResource *Base) {
961 auto *Res = cast<DialogResource>(Base);
962
963 // Default style: WS_POPUP | WS_BORDER | WS_SYSMENU.
Zachary Turner420090a2017-10-06 20:51:20 +0000964 const uint32_t DefaultStyle = 0x80880000;
965 const uint32_t StyleFontFlag = 0x40;
966 const uint32_t StyleCaptionFlag = 0x00C00000;
967
968 uint32_t UsedStyle = ObjectData.Style.getValueOr(DefaultStyle);
969 if (ObjectData.Font)
970 UsedStyle |= StyleFontFlag;
971 else
972 UsedStyle &= ~StyleFontFlag;
973
974 // Actually, in case of empty (but existent) caption, the examined field
975 // is equal to "\"\"". That's why empty captions are still noticed.
976 if (ObjectData.Caption != "")
977 UsedStyle |= StyleCaptionFlag;
978
979 const uint16_t DialogExMagic = 0xFFFF;
Marek Sokolowski7f7745c2017-09-30 00:38:52 +0000980
981 // Write DIALOG(EX) header prefix. These are pretty different.
982 if (!Res->IsExtended) {
Zachary Turner420090a2017-10-06 20:51:20 +0000983 // We cannot let the higher word of DefaultStyle be equal to 0xFFFF.
984 // In such a case, whole object (in .res file) is equivalent to a
985 // DIALOGEX. It might lead to access violation/segmentation fault in
986 // resource readers. For example,
987 // 1 DIALOG 0, 0, 0, 65432
988 // STYLE 0xFFFF0001 {}
989 // would be compiled to a DIALOGEX with 65432 controls.
990 if ((UsedStyle >> 16) == DialogExMagic)
991 return createError("16 higher bits of DIALOG resource style cannot be"
992 " equal to 0xFFFF");
993
Marek Sokolowski7f7745c2017-09-30 00:38:52 +0000994 struct {
995 ulittle32_t Style;
996 ulittle32_t ExtStyle;
997 } Prefix{ulittle32_t(UsedStyle),
998 ulittle32_t(0)}; // As of now, we don't keep EXSTYLE.
999
1000 writeObject(Prefix);
1001 } else {
Marek Sokolowski7f7745c2017-09-30 00:38:52 +00001002 struct {
1003 ulittle16_t Version;
1004 ulittle16_t Magic;
1005 ulittle32_t HelpID;
1006 ulittle32_t ExtStyle;
1007 ulittle32_t Style;
1008 } Prefix{ulittle16_t(1), ulittle16_t(DialogExMagic),
1009 ulittle32_t(Res->HelpID), ulittle32_t(0), ulittle32_t(UsedStyle)};
1010
1011 writeObject(Prefix);
1012 }
1013
1014 // Now, a common part. First, fixed-length fields.
1015 RETURN_IF_ERROR(checkNumberFits<uint16_t>(Res->Controls.size(),
1016 "Number of dialog controls"));
1017 RETURN_IF_ERROR(
1018 checkSignedNumberFits<int16_t>(Res->X, "Dialog x-coordinate", true));
1019 RETURN_IF_ERROR(
1020 checkSignedNumberFits<int16_t>(Res->Y, "Dialog y-coordinate", true));
1021 RETURN_IF_ERROR(
1022 checkSignedNumberFits<int16_t>(Res->Width, "Dialog width", false));
1023 RETURN_IF_ERROR(
1024 checkSignedNumberFits<int16_t>(Res->Height, "Dialog height", false));
1025 struct {
1026 ulittle16_t Count;
1027 ulittle16_t PosX;
1028 ulittle16_t PosY;
1029 ulittle16_t DialogWidth;
1030 ulittle16_t DialogHeight;
1031 } Middle{ulittle16_t(Res->Controls.size()), ulittle16_t(Res->X),
1032 ulittle16_t(Res->Y), ulittle16_t(Res->Width),
1033 ulittle16_t(Res->Height)};
1034 writeObject(Middle);
1035
1036 // MENU field. As of now, we don't keep them in the state and can peacefully
1037 // think there is no menu attached to the dialog.
1038 writeInt<uint16_t>(0);
1039
1040 // Window CLASS field. Not kept here.
1041 writeInt<uint16_t>(0);
1042
Zachary Turner420090a2017-10-06 20:51:20 +00001043 // Window title or a single word equal to 0.
1044 RETURN_IF_ERROR(writeCString(ObjectData.Caption));
1045
1046 // If there *is* a window font declared, output its data.
1047 auto &Font = ObjectData.Font;
1048 if (Font) {
1049 writeInt<uint16_t>(Font->Size);
1050 // Additional description occurs only in DIALOGEX.
1051 if (Res->IsExtended) {
1052 writeInt<uint16_t>(Font->Weight);
1053 writeInt<uint8_t>(Font->IsItalic);
1054 writeInt<uint8_t>(Font->Charset);
1055 }
1056 RETURN_IF_ERROR(writeCString(Font->Typeface));
1057 }
Marek Sokolowski7f7745c2017-09-30 00:38:52 +00001058
1059 auto handleCtlError = [&](Error &&Err, const Control &Ctl) -> Error {
1060 if (!Err)
1061 return Error::success();
1062 return joinErrors(createError("Error in " + Twine(Ctl.Type) +
1063 " control (ID " + Twine(Ctl.ID) + "):"),
1064 std::move(Err));
1065 };
1066
1067 for (auto &Ctl : Res->Controls)
1068 RETURN_IF_ERROR(
1069 handleCtlError(writeSingleDialogControl(Ctl, Res->IsExtended), Ctl));
1070
1071 return Error::success();
1072}
1073
1074// --- HTMLResource helpers. --- //
Marek Sokolowski22fccd62017-09-29 19:07:44 +00001075
Marek Sokolowski8f193432017-09-29 17:14:09 +00001076Error ResourceFileWriter::writeHTMLBody(const RCResource *Base) {
1077 return appendFile(cast<HTMLResource>(Base)->HTMLLoc);
1078}
1079
Marek Sokolowski42f494d2017-09-29 22:25:05 +00001080// --- MenuResource helpers. --- //
1081
1082Error ResourceFileWriter::writeMenuDefinition(
1083 const std::unique_ptr<MenuDefinition> &Def, uint16_t Flags) {
1084 assert(Def);
1085 const MenuDefinition *DefPtr = Def.get();
1086
1087 if (auto *MenuItemPtr = dyn_cast<MenuItem>(DefPtr)) {
1088 writeInt<uint16_t>(Flags);
1089 RETURN_IF_ERROR(
1090 checkNumberFits<uint16_t>(MenuItemPtr->Id, "MENUITEM action ID"));
1091 writeInt<uint16_t>(MenuItemPtr->Id);
1092 RETURN_IF_ERROR(writeCString(MenuItemPtr->Name));
1093 return Error::success();
1094 }
1095
1096 if (isa<MenuSeparator>(DefPtr)) {
1097 writeInt<uint16_t>(Flags);
1098 writeInt<uint32_t>(0);
1099 return Error::success();
1100 }
1101
1102 auto *PopupPtr = cast<PopupItem>(DefPtr);
1103 writeInt<uint16_t>(Flags);
1104 RETURN_IF_ERROR(writeCString(PopupPtr->Name));
1105 return writeMenuDefinitionList(PopupPtr->SubItems);
1106}
1107
1108Error ResourceFileWriter::writeMenuDefinitionList(
1109 const MenuDefinitionList &List) {
1110 for (auto &Def : List.Definitions) {
1111 uint16_t Flags = Def->getResFlags();
1112 // Last element receives an additional 0x80 flag.
1113 const uint16_t LastElementFlag = 0x0080;
1114 if (&Def == &List.Definitions.back())
1115 Flags |= LastElementFlag;
1116
1117 RETURN_IF_ERROR(writeMenuDefinition(Def, Flags));
1118 }
1119 return Error::success();
1120}
1121
1122Error ResourceFileWriter::writeMenuBody(const RCResource *Base) {
1123 // At first, MENUHEADER structure. In fact, these are two WORDs equal to 0.
1124 // Ref: msdn.microsoft.com/en-us/library/windows/desktop/ms648018.aspx
Zachary Turner1e2c8b12017-10-09 22:59:40 +00001125 writeInt<uint32_t>(0);
Marek Sokolowski42f494d2017-09-29 22:25:05 +00001126
1127 return writeMenuDefinitionList(cast<MenuResource>(Base)->Elements);
1128}
1129
Zachary Turnerda366692017-10-06 21:30:55 +00001130// --- StringTableResource helpers. --- //
1131
1132class BundleResource : public RCResource {
1133public:
1134 using BundleType = ResourceFileWriter::StringTableInfo::Bundle;
1135 BundleType Bundle;
1136
1137 BundleResource(const BundleType &StrBundle) : Bundle(StrBundle) {}
1138 IntOrString getResourceType() const override { return 6; }
1139
1140 ResourceKind getKind() const override { return RkStringTableBundle; }
1141 static bool classof(const RCResource *Res) {
1142 return Res->getKind() == RkStringTableBundle;
1143 }
1144};
1145
1146Error ResourceFileWriter::visitStringTableBundle(const RCResource *Res) {
1147 return writeResource(Res, &ResourceFileWriter::writeStringTableBundleBody);
1148}
1149
1150Error ResourceFileWriter::insertStringIntoBundle(
1151 StringTableInfo::Bundle &Bundle, uint16_t StringID, StringRef String) {
1152 uint16_t StringLoc = StringID & 15;
1153 if (Bundle.Data[StringLoc])
1154 return createError("Multiple STRINGTABLE strings located under ID " +
1155 Twine(StringID));
1156 Bundle.Data[StringLoc] = String;
1157 return Error::success();
1158}
1159
1160Error ResourceFileWriter::writeStringTableBundleBody(const RCResource *Base) {
1161 auto *Res = cast<BundleResource>(Base);
1162 for (size_t ID = 0; ID < Res->Bundle.Data.size(); ++ID) {
1163 // The string format is a tiny bit different here. We
1164 // first output the size of the string, and then the string itself
1165 // (which is not null-terminated).
1166 bool IsLongString;
1167 SmallVector<UTF16, 128> Data;
1168 RETURN_IF_ERROR(processString(Res->Bundle.Data[ID].getValueOr(StringRef()),
1169 NullHandlingMethod::CutAtDoubleNull,
1170 IsLongString, Data));
1171 if (AppendNull && Res->Bundle.Data[ID])
1172 Data.push_back('\0');
1173 RETURN_IF_ERROR(
1174 checkNumberFits<uint16_t>(Data.size(), "STRINGTABLE string size"));
Zachary Turnerb12792a2017-10-06 23:21:43 +00001175 writeInt<uint16_t>(Data.size());
Zachary Turnerda366692017-10-06 21:30:55 +00001176 for (auto Char : Data)
Zachary Turnerb12792a2017-10-06 23:21:43 +00001177 writeInt(Char);
Zachary Turnerda366692017-10-06 21:30:55 +00001178 }
1179 return Error::success();
1180}
1181
1182Error ResourceFileWriter::dumpAllStringTables() {
1183 for (auto Key : StringTableData.BundleList) {
1184 auto Iter = StringTableData.BundleData.find(Key);
1185 assert(Iter != StringTableData.BundleData.end());
1186
1187 // For a moment, revert the context info to moment of bundle declaration.
1188 ContextKeeper RAII(this);
1189 ObjectData = Iter->second.DeclTimeInfo;
1190
1191 BundleResource Res(Iter->second);
1192 // Bundle #(k+1) contains keys [16k, 16k + 15].
1193 Res.setName(Key.first + 1);
1194 RETURN_IF_ERROR(visitStringTableBundle(&Res));
1195 }
1196 return Error::success();
1197}
1198
Zachary Turner9d8b3582017-10-06 21:52:15 +00001199// --- UserDefinedResource helpers. --- //
1200
1201Error ResourceFileWriter::writeUserDefinedBody(const RCResource *Base) {
1202 auto *Res = cast<UserDefinedResource>(Base);
1203
1204 if (Res->IsFileResource)
1205 return appendFile(Res->FileLoc);
1206
1207 for (auto &Elem : Res->Contents) {
1208 if (Elem.isInt()) {
1209 RETURN_IF_ERROR(
1210 checkRCInt(Elem.getInt(), "Number in user-defined resource"));
1211 writeRCInt(Elem.getInt());
1212 continue;
1213 }
1214
1215 SmallVector<UTF16, 128> ProcessedString;
1216 bool IsLongString;
1217 RETURN_IF_ERROR(processString(Elem.getString(),
1218 NullHandlingMethod::UserResource,
1219 IsLongString, ProcessedString));
1220
1221 for (auto Ch : ProcessedString) {
1222 if (IsLongString) {
Zachary Turnerb12792a2017-10-06 23:21:43 +00001223 writeInt(Ch);
Zachary Turner9d8b3582017-10-06 21:52:15 +00001224 continue;
1225 }
1226
1227 RETURN_IF_ERROR(checkNumberFits<uint8_t>(
Simon Dardis75f9ae22017-10-11 10:14:22 +00001228 Ch, "Character in narrow string in user-defined resource"));
Zachary Turnerb12792a2017-10-06 23:21:43 +00001229 writeInt<uint8_t>(Ch);
Zachary Turner9d8b3582017-10-06 21:52:15 +00001230 }
1231 }
1232
1233 return Error::success();
1234}
1235
Zachary Turner07bc04f2017-10-06 21:26:06 +00001236// --- VersionInfoResourceResource helpers. --- //
1237
1238Error ResourceFileWriter::writeVersionInfoBlock(const VersionInfoBlock &Blk) {
1239 // Output the header if the block has name.
1240 bool OutputHeader = Blk.Name != "";
1241 uint64_t LengthLoc;
1242
1243 if (OutputHeader) {
Zachary Turner1e2c8b12017-10-09 22:59:40 +00001244 LengthLoc = writeInt<uint16_t>(0);
1245 writeInt<uint16_t>(0);
1246 writeInt<uint16_t>(1); // true
Zachary Turner07bc04f2017-10-06 21:26:06 +00001247 RETURN_IF_ERROR(writeCString(Blk.Name));
1248 padStream(sizeof(uint32_t));
1249 }
1250
1251 for (const std::unique_ptr<VersionInfoStmt> &Item : Blk.Stmts) {
1252 VersionInfoStmt *ItemPtr = Item.get();
1253
1254 if (auto *BlockPtr = dyn_cast<VersionInfoBlock>(ItemPtr)) {
1255 RETURN_IF_ERROR(writeVersionInfoBlock(*BlockPtr));
1256 continue;
1257 }
1258
1259 auto *ValuePtr = cast<VersionInfoValue>(ItemPtr);
1260 RETURN_IF_ERROR(writeVersionInfoValue(*ValuePtr));
1261 }
1262
1263 if (OutputHeader) {
1264 uint64_t CurLoc = tell();
1265 writeObjectAt(ulittle16_t(CurLoc - LengthLoc), LengthLoc);
1266 }
1267
1268 padStream(sizeof(uint32_t));
1269 return Error::success();
1270}
1271
1272Error ResourceFileWriter::writeVersionInfoValue(const VersionInfoValue &Val) {
1273 // rc has a peculiar algorithm to output VERSIONINFO VALUEs. Each VALUE
1274 // is a mapping from the key (string) to the value (a sequence of ints or
1275 // a sequence of strings).
1276 //
1277 // If integers are to be written: width of each integer written depends on
1278 // whether it's been declared 'long' (it's DWORD then) or not (it's WORD).
1279 // ValueLength defined in structure referenced below is then the total
1280 // number of bytes taken by these integers.
1281 //
1282 // If strings are to be written: characters are always WORDs.
1283 // Moreover, '\0' character is written after the last string, and between
1284 // every two strings separated by comma (if strings are not comma-separated,
1285 // they're simply concatenated). ValueLength is equal to the number of WORDs
1286 // written (that is, half of the bytes written).
1287 //
1288 // Ref: msdn.microsoft.com/en-us/library/windows/desktop/ms646994.aspx
1289 bool HasStrings = false, HasInts = false;
1290 for (auto &Item : Val.Values)
1291 (Item.isInt() ? HasInts : HasStrings) = true;
1292
1293 assert((HasStrings || HasInts) && "VALUE must have at least one argument");
1294 if (HasStrings && HasInts)
1295 return createError(Twine("VALUE ") + Val.Key +
1296 " cannot contain both strings and integers");
1297
Zachary Turner1e2c8b12017-10-09 22:59:40 +00001298 auto LengthLoc = writeInt<uint16_t>(0);
1299 auto ValLengthLoc = writeInt<uint16_t>(0);
1300 writeInt<uint16_t>(HasStrings);
Zachary Turner07bc04f2017-10-06 21:26:06 +00001301 RETURN_IF_ERROR(writeCString(Val.Key));
1302 padStream(sizeof(uint32_t));
1303
1304 auto DataLoc = tell();
1305 for (size_t Id = 0; Id < Val.Values.size(); ++Id) {
1306 auto &Item = Val.Values[Id];
1307 if (Item.isInt()) {
1308 auto Value = Item.getInt();
1309 RETURN_IF_ERROR(checkRCInt(Value, "VERSIONINFO integer value"));
1310 writeRCInt(Value);
1311 continue;
1312 }
1313
1314 bool WriteTerminator =
1315 Id == Val.Values.size() - 1 || Val.HasPrecedingComma[Id + 1];
1316 RETURN_IF_ERROR(writeCString(Item.getString(), WriteTerminator));
1317 }
1318
1319 auto CurLoc = tell();
1320 auto ValueLength = CurLoc - DataLoc;
1321 if (HasStrings) {
1322 assert(ValueLength % 2 == 0);
1323 ValueLength /= 2;
1324 }
1325 writeObjectAt(ulittle16_t(CurLoc - LengthLoc), LengthLoc);
1326 writeObjectAt(ulittle16_t(ValueLength), ValLengthLoc);
1327 padStream(sizeof(uint32_t));
1328 return Error::success();
1329}
1330
1331template <typename Ty>
1332static Ty getWithDefault(const StringMap<Ty> &Map, StringRef Key,
1333 const Ty &Default) {
1334 auto Iter = Map.find(Key);
1335 if (Iter != Map.end())
1336 return Iter->getValue();
1337 return Default;
1338}
1339
1340Error ResourceFileWriter::writeVersionInfoBody(const RCResource *Base) {
1341 auto *Res = cast<VersionInfoResource>(Base);
1342
1343 const auto &FixedData = Res->FixedData;
1344
1345 struct /* VS_FIXEDFILEINFO */ {
1346 ulittle32_t Signature = ulittle32_t(0xFEEF04BD);
1347 ulittle32_t StructVersion = ulittle32_t(0x10000);
1348 // It's weird to have most-significant DWORD first on the little-endian
1349 // machines, but let it be this way.
1350 ulittle32_t FileVersionMS;
1351 ulittle32_t FileVersionLS;
1352 ulittle32_t ProductVersionMS;
1353 ulittle32_t ProductVersionLS;
1354 ulittle32_t FileFlagsMask;
1355 ulittle32_t FileFlags;
1356 ulittle32_t FileOS;
1357 ulittle32_t FileType;
1358 ulittle32_t FileSubtype;
1359 // MS implementation seems to always set these fields to 0.
1360 ulittle32_t FileDateMS = ulittle32_t(0);
1361 ulittle32_t FileDateLS = ulittle32_t(0);
1362 } FixedInfo;
1363
1364 // First, VS_VERSIONINFO.
Zachary Turnerb12792a2017-10-06 23:21:43 +00001365 auto LengthLoc = writeInt<uint16_t>(0);
1366 writeInt<uint16_t>(sizeof(FixedInfo));
1367 writeInt<uint16_t>(0);
Zachary Turner07bc04f2017-10-06 21:26:06 +00001368 cantFail(writeCString("VS_VERSION_INFO"));
1369 padStream(sizeof(uint32_t));
1370
1371 using VersionInfoFixed = VersionInfoResource::VersionInfoFixed;
1372 auto GetField = [&](VersionInfoFixed::VersionInfoFixedType Type) {
1373 static const SmallVector<uint32_t, 4> DefaultOut{0, 0, 0, 0};
1374 if (!FixedData.IsTypePresent[(int)Type])
1375 return DefaultOut;
1376 return FixedData.FixedInfo[(int)Type];
1377 };
1378
1379 auto FileVer = GetField(VersionInfoFixed::FtFileVersion);
1380 RETURN_IF_ERROR(checkNumberFits<uint16_t>(
1381 *std::max_element(FileVer.begin(), FileVer.end()), "FILEVERSION fields"));
1382 FixedInfo.FileVersionMS = (FileVer[0] << 16) | FileVer[1];
1383 FixedInfo.FileVersionLS = (FileVer[2] << 16) | FileVer[3];
1384
1385 auto ProdVer = GetField(VersionInfoFixed::FtProductVersion);
1386 RETURN_IF_ERROR(checkNumberFits<uint16_t>(
1387 *std::max_element(ProdVer.begin(), ProdVer.end()),
1388 "PRODUCTVERSION fields"));
1389 FixedInfo.ProductVersionMS = (ProdVer[0] << 16) | ProdVer[1];
1390 FixedInfo.ProductVersionLS = (ProdVer[2] << 16) | ProdVer[3];
1391
1392 FixedInfo.FileFlagsMask = GetField(VersionInfoFixed::FtFileFlagsMask)[0];
1393 FixedInfo.FileFlags = GetField(VersionInfoFixed::FtFileFlags)[0];
1394 FixedInfo.FileOS = GetField(VersionInfoFixed::FtFileOS)[0];
1395 FixedInfo.FileType = GetField(VersionInfoFixed::FtFileType)[0];
1396 FixedInfo.FileSubtype = GetField(VersionInfoFixed::FtFileSubtype)[0];
1397
1398 writeObject(FixedInfo);
1399 padStream(sizeof(uint32_t));
1400
1401 RETURN_IF_ERROR(writeVersionInfoBlock(Res->MainBlock));
1402
1403 // FIXME: check overflow?
1404 writeObjectAt(ulittle16_t(tell() - LengthLoc), LengthLoc);
1405
1406 return Error::success();
1407}
1408
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +00001409Expected<std::unique_ptr<MemoryBuffer>>
1410ResourceFileWriter::loadFile(StringRef File) const {
1411 SmallString<128> Path;
1412 SmallString<128> Cwd;
1413 std::unique_ptr<MemoryBuffer> Result;
1414
1415 // 1. The current working directory.
1416 sys::fs::current_path(Cwd);
1417 Path.assign(Cwd.begin(), Cwd.end());
1418 sys::path::append(Path, File);
1419 if (sys::fs::exists(Path))
Zachary Turnerf22a25e2017-10-11 20:23:38 +00001420 return errorOrToExpected(MemoryBuffer::getFile(Path, -1, false));
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +00001421
1422 // 2. The directory of the input resource file, if it is different from the
1423 // current
1424 // working directory.
1425 StringRef InputFileDir = sys::path::parent_path(Params.InputFilePath);
1426 Path.assign(InputFileDir.begin(), InputFileDir.end());
1427 sys::path::append(Path, File);
1428 if (sys::fs::exists(Path))
Zachary Turnerf22a25e2017-10-11 20:23:38 +00001429 return errorOrToExpected(MemoryBuffer::getFile(Path, -1, false));
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +00001430
1431 // 3. All of the include directories specified on the command line.
1432 for (StringRef ForceInclude : Params.Include) {
1433 Path.assign(ForceInclude.begin(), ForceInclude.end());
1434 sys::path::append(Path, File);
1435 if (sys::fs::exists(Path))
Zachary Turnerf22a25e2017-10-11 20:23:38 +00001436 return errorOrToExpected(MemoryBuffer::getFile(Path, -1, false));
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +00001437 }
1438
1439 if (auto Result =
1440 llvm::sys::Process::FindInEnvPath("INCLUDE", File, Params.NoInclude))
Zachary Turnerf22a25e2017-10-11 20:23:38 +00001441 return errorOrToExpected(MemoryBuffer::getFile(*Result, -1, false));
Zachary Turnerfa0ca6c2017-10-11 20:12:09 +00001442
1443 return make_error<StringError>("error : file not found : " + Twine(File),
1444 inconvertibleErrorCode());
1445}
1446
Marek Sokolowski8f193432017-09-29 17:14:09 +00001447} // namespace rc
1448} // namespace llvm