Skip to content

docs: Vulkan effective render target (vk_get_render_target_*)#149

Draft
cursor[bot] wants to merge 1 commit intomainfrom
cursor/codebase-documentation-alignment-87a3
Draft

docs: Vulkan effective render target (vk_get_render_target_*)#149
cursor[bot] wants to merge 1 commit intomainfrom
cursor/codebase-documentation-alignment-87a3

Conversation

@cursor
Copy link
Copy Markdown

@cursor cursor Bot commented Apr 26, 2026

Summary

Documents the resolution order for vk_get_render_target_width() / vk_get_render_target_height() so Vulkan subsystem docs match src/renderers/vulkan/vk_view_state.c.

Changes

  • docs/RENDERERS.md — Under Internal Resolution / Present Scaling, adds a bullet describing the FBO main-color → vk.render*glConfig fallback, why vk.renderWidth can diverge mid-frame (e.g. sun shadow pass), and which systems rely on this helper (Forward+, SSAO/HBAO, SSR copy, temporal reset), with file pointers.
  • docs/ARCHITECTURE.md — Clarifies the Forward+ bullet so “tile buffers follow …” names the same source of truth as the implementation.

Why

Recent Vulkan work standardized post-FX and Forward+ packing on this helper; the long-form audit and RENDERER_2026_ARCHITECTURE_PASS.md already mention it—the feature doc and architecture overview were the weak link for quick scanning.

Open in Web View Automation 

Explain the FBO main-color vs vk.renderWidth fallback chain from
vk_view_state.c so internal scale, Forward+, SSAO, SSR, and temporal
reset behavior are easier to reason about. Tighten ARCHITECTURE Forward+
line to match the same source of truth.

Co-authored-by: Tim Fox <timfox@outlook.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant