adjustments over frame composer contract - agnostic tile size
This commit is contained in:
+60
-1
@@ -4,7 +4,7 @@ ticket: render-all-scene-cache-and-camera-integration
|
||||
title: Agenda - Integrate render_all with Scene Cache and Camera
|
||||
status: accepted
|
||||
created: 2026-04-14
|
||||
updated: 2026-04-14
|
||||
updated: 2026-04-15
|
||||
tags: [gfx, runtime, render, camera, scene]
|
||||
---
|
||||
|
||||
@@ -54,6 +54,10 @@ O problema concreto não é só “chamar uma função”. É decidir:
|
||||
- cache ativo
|
||||
- resolver ativo
|
||||
- câmera ativa
|
||||
- O `FrameComposer` não pode regredir o contrato já aceito no scene model:
|
||||
- `SceneLayer.tile_size` já é por-layer e aceita `8x8`, `16x16` e `32x32`;
|
||||
- o decoder de `SCENE` já materializa esses tamanhos;
|
||||
- fixar o pipeline em `16x16` dentro do orquestrador de frame criaria uma restrição artificial que não existe no modelo canônico.
|
||||
- Se a integração for mal feita, o renderer pode voltar a misturar:
|
||||
- política de câmera
|
||||
- atualização de cache
|
||||
@@ -315,6 +319,60 @@ Aceitar o contrato mínimo acima como base de fechamento da agenda, a menos que
|
||||
- O HUD entra nesta integração já agora, ou o foco da primeira integração é apenas world + sprites + fades?
|
||||
- fechado: sem HUD nesta primeira integração.
|
||||
|
||||
## Reabertura 2026-04-15
|
||||
|
||||
### Contexto adicional
|
||||
|
||||
Ao revisitar a thread, apareceu uma restrição indevida: tratar o `FrameComposer` como se aceitasse apenas tilesets `16x16`.
|
||||
|
||||
Isso conflita com o estado atual do runtime:
|
||||
|
||||
- `TileSize` no HAL já enumera `Size8`, `Size16` e `Size32`;
|
||||
- `SceneLayer` carrega `tile_size` por layer;
|
||||
- o decoder de `SCENE` já aceita `8`, `16` e `32`;
|
||||
- `SceneViewportResolver` e `SceneViewportCache` já calculam offsets, anchors e cópia a partir do `tile_size` da própria layer.
|
||||
|
||||
O risco aqui não é apenas de implementação. Se o contrato do `FrameComposer` assumir `16x16` como pré-condição, ele quebra a neutralidade do orquestrador e reabre uma limitação artificial acima do scene model.
|
||||
|
||||
### Problema reaberto
|
||||
|
||||
Precisamos fechar explicitamente que o `FrameComposer` aceita cenas/layers com `tile_size` `8x8` e não impõe `16x16` como tamanho mínimo ou obrigatório para o world path.
|
||||
|
||||
### Opcoes adicionais
|
||||
|
||||
### Opcao 4 - Fixar `16x16` no `FrameComposer` e tratar `8x8` como fora de escopo
|
||||
|
||||
**Vantagens:**
|
||||
- reduz casos de teste imediatos;
|
||||
- simplifica implementação inicial se alguém estiver assumindo viewport/caches calibrados manualmente para `16`.
|
||||
|
||||
**Desvantagens:**
|
||||
- contradiz o scene model já aceito;
|
||||
- introduz restrição artificial no orquestrador;
|
||||
- obriga futura revisão de contrato para reaceitar algo que a base já suporta.
|
||||
|
||||
### Opcao 5 - Manter `FrameComposer` tile-size agnostic e aceitar `8x8` desde V1
|
||||
|
||||
**Vantagens:**
|
||||
- preserva o contrato canônico já existente em `SceneLayer`;
|
||||
- mantém o `FrameComposer` como orquestrador, não como redefinidor de formato;
|
||||
- evita bifurcação entre pipeline de scene e pipeline de composição.
|
||||
|
||||
**Desvantagens:**
|
||||
- exige deixar isso explícito na decisão e nos planos;
|
||||
- aumenta a exigência de testes para viewport/cache/cópia com `8x8`.
|
||||
|
||||
### Recomendacao adicional
|
||||
|
||||
Seguir com a **Opcao 5**.
|
||||
|
||||
Norma proposta para fechamento desta reabertura:
|
||||
|
||||
- `FrameComposer` deve aceitar scenes/layers cujo `tile_size` resolvido seja `8x8`, `16x16` ou `32x32`;
|
||||
- `FrameComposer` nao deve impor `16x16` como pré-condição para bind, cache, resolver ou composição;
|
||||
- qualquer validação de compatibilidade deve ser derivada do `tile_size` declarado pela própria layer / glyph bank, nunca de um default rígido no compositor;
|
||||
- os planos derivados desta thread precisam citar testes explícitos para `8x8`.
|
||||
|
||||
## Criterio para Encerrar
|
||||
|
||||
Esta agenda pode ser encerrada quando estiver explícito:
|
||||
@@ -324,6 +382,7 @@ Esta agenda pode ser encerrada quando estiver explícito:
|
||||
- como funciona o bind/unbind da scene ativa;
|
||||
- quando o cache é atualizado;
|
||||
- como `render_all()` passa a compor o world path aceito;
|
||||
- que o `FrameComposer` permanece agnóstico ao `tile_size` canônico da layer e aceita `8x8` sem downgrade contratual;
|
||||
- e qual é a superfície mínima de integração para implementação sem reabrir a arquitetura base.
|
||||
|
||||
## Resolucao
|
||||
|
||||
Reference in New Issue
Block a user