# Changelog for keid-render-basic ## 0.2.0.0 Rendering uses Vulkan dynamic rendering targets in a render graph. - Requires `keid-core >= 0.2.0.0` for the Vulkan 1.3 baseline and dynamic rendering. - `Render.Basic.RenderTargets` holds `rtForwardMsaa` and `rtShadowMap`. - `Render.ForwardMsaa.render` and `renderReading` draw into the swapchain image. Multisampled color resolves into it; with one sample it is stored straight into the swapchain image. - `Render.ShadowMap.Target` renders the multiview shadow map. * `depth` is the tracked shadow map and `render` draws into it. Set0 samples shadow maps in `SHADER_READ_ONLY_OPTIMAL`. * The light count is checked against `maxMultiviewViewCount`. - `Render.Target.Compose` renders into the swapchain image without depth and without clearing (`render`, `renderReading`). - `Render.Basic.StageGraph` and `RenderGraph` specialise the render graph to the basic targets and pipelines. The loader stage draws through it. - Pipelines take their sample count, attachment formats and view mask from the render target. - Shadow-casting pipelines hot-reload against the shadow map with the sun bindings. - Sprite and TileMap use explicit `terminateInvocation`, Lit Material and Lit Textured use `demote`. - Built-in pipelines compile their shaders with `Render.Code.compileStages`. Hot-reloaded pipelines no longer set `cReflect`. - Removed `RenderPasses`, `rpForwardMsaa`, `rpShadowPass`, `Settings.sMSAA`, `Render.Pass.Compose`, `Render.ShadowMap.RenderPass`, the `usePass` re-exports, and the sample count argument of the pipeline `allocate` functions. ## 0.1.12.0 Moving from EvanwSdf atlases (thanks Evan!), to MTSDF by Chlumsky. Atlas generation now doesn't require using browser and copypasting. - Added `Resource.Font.Ktxf` for the texture+atlas+shaping font container. * New deps: `ktx-font`, `msdf-atlas`, `kb-text-shape`. * Text is shaped once with `Ktxf.shape` and placed with the pure `Ktxf.place`, which wraps and aligns the lines using `kb-text-layout` via `ktx-font`. * `Ktxf.Stack` pairs the shaping context with its measuring style. `allocateStack1`/`allocateMonoStacks` produce those. - Removed `Resource.Font.EvanwSdf.*` (models and `pEvanwSdf` pipeline). - Added `Resource.Font.Msdf.*` models and (`pMsdf`) pipeline. - Changed `Engine.UI.Message.Input.inputFont` field to use textureId-augmented font stacks (`Ktxf.Stack`). - Added `Engine.UI.Message.Input.inputBreak` field to pick the line breaking strategy. Long lines now wrap to the box width and align per line. - Removed `Engine.UI.Message.Input.inputFontId` field, now redundant. - Added Base{white} built-in texture. * Breaking change as it will alter the indices that come after it. ## 0.1.11.0 - Added specialization constants to common Lit code (thus, all the pipelines). - Added Lit specialization to Basic.Settings. - Moved antialiasing settings (msaa, sampler anisotropy) to Basic.Settings. + Use new `Basic.swapchainSettings` instead of passing swapchain as arguments. - Refactored external pipelines to use one loader for all the variants. + External pipelines now react to change in the specialization constants. - Fixed AO texture application in Material. + With 0 being most occluded, and 1 fully open. + Values are multiplicative now, like the rest of the channels. - Changed Fresnel function for lights to use the roughness-aware version. ## 0.1.10.0 - Update to follow the changes in keid-core-0.1.11 and geomancy-0.3. - Fix lit pipelines by removing spurious sign flips. - Require LitColored to participate in the depth pre-pass. ## 0.1.9.0 - Moved to geomancy-layout. - Added discard and color specializations to `TileMap`. ## 0.1.8.0 - Embedded texture resources now using KTX2. - Fixed grid artifacts in TileMap shader. - Added multiscattering term for `Lit` pipelines, plugging an energy loss in metals. - Added Unlit Line2D pipeline for batches of extra-fancy lines with rounded corners and segments. - Fixed missing margins in sprite model generation from an atlas. - Sprite LOD fixed to 0 to prevent issues with packed tilesets. - Added tileset borders and offset. - Changed TileMap pipeline model to use Tiled-style mod flags in A-channel. ## 0.1.7.0 - Pipelines updated to use `Engine.Vulkan.Pipeline.Graphics`. - Pipelines wrapped in a HKD. * The `Pipelines` is now an alias for `Identity` wrapper. * The data type is now `PipelinesF f` with a hole for HKD parameter. * The constructor name is still `Pipelines`, with all the fields intact. - Added a bunch of functions to work with runtime-reloadable pipelines. - Expose `stageCode` and `stageSpirv` for all pipelines. - Added `Render.Basic.rendering` reusable stage component. ## 0.1.6.1 - `withFrozenCallStack` fixes for GHC-9.0. - Added color helpers to `Render.Unlit.Colored`. - Added `Render.Unlit.Sprite` pipeline. * Available as `pSprite` and `pSpriteOutline`. ## 0.1.6.0 - Updated `Loader` stage to camera changes in core. - Import sun (directional light) functions from demos. ## 0.1.5.0 - Extracted deprecated `allocateRenderpass_` into `Render.Basic.allocate`. - Extracted hardcoded shadowmap params into `Render.Basic.Settings`. - Added `Render.Unlit.TileMap` pipeline. - Added `Render.DepthOnly` pipeline. - Updated lit pipelines to match vertex position calculation. - Fixed shadowmap index guard. - Pipelines updated for new configs with specialization. * `pDebug` is split into multiple pipelines, specialized by mode. ## 0.1.4.0 Update to match `keid-core-0.1.4.0`. - Changed `allocatePipelines` to use `msaa` directly. (`allocatePipelines_` remains unchanged.) - Fixed litMain check for missing shadowmap. - Relaxed `Set0.allocate`, `Set0.allocateEmpty` to any `MonadVulkan` under `ResourceT`. - Added pipeline config exports. - Added shared pipeline params to collection. ## 0.1.3.0 - Replaced RIO in resource loaders with constraints. - `ForwardMSAA` and `ShadowMap` updated to `keid-core-0.1.3.0`. ## 0.1.2.1 - Fixed missing embedded textures in source distribution. ## 0.1.2.0 - Added embedded base textures and cubes needed for shader code. - Changed Font resource to Source loader for both container and texture. - Added callstack freezing to report call sites in debug log. - Changed Loader stage to use `Source` in bootstrap. - Removed `Set0.set0` and `Set0.set0_`. - Added `Set0.mkBindings` instead. - Minimal descriptor counts derived from base collections to prevent HOOM errors. ## 0.1.1.4 - Fixed another VK_HOST_OUT_OF_MEMORY, in Loader stage. ## 0.1.1.3 - Removed unused deps. - Fixed VK_HOST_OUT_OF_MEMORY due to zero cubemap descriptors provided in Basic pipelines. ## 0.1.1.2 - Fix ambient occlusion in LitMaterial shader setup. - Fix roughness clamping in Lit shader. ## 0.1.1.1 - Update timer to match `keid-core`. ## 0.1.1.0 - Added `Stage.Loader.*` (and `keid-geometry` dependency with it). ## 0.1.0.0 - Initial public version.