image_t Struct Reference

Image structure. More...

#include <lib/video/image.h>

Data Fields
int	w
	Image width in pixels (must be > 0)
int	h
	Image height in pixels (must be > 0)
rgb_pixel_t *	pixels
	Pixel data array (width * height RGB pixels, row-major order)
uint8_t	alloc_method
	Allocation method (image_alloc_method_t) for correct deallocation.

Detailed Description

Image structure.

Complete image structure containing dimensions and pixel data. Pixel data is stored as a contiguous array of RGB pixels in row-major order. Compatible with webcam capture and image processing pipeline.

MEMORY LAYOUT:

• pixels array is allocated separately from image structure (except for pool alloc)
• pixels array size: width * height * sizeof(rgb_pixel_t)
• Pixel access: pixels[row * width + col]
• Row-major order (first row, then second row, etc.)

Note

Pixel array must be allocated (by image_new() or image_new_from_pool()).

Image structure and pixels array can be freed separately if needed.

Compatible with webcam capture functions (webcam_read()).

alloc_method tracks allocation source for correct deallocation.

Definition at line 141 of file video/image.h.

Field Documentation

alloc_method

uint8_t image_t::alloc_method

Allocation method (image_alloc_method_t) for correct deallocation.

Definition at line 145 of file video/image.h.

Referenced by image_destroy(), image_new(), and image_new_from_pool().

h

int image_t::h

Image height in pixels (must be > 0)

Definition at line 143 of file video/image.h.

Referenced by ascii_convert(), ascii_convert_with_capabilities(), benchmark_simd_color_conversion_with_source(), benchmark_simd_conversion_with_source(), convert_pixels_scalar_with_newlines(), image_clear(), image_destroy(), image_destroy_to_pool(), image_new(), image_new_from_pool(), image_pixel(), image_print(), image_print_16color(), image_print_16color_dithered(), image_print_16color_dithered_with_background(), image_print_color(), image_print_with_capabilities(), image_resize_interpolation(), and webcam_read().

pixels

rgb_pixel_t* image_t::pixels

Pixel data array (width * height RGB pixels, row-major order)

Definition at line 144 of file video/image.h.

Referenced by ascii_convert(), benchmark_simd_color_conversion(), benchmark_simd_color_conversion_with_source(), benchmark_simd_conversion(), benchmark_simd_conversion_with_source(), convert_pixels_scalar_with_newlines(), image_clear(), image_destroy(), image_new(), image_new_from_pool(), image_pixel(), image_print(), image_print_16color(), image_print_16color_dithered(), image_print_16color_dithered_with_background(), image_print_256color(), image_print_color(), image_print_with_capabilities(), image_resize_interpolation(), and webcam_read().

w

int image_t::w

Image width in pixels (must be > 0)

Definition at line 142 of file video/image.h.

Referenced by ascii_convert(), ascii_convert_with_capabilities(), benchmark_simd_color_conversion_with_source(), benchmark_simd_conversion_with_source(), convert_pixels_scalar_with_newlines(), image_clear(), image_destroy(), image_destroy_to_pool(), image_new(), image_new_from_pool(), image_pixel(), image_print(), image_print_16color(), image_print_16color_dithered(), image_print_16color_dithered_with_background(), image_print_color(), image_print_with_capabilities(), image_resize_interpolation(), and webcam_read().

---

The documentation for this struct was generated from the following file:

• video/image.h