ListView.cpp

Go to the documentation of this file.

 
#include "cdc_views/ListView.h"
#include "cdc_views/KeyCodes.h"
#include "cdc_views/LayoutConstants.h"
#include "cdc_views/RenderHelpers.h"
#include "cdc_ui/ViewStack.h"
#include "cdc_ui/I18n.h"
#include "cdc_hal/IDisplay.h"
#include "cdc_core/Raii.h"
#include "cdc_log.h"
#include <goodisplay/gdey029T94.h>
 
static const char* TAG = "ListView";

static constexpr int TITLE_Y = 5;
static constexpr int LIST_START_Y = 30;
static constexpr int ITEM_PADDING_X = 10;
using cdc::ui::layout::SCROLL_INDICATOR_WIDTH;

static constexpr uint8_t VISIBLE_ITEMS = 4;
 
namespace cdc::ui {

void ListView::init(const char* title, const ListItem* items, uint16_t count) {
    title_ = title;
    items_ = items;
    itemCount_ = count > MAX_ITEMS ? MAX_ITEMS : count;
 
    // Only reset position if not preserving (for back-navigation)
    if (!preservePosition_) {
        selection_ = 0;
        scrollPos_ = 0;
    } else {
        preservePosition_ = false;
        if (selection_ >= itemCount_) {
            selection_ = itemCount_ > 0 ? itemCount_ - 1 : 0;
        }
        ensureVisible();
    }
    visibleItems_ = VISIBLE_ITEMS;
    dirty_ = true;
 
    LOG_D(TAG, "init: title='%s', items=%d, visible=%d", title, itemCount_, visibleItems_);
}

void ListView::setSelection(uint16_t index) {
    if (index < itemCount_ && index != selection_) {
        selection_ = index;
        ensureVisible();
        dirty_ = true;
    }
}

const ListItem* ListView::getSelectedItem() const {
    if (items_ && selection_ < itemCount_) {
        return &items_[selection_];
    }
    return nullptr;
}

void ListView::navigate(bool down) {
    if (itemCount_ == 0) return;
 
    if (down) {
        if (selection_ < itemCount_ - 1) {
            selection_++;
        } else {
            // Wrap-around: bottom to top
            selection_ = 0;
            scrollPos_ = 0;
        }
    } else {
        if (selection_ > 0) {
            selection_--;
        } else {
            // Wrap-around: top to bottom
            selection_ = itemCount_ - 1;
        }
    }
 
    ensureVisible();
    dirty_ = true;
 
    LOG_D(TAG, "navigate: sel=%d, scroll=%d", selection_, scrollPos_);
}

void ListView::ensureVisible() {
    if (selection_ >= scrollPos_ + visibleItems_) {
        scrollPos_ = selection_ - visibleItems_ + 1;
    }
    if (selection_ < scrollPos_) {
        scrollPos_ = selection_;
    }
}

InputResult ListView::onKey(char key) {
    switch (key) {
        case KEY_UP: {
            cdc::core::RecursiveMutexGuard guard(editMutex_);
            navigate(false);
            return InputResult::CONSUMED;
        }
 
        case KEY_DOWN: {
            cdc::core::RecursiveMutexGuard guard(editMutex_);
            navigate(true);
            return InputResult::CONSUMED;
        }
 
        case KEY_YES: { // Select
            // Snapshot the target under the lock; the callback may re-enter the
            // call stack (plugin dispatch) and must not run while editMutex_ is
            // held, so release before invoking it.
            void* userData = nullptr;
            uint16_t sel = 0;
            bool valid = false;
            {
                cdc::core::RecursiveMutexGuard guard(editMutex_);
                if (onSelect_ && items_ && selection_ < itemCount_) {
                    sel = selection_;
                    userData = items_[selection_].userData;
                    valid = true;
                }
            }
            if (valid) {
                onSelect_(sel, userData);
                return InputResult::CONSUMED;
            }
            // No select callback bound: leave KEY_YES free for the plugin
            // (delivered via the KEY_PRESSED EventBus) instead of swallowing it.
            return InputResult::IGNORED;
        }
 
        case KEY_MENU: { // Context menu
            if (!onMenu_) return InputResult::IGNORED;
            void* userData = nullptr;
            uint16_t sel = 0xFFFF;  // sentinel: empty list / no selection
            {
                cdc::core::RecursiveMutexGuard guard(editMutex_);
                if (items_ && selection_ < itemCount_) {
                    sel = selection_;
                    userData = items_[selection_].userData;
                }
            }
            onMenu_(sel, userData);
            return InputResult::CONSUMED;
        }
 
        case KEY_NO: // Back
            return InputResult::REQUEST_POP;
 
        default:
            return InputResult::IGNORED;
    }
}
 
InputResult ListView::onLongPress(char key) {
    cdc::core::RecursiveMutexGuard guard(editMutex_);
    if (itemCount_ == 0) return InputResult::IGNORED;
    switch (key) {
        case KEY_UP:   setSelection(0); return InputResult::CONSUMED;
        case KEY_DOWN: setSelection(itemCount_ - 1); return InputResult::CONSUMED;
        default:       return InputResult::IGNORED;
    }
}

const char* ListView::getFooterHint() const {
    if (customFooter_) {
        return customFooter_;
    }
    if (customHint_) {
        return customHint_;
    }
    return ui::tr("core.hint_ok_back");
}

void ListView::render(bool partial) {
    hal::IDisplay* display = hal::getDisplayInstance();
    if (!display) return;
 
    auto* gfx = static_cast<Gdey029T94*>(display->getNativeHandle());
    if (!gfx) return;
 
    // Serialise against a cross-task writer that may re-point items_ / free the
    // backing buffer mid-render (plugin list edits). No-op when unset.
    cdc::core::RecursiveMutexGuard guard(editMutex_);
 
    const uint16_t width = display->getWidth();
    const uint16_t height = display->getHeight();
 
    if (!partial) {
        gfx->fillScreen(EPD_WHITE);
    }
 
    gfx->setFont(nullptr);  // 6x8 built-in (CP437): never inherit a leaked GFX font
    gfx->setTextColor(EPD_BLACK);
    gfx->setTextSize(1);
    gfx->setTextWrap(false);
 
    // Title + underline
    render::drawHeaderLeft(gfx, title_, ITEM_PADDING_X, TITLE_Y, width);
 
    // Items
    const int rowWidth = width - SCROLL_INDICATOR_WIDTH;
    for (uint8_t i = 0; i < visibleItems_; i++) {
        uint16_t itemIndex = scrollPos_ + i;
        int y = LIST_START_Y + i * itemHeight_;
        drawRow(gfx, itemIndex, y, rowWidth);
    }
 
    // Empty placeholder (after item rects so it's not overpainted)
    if (itemCount_ == 0 && emptyText_) {
        int16_t x1, y1;
        uint16_t w, h;
        gfx->setTextColor(EPD_BLACK);
        gfx->setTextSize(1);
        gfx->getTextBounds(emptyText_, 0, 0, &x1, &y1, &w, &h);
        int x = (width - static_cast<int>(w)) / 2;
        int y = LIST_START_Y + (visibleItems_ * itemHeight_) / 2 - h / 2;
        gfx->setCursor(x < 0 ? 0 : x, y);
        render::printText(gfx, emptyText_);
    }
 
    // Scroll indicators
    if (itemCount_ > visibleItems_) {
        int indicatorX = width - SCROLL_INDICATOR_WIDTH;
        int listHeight = visibleItems_ * itemHeight_;
        render::drawScrollIndicator(gfx, indicatorX, LIST_START_Y, listHeight,
                                    itemCount_, visibleItems_, scrollPos_);
    }
 
    // Footer with position counter
    char positionStr[16];
    const char* prefix = nullptr;
    if (itemCount_ > 0) {
        snprintf(positionStr, sizeof(positionStr), "%u/%u  ", selection_ + 1, itemCount_);
        prefix = positionStr;
    }
    const char* hint = getFooterHint();
    render::drawFooterBar(gfx, width, height, prefix, hint, true);
 
    dirty_ = false;
}

void ListView::drawRow(Gdey029T94* gfx, uint16_t itemIndex, int y, int rowWidth) {
    gfx->setFont(nullptr);
    gfx->setTextSize(1);
    gfx->setTextWrap(false);
 
    // Clear item area
    gfx->fillRect(0, y, rowWidth, itemHeight_, EPD_WHITE);
 
    if (itemIndex >= itemCount_) return;
 
    const ListItem& item = items_[itemIndex];
    bool isSelected = (itemIndex == selection_);
 
    if (isSelected) {
        gfx->fillRect(2, y + 1, rowWidth - 4, itemHeight_ - 2, EPD_BLACK);
        gfx->setTextColor(EPD_WHITE);
    } else {
        gfx->setTextColor(EPD_BLACK);
    }
 
    bool handled = false;
    if (itemRenderer_) {
        handled = itemRenderer_(gfx, item, itemIndex,
                                0, y, rowWidth, itemHeight_,
                                isSelected, itemRendererCtx_);
    }
 
    if (!handled) {
        int textX = ITEM_PADDING_X;
        if (item.icon) {
            char iconStr[2] = {static_cast<char>(item.icon), '\0'};
            gfx->setCursor(textX, y + 4);
            render::printText(gfx, iconStr);
            if (item.iconDisabled) {
                uint16_t color = isSelected ? EPD_WHITE : EPD_BLACK;
                gfx->drawLine(textX, y + 10, textX + 6, y + 10, color);
            }
            textX += 10;
        } else {
            uint16_t bullet_color = isSelected ? EPD_WHITE : EPD_BLACK;
            gfx->fillCircle(textX + 2, y + itemHeight_ / 2, 2, bullet_color);
            textX += 9;
        }
 
        gfx->setCursor(textX, y + 4);
        if (item.label) {
            render::printTruncated(gfx, item.label, rowWidth - textX - 2);
        }
    }
}

void ListView::updateItem(uint16_t index) {
    cdc::core::RecursiveMutexGuard guard(editMutex_);
    if (!items_ || index >= itemCount_) return;
    markDirty();
}

void ListView::repaintPartial() {
    markDirty();
}

void ListView::insertItem(uint16_t index) {
    cdc::core::RecursiveMutexGuard guard(editMutex_);
    if (!items_ || itemCount_ >= MAX_ITEMS) return;
    if (index > itemCount_) index = itemCount_;
    uint16_t oldCount = itemCount_;
    itemCount_++;
    // Keep the selected item selected: it shifts down when inserting at or
    // before it.
    if (oldCount > 0 && index <= selection_ && selection_ + 1 < itemCount_) {
        selection_++;
    }
    ensureVisible();
    markDirty();
}

void ListView::removeItem(uint16_t index) {
    cdc::core::RecursiveMutexGuard guard(editMutex_);
    if (!items_ || itemCount_ == 0 || index >= itemCount_) return;
    itemCount_--;
    if (selection_ > index) {
        selection_--;
    }
    if (selection_ >= itemCount_) {
        selection_ = itemCount_ > 0 ? itemCount_ - 1 : 0;
    }
    ensureVisible();
    markDirty();
}

 
static ListView s_sharedListView;

ListView* showListView(const char* title, const ListItem* items, uint16_t count,
                       ListView::SelectCallback onSelect, const char* hint) {
    s_sharedListView.init(title, items, count);
    s_sharedListView.setOnSelect(onSelect);
    if (hint) {
        s_sharedListView.setHint(hint);
    }
    ViewStack::instance().push(&s_sharedListView);
    return &s_sharedListView;
}
 
} // namespace cdc::ui