lzw_decompressor.h

Go to the documentation of this file.

// Copyright 2017 The PDFium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
 
// Original code copyright 2014 Foxit Software Inc. http://www.foxitsoftware.com
 
#ifndef CORE_FXCODEC_GIF_LZW_DECOMPRESSOR_H_
#define CORE_FXCODEC_GIF_LZW_DECOMPRESSOR_H_
 
#include <stddef.h>
#include <stdint.h>
 
#include <array>
#include <memory>
 
#include "core/fxcodec/gif/cfx_gif.h"
#include "core/fxcrt/compiler_specific.h"
#include "core/fxcrt/data_vector.h"
#include "core/fxcrt/span.h"
 
namespace fxcodec {
 
class LZWDecompressor {
 public:
  enum class Status {
    kError,
    kSuccess,
    kUnfinished,
    kInsufficientDestSize,
  };
 
  struct CodeEntry {
    uint16_t prefix;
    uint8_t suffix;
  };
 
  // Returns nullptr on error
  static std::unique_ptr<LZWDecompressor> Create(uint8_t color_exp,
                                                 uint8_t code_exp);
  ~LZWDecompressor();
 
  void SetSource(pdfium::span<const uint8_t> src_buf) {
    avail_input_ = src_buf;
  }
  UNSAFE_BUFFER_USAGE Status Decode(uint8_t* dest_buf, uint32_t* dest_size);
 
  // Used by unittests, should not be called in production code.
  size_t ExtractDataForTest(pdfium::span<uint8_t> dest_buf) {
    return ExtractData(dest_buf);
  }
 
  DataVector<uint8_t>* DecompressedForTest() { return &decompressed_; }
  size_t* DecompressedNextForTest() { return &decompressed_next_; }
 
 private:
  // Use Create() instead.
  LZWDecompressor(uint8_t color_exp, uint8_t code_exp);
 
  void ClearTable();
  void AddCode(uint16_t prefix_code, uint8_t append_char);
  bool DecodeString(uint16_t code);
  size_t ExtractData(pdfium::span<uint8_t> dest_buf);
 
  const uint8_t code_size_;
  uint8_t code_size_cur_ = 0;
  const uint16_t code_color_end_;
  const uint16_t code_clear_;
  const uint16_t code_end_;
  uint16_t code_next_ = 0;
  uint8_t code_first_ = 0;
  DataVector<uint8_t> decompressed_;
  size_t decompressed_next_ = 0;
  uint16_t code_old_ = 0;
  pdfium::span<const uint8_t> avail_input_;
  uint8_t bits_left_ = 0;
  uint32_t code_store_ = 0;
  std::array<CodeEntry, GIF_MAX_LZW_CODE> code_table_;
};
 
}  // namespace fxcodec
 
using LZWDecompressor = fxcodec::LZWDecompressor;
 
#endif  // CORE_FXCODEC_GIF_LZW_DECOMPRESSOR_H_