// nextion_components.h #pragma once #include #include #include namespace nspanel_ha_blueprint { struct NextionComponent { char page[15]; // 14 characters + null terminator, representing the Nextion display page char component_id[15]; // 14 characters + null terminator, representing the component ID within the page bool is_current_page; // Flag indicating whether the component is on the current page }; /** * Extracts the page name and component ID from a given input string. * If the input string omits the page, a default page name is used. * Handles a special case for "alarm_control_panel" by shortening it to "alarm". * * @param input The input string containing the component ID, optionally prefixed by the page name and a dot. * @param defaultPage The default page name to use if the input string does not specify a page. * @return A NextionComponent struct with the extracted or default page name, component ID, and current page status. */ NextionComponent extractNextionComponent(const std::string& input, const std::string& defaultPage); /** * Converts an RGB color represented as a vector of integers to the 16-bit 5-6-5 format supported by Nextion displays. * * This function takes a vector containing three integer values representing * the red, green, and blue components of an RGB color, each in the range 0-255. * It then converts these values into a single uint16_t value in 5-6-5 format, * commonly used for color displays. The conversion process masks and shifts * the components to fit into the 5 bits for red, 6 bits for green, and 5 bits for blue. * * @param rgb A vector of integers with exactly three elements: [red, green, blue]. * @return The color encoded in 16-bit 5-6-5 format, or UINT16_MAX if the input vector * does not contain at least three elements. */ template inline uint16_t rgbTo565(const Container& rgb) { if (rgb.size() != 3) { return UINT16_MAX; // Use UINT16_MAX as an error indicator } return ((rgb[0] & 0xF8) << 8) | ((rgb[1] & 0xFC) << 3) | (rgb[2] >> 3); } } // namespace nspanel_ha_blueprint