MapStage

¿Qué hace MapStage?

Usa esta habilidad cuando estés construyendo o ajustando una escena MapStage: proyección mapa/globo, satélite, relieve hipsométrico, terreno Mapterhorn, aislamiento de regiones, gradación de color CSS y exportación JSON.

Cuándo usarla

• Necesitas un ajustador en vivo de MapStage (mapa vs globo, satélite vs relieve, aislamiento).
• Necesitas fijar pintura / CSS / cámara, y luego exportar JSON a otro host.
• Necesitas asentamientos jerarquizados (capital / large / medium / small / pass / station / ordos).

No uses la página de ajuste como host de renderizado final.

Modos

Modo	Propósito
Stack de producción	Integra MapStage en tu aplicación: satélite/ráster opcional + Mapterhorn DEM (encoding: 'terrarium') + sombreado de colina + agua vectorial OpenFreeMap + filtro CSS + extrusiones de ciudades. Controla la apariencia desde JSON exportado.
Ajustador	Página HTTP local en tuner/ con controles deslizantes, proyección, aislamiento, carga/exportación de ajustes preestablecidos.

Flujo de trabajo

1. Servir el ajustador: cd tuner && python -m http.server 8765 → http://localhost:8765/
2. Teselas: por defecto EOX Sentinel-2 sin nubes + Mapterhorn (tuner/map-tiles.config.js). Sobrescribe con map-tiles.config.local.js (ignorado por git).
3. Aplica el ajuste preestablecido por defecto tuner/preset-antique-default.json (igual que tuner/presets/antique-default.json).
4. Ajusta proyección / satélite / relieve / aislamiento / CSS / ciudades hasta que la apariencia esté fijada.
5. Exporta JSON desde el ajustador (copia o descarga).
6. Migra los campos de pintura + cámara + CSS a la escena MapStage de producción (ver referencias).
7. En producción: jumpTo a la cámara; espera a idle; opcionalmente precarga teselas. Evita easeTo / flyTo para cuadros grabados.
8. Siempre configura DEM con encoding: 'terrarium'. Una codificación incorrecta rompe el sombreado de colina/terreno.
9. Los fotogramas finales se renderizan desde el host de producción — no desde la interfaz de ajuste.

Reglas estrictas

• Las teselas no están incluidas — MapStage obtiene DEM y mapa base en tiempo de ejecución solo desde las URLs configuradas.
• Usa solo los endpoints de mapa base que tengas permiso de usar — los valores por defecto son teselas públicas de demostración (EOX); cámbialos en la configuración cuando sea necesario.
• encoding: 'terrarium' en la fuente de terreno — obligatorio.
• No uses easeTo / flyTo en rutas de producción grabadas; prefiere jumpTo + idle.
• No alojes el renderizado final en el ajustador.
• Agua son las capas vectoriales integradas de OpenFreeMap / OpenMapTiles. No esperes ni subas tuner/assets/water-data.js.

Referencias

• references/参数列表说明.md — tablas de parámetros + valores por defecto
• references/tested-config.md — fuentes, orden de capas, jumpTo + idle
• references/tuner-workflow.md — ajustador HTTP → exportación → producción
• references/city-tier-schema.md — jerarquías de asentamientos
• schemas/map-preset.schema.json
• schemas/sample-sites.schema.json
• tuner/ — página en vivo, script de verificación, ajuste preestablecido por defecto, sitios de muestra

Agentes

Consulta agents/openai.yaml para el nombre mostrado / mensaje por defecto.