host_api_display.cpp

Go to the documentation of this file.

 
#include "plugin_manager/host_api.h"
#include "plugin_manager/Plugin.h"
#include "cdc_hal/IDisplay.h"
#include "cdc_views/RenderHelpers.h"
#include "host_str_conv.h"
#include <goodisplay/gdey029T94.h>
#include <string>
 
extern "C" void* plg_get_active_plugin(void);
 
namespace {
 
cdc::plugin_manager::Plugin* active() {
    return static_cast<cdc::plugin_manager::Plugin*>(plg_get_active_plugin());
}
 
bool allowed() {
    auto* p = active();
    return p && p->manifest().capabilities.display_lowlevel;
}
 
cdc::hal::IDisplay* disp() { return cdc::hal::getDisplayInstance(); }
 
}  // namespace
 
extern "C" {
 
uint16_t host_display_width(void)
{
    auto* d = disp();
    return (allowed() && d) ? d->getWidth() : 0;
}
 
uint16_t host_display_height(void)
{
    auto* d = disp();
    return (allowed() && d) ? d->getHeight() : 0;
}
 
int host_display_clear(void)
{
    if (!allowed()) return HOST_ERR_NO_CAPABILITY;
    auto* d = disp();
    if (!d) return HOST_ERR_GENERIC;
    d->clear();
    return HOST_OK;
}
 
int host_display_draw_pixel(int16_t x, int16_t y, uint16_t color)
{
    if (!allowed()) return HOST_ERR_NO_CAPABILITY;
    auto* d = disp();
    if (!d) return HOST_ERR_GENERIC;
    d->drawPixel(x, y, color);
    return HOST_OK;
}
 
int host_display_draw_line(int16_t x0, int16_t y0, int16_t x1, int16_t y1, uint16_t color)
{
    if (!allowed()) return HOST_ERR_NO_CAPABILITY;
    auto* d = disp();
    if (!d) return HOST_ERR_GENERIC;
    d->drawLine(x0, y0, x1, y1, color);
    return HOST_OK;
}
 
int host_display_draw_rect(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color)
{
    if (!allowed()) return HOST_ERR_NO_CAPABILITY;
    auto* d = disp();
    if (!d) return HOST_ERR_GENERIC;
    d->drawRect(x, y, w, h, color);
    return HOST_OK;
}
 
int host_display_fill_rect(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color)
{
    if (!allowed()) return HOST_ERR_NO_CAPABILITY;
    auto* d = disp();
    if (!d) return HOST_ERR_GENERIC;
    d->fillRect(x, y, w, h, color);
    return HOST_OK;
}
 
int host_display_draw_text(int16_t x, int16_t y, const char* text, uint8_t size, uint16_t color)
{
    if (!allowed()) return HOST_ERR_NO_CAPABILITY;
    if (!text) return HOST_ERR_INVALID_ARG;
    auto* d = disp();
    if (!d) return HOST_ERR_GENERIC;
    auto* gfx = static_cast<Gdey029T94*>(d->getNativeHandle());
    if (!gfx) return HOST_ERR_GENERIC;
    d->setTextSize(size ? size : 1);
    d->setTextColor(color);
    d->setCursor(x, y);
    cdc::ui::render::printText(gfx, cdc::plugin_manager::toDisplay(text).c_str());
    return HOST_OK;
}
 
// refresh_mode: 0 = FULL, 1 = PARTIAL, 2 = FAST (single-flash waveform).
// Plugins choose per flush; explicit FULL/FAST also reset the HAL ghost
// escalation counters, so high-churn apps (e.g. games) can keep their own
// panel hygiene. Unknown values map to FULL for backward compatibility.
int host_display_flush(uint8_t refresh_mode)
{
    if (!allowed()) return HOST_ERR_NO_CAPABILITY;
    auto* d = disp();
    if (!d) return HOST_ERR_GENERIC;
    cdc::hal::RefreshMode mode = cdc::hal::RefreshMode::FULL;
    if (refresh_mode == 1) mode = cdc::hal::RefreshMode::PARTIAL;
    else if (refresh_mode == 2) mode = cdc::hal::RefreshMode::FAST;
    d->flush(mode);
    return HOST_OK;
}
 
bool host_display_is_busy(void)
{
    auto* d = disp();
    return (allowed() && d) ? d->isBusy() : false;
}
 
// Backlight control is not framebuffer access, so - like host_ui_wink - it is
// NOT gated on the display_lowlevel capability. The value is applied live and
// is NOT persisted to NVS (the firmware persists only via saveBacklight()).
int host_display_set_backlight(uint16_t level)
{
    auto* d = disp();
    if (!d) return HOST_ERR_GENERIC;
    d->setBacklight(level);  // clamped to the panel maximum inside the HAL
    return HOST_OK;
}
 
uint16_t host_display_get_backlight(void)
{
    auto* d = disp();
    return d ? d->getBacklight() : 0;
}
 
}  // extern "C"