panel.hpp

Go to the documentation of this file.

// SPDX-License-Identifier: Apache-2.0
// Copyright 2026 Chris Leishman
 
#pragma once
 
#include <idfxx/error>
#include <idfxx/gpio>
#include <idfxx/lcd/color>
 
struct esp_lcd_panel_t;
typedef struct esp_lcd_panel_t* esp_lcd_panel_handle_t;
 
namespace idfxx::lcd {
 
class panel {
public:
    struct config {
        gpio reset_gpio = gpio::nc();             
        enum rgb_element_order rgb_element_order; 
        rgb_data_endian data_endian = rgb_data_endian::big; 
        uint32_t bits_per_pixel;                            
        struct {
            unsigned int reset_active_high : 1 = 0; 
        } flags = {};                               
        void* vendor_config = nullptr; 
    };
 
    virtual ~panel() = default;
 
    [[nodiscard]] virtual esp_lcd_panel_handle_t idf_handle() const = 0;
 
#ifdef CONFIG_COMPILER_CXX_EXCEPTIONS
    virtual void swap_xy(bool swap) { unwrap(try_swap_xy(swap)); }
#endif
 
    [[nodiscard]] virtual result<void> try_swap_xy(bool swap) = 0;
 
#ifdef CONFIG_COMPILER_CXX_EXCEPTIONS
    virtual void mirror(bool mirrorX, bool mirrorY) { unwrap(try_mirror(mirrorX, mirrorY)); }
#endif
 
    [[nodiscard]] virtual result<void> try_mirror(bool mirrorX, bool mirrorY) = 0;
 
#ifdef CONFIG_COMPILER_CXX_EXCEPTIONS
    virtual void display_on(bool on) { unwrap(try_display_on(on)); }
#endif
 
    [[nodiscard]] virtual result<void> try_display_on(bool on) = 0;
};
 
} // namespace idfxx::lcd