nes-pascal

Runtime do NES

English

Português (Brasil)

O runtime implementado fornece uma pequena sequência de inicialização e um tratador de NMI pertencente ao runtime para um programa NROM NTSC. Suas APIs de quadros e controles são:

• nes.set_background_color define a cor de fundo universal da paleta do NES;
• APIs de paleta configuram quatro paletas de fundo e quatro paletas de sprites e enfileiram alterações de runtime para o VBlank;
• nes.load_background transfere uma nametable bruta configurada e sua tabela de atributos durante a inicialização;
• APIs de atualização de fundo mantêm opcionalmente um shadow de tiles confirmados e enfileiram no máximo quatro escritas de tiles ou atributos para cada VBlank;
• nes.run conclui a inicialização, habilita a NMI e a renderização no VBlank, e inicia a fase de runtime sincronizada por quadros;
• nes.set_scroll prepara atomicamente um par fixo de rolagem horizontal e vertical para a restauração final da NMI;
• nes.wait_frame aguarda a alteração do contador volátil de quadros da NMI;
• nes.on_update registra estaticamente um procedimento sem parâmetros para o laço de quadros da thread principal;
• nes.on_vblank registra estaticamente um procedimento restrito e sem parâmetros para trabalho no VBlank da NMI;
• nes.controller_down, nes.controller_pressed e nes.controller_released consultam o estado estável dos controles padrão 1 e 2;
• Primitivas de sprites de hardware mantêm 64 entradas de OAM em um shadow de CPU alinhado a página e as transferem via DMA de OAM na NMI;
• Metasprites compilam metadados de quadros do PNG2CHR Studio em listas de componentes residentes em PRG com uma posição lógica e posse compartilhada de OAM;
• Animação de sprites avança sequências simbólicas de quadros de metasprites na thread principal sincronizada por quadros;
• Helpers de colisão fornecem predicados de ponto/retângulo, bounds de sprites e metasprites e consulta imutável de colisão por tile de fundo;
• Números aleatórios fornecem bytes determinísticos e ranges inclusivos com viés controlado e seed explícita opcional;
• Suporte a estados de jogo documenta o padrão oficial com enum, helpers de transição, dispatcher, pausa, game over e reinício explícito;
• nes.set_sprite_zero é o helper fixo de preparação de OAM, exclusivo para exemplos, descrito na documentação de controles; ele permanece como um helper de compatibilidade.

nes.load_background() e comandos diretos de paleta de inicialização devem ficar antes de nes.run; chamadas de paleta em procedimentos ou após nes.run são enfileiradas. nes.wait_frame pode aparecer em laços e condicionais do bloco principal após nes.run, mas não em procedimentos. O único código de usuário executado pela NMI é o callback único de VBlank estaticamente validado, quando registrado.

Consulte Orçamento de ciclos de VBlank para os custos atuais de pior caso do runtime, margem disponível para callbacks e limites de escalabilidade.

Consulte Plataforma-alvo para o formato da ROM gerada e comportamento de inicialização do hardware. Consulte Memória da CPU para o limite físico de RAM, regiões reservadas, capacidade do usuário e o relatório gerado de mapa de memória.

This site is open source. Improve this page.