esphome::online_image::ImageDecoder Class Reference

Class to abstract decoding different image formats. More...

#include <image_decoder.h>

Inheritance diagram for esphome::online_image::ImageDecoder:

Public Member Functions
	ImageDecoder (OnlineImage *image)
	Construct a new Image Decoder object. More...
virtual	~ImageDecoder ()=default
virtual void	prepare (uint32_t download_size)
	Initialize the decoder. More...
virtual int	decode (uint8_t *buffer, size_t size)
	Decode a part of the image. More...
void	set_size (int width, int height)
	Request the image to be resized once the actual dimensions are known. More...
void	draw (int x, int y, int w, int h, const Color &color)
	Draw a rectangle on the display_buffer using the defined color. More...
bool	is_finished () const

Protected Attributes
OnlineImage *	image_
uint32_t	download_size_ = 1
uint32_t	decoded_bytes_ = 0
double	x_scale_ = 1.0
double	y_scale_ = 1.0

Detailed Description

Class to abstract decoding different image formats.

Definition at line 13 of file image_decoder.h.

Constructor & Destructor Documentation

ImageDecoder()

esphome::online_image::ImageDecoder::ImageDecoder ( OnlineImage *  image )

inline

Construct a new Image Decoder object.

Parameters

image

The image to decode the stream into.

Definition at line 20 of file image_decoder.h.

~ImageDecoder()

virtual esphome::online_image::ImageDecoder::~ImageDecoder ( )

virtualdefault

Member Function Documentation

decode()

virtual int esphome::online_image::ImageDecoder::decode ( uint8_t *  buffer, size_t  size  )

virtual

Decode a part of the image.

It will try reading from the buffer. There is no guarantee that the whole available buffer will be read/decoded; the method will return the amount of bytes actually decoded, so that the unread content can be moved to the beginning.

Parameters

buffer	The buffer to read from.
size	The maximum amount of bytes that can be read from the buffer.

Returns

int The amount of bytes read. It can be 0 if the buffer does not have enough content to meaningfully decode anything, or negative in case of a decoding error.

Reimplemented in esphome::online_image::PngDecoder.

draw()

void esphome::online_image::ImageDecoder::draw	(	int	x,
		int	y,
		int	w,
		int	h,
		const Color &	color
	)

Draw a rectangle on the display_buffer using the defined color.

Will check the given coordinates for out-of-bounds, and clip the rectangle accordingly. In case of binary displays, the color will be converted to binary as well. Called by the callback functions, to be able to access the parent Image class.

Parameters

x	The left-most coordinate of the rectangle.
y	The top-most coordinate of the rectangle.
w	The width of the rectangle.
h	The height of the rectangle.
color	The color to draw the rectangle with.

Definition at line 17 of file image_decoder.cpp.

is_finished()

bool esphome::online_image::ImageDecoder::is_finished ( ) const

inline

Definition at line 66 of file image_decoder.h.

prepare()

virtual void esphome::online_image::ImageDecoder::prepare ( uint32_t  download_size )

inlinevirtual

Initialize the decoder.

Parameters

download_size

The total number of bytes that need to be download for the image.

Reimplemented in esphome::online_image::PngDecoder.

Definition at line 28 of file image_decoder.h.

set_size()

void esphome::online_image::ImageDecoder::set_size	(	int	width,
		int	height
	)

Request the image to be resized once the actual dimensions are known.

Called by the callback functions, to be able to access the parent Image class.

Parameters

width	The image's width.
height	The image's height.

Definition at line 11 of file image_decoder.cpp.

Field Documentation

decoded_bytes_

uint32_t esphome::online_image::ImageDecoder::decoded_bytes_ = 0

protected

Definition at line 73 of file image_decoder.h.

download_size_

uint32_t esphome::online_image::ImageDecoder::download_size_ = 1

protected

Definition at line 72 of file image_decoder.h.

image_

OnlineImage* esphome::online_image::ImageDecoder::image_

protected

Definition at line 69 of file image_decoder.h.

x_scale_

double esphome::online_image::ImageDecoder::x_scale_ = 1.0

protected

Definition at line 74 of file image_decoder.h.

y_scale_

double esphome::online_image::ImageDecoder::y_scale_ = 1.0

protected

Definition at line 75 of file image_decoder.h.

---

The documentation for this class was generated from the following files:

• /opt/build/esphome/esphome/components/online_image/image_decoder.h
• /opt/build/esphome/esphome/components/online_image/image_decoder.cpp