Version 0.5.6: Optimized program bindings, Upload resources with DX COPY queue, Improved automatic resource barriers

[egorodet]

Methane Kit v0.5 Pre-Release Update 6

• Samples and tutorials:
  • Asteroids sample optimization with up to 50% FPS increase:
    • Uniforms buffer size was reduced by reusing scene view-projection matrix in shaders (+7% FPS)
    • Uniforms buffer data transfer is made asynchronously with draw commands encoding (+20% FPS)
    • Disabled repeated retaining of the bound resources in command list draw calls (+30% FPS)
    • Disabled automatic resource barriers setup during parallel asteroids rendering to take advantage of automatic state propagation from Common state.
    • Got rid of excessive program binding calls in DirectX as a result of using Frame-Constant argument accessors in program bindings.
• Graphics libraries:
  • Program binding improvements:
    • Program::Argument and Program::ArgumentAccessor (previously Program::ArgumentDesc) were refactored from struct to class style with field accesor functions. Program::Argument::Modifiers bit-mask was replaced with Program::ArgumentAccessor::Type enum.
    • New program argument accessor type was added for frame-constant arguments Program::ArgumentAccessor::Type::FrameConstant to reduce number of excessive argument binding setup calls. Frame-constant bindings are properly supported by DX descriptor table layout.
    • Frame-buffer index was added to ProgramBindings::Create function as an optional argument to support frame-constant bindings.
    • Applying of DirectX resource states and root parameter bindings was reworked in ProgramBindingsDX.
  • Resource upload and state synchronization improvements:
    • COPY comamnd queue is now used by default for BlitCommandList execution in DirectX (instead of DIRECT command queue used before). So the resources upload is also done with a COPY queue in DX now. It can be switched back to using DIRECT queue with RenderContext::Settings::options_mask bit-mask flag Context::Options::BlitWithDirectQueueOnWindows.
    • Resource::SetData method is extended with an optional argument of command queue for resource state synchronization. Command queue where resource is actually used should be passed whenever possible.
    • Resource barriers setup was moved from the Resource::SetData method implementations to the SetProgramBindings, SetVertexBuffer and SetIndexBuffer calls, while setup resource barriers are still cached inside Resource object.
    • Resource::State and Resource::Barriers types were moved to the public header files and split from Resource interface definition.
  • CommandKit interface was added to Graphics Core to provide unified access from Context::GetDefaultCommandKit to the command queue, command lists, command list set and synchronization fences made for working together with the same CommandList::Type. This interface allowed to replace methods Context::GetUploadCommandQueue, Context::GetUploadCommandList, Context::GetUploadCommandListSet and RenderContext::GetRenderCommandQueue with Context::GetDefaultCommandKit.
  • CommandList changes:
    • CommandList::SetResourceBarriers(...) call was added to the public interface (was private before).
  • RenderCommandList changes:
    • RenderCommandList::SetIndexBuffers method was adedd, index buffer is now set separately from DrawIndexed call.
    • RenderCommandList::Set[Index|Vertex]Buffers methods were exnteded with an optional argument which allows to disable setting resource barriers automatically.
  • ParallelRenderCommandList changes:
    • Child render command lists are now committed in parallel.
  • ImageLoader not initializes texture names inside Load functions.
  • Fixed const correctness for Device and Context references passed to core interface factory functions.
• Common changes:
  • Debug logging was extended for resource barriers synchronization, render and view state parameters and cleaned up with fixes of some issues: properly used magic_enum, removed manual enum to string conversion functions, fixed logs formatting.
  • Fixed all new static analysis issues from SonarCloud.
• External libraries:
  • HLSL++ library was updated to v3.0
  • CLI11 library was updated
  • Catch2 library was updated to v2.13.5
  • IttApi library was updated
  • TaskFlow library was updated to v3.1.0
  • Tracy was updated to v0.7.7
• Build Infrastructure:
  • CodeQL static analysis was enabled with GitHub Actions workflow and results available in Security tab on repository page.
  • GitPod was switched to VSCode UI and extensions were updated.
  • CMake profiles were added for CLion 2021.

[gitpod-io]

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!

0 Bugs
0 Vulnerabilities
0 Security Hotspots
1 Code Smell

1.5% Coverage
0.3% Duplication

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!

0 Bugs
0 Vulnerabilities
0 Security Hotspots
1 Code Smell

0.5% Coverage
0.3% Duplication

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!

0 Bugs
0 Vulnerabilities
0 Security Hotspots
6 Code Smells

0.4% Coverage
0.3% Duplication