Skip to content

Xbox Cloud Gaming app for PS5 Homebrew

C
2.5 KB
Raw Blame
// SPDX-License-Identifier: GPL-3.0-or-later
// Copyright (C) 2026 RafaelNGP
// Box art and hero images: downloaded and decoded on background threads,
// scaled to exactly the size they are drawn at ("cover": fill and crop), and
// kept in memory up to a byte budget (least recently used dropped first).
// With a disk directory, downloads are also kept there (as fetched, already
// sized by the image server) so the next launch doesn't download them again;
// the directory is trimmed to a size limit, oldest files first.
#pragma once

#include "platform/platform.h"
#include "ui/canvas.h"

#include <condition_variable>
#include <cstdint>
#include <deque>
#include <functional>
#include <memory>
#include <mutex>
#include <string>
#include <unordered_map>
#include <vector>

namespace xc::ui {

// Decodes PNG/JPEG bytes. Returns false on unsupported data.
bool decodeImage(const std::string& bytes, Image& out);
// Scales `src` to fill w x h, cropping the excess around the centre.
Image coverResize(const Image& src, int w, int h);
// Sized URL rewrite for store-images and images-eds-ssl.
std::string sizedUrl(std::string url, int w, int h);

class ImageCache {
public:
    // `onReady` is called (from a loader thread) whenever an image arrives.
    explicit ImageCache(std::function<void()> onReady, size_t budgetBytes = 160u << 20, std::string diskDir = {},
                        size_t diskBudgetBytes = 256u << 20);
    ~ImageCache();
    void stop();

    // The image scaled to w x h, or nullptr while it loads (or if it failed).
    std::shared_ptr<const Image> get(const std::string& url, int w, int h);

private:
    struct Entry {
        std::shared_ptr<const Image> image;
        bool loading = false, failed = false;
        // A failure that may pass (no answer, 5xx) is tried again from
        // retryAt (ms), three times at most; a 4xx isn't.
        int failures = 0;
        uint64_t retryAt = 0;
        uint64_t lastUse = 0;
    };
    struct Job {
        std::string key, url;
        int w, h;
    };
    void loop();
    void evict();
    std::string diskPath(const std::string& url) const;
    void trimDisk();

    std::function<void()> onReady_;
    size_t budget_;
    std::string diskDir_;
    size_t diskBudget_;
    std::mutex mutex_;
    std::condition_variable cv_;
    std::unordered_map<std::string, Entry> entries_;
    std::deque<Job> jobs_;  // newest first: what is on screen now wins
    size_t bytes_ = 0;
    uint64_t clock_ = 0;
    bool stop_ = false;
    std::vector<platform::Thread> threads_;
};

}  // namespace xc::ui