ewrogers/megadev-skills

megadev-raster

Implement bounded HBlank water/reflection and split-screen effects in Megadev Sega CD games, preserving VBlank ownership, interrupt safety and palette/scroll budgets.

Ver código-fonte

Como usar

  1. Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
  2. Consulte no original as ferramentas, credenciais e ambientes necessários.
  3. Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/ewrogers/megadev-skills --skill megadev-raster

Antes de começar

  • A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
  • Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Documento original do Skill

Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.

Megadev raster effects

Use raster effects when the design needs different display state within a frame. Mega CD still uses the Mega Drive VDP: extra CPUs, Word RAM and the ASIC do not add palettes, planes, sprite capacity or a second independent display. The Labs' scenery, audio, controls and split sizes are illustrative.

a handler or changing VDP state during display.

line scroll, palette pairs, camera transforms and seam/sprite budgets.

  • Read Validation for failure tests, regional builds,

emulator checks and physical-hardware limits.

Inspect actual source in ewrogers/megadev:latest. The Lab's rt_* functions and raster_* assembly are application code, not Megadev raster APIs. Do not import SGDK interrupt, DMA-queue or sprite-engine calls.

Essential rules:

  • Reuse the game's VBlank, input, audio and Main/Sub service owners. One owner

schedules VDP access; an H handler must not compete with foreground uploads.

  • Build an immutable frame outside interrupts. Commit its line, scroll, palette

and seam sprites together, then latch a dedicated HBlank plan in VBlank.

  • Restore dry/top state early in VBlank. Program the next counter before bulk

uploads, finish within a measured blank interval, then arm the current epoch. Reject pending blank-edge/early interrupts without consuming that plan.

  • Keep HBlank assembly short and bounded. Save used registers, return with RTE,

and perform no BIOS, C, allocator, CD or decoder calls there. Bound edge polling and interrupt masking; reject late writes rather than coloring another frame.

  • Minimize active-display CRAM writes. Prefer prepared palette banks and line

scroll; if needed, preload a tiny color pair and write on a fresh HBlank. A foam sprite can hide the seam, but cannot excuse an unbounded palette upload.

  • Split-screen shares planes, SAT, palettes and VRAM. Transform and clip sprites

for each view, budget scanlines, and explicitly reserve divider rows.

  • Measure repeated movement and boundary cases, not just a fixed waterline.

Emulator success does not prove CRAM-dot absence or interrupt/bus timing on physical hardware. Offer an effect-off comparison and a simpler fallback.

Raster Labs generate separate water and split discs with scripts/create_project.py --demo water|split. The renderer uploads resident art once and bounds steady-state DMA. Reuse megadev-graphics for general VDP rendering, megadev-system for Main/Sub work, megadev-audio for audio ownership and megadev-performance/megadev-hardware for broader qualification. This skill owns scanline scheduling and the within-frame transforms, not those systems.

Relacionados por tarefa

do mesmo repositório

Mais Skills

Todos os Skills
ewrogers
Comunidade

megadev-best-practices

Apply Megadev-specific C/assembly, project-structure and integration practices while preserving CPU, interrupt and resource ownership. Use when writing or reviewing Megadev game code, joining existing systems, or fixing cross-system correctness problems; detailed graphics, audio, loading, save and release implementations remain with their own skills.

Instalações / 1h
1
GitHub Stars
0
Atualizado
20 de out.
ewrogers
Comunidade

megadev-combat

Implement attack resolution, directional guards, damage, invulnerability and knockback in Megadev Sega CD games. Use for combat rule ordering, attack-instance hit tracking and bounded projectile handling; animation timing, geometry and enemy decisions remain separate concerns.

Instalações / 1h
1
GitHub Stars
0
Atualizado
20 de out.
ewrogers
Comunidade

megadev-compression

Choose and validate compression for Megadev Sega CD assets, comparing sector-rounded disc size, decode time and RAM, with safe Kosinski decoding and loading/preloading integration.

Instalações / 1h
1
GitHub Stars
0
Atualizado
20 de out.
ewrogers
Comunidade

megadev-effects

Build bounded particles, explosions, trails, weather and screen shake in Megadev Sega CD games, with effect priorities, resident art and measured rendering budgets.

Instalações / 1h
1
GitHub Stars
0
Atualizado
20 de out.