runtime_image.h

Go to the documentation of this file.

#pragma once
 
#include "esphome/components/image/image.h"
#include "esphome/core/helpers.h"
 
namespace esphome::runtime_image {
 
// Forward declaration
class ImageDecoder;
 
enum ImageFormat {
  AUTO,
  JPEG,
  PNG,
  BMP,
};
 
class RuntimeImage : public image::Image {
 public:
  RuntimeImage(ImageFormat format, image::ImageType type, image::Transparency transparency,
               image::Image *placeholder = nullptr, bool is_big_endian = false, int fixed_width = 0,
               int fixed_height = 0);
 
  ~RuntimeImage();
 
  // Decoder interface methods
  int resize(int width, int height);
  void draw_pixel(int x, int y, const Color &color);
  void map_chroma_key(Color &color);
  int get_buffer_width() const { return this->buffer_width_; }
  int get_buffer_height() const { return this->buffer_height_; }
 
  // Image drawing interface
  void draw(int x, int y, display::Display *display, Color color_on, Color color_off) override;
 
  bool begin_decode(size_t expected_size = 0);
 
  int feed_data(uint8_t *data, size_t len);
 
  bool end_decode();
 
  bool is_decoding() const { return this->decoder_ != nullptr; }
 
  bool is_decode_finished() const;
 
  bool is_loaded() const { return this->buffer_ != nullptr; }
 
  ImageFormat get_format() const { return this->format_; }
 
  void release();
 
  void set_progressive_display(bool progressive) { this->progressive_display_ = progressive; }
 
 protected:
  size_t resize_buffer_(int width, int height);
 
  void release_buffer_();
 
  size_t get_buffer_size_(int width, int height) const;
 
  int get_position_(int x, int y) const;
 
  std::unique_ptr<ImageDecoder> create_decoder_();
 
  // Memory management
  RAMAllocator<uint8_t> allocator_{};
  uint8_t *buffer_{nullptr};
 
  // Decoder management
  std::unique_ptr<ImageDecoder> decoder_{nullptr};
  const ImageFormat format_;
 
  int buffer_width_{0};
  int buffer_height_{0};
 
  // Decoding state
  size_t total_size_{0};
  size_t decoded_bytes_{0};
 
  const int fixed_width_{0};
  const int fixed_height_{0};
 
  image::Image *placeholder_{nullptr};
 
  // Configuration
  bool progressive_display_{false};
  bool is_big_endian_{false};
};
 
}  // namespace esphome::runtime_image