nxsand: A GPU grid for falling sand

@startuml
!include <C4/C4_Context>
LAYOUT_LEFT_RIGHT()
Person(P_cli, "CLI user")
System(SYS, "nxsand", "nxsand is a falling-sand simulation for Switch with a desktop develop…")
System_Ext(E0, "Kroki")
Rel(P_cli, SYS, "Uses")
Rel(SYS, E0, "Calls")
@enduml

@startuml
!include <C4/C4_Container>
LAYOUT_LEFT_RIGHT()
Person(P_cli, "CLI user")
System_Boundary(SYS, "nxsand") {
  Container(APP, "nxsand", "C++")
}
System_Ext(E0, "Kroki")
Rel(P_cli, APP, "Uses")
Rel(APP, E0, "Calls")
@enduml

@startuml
!include <C4/C4_Component>
LAYOUT_TOP_DOWN()
System_Boundary(SYS, "nxsand") {
Boundary(L0, "Presentation", "layer") {
Component(M0_0, "ui", "C++", "30 files")
}
Boundary(L1, "Application services", "layer") {
Component(M1_0, "scripts", ".ps1, Python, .sh", "18 files")
Component(M1_1, "gpu", "C++", "4 files")
}
Boundary(L2, "Domain and business rules", "layer") {
Component(M2_0, "game", "C++", "8 files")
}
Boundary(L3, "Data and infrastructure", "layer") {
Component(M3_0, "platform/audio", "C++", "10 files")
Component(M3_1, "platform/input", "C++", "7 files")
Component(M3_2, "platform", "C++", "4 files")
Component(M3_3, "gpu", "C++", "2 files")
}
Boundary(L4, "Core source", "layer") {
Component(M4_0, "gpu", "C++", "13 files")
Component(M4_1, "save", "C++", "13 files")
Component(M4_2, "sim", "C++", "13 files")
Component(M4_3, "shaders", ".glsl", "3 files")
Component(M4_4, "third_party/glad", "C/C++, C", "3 files")
Component(M4_5, "third_party/nlohmann", "C++", "1 files")
}
Boundary(L5, "Tests", "layer") {
Component(M5_0, "tests", "C++", "21 files")
}
Boundary(L6, "Build, CI and hosting", "layer") {
Component(M6_0, ".github", ".yml, .json", "4 files")
Component(M6_1, "(root)", "Makefile, justfile", "2 files")
}
}
@enduml

@startuml
skinparam backgroundColor transparent
skinparam shadowing false
skinparam roundCorner 10
skinparam defaultFontName Arial
skinparam defaultFontSize 13
skinparam ArrowColor #4e6070
skinparam ArrowFontColor #3d4f5f
skinparam titleFontSize 14
skinparam actorBorderColor #006a62
skinparam actorBackgroundColor #e9f3f4
skinparam usecaseBorderColor #006a62
skinparam usecaseBackgroundColor #e9f3f4
skinparam componentBorderColor #006a62
skinparam componentBackgroundColor #e9f3f4
skinparam interfaceBorderColor #006a62
skinparam interfaceBackgroundColor #ffffff
skinparam nodeBorderColor #4e6070
skinparam nodeBackgroundColor #f4f8fb
skinparam databaseBorderColor #006a62
skinparam databaseBackgroundColor #ffffff
skinparam cloudBorderColor #4e6070
skinparam cloudBackgroundColor #f0f5fa
skinparam artifactBorderColor #006a62
skinparam artifactBackgroundColor #ffffff
skinparam rectangleBorderColor #b0c2d3
skinparam activityBorderColor #006a62
skinparam activityBackgroundColor #e9f3f4
skinparam partitionBorderColor #b0c2d3
skinparam stereotypeCBackgroundColor #ffffff
top to bottom direction
hide empty members
package "nxsand" {
package "source/game/app.hpp" as F0 {
class "App" as T0_0 {
  shutdown()
  frame()
  setSimGridSize()
  applyRuntimeSettings()
  applyRuntimeSettingsLight()
  applyRuntimeSettingsHeavy()
}
}
package "source/gpu/active_tiles.hpp" as F1 {
class "ActiveTileMap" as T1_0 {
  reset()
  wakeAll()
  sleepAll()
  wakeFromGridTopDown()
  wakeBoundsPx()
  rememberBounds()
}
class "ActiveTileRun" as T1_1 {
  std
}
}
package "source/gpu/perf_stats.hpp" as F2 {
class "PerfStats" as T2_0 {
  beginFrame()
  beginSim()
  endSim()
  beginPaint()
  endPaint()
  beginWorldRender()
}
}
package "source/gpu/font_atlas.hpp" as F3 {
class "FontAtlas" as T3_0 {
  isReady()
  shutdown()
  invalidateGlTexture()
  resetGlResources()
  textWidth()
  drawText()
}
}
package "source/gpu/shader_program.hpp" as F4 {
class "ShaderProgram" as T4_0 {
  loadFromFiles()
  loadComputeFromFile()
  use()
  uniformLocation()
  readFile()
  compile()
}
}
package "source/platform/input/menu_repeat.hpp" as F5 {
class "MenuRepeatState" as T5_0 {
  reset()
  tick()
  tickAxis()
}
}
package "source/gpu/shader_program.cpp" as F6 {
class "SwitchLinkHeartbeat" as T6_0 {
  start()
  finish()
}
}
package "source/ui/menu.hpp" as F7 {
class "MenuLayout" as T7_0 {
  s
  panelX
  panelY
  panelW
  panelH
  rowH
  listY0
  titleY
}
}
package "source/sim/physics_gpu.hpp" as F8 {
class "PhysicsParamsGPU" as T8_0 {
  fire_speed
  fire_smokeRate
  fire_ignitePlant
  fire_igniteOil
  fire_spreadRate
  smoke_fadeRate
  smoke_driftRate
  water_flowRate
}
}
package "source/gpu/shader_cache.cpp" as F9 {
class "ShaderCacheHeader" as T9_0 {
  magic
  version
  keyHash
  binaryFormat
  payloadSize
}
}
package "source/gpu/sim_pipeline.hpp" as F10 {
class "SimPassRect" as T10_0 {
  simShader
  computeShader
  paintShader
  activeTiles
}
}
package "source/gpu/render_pipeline.hpp" as F11 {
class "UiVertex" as T11_0 {
  std
  bloomBrightShader
  bloomBlurShader
  bloomCompositeShader
}
}
package "source/sim/brush_stroke.hpp" as F12 {
class "BrushDab" as T12_0 {
  x
  y
  std
}
class "BrushStrokePlan" as T12_1 {
  std
}
}
package "source/gpu/font_atlas.cpp" as F13 {
class "FtLibrary" as T13_0 {
  std
  true
}
}
package "source/sim/physics_settings.hpp" as F14 {
class "ParamSpec" as T14_0 {
  id
  label
}
}
package "source/ui/layout.hpp" as F15 {
class "PlayRegion" as T15_0 {
  scaleX
  scaleY
}
}
package "source/game/game_settings.hpp" as F16 {
class "DebugSettings" as T16_0 {
  std
}
class "DisplaySettings" as T16_1 {
  std
}
class "GameSettings" as T16_2 {
  std
}
}
}
@enduml