Skip to content

FramebufferPresenter

Index · English

Description

Transmet progressivement un Framebuffer vers Window via WINDOW_BLIT=146. Utiliser pour présenter du rendu logiciel après READY.

gaspardos::FramebufferPresenter — bindings/cpp/framebuffer_window.hpp, C++98.

Exemple de programme simple

#include "framebuffer_window.hpp"
#include <cstring>

int main()
{
    gaspardos::Window  window;
    GO64_WindowOptions options = {};
    options.width              = 320;
    options.height             = 240;
    std::strcpy(options.title, "Framebuffer");
    if (window.create(options) < 0)
        return 1;
    gaspardos::Framebuffer image(320, 240);
    image.clear(0x00201810);
    image.circle(160, 120, 40, 0x00ffffff);
    gaspardos::FramebufferPresenter presenter(window);
    for (unsigned i = 0; i < 10000; ++i)
    {
        GO64_Event event  = {};
        int64_t    result = window.event(event);
        if (result < 0 && result != -11)
            return 1;
        if (result == 0 && (event.type == 15 || event.type == GO64_ERROR))
            break;
        if (window.ready())
        {
            result = presenter.present(image);
            if (result == 0)
                break;
            if (result != -11)
                return 1;
        }
        GO64_yield();
    }
    for (unsigned i = 0; i < 10000; ++i)
    {
        GO64_Event event = {};
        if (window.event(event) == 0 && event.type == 15)
            break;
        GO64_yield();
    }
    return window.close() == 0 ? 0 : 1;
}

Compilation depuis Windows

Depuis la racine du dépôt, enregistrer le programme dans build/api-examples/FramebufferPresenter.cpp.

New-Item -ItemType Directory -Force build/api-examples | Out-Null
& .\build-x64-install\bin\x86_64-gaspardos-gcc.exe -std=gnu1x -O2 -mno-red-zone -c bindings/native/gaspardos_x64_syscall.c -o build/api-examples/syscall.o
if ($LASTEXITCODE -ne 0) { throw "C build failed" }
& .\build-x64-install\bin\x86_64-gaspardos-g++.exe -std=c++98 -O2 -Ibindings/cpp build/api-examples/FramebufferPresenter.cpp build/api-examples/syscall.o -o build/api-examples/FramebufferPresenter.elf
if ($LASTEXITCODE -ne 0) { throw "C++ build failed" }

Exécutable pour GaspardOS. La présentation exige un noyau avec WINDOW_BLIT=146 ; -38 signifie extension absente. Source files.

Méthodes et données publiques

explicit FramebufferPresenter(Window& window)

Référence non propriétaire ; la fenêtre doit vivre plus longtemps. Non copiable.

bool pending() const

Vrai lorsqu’une présentation doit être reprise après -11.

void cancel()

Abandonne la progression locale ; les tuiles déjà copiées restent en file noyau.

int64_t present(const Framebuffer& source, int x=0, int y=0)

Découpe en tuiles de 256 × 256 ; 0 = image entièrement mise en file, -11 = reprendre avec mêmes pixels et arguments, -16 = autre source/stockage/destination pendant une reprise, -22 = dimensions/coordonnées refusées. Les autres erreurs annulent la progression. La source doit rester vivante et inchangée jusqu’à 0 ou cancel. Pas de VSync ni de présentation atomique.