JBIG2Loader.cpp 48 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230
  1. /*
  2. * Copyright (c) 2024, Nico Weber <thakis@chromium.org>
  3. *
  4. * SPDX-License-Identifier: BSD-2-Clause
  5. */
  6. #include <AK/Debug.h>
  7. #include <AK/Utf16View.h>
  8. #include <LibGfx/ImageFormats/CCITTDecoder.h>
  9. #include <LibGfx/ImageFormats/JBIG2Loader.h>
  10. #include <LibTextCodec/Decoder.h>
  11. // Spec: ITU-T_T_88__08_2018.pdf in the zip file here:
  12. // https://www.itu.int/rec/T-REC-T.88-201808-I
  13. // Annex H has a datastream example.
  14. namespace Gfx {
  15. namespace JBIG2 {
  16. // Table E.1 – Qe values and probability estimation process
  17. // See also E.1.2 Coding conventions and approximations
  18. // and E.2.5 Probability estimation.
  19. struct QeEntry {
  20. u16 qe; // Sub-interval for the less probable symbol.
  21. u16 nmps; // Next index if the more probable symbol is decoded
  22. u16 nlps; // Next index if the less probable symbol is decoded
  23. u16 switch_flag; // See second-to-last paragraph in E.1.2.
  24. };
  25. constexpr auto qe_table = to_array<QeEntry>({
  26. { 0x5601, 1, 1, 1 },
  27. { 0x3401, 2, 6, 0 },
  28. { 0x1801, 3, 9, 0 },
  29. { 0x0AC1, 4, 12, 0 },
  30. { 0x0521, 5, 29, 0 },
  31. { 0x0221, 38, 33, 0 },
  32. { 0x5601, 7, 6, 1 },
  33. { 0x5401, 8, 14, 0 },
  34. { 0x4801, 9, 14, 0 },
  35. { 0x3801, 10, 14, 0 },
  36. { 0x3001, 11, 17, 0 },
  37. { 0x2401, 12, 18, 0 },
  38. { 0x1C01, 13, 20, 0 },
  39. { 0x1601, 29, 21, 0 },
  40. { 0x5601, 15, 14, 1 },
  41. { 0x5401, 16, 14, 0 },
  42. { 0x5101, 17, 15, 0 },
  43. { 0x4801, 18, 16, 0 },
  44. { 0x3801, 19, 17, 0 },
  45. { 0x3401, 20, 18, 0 },
  46. { 0x3001, 21, 19, 0 },
  47. { 0x2801, 22, 19, 0 },
  48. { 0x2401, 23, 20, 0 },
  49. { 0x2201, 24, 21, 0 },
  50. { 0x1C01, 25, 22, 0 },
  51. { 0x1801, 26, 23, 0 },
  52. { 0x1601, 27, 24, 0 },
  53. { 0x1401, 28, 25, 0 },
  54. { 0x1201, 29, 26, 0 },
  55. { 0x1101, 30, 27, 0 },
  56. { 0x0AC1, 31, 28, 0 },
  57. { 0x09C1, 32, 29, 0 },
  58. { 0x08A1, 33, 30, 0 },
  59. { 0x0521, 34, 31, 0 },
  60. { 0x0441, 35, 32, 0 },
  61. { 0x02A1, 36, 33, 0 },
  62. { 0x0221, 37, 34, 0 },
  63. { 0x0141, 38, 35, 0 },
  64. { 0x0111, 39, 36, 0 },
  65. { 0x0085, 40, 37, 0 },
  66. { 0x0049, 41, 38, 0 },
  67. { 0x0025, 42, 39, 0 },
  68. { 0x0015, 43, 40, 0 },
  69. { 0x0009, 44, 41, 0 },
  70. { 0x0005, 45, 42, 0 },
  71. { 0x0001, 45, 43, 0 },
  72. { 0x5601, 46, 46, 0 },
  73. });
  74. ErrorOr<ArithmeticDecoder> ArithmeticDecoder::initialize(ReadonlyBytes data)
  75. {
  76. ArithmeticDecoder decoder { data };
  77. decoder.INITDEC();
  78. return decoder;
  79. }
  80. bool ArithmeticDecoder::get_next_bit(Context& context)
  81. {
  82. CX = &context;
  83. // Useful for comparing to Table H.1 – Encoder and decoder trace data.
  84. // dbg("I={} MPS={} A={:#x} C={:#x} CT={} B={:#x}", I(CX), MPS(CX), A, C, CT, B());
  85. u8 D = DECODE();
  86. // dbgln(" -> D={}", D);
  87. return D;
  88. }
  89. u16 ArithmeticDecoder::Qe(u16 index) { return qe_table[index].qe; }
  90. u8 ArithmeticDecoder::NMPS(u16 index) { return qe_table[index].nmps; }
  91. u8 ArithmeticDecoder::NLPS(u16 index) { return qe_table[index].nlps; }
  92. u8 ArithmeticDecoder::SWITCH(u16 index) { return qe_table[index].switch_flag; }
  93. u8 ArithmeticDecoder::B(size_t offset) const
  94. {
  95. // E.2.10 Minimization of the compressed data
  96. // "the convention is used in the decoder that when a marker code is encountered,
  97. // 1-bits (without bit stuffing) are supplied to the decoder until the coding interval is complete."
  98. if (BP + offset >= m_data.size())
  99. return 0xFF;
  100. return m_data[BP + offset];
  101. }
  102. void ArithmeticDecoder::INITDEC()
  103. {
  104. // E.3.5 Initialization of the decoder (INITDEC)
  105. // Figure G.1 – Initialization of the software conventions decoder
  106. // "BP, the pointer to the compressed data, is initialized to BPST (pointing to the first compressed byte)."
  107. auto const BPST = 0;
  108. BP = BPST;
  109. C = (B() ^ 0xFF) << 16;
  110. BYTEIN();
  111. C = C << 7;
  112. CT = CT - 7;
  113. A = 0x8000;
  114. }
  115. u8 ArithmeticDecoder::DECODE()
  116. {
  117. // E.3.2 Decoding a decision (DECODE)
  118. // Figure G.2 – Decoding an MPS or an LPS in the software-conventions decoder
  119. u8 D;
  120. A = A - Qe(I(CX));
  121. if (C < ((u32)A << 16)) { // `(C_high < A)` in spec
  122. if ((A & 0x8000) == 0) {
  123. D = MPS_EXCHANGE();
  124. RENORMD();
  125. } else {
  126. D = MPS(CX);
  127. }
  128. } else {
  129. C = C - ((u32)A << 16); // `C_high = C_high - A` in spec
  130. D = LPS_EXCHANGE();
  131. RENORMD();
  132. }
  133. return D;
  134. }
  135. u8 ArithmeticDecoder::MPS_EXCHANGE()
  136. {
  137. // Figure E.16 – Decoder MPS path conditional exchange procedure
  138. u8 D;
  139. if (A < Qe(I(CX))) {
  140. D = 1 - MPS(CX);
  141. if (SWITCH(I(CX)) == 1) {
  142. MPS(CX) = 1 - MPS(CX);
  143. }
  144. I(CX) = NLPS(I(CX));
  145. } else {
  146. D = MPS(CX);
  147. I(CX) = NMPS(I(CX));
  148. }
  149. return D;
  150. }
  151. u8 ArithmeticDecoder::LPS_EXCHANGE()
  152. {
  153. // Figure E.17 – Decoder LPS path conditional exchange procedure
  154. u8 D;
  155. if (A < Qe(I(CX))) {
  156. A = Qe(I(CX));
  157. D = MPS(CX);
  158. I(CX) = NMPS(I(CX));
  159. } else {
  160. A = Qe(I(CX));
  161. D = 1 - MPS(CX);
  162. if (SWITCH(I(CX)) == 1) {
  163. MPS(CX) = 1 - MPS(CX);
  164. }
  165. I(CX) = NLPS(I(CX));
  166. }
  167. return D;
  168. }
  169. void ArithmeticDecoder::RENORMD()
  170. {
  171. // E.3.3 Renormalization in the decoder (RENORMD)
  172. // Figure E.18 – Decoder renormalization procedure
  173. do {
  174. if (CT == 0)
  175. BYTEIN();
  176. A = A << 1;
  177. C = C << 1;
  178. CT = CT - 1;
  179. } while ((A & 0x8000) == 0);
  180. }
  181. void ArithmeticDecoder::BYTEIN()
  182. {
  183. // E.3.4 Compressed data input (BYTEIN)
  184. // Figure G.3 – Inserting a new byte into the C register in the software-conventions decoder
  185. if (B() == 0xFF) {
  186. if (B(1) > 0x8F) {
  187. CT = 8;
  188. } else {
  189. BP = BP + 1;
  190. C = C + 0xFE00 - (B() << 9);
  191. CT = 7;
  192. }
  193. } else {
  194. BP = BP + 1;
  195. C = C + 0xFF00 - (B() << 8);
  196. CT = 8;
  197. }
  198. }
  199. }
  200. // JBIG2 spec, Annex D, D.4.1 ID string
  201. static constexpr u8 id_string[] = { 0x97, 0x4A, 0x42, 0x32, 0x0D, 0x0A, 0x1A, 0x0A };
  202. // 7.3 Segment types
  203. enum SegmentType {
  204. SymbolDictionary = 0,
  205. IntermediateTextRegion = 4,
  206. ImmediateTextRegion = 6,
  207. ImmediateLosslessTextRegion = 7,
  208. PatternDictionary = 16,
  209. IntermediateHalftoneRegion = 20,
  210. ImmediateHalftoneRegion = 22,
  211. ImmediateLosslessHalftoneRegion = 23,
  212. IntermediateGenericRegion = 36,
  213. ImmediateGenericRegion = 38,
  214. ImmediateLosslessGenericRegion = 39,
  215. IntermediateGenericRefinementRegion = 40,
  216. ImmediateGenericRefinementRegion = 42,
  217. ImmediateLosslessGenericRefinementRegion = 43,
  218. PageInformation = 48,
  219. EndOfPage = 49,
  220. EndOfStripe = 50,
  221. EndOfFile = 51,
  222. Profiles = 52,
  223. Tables = 53,
  224. ColorPalette = 54,
  225. Extension = 62,
  226. };
  227. // Annex D
  228. enum class Organization {
  229. // D.1 Sequential organization
  230. Sequential,
  231. // D.2 Random-access organization
  232. RandomAccess,
  233. // D.3 Embedded organization
  234. Embedded,
  235. };
  236. struct SegmentHeader {
  237. u32 segment_number;
  238. SegmentType type;
  239. Vector<u32> referred_to_segment_numbers;
  240. // 7.2.6 Segment page association
  241. // "The first page must be numbered "1". This field may contain a value of zero; this value indicates that this segment is not associated with any page."
  242. u32 page_association;
  243. Optional<u32> data_length;
  244. };
  245. struct SegmentData {
  246. SegmentHeader header;
  247. ReadonlyBytes data;
  248. };
  249. class BitBuffer {
  250. public:
  251. static ErrorOr<NonnullOwnPtr<BitBuffer>> create(size_t width, size_t height);
  252. bool get_bit(size_t x, size_t y) const;
  253. void set_bit(size_t x, size_t y, bool b);
  254. void fill(bool b);
  255. ErrorOr<NonnullRefPtr<Gfx::Bitmap>> to_gfx_bitmap() const;
  256. ErrorOr<ByteBuffer> to_byte_buffer() const;
  257. private:
  258. BitBuffer(ByteBuffer, size_t width, size_t height, size_t pitch);
  259. ByteBuffer m_bits;
  260. size_t m_width;
  261. size_t m_height;
  262. size_t m_pitch;
  263. };
  264. ErrorOr<NonnullOwnPtr<BitBuffer>> BitBuffer::create(size_t width, size_t height)
  265. {
  266. size_t pitch = ceil_div(width, 8ull);
  267. auto bits = TRY(ByteBuffer::create_uninitialized(pitch * height));
  268. return adopt_nonnull_own_or_enomem(new (nothrow) BitBuffer(move(bits), width, height, pitch));
  269. }
  270. bool BitBuffer::get_bit(size_t x, size_t y) const
  271. {
  272. VERIFY(x < m_width);
  273. VERIFY(y < m_height);
  274. size_t byte_offset = x / 8;
  275. size_t bit_offset = x % 8;
  276. u8 byte = m_bits[y * m_pitch + byte_offset];
  277. byte = (byte >> (8 - 1 - bit_offset)) & 1;
  278. return byte != 0;
  279. }
  280. void BitBuffer::set_bit(size_t x, size_t y, bool b)
  281. {
  282. VERIFY(x < m_width);
  283. VERIFY(y < m_height);
  284. size_t byte_offset = x / 8;
  285. size_t bit_offset = x % 8;
  286. u8 byte = m_bits[y * m_pitch + byte_offset];
  287. u8 mask = 1u << (8 - 1 - bit_offset);
  288. if (b)
  289. byte |= mask;
  290. else
  291. byte &= ~mask;
  292. m_bits[y * m_pitch + byte_offset] = byte;
  293. }
  294. void BitBuffer::fill(bool b)
  295. {
  296. u8 fill_byte = b ? 0xff : 0;
  297. for (auto& byte : m_bits.bytes())
  298. byte = fill_byte;
  299. }
  300. ErrorOr<NonnullRefPtr<Gfx::Bitmap>> BitBuffer::to_gfx_bitmap() const
  301. {
  302. auto bitmap = TRY(Gfx::Bitmap::create(Gfx::BitmapFormat::BGRx8888, { m_width, m_height }));
  303. for (size_t y = 0; y < m_height; ++y) {
  304. for (size_t x = 0; x < m_width; ++x) {
  305. auto color = get_bit(x, y) ? Color::Black : Color::White;
  306. bitmap->set_pixel(x, y, color);
  307. }
  308. }
  309. return bitmap;
  310. }
  311. ErrorOr<ByteBuffer> BitBuffer::to_byte_buffer() const
  312. {
  313. return ByteBuffer::copy(m_bits);
  314. }
  315. BitBuffer::BitBuffer(ByteBuffer bits, size_t width, size_t height, size_t pitch)
  316. : m_bits(move(bits))
  317. , m_width(width)
  318. , m_height(height)
  319. , m_pitch(pitch)
  320. {
  321. }
  322. // 7.4.8.5 Page segment flags
  323. enum class CombinationOperator {
  324. Or = 0,
  325. And = 1,
  326. Xor = 2,
  327. XNor = 3,
  328. };
  329. struct Page {
  330. IntSize size;
  331. CombinationOperator default_combination_operator;
  332. OwnPtr<BitBuffer> bits;
  333. };
  334. struct JBIG2LoadingContext {
  335. enum class State {
  336. NotDecoded = 0,
  337. Error,
  338. Decoded,
  339. };
  340. State state { State::NotDecoded };
  341. Organization organization { Organization::Sequential };
  342. Page page;
  343. Optional<u32> number_of_pages;
  344. Vector<SegmentData> segments;
  345. };
  346. static ErrorOr<void> decode_jbig2_header(JBIG2LoadingContext& context, ReadonlyBytes data)
  347. {
  348. if (!JBIG2ImageDecoderPlugin::sniff(data))
  349. return Error::from_string_literal("JBIG2LoadingContext: Invalid JBIG2 header");
  350. FixedMemoryStream stream(data.slice(sizeof(id_string)));
  351. // D.4.2 File header flags
  352. u8 header_flags = TRY(stream.read_value<u8>());
  353. if (header_flags & 0b11110000)
  354. return Error::from_string_literal("JBIG2LoadingContext: Invalid header flags");
  355. context.organization = (header_flags & 1) ? Organization::Sequential : Organization::RandomAccess;
  356. dbgln_if(JBIG2_DEBUG, "JBIG2LoadingContext: Organization: {} ({})", (int)context.organization, context.organization == Organization::Sequential ? "Sequential" : "Random-access");
  357. bool has_known_number_of_pages = (header_flags & 2) ? false : true;
  358. bool uses_templates_with_12_AT_pixels = (header_flags & 4) ? true : false;
  359. bool contains_colored_region_segments = (header_flags & 8) ? true : false;
  360. // FIXME: Do something with these?
  361. (void)uses_templates_with_12_AT_pixels;
  362. (void)contains_colored_region_segments;
  363. // D.4.3 Number of pages
  364. if (has_known_number_of_pages) {
  365. context.number_of_pages = TRY(stream.read_value<BigEndian<u32>>());
  366. dbgln_if(JBIG2_DEBUG, "JBIG2LoadingContext: Number of pages: {}", context.number_of_pages.value());
  367. }
  368. return {};
  369. }
  370. static ErrorOr<SegmentHeader> decode_segment_header(SeekableStream& stream)
  371. {
  372. // 7.2.2 Segment number
  373. u32 segment_number = TRY(stream.read_value<BigEndian<u32>>());
  374. dbgln_if(JBIG2_DEBUG, "Segment number: {}", segment_number);
  375. // 7.2.3 Segment header flags
  376. u8 flags = TRY(stream.read_value<u8>());
  377. SegmentType type = static_cast<SegmentType>(flags & 0b11'1111);
  378. dbgln_if(JBIG2_DEBUG, "Segment type: {}", (int)type);
  379. bool segment_page_association_size_is_32_bits = (flags & 0b100'0000) != 0;
  380. bool segment_retained_only_by_itself_and_extension_segments = (flags & 0b1000'00000) != 0;
  381. // FIXME: Do something with these.
  382. (void)segment_page_association_size_is_32_bits;
  383. (void)segment_retained_only_by_itself_and_extension_segments;
  384. // 7.2.4 Referred-to segment count and retention flags
  385. u8 referred_to_segment_count_and_retention_flags = TRY(stream.read_value<u8>());
  386. u32 count_of_referred_to_segments = referred_to_segment_count_and_retention_flags >> 5;
  387. if (count_of_referred_to_segments == 5 || count_of_referred_to_segments == 6)
  388. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Invalid count_of_referred_to_segments");
  389. u32 extra_count = 0;
  390. if (count_of_referred_to_segments == 7) {
  391. TRY(stream.seek(-1, SeekMode::FromCurrentPosition));
  392. count_of_referred_to_segments = TRY(stream.read_value<BigEndian<u32>>()) & 0x1FFF'FFFF;
  393. extra_count = ceil_div(count_of_referred_to_segments + 1, 8);
  394. TRY(stream.seek(extra_count, SeekMode::FromCurrentPosition));
  395. }
  396. dbgln_if(JBIG2_DEBUG, "Referred-to segment count: {}", count_of_referred_to_segments);
  397. // 7.2.5 Referred-to segment numbers
  398. Vector<u32> referred_to_segment_numbers;
  399. for (u32 i = 0; i < count_of_referred_to_segments; ++i) {
  400. u32 referred_to_segment_number;
  401. if (segment_number <= 256)
  402. referred_to_segment_number = TRY(stream.read_value<u8>());
  403. else if (segment_number <= 65536)
  404. referred_to_segment_number = TRY(stream.read_value<BigEndian<u16>>());
  405. else
  406. referred_to_segment_number = TRY(stream.read_value<BigEndian<u32>>());
  407. referred_to_segment_numbers.append(referred_to_segment_number);
  408. dbgln_if(JBIG2_DEBUG, "Referred-to segment number: {}", referred_to_segment_number);
  409. }
  410. // 7.2.6 Segment page association
  411. u32 segment_page_association;
  412. if (segment_page_association_size_is_32_bits) {
  413. segment_page_association = TRY(stream.read_value<BigEndian<u32>>());
  414. } else {
  415. segment_page_association = TRY(stream.read_value<u8>());
  416. }
  417. dbgln_if(JBIG2_DEBUG, "Segment page association: {}", segment_page_association);
  418. // 7.2.7 Segment data length
  419. u32 data_length = TRY(stream.read_value<BigEndian<u32>>());
  420. dbgln_if(JBIG2_DEBUG, "Segment data length: {}", data_length);
  421. // FIXME: Add some validity checks:
  422. // - check type is valid
  423. // - check referred_to_segment_numbers are smaller than segment_number
  424. // - 7.3.1 Rules for segment references
  425. // - 7.3.2 Rules for page associations
  426. Optional<u32> opt_data_length;
  427. if (data_length != 0xffff'ffff)
  428. opt_data_length = data_length;
  429. else if (type != ImmediateGenericRegion)
  430. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Unknown data length only allowed for ImmediateGenericRegion");
  431. return SegmentHeader { segment_number, type, move(referred_to_segment_numbers), segment_page_association, opt_data_length };
  432. }
  433. static ErrorOr<size_t> scan_for_immediate_generic_region_size(ReadonlyBytes data)
  434. {
  435. // 7.2.7 Segment data length
  436. // "If the segment's type is "Immediate generic region", then the length field may contain the value 0xFFFFFFFF.
  437. // This value is intended to mean that the length of the segment's data part is unknown at the time that the segment header is written (...).
  438. // In this case, the true length of the segment's data part shall be determined through examination of the data:
  439. // if the segment uses template-based arithmetic coding, then the segment's data part ends with the two-byte sequence 0xFF 0xAC followed by a four-byte row count.
  440. // If the segment uses MMR coding, then the segment's data part ends with the two-byte sequence 0x00 0x00 followed by a four-byte row count.
  441. // The form of encoding used by the segment may be determined by examining the eighteenth byte of its segment data part,
  442. // and the end sequences can occur anywhere after that eighteenth byte."
  443. // 7.4.6.4 Decoding a generic region segment
  444. // "NOTE – The sequence 0x00 0x00 cannot occur within MMR-encoded data; the sequence 0xFF 0xAC can occur only at the end of arithmetically-coded data.
  445. // Thus, those sequences cannot occur by chance in the data that is decoded to generate the contents of the generic region."
  446. dbgln_if(JBIG2_DEBUG, "(Unknown data length, computing it)");
  447. if (data.size() < 19 + sizeof(u32))
  448. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Data too short to contain segment data header and end sequence");
  449. // Per 7.4.6.1 Generic region segment data header, this starts with the 17 bytes described in
  450. // 7.4.1 Region segment information field, followed the byte described in 7.4.6.2 Generic region segment flags.
  451. // That byte's lowest bit stores if the segment uses MMR.
  452. u8 flags = data[17];
  453. bool uses_mmr = (flags & 1) != 0;
  454. auto end_sequence = uses_mmr ? to_array<u8>({ 0x00, 0x00 }) : to_array<u8>({ 0xFF, 0xAC });
  455. u8 const* end = static_cast<u8 const*>(memmem(data.data() + 19, data.size() - 19 - sizeof(u32), end_sequence.data(), end_sequence.size()));
  456. if (!end)
  457. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Could not find end sequence in segment data");
  458. size_t size = end - data.data() + end_sequence.size() + sizeof(u32);
  459. dbgln_if(JBIG2_DEBUG, "(Computed size is {})", size);
  460. return size;
  461. }
  462. static ErrorOr<void> decode_segment_headers(JBIG2LoadingContext& context, ReadonlyBytes data)
  463. {
  464. FixedMemoryStream stream(data);
  465. Vector<ReadonlyBytes> segment_datas;
  466. auto store_and_skip_segment_data = [&](SegmentHeader const& segment_header) -> ErrorOr<void> {
  467. size_t start_offset = TRY(stream.tell());
  468. u32 data_length = TRY(segment_header.data_length.try_value_or_lazy_evaluated([&]() {
  469. return scan_for_immediate_generic_region_size(data.slice(start_offset));
  470. }));
  471. if (start_offset + data_length > data.size()) {
  472. dbgln_if(JBIG2_DEBUG, "JBIG2ImageDecoderPlugin: start_offset={}, data_length={}, data.size()={}", start_offset, data_length, data.size());
  473. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Segment data length exceeds file size");
  474. }
  475. ReadonlyBytes segment_data = data.slice(start_offset, data_length);
  476. segment_datas.append(segment_data);
  477. TRY(stream.seek(data_length, SeekMode::FromCurrentPosition));
  478. return {};
  479. };
  480. Vector<SegmentHeader> segment_headers;
  481. while (!stream.is_eof()) {
  482. auto segment_header = TRY(decode_segment_header(stream));
  483. segment_headers.append(segment_header);
  484. if (context.organization != Organization::RandomAccess)
  485. TRY(store_and_skip_segment_data(segment_header));
  486. // Required per spec for files with RandomAccess organization.
  487. if (segment_header.type == SegmentType::EndOfFile)
  488. break;
  489. }
  490. if (context.organization == Organization::RandomAccess) {
  491. for (auto const& segment_header : segment_headers)
  492. TRY(store_and_skip_segment_data(segment_header));
  493. }
  494. if (segment_headers.size() != segment_datas.size())
  495. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Segment headers and segment datas have different sizes");
  496. for (size_t i = 0; i < segment_headers.size(); ++i)
  497. context.segments.append({ segment_headers[i], segment_datas[i] });
  498. return {};
  499. }
  500. // 7.4.1 Region segment information field
  501. struct [[gnu::packed]] RegionSegmentInformationField {
  502. BigEndian<u32> width;
  503. BigEndian<u32> height;
  504. BigEndian<u32> x_location;
  505. BigEndian<u32> y_location;
  506. u8 flags;
  507. // FIXME: Or have just ::CombinationOperator represent both page and segment operators?
  508. enum class CombinationOperator {
  509. Or = 0,
  510. And = 1,
  511. Xor = 2,
  512. XNor = 3,
  513. Replace = 4,
  514. };
  515. CombinationOperator external_combination_operator() const
  516. {
  517. VERIFY((flags & 0x7) <= 4);
  518. return static_cast<CombinationOperator>(flags & 0x7);
  519. }
  520. bool is_color_bitmap() const
  521. {
  522. return (flags & 0x8) != 0;
  523. }
  524. };
  525. static_assert(AssertSize<RegionSegmentInformationField, 17>());
  526. static ErrorOr<RegionSegmentInformationField> decode_region_segment_information_field(ReadonlyBytes data)
  527. {
  528. // 7.4.8 Page information segment syntax
  529. if (data.size() < sizeof(RegionSegmentInformationField))
  530. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Invalid region segment information field size");
  531. auto result = *(RegionSegmentInformationField const*)data.data();
  532. if ((result.flags & 0b1111'0000) != 0)
  533. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Invalid region segment information field flags");
  534. if ((result.flags & 0x7) > 4)
  535. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Invalid region segment information field operator");
  536. // NOTE 3 – If the colour extension flag (COLEXTFLAG) is equal to 1, the external combination operator must be REPLACE.
  537. if (result.is_color_bitmap() && result.external_combination_operator() != RegionSegmentInformationField::CombinationOperator::Replace)
  538. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Invalid colored region segment information field operator");
  539. return result;
  540. }
  541. // 7.4.8 Page information segment syntax
  542. struct [[gnu::packed]] PageInformationSegment {
  543. BigEndian<u32> bitmap_width;
  544. BigEndian<u32> bitmap_height;
  545. BigEndian<u32> page_x_resolution; // In pixels/meter.
  546. BigEndian<u32> page_y_resolution; // In pixels/meter.
  547. u8 flags;
  548. BigEndian<u16> striping_information;
  549. };
  550. static_assert(AssertSize<PageInformationSegment, 19>());
  551. static ErrorOr<PageInformationSegment> decode_page_information_segment(ReadonlyBytes data)
  552. {
  553. // 7.4.8 Page information segment syntax
  554. if (data.size() != sizeof(PageInformationSegment))
  555. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Invalid page information segment size");
  556. return *(PageInformationSegment const*)data.data();
  557. }
  558. static ErrorOr<void> scan_for_page_size(JBIG2LoadingContext& context)
  559. {
  560. // We only decode the first page at the moment.
  561. bool found_size = false;
  562. for (auto const& segment : context.segments) {
  563. if (segment.header.type != SegmentType::PageInformation || segment.header.page_association != 1)
  564. continue;
  565. auto page_information = TRY(decode_page_information_segment(segment.data));
  566. // FIXME: We're supposed to compute this from the striping information if it's not set.
  567. if (page_information.bitmap_height == 0xffff'ffff)
  568. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot handle unknown page height yet");
  569. context.page.size = { page_information.bitmap_width, page_information.bitmap_height };
  570. found_size = true;
  571. }
  572. if (!found_size)
  573. return Error::from_string_literal("JBIG2ImageDecoderPlugin: No page information segment found for page 1");
  574. return {};
  575. }
  576. static ErrorOr<void> warn_about_multiple_pages(JBIG2LoadingContext& context)
  577. {
  578. HashTable<u32> seen_pages;
  579. Vector<u32> pages;
  580. for (auto const& segment : context.segments) {
  581. if (segment.header.page_association == 0)
  582. continue;
  583. if (seen_pages.contains(segment.header.page_association))
  584. continue;
  585. seen_pages.set(segment.header.page_association);
  586. pages.append(segment.header.page_association);
  587. }
  588. // scan_for_page_size() already checked that there's a page 1.
  589. VERIFY(seen_pages.contains(1));
  590. if (pages.size() == 1)
  591. return {};
  592. StringBuilder builder;
  593. builder.appendff("JBIG2 file contains {} pages ({}", pages.size(), pages[0]);
  594. size_t i;
  595. for (i = 1; i < min(pages.size(), 10); ++i)
  596. builder.appendff(" {}", pages[i]);
  597. if (i != pages.size())
  598. builder.append(" ..."sv);
  599. builder.append("). We will only render page 1."sv);
  600. dbgln("JBIG2ImageDecoderPlugin: {}", TRY(builder.to_string()));
  601. return {};
  602. }
  603. // 6.2.2 Input parameters
  604. struct GenericRegionDecodingInputParameters {
  605. bool is_modified_modified_read; // "MMR" in spec.
  606. u32 region_width; // "GBW" in spec.
  607. u32 region_height; // "GBH" in spec.
  608. u8 gb_template;
  609. bool is_typical_prediction_used; // "TPGDON" in spec.
  610. bool is_extended_reference_template_used; // "EXTTEMPLATE" in spec.
  611. Optional<NonnullOwnPtr<BitBuffer>> skip_pattern; // "USESKIP", "SKIP" in spec.
  612. struct AdaptiveTemplatePixel {
  613. i8 x, y;
  614. };
  615. AdaptiveTemplatePixel adaptive_template_pixels[12]; // "GBATX" / "GBATY" in spec.
  616. // FIXME: GBCOLS, GBCOMBOP, COLEXTFLAG
  617. };
  618. // 6.2 Generic region decoding procedure
  619. static ErrorOr<NonnullOwnPtr<BitBuffer>> generic_region_decoding_procedure(GenericRegionDecodingInputParameters const& inputs, ReadonlyBytes data)
  620. {
  621. if (inputs.is_modified_modified_read) {
  622. dbgln_if(JBIG2_DEBUG, "JBIG2ImageDecoderPlugin: MMR image data");
  623. // 6.2.6 Decoding using MMR coding
  624. auto buffer = TRY(CCITT::decode_ccitt_group4(data, inputs.region_width, inputs.region_height));
  625. auto result = TRY(BitBuffer::create(inputs.region_width, inputs.region_height));
  626. size_t bytes_per_row = ceil_div(inputs.region_width, 8);
  627. if (buffer.size() != bytes_per_row * inputs.region_height)
  628. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Decoded MMR data has wrong size");
  629. // FIXME: Could probably just copy the ByteBuffer directly into the BitBuffer's internal ByteBuffer instead.
  630. for (size_t y = 0; y < inputs.region_height; ++y) {
  631. for (size_t x = 0; x < inputs.region_width; ++x) {
  632. bool bit = buffer[y * bytes_per_row + x / 8] & (1 << (7 - x % 8));
  633. result->set_bit(x, y, bit);
  634. }
  635. }
  636. return result;
  637. }
  638. // 6.2.5 Decoding using a template and arithmetic coding
  639. if (inputs.gb_template != 0)
  640. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode GBTEMPLATE != 0 yet");
  641. if (inputs.adaptive_template_pixels[0].x != 3 || inputs.adaptive_template_pixels[0].y != -1
  642. || inputs.adaptive_template_pixels[1].x != -3 || inputs.adaptive_template_pixels[1].y != -1
  643. || inputs.adaptive_template_pixels[2].x != 2 || inputs.adaptive_template_pixels[2].y != -2
  644. || inputs.adaptive_template_pixels[3].x != -2 || inputs.adaptive_template_pixels[3].y != -2)
  645. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot handle custom adaptive pixels yet");
  646. if (inputs.is_typical_prediction_used)
  647. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode TPGDON yet");
  648. if (inputs.is_extended_reference_template_used)
  649. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode EXTTEMPLATE yet");
  650. if (inputs.skip_pattern.has_value())
  651. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode USESKIP yet");
  652. auto result = TRY(BitBuffer::create(inputs.region_width, inputs.region_height));
  653. auto decoder = MUST(JBIG2::ArithmeticDecoder::initialize(data));
  654. auto get_pixel = [&inputs](NonnullOwnPtr<BitBuffer> const& buffer, int x, int y) -> bool {
  655. if (x < 0 || x >= (int)inputs.region_width || y < 0)
  656. return false;
  657. return buffer->get_bit(x, y);
  658. };
  659. // Figure 3(a) – Template when GBTEMPLATE = 0 and EXTTEMPLATE = 0,
  660. auto compute_context = [&get_pixel](NonnullOwnPtr<BitBuffer> const& buffer, int x, int y) -> u16 {
  661. u16 result = 0;
  662. for (int i = 0; i < 5; ++i)
  663. result = (result << 1) | (u16)get_pixel(buffer, x - 2 + i, y - 2);
  664. for (int i = 0; i < 7; ++i)
  665. result = (result << 1) | (u16)get_pixel(buffer, x - 3 + i, y - 1);
  666. for (int i = 0; i < 4; ++i)
  667. result = (result << 1) | (u16)get_pixel(buffer, x - 4 + i, y);
  668. return result;
  669. };
  670. // "The values of the pixels in this neighbourhood define a context. Each context has its own adaptive probability estimate
  671. // used by the arithmetic coder (see Annex E)."
  672. // "* Decode the current pixel by invoking the arithmetic entropy decoding procedure, with CX set to the value formed by
  673. // concatenating the label "GB" and the 10-16 pixel values gathered in CONTEXT."
  674. // Implementor's note: What this is supposed to mean is that we have a bunch of independent contexts, and we pick the
  675. // context for the current pixel based on pixel values in the neighborhood. The "GB" part just means this context is
  676. // independent from other contexts in the spec. At the moment, these are the only contexts we have, so we just
  677. // create them on demand here.
  678. // I can't find where the spec says this, but the contexts all start out zero-initialized.
  679. Vector<JBIG2::ArithmeticDecoder::Context> contexts;
  680. contexts.resize(1 << 16);
  681. for (size_t y = 0; y < inputs.region_height; ++y) {
  682. for (size_t x = 0; x < inputs.region_width; ++x) {
  683. u16 context = compute_context(result, x, y);
  684. bool bit = decoder.get_next_bit(contexts[context]);
  685. result->set_bit(x, y, bit);
  686. }
  687. }
  688. return result;
  689. }
  690. static ErrorOr<void> decode_symbol_dictionary(JBIG2LoadingContext&, SegmentData const&)
  691. {
  692. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode symbol dictionary yet");
  693. }
  694. static ErrorOr<void> decode_intermediate_text_region(JBIG2LoadingContext&, SegmentData const&)
  695. {
  696. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode intermediate text region yet");
  697. }
  698. static ErrorOr<void> decode_immediate_text_region(JBIG2LoadingContext&, SegmentData const&)
  699. {
  700. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode immediate text region yet");
  701. }
  702. static ErrorOr<void> decode_immediate_lossless_text_region(JBIG2LoadingContext&, SegmentData const&)
  703. {
  704. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode immediate lossless text region yet");
  705. }
  706. static ErrorOr<void> decode_pattern_dictionary(JBIG2LoadingContext&, SegmentData const&)
  707. {
  708. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode pattern dictionary yet");
  709. }
  710. static ErrorOr<void> decode_intermediate_halftone_region(JBIG2LoadingContext&, SegmentData const&)
  711. {
  712. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode intermediate halftone region yet");
  713. }
  714. static ErrorOr<void> decode_immediate_halftone_region(JBIG2LoadingContext&, SegmentData const&)
  715. {
  716. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode immediate halftone region yet");
  717. }
  718. static ErrorOr<void> decode_immediate_lossless_halftone_region(JBIG2LoadingContext&, SegmentData const&)
  719. {
  720. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode immediate lossless halftone region yet");
  721. }
  722. static ErrorOr<void> decode_intermediate_generic_region(JBIG2LoadingContext&, SegmentData const&)
  723. {
  724. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode intermediate generic region yet");
  725. }
  726. static ErrorOr<void> decode_immediate_generic_region(JBIG2LoadingContext& context, SegmentData const& segment)
  727. {
  728. // 7.4.6 Generic region segment syntax
  729. auto data = segment.data;
  730. auto information_field = TRY(decode_region_segment_information_field(data));
  731. data = data.slice(sizeof(information_field));
  732. dbgln_if(JBIG2_DEBUG, "Generic region: width={}, height={}, x={}, y={}, flags={:#x}", information_field.width, information_field.height, information_field.x_location, information_field.y_location, information_field.flags);
  733. // 7.4.6.2 Generic region segment flags
  734. if (data.is_empty())
  735. return Error::from_string_literal("JBIG2ImageDecoderPlugin: No segment data");
  736. u8 flags = data[0];
  737. bool uses_mmr = (flags & 1) != 0;
  738. u8 arithmetic_coding_template = (flags >> 1) & 3; // "GBTEMPLATE"
  739. bool typical_prediction_generic_decoding_on = (flags >> 3) & 1; // "TPGDON"; "TPGD" is short for "Typical Prediction for Generic Direct coding"
  740. bool uses_extended_reference_template = (flags >> 4) & 1; // "EXTTEMPLATE"
  741. if (flags & 0b1110'0000)
  742. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Invalid flags");
  743. data = data.slice(sizeof(flags));
  744. // 7.4.6.3 Generic region segment AT flags
  745. GenericRegionDecodingInputParameters::AdaptiveTemplatePixel adaptive_template_pixels[12] = {};
  746. if (!uses_mmr) {
  747. dbgln_if(JBIG2_DEBUG, "Non-MMR generic region, GBTEMPLATE={} TPGDON={} EXTTEMPLATE={}", arithmetic_coding_template, typical_prediction_generic_decoding_on, uses_extended_reference_template);
  748. if (arithmetic_coding_template == 0 && uses_extended_reference_template) {
  749. // This was added in T.88 Amendment 2 (https://www.itu.int/rec/T-REC-T.88-200306-S!Amd2/en) mid-2003.
  750. // I haven't seen it being used in the wild, and the spec says "32-byte field as shown below" and then shows 24 bytes,
  751. // so it's not clear how much data to read.
  752. return Error::from_string_literal("JBIG2ImageDecoderPlugin: GBTEMPLATE=0 EXTTEMPLATE=1 not yet implemented");
  753. }
  754. size_t number_of_adaptive_template_pixels = arithmetic_coding_template == 0 ? 4 : 1;
  755. if (data.size() < 2 * number_of_adaptive_template_pixels)
  756. return Error::from_string_literal("JBIG2ImageDecoderPlugin: No adaptive template data");
  757. for (size_t i = 0; i < number_of_adaptive_template_pixels; ++i) {
  758. adaptive_template_pixels[i].x = static_cast<i8>(data[2 * i]);
  759. adaptive_template_pixels[i].y = static_cast<i8>(data[2 * i + 1]);
  760. }
  761. data = data.slice(2 * number_of_adaptive_template_pixels);
  762. }
  763. // 7.4.6.4 Decoding a generic region segment
  764. // "1) Interpret its header, as described in 7.4.6.1"
  765. // Done above.
  766. // "2) As described in E.3.7, reset all the arithmetic coding statistics to zero."
  767. // FIXME: Implement this once we support arithmetic coding.
  768. // "3) Invoke the generic region decoding procedure described in 6.2, with the parameters to the generic region decoding procedure set as shown in Table 37."
  769. GenericRegionDecodingInputParameters inputs;
  770. inputs.is_modified_modified_read = uses_mmr;
  771. inputs.region_width = information_field.width;
  772. inputs.region_height = information_field.height;
  773. inputs.gb_template = arithmetic_coding_template;
  774. inputs.is_typical_prediction_used = typical_prediction_generic_decoding_on;
  775. inputs.is_extended_reference_template_used = uses_extended_reference_template;
  776. inputs.skip_pattern = OptionalNone {};
  777. static_assert(sizeof(inputs.adaptive_template_pixels) == sizeof(adaptive_template_pixels));
  778. memcpy(inputs.adaptive_template_pixels, adaptive_template_pixels, sizeof(adaptive_template_pixels));
  779. auto result = TRY(generic_region_decoding_procedure(inputs, data));
  780. // 8.2 Page image composition step 5)
  781. if (information_field.x_location + information_field.width > (u32)context.page.size.width()
  782. || information_field.y_location + information_field.height > (u32)context.page.size.height()) {
  783. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Region bounds outsize of page bounds");
  784. }
  785. if (information_field.external_combination_operator() != RegionSegmentInformationField::CombinationOperator::Or
  786. && information_field.external_combination_operator() != RegionSegmentInformationField::CombinationOperator::Xor
  787. && information_field.external_combination_operator() != RegionSegmentInformationField::CombinationOperator::Replace)
  788. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot handle external combination operator other than OR, XOR, and REPLACE yet");
  789. for (size_t y = 0; y < information_field.height; ++y) {
  790. for (size_t x = 0; x < information_field.width; ++x) {
  791. // FIXME: Honor segment's combination operator instead of just copying.
  792. context.page.bits->set_bit(information_field.x_location + x, information_field.y_location + y, result->get_bit(x, y));
  793. }
  794. }
  795. return {};
  796. }
  797. static ErrorOr<void> decode_intermediate_generic_refinement_region(JBIG2LoadingContext&, SegmentData const&)
  798. {
  799. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode intermediate generic refinement region yet");
  800. }
  801. static ErrorOr<void> decode_immediate_generic_refinement_region(JBIG2LoadingContext&, SegmentData const&)
  802. {
  803. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode immediate generic refinement region yet");
  804. }
  805. static ErrorOr<void> decode_immediate_lossless_generic_refinement_region(JBIG2LoadingContext&, SegmentData const&)
  806. {
  807. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode immediate lossless generic refinement region yet");
  808. }
  809. static ErrorOr<void> decode_page_information(JBIG2LoadingContext& context, SegmentData const& segment)
  810. {
  811. // 7.4.8 Page information segment syntax and 8.1 Decoder model steps 1) - 3).
  812. // "1) Decode the page information segment.""
  813. auto page_information = TRY(decode_page_information_segment(segment.data));
  814. bool page_is_striped = (page_information.striping_information & 0x80) != 0;
  815. if (page_information.bitmap_height == 0xffff'ffff && !page_is_striped)
  816. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Non-striped bitmaps of indeterminate height not allowed");
  817. u8 default_color = (page_information.flags >> 2) & 1;
  818. u8 default_combination_operator = (page_information.flags >> 3) & 3;
  819. context.page.default_combination_operator = static_cast<CombinationOperator>(default_combination_operator);
  820. // FIXME: Do something with the other fields in page_information.
  821. // "2) Create the page buffer, of the size given in the page information segment.
  822. //
  823. // If the page height is unknown, then this is not possible. However, in this case the page must be striped,
  824. // and the maximum stripe height specified, and the initial page buffer can be created with height initially
  825. // equal to this maximum stripe height."
  826. size_t height = page_information.bitmap_height;
  827. if (height == 0xffff'ffff)
  828. height = page_information.striping_information & 0x7F;
  829. context.page.bits = TRY(BitBuffer::create(page_information.bitmap_width, height));
  830. // "3) Fill the page buffer with the page's default pixel value."
  831. if (default_color == 1)
  832. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Can only handle white default color for now");
  833. context.page.bits->fill(default_color != 0);
  834. return {};
  835. }
  836. static ErrorOr<void> decode_end_of_page(JBIG2LoadingContext&, SegmentData const& segment)
  837. {
  838. // 7.4.9 End of page segment syntax
  839. if (segment.data.size() != 0)
  840. return Error::from_string_literal("JBIG2ImageDecoderPlugin: End of page segment has non-zero size");
  841. // FIXME: If the page had unknown height, check that previous segment was end-of-stripe.
  842. // FIXME: Maybe mark page as completed and error if we see more segments for it?
  843. return {};
  844. }
  845. static ErrorOr<void> decode_end_of_stripe(JBIG2LoadingContext&, SegmentData const&)
  846. {
  847. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode end of stripe yet");
  848. }
  849. static ErrorOr<void> decode_end_of_file(JBIG2LoadingContext&, SegmentData const& segment)
  850. {
  851. // 7.4.11 End of file segment syntax
  852. if (segment.data.size() != 0)
  853. return Error::from_string_literal("JBIG2ImageDecoderPlugin: End of file segment has non-zero size");
  854. return {};
  855. }
  856. static ErrorOr<void> decode_profiles(JBIG2LoadingContext&, SegmentData const&)
  857. {
  858. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode profiles yet");
  859. }
  860. static ErrorOr<void> decode_tables(JBIG2LoadingContext&, SegmentData const&)
  861. {
  862. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode tables yet");
  863. }
  864. static ErrorOr<void> decode_color_palette(JBIG2LoadingContext&, SegmentData const&)
  865. {
  866. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Cannot decode color palette yet");
  867. }
  868. static ErrorOr<void> decode_extension(JBIG2LoadingContext&, SegmentData const& segment)
  869. {
  870. // 7.4.14 Extension segment syntax
  871. FixedMemoryStream stream { segment.data };
  872. enum ExtensionType {
  873. SingleByteCodedComment = 0x20000000,
  874. MultiByteCodedComment = 0x20000002,
  875. };
  876. u32 type = TRY(stream.read_value<BigEndian<u32>>());
  877. auto read_string = [&]<class T>() -> ErrorOr<Vector<T>> {
  878. Vector<T> result;
  879. do {
  880. result.append(TRY(stream.read_value<BigEndian<T>>()));
  881. } while (result.last());
  882. result.take_last();
  883. return result;
  884. };
  885. switch (type) {
  886. case SingleByteCodedComment: {
  887. // 7.4.15.1 Single-byte coded comment
  888. // Pairs of zero-terminated ISO/IEC 8859-1 (latin1) pairs, terminated by another \0.
  889. while (true) {
  890. auto first_bytes = TRY(read_string.template operator()<u8>());
  891. if (first_bytes.is_empty())
  892. break;
  893. auto second_bytes = TRY(read_string.template operator()<u8>());
  894. auto first = TRY(TextCodec::decoder_for("ISO-8859-1"sv)->to_utf8(StringView { first_bytes }));
  895. auto second = TRY(TextCodec::decoder_for("ISO-8859-1"sv)->to_utf8(StringView { second_bytes }));
  896. dbgln("JBIG2ImageDecoderPlugin: key '{}', value '{}'", first, second);
  897. }
  898. if (!stream.is_eof())
  899. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Trailing data after SingleByteCodedComment");
  900. return {};
  901. }
  902. case MultiByteCodedComment: {
  903. // 7.4.15.2 Multi-byte coded comment
  904. // Pairs of (two-byte-)zero-terminated UCS-2 pairs, terminated by another \0\0.
  905. while (true) {
  906. auto first_ucs2 = TRY(read_string.template operator()<u16>());
  907. if (first_ucs2.is_empty())
  908. break;
  909. auto second_ucs2 = TRY(read_string.template operator()<u16>());
  910. auto first = TRY(Utf16View(first_ucs2).to_utf8());
  911. auto second = TRY(Utf16View(second_ucs2).to_utf8());
  912. dbgln("JBIG2ImageDecoderPlugin: key '{}', value '{}'", first, second);
  913. }
  914. if (!stream.is_eof())
  915. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Trailing data after MultiByteCodedComment");
  916. return {};
  917. }
  918. }
  919. // FIXME: If bit 31 in `type` is not set, the extension isn't necessary, and we could ignore it.
  920. dbgln("JBIG2ImageDecoderPlugin: Unknown extension type {:#x}", type);
  921. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Unknown extension type");
  922. }
  923. static ErrorOr<void> decode_data(JBIG2LoadingContext& context)
  924. {
  925. TRY(warn_about_multiple_pages(context));
  926. for (size_t i = 0; i < context.segments.size(); ++i) {
  927. auto const& segment = context.segments[i];
  928. if (segment.header.page_association != 0 && segment.header.page_association != 1)
  929. continue;
  930. switch (segment.header.type) {
  931. case SegmentType::SymbolDictionary:
  932. TRY(decode_symbol_dictionary(context, segment));
  933. break;
  934. case SegmentType::IntermediateTextRegion:
  935. TRY(decode_intermediate_text_region(context, segment));
  936. break;
  937. case SegmentType::ImmediateTextRegion:
  938. TRY(decode_immediate_text_region(context, segment));
  939. break;
  940. case SegmentType::ImmediateLosslessTextRegion:
  941. TRY(decode_immediate_lossless_text_region(context, segment));
  942. break;
  943. case SegmentType::PatternDictionary:
  944. TRY(decode_pattern_dictionary(context, segment));
  945. break;
  946. case SegmentType::IntermediateHalftoneRegion:
  947. TRY(decode_intermediate_halftone_region(context, segment));
  948. break;
  949. case SegmentType::ImmediateHalftoneRegion:
  950. TRY(decode_immediate_halftone_region(context, segment));
  951. break;
  952. case SegmentType::ImmediateLosslessHalftoneRegion:
  953. TRY(decode_immediate_lossless_halftone_region(context, segment));
  954. break;
  955. case SegmentType::IntermediateGenericRegion:
  956. TRY(decode_intermediate_generic_region(context, segment));
  957. break;
  958. case SegmentType::ImmediateGenericRegion:
  959. case SegmentType::ImmediateLosslessGenericRegion:
  960. // 7.4.6 Generic region segment syntax
  961. // "The data parts of all three of the generic region segment types ("intermediate generic region", "immediate generic region" and
  962. // "immediate lossless generic region") are coded identically, but are acted upon differently, see 8.2."
  963. // But 8.2 only describes a difference between intermediate and immediate regions as far as I can tell,
  964. // and calling the immediate generic region handler for immediate generic lossless regions seems to do the right thing (?).
  965. TRY(decode_immediate_generic_region(context, segment));
  966. break;
  967. case SegmentType::IntermediateGenericRefinementRegion:
  968. TRY(decode_intermediate_generic_refinement_region(context, segment));
  969. break;
  970. case SegmentType::ImmediateGenericRefinementRegion:
  971. TRY(decode_immediate_generic_refinement_region(context, segment));
  972. break;
  973. case SegmentType::ImmediateLosslessGenericRefinementRegion:
  974. TRY(decode_immediate_lossless_generic_refinement_region(context, segment));
  975. break;
  976. case SegmentType::PageInformation:
  977. TRY(decode_page_information(context, segment));
  978. break;
  979. case SegmentType::EndOfPage:
  980. TRY(decode_end_of_page(context, segment));
  981. break;
  982. case SegmentType::EndOfStripe:
  983. TRY(decode_end_of_stripe(context, segment));
  984. break;
  985. case SegmentType::EndOfFile:
  986. TRY(decode_end_of_file(context, segment));
  987. // "If a file contains an end of file segment, it must be the last segment."
  988. if (i != context.segments.size() - 1)
  989. return Error::from_string_literal("JBIG2ImageDecoderPlugin: End of file segment not last segment");
  990. break;
  991. case SegmentType::Profiles:
  992. TRY(decode_profiles(context, segment));
  993. break;
  994. case SegmentType::Tables:
  995. TRY(decode_tables(context, segment));
  996. break;
  997. case SegmentType::ColorPalette:
  998. TRY(decode_color_palette(context, segment));
  999. break;
  1000. case SegmentType::Extension:
  1001. TRY(decode_extension(context, segment));
  1002. break;
  1003. }
  1004. }
  1005. return {};
  1006. }
  1007. JBIG2ImageDecoderPlugin::JBIG2ImageDecoderPlugin()
  1008. {
  1009. m_context = make<JBIG2LoadingContext>();
  1010. }
  1011. IntSize JBIG2ImageDecoderPlugin::size()
  1012. {
  1013. return m_context->page.size;
  1014. }
  1015. bool JBIG2ImageDecoderPlugin::sniff(ReadonlyBytes data)
  1016. {
  1017. return data.starts_with(id_string);
  1018. }
  1019. ErrorOr<NonnullOwnPtr<ImageDecoderPlugin>> JBIG2ImageDecoderPlugin::create(ReadonlyBytes data)
  1020. {
  1021. auto plugin = TRY(adopt_nonnull_own_or_enomem(new (nothrow) JBIG2ImageDecoderPlugin()));
  1022. TRY(decode_jbig2_header(*plugin->m_context, data));
  1023. data = data.slice(sizeof(id_string) + sizeof(u8) + (plugin->m_context->number_of_pages.has_value() ? sizeof(u32) : 0));
  1024. TRY(decode_segment_headers(*plugin->m_context, data));
  1025. TRY(scan_for_page_size(*plugin->m_context));
  1026. return plugin;
  1027. }
  1028. ErrorOr<ImageFrameDescriptor> JBIG2ImageDecoderPlugin::frame(size_t index, Optional<IntSize>)
  1029. {
  1030. // FIXME: Use this for multi-page JBIG2 files?
  1031. if (index != 0)
  1032. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Invalid frame index");
  1033. if (m_context->state == JBIG2LoadingContext::State::Error)
  1034. return Error::from_string_literal("JBIG2ImageDecoderPlugin: Decoding failed");
  1035. if (m_context->state < JBIG2LoadingContext::State::Decoded) {
  1036. auto result = decode_data(*m_context);
  1037. if (result.is_error()) {
  1038. m_context->state = JBIG2LoadingContext::State::Error;
  1039. return result.release_error();
  1040. }
  1041. m_context->state = JBIG2LoadingContext::State::Decoded;
  1042. }
  1043. auto bitmap = TRY(m_context->page.bits->to_gfx_bitmap());
  1044. return ImageFrameDescriptor { move(bitmap), 0 };
  1045. }
  1046. ErrorOr<ByteBuffer> JBIG2ImageDecoderPlugin::decode_embedded(Vector<ReadonlyBytes> data)
  1047. {
  1048. auto plugin = TRY(adopt_nonnull_own_or_enomem(new (nothrow) JBIG2ImageDecoderPlugin()));
  1049. plugin->m_context->organization = Organization::Embedded;
  1050. for (auto const& segment_data : data)
  1051. TRY(decode_segment_headers(*plugin->m_context, segment_data));
  1052. TRY(scan_for_page_size(*plugin->m_context));
  1053. TRY(decode_data(*plugin->m_context));
  1054. return plugin->m_context->page.bits->to_byte_buffer();
  1055. }
  1056. }