Artemis-Switch: A streamed frame from host to screen

@startuml
!include <C4/C4_Context>
LAYOUT_LEFT_RIGHT()
Person(P_cli, "CLI user")
System(SYS, "Artemis-Switch", "Artemis-Switch is a fork in the Moonlight streaming family")
SystemDb(D0, "Active Record")
Rel(P_cli, SYS, "Uses")
Rel(SYS, D0, "Reads and writes")
@enduml

@startuml
!include <C4/C4_Container>
LAYOUT_LEFT_RIGHT()
Person(P_cli, "CLI user")
System_Boundary(SYS, "Artemis-Switch") {
  Container(C0, "artemis-switch-build", "Docker")
  ContainerDb(DB0, "Active Record", "")
}
Rel(P_cli, C0, "Uses")
Rel(C0, DB0, "Reads and writes")
@enduml

@startuml
!include <C4/C4_Component>
LAYOUT_TOP_DOWN()
System_Boundary(SYS, "Artemis-Switch") {
Boundary(L0, "Presentation", "layer") {
Component(M0_0, "resources/xml", ".xml", "19 files")
Component(M0_1, "features/ui", "C++", "9 files")
Component(M0_2, "platforms/android-project", ".xml", "5 files")
Component(M0_3, "views", "C++", "2 files")
Component(M0_4, "docs/_static", ".css", "1 files")
}
Boundary(L1, "Application services", "layer") {
Component(M1_0, "src", "C++", "51 files")
Component(M1_1, "remote_access/tailscale", "C++, C/C++", "41 files")
Component(M1_2, "streaming", "C++", "37 files")
Component(M1_3, "include", "C++", "27 files")
Component(M1_4, "streaming/video", "C++, .glsl", "24 files")
Component(M1_5, "features/input", "C++", "21 files")
Component(M1_6, "platforms/android-project", "Java, .gradle, .xml", "19 files")
Component(M1_7, "remote_access", "C++", "17 files")
Component(M1_more, "+24 modules", "", "")
}
Boundary(L2, "Data and infrastructure", "layer") {
Component(M2_0, "switch/libavutil", "C/C++", "100 files")
Component(M2_1, "switch/libavcodec", "C/C++", "25 files")
Component(M2_2, "switch/curl", "C/C++", "12 files")
Component(M2_3, "remote_access/providers", "C++", "6 files")
Component(M2_4, "switch/libavformat", "C/C++", "4 files")
Component(M2_5, "switch/libswresample", "C/C++", "3 files")
}
Boundary(L3, "Core source", "layer") {
Component(M3_0, "(root)", ".sh", "1 files")
Component(M3_1, "docs/source", "Python", "1 files")
}
Boundary(L4, "Tests", "layer") {
Component(M4_0, "tests", "C++, Python", "78 files")
}
Boundary(L5, "Build, CI and hosting", "layer") {
Component(M5_0, ".github", ".yml, .md", "15 files")
Component(M5_1, "(root)", ".txt, .yml", "2 files")
Component(M5_2, "platforms", ".txt", "2 files")
Component(M5_3, "ci", ".txt", "1 files")
Component(M5_4, "docs", "Makefile", "1 files")
Component(M5_5, "extern", ".txt", "1 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 "Artemis-Switch" {
package "app/src/utils/Settings.hpp" as F0 {
class "Settings" as T0_0 {
  working_dir()
  set_working_dir()
  launch_path()
  set_launch_path()
  key_dir()
  boxart_dir()
}
}
package "app/platforms/android-project/app/src/main/java/org/libsdl/app/SDLActivity.java" as F1 {
class "SDLActivity" as T1_0 {
  getMotionListener()
  main()
  getMainSharedObject()
  getMainFunction()
  getLibraries()
  loadLibraries()
}
}
package "app/src/remote_access/tailscale/TailscaleWgxRoute.cpp" as F2 {
class "RealWgxBackend" as T2_0 {
  realEgressCallback()
  sendEgress()
  toSockaddr()
  fromSockaddr()
  discoverLanAddress()
  startDirectPath()
}
}
package "app/src/streaming/MoonlightSession.hpp" as F3 {
class "MoonlightSession" as T3_0 {
  set_provider()
  start()
  stop()
  stopForApplicationExit()
  set_address()
  setApolloLaunchOptions()
}
}
package "app/src/streaming/AVFrameHolder.hpp" as F4 {
class "AVFrameQueue" as T4_0 {
  push()
  pushTransferred()
  recycleWriteFrame()
  configure()
  capacityFor()
  size()
}
class "AVFrameHolder" as T4_1 {
  push()
  pushTransferred()
  get()
  acquireWriteFrame()
  recycleWriteFrame()
  prepare()
}
}
package "app/src/streaming/FramePipelineTelemetry.hpp" as F5 {
class "FramePipelineTelemetry" as T5_0 {
  reset()
  noteStreamStart()
  noteFirstPacket()
  noteDecodedFrame()
  consumePendingDecodeTiming()
  noteFrameQueued()
}
}
package "app/src/remote_access/tailscale/TailscaleCore.hpp" as F6 {
class "TailscaleCore" as T6_0 {
  start()
  stop()
  snapshot()
  resolveRoute()
  activateRoute()
  prepareRouteForStreaming()
}
}
package "app/platforms/android-project/app/src/main/java/org/libsdl/app/SDLSurface.java" as F7 {
class "SDLSurface" as T7_0 {
  handlePause()
  handleResume()
  getNativeSurface()
  enableMediaCodecOverlay()
  surfaceCreated()
  surfaceDestroyed()
}
}
package "app/src/remote_access/tailscale/relay/TsLwipRelay.hpp" as F8 {
class "TsLwipRelay" as T8_0 {
  start()
  stop()
  addTcp()
  addUdp()
  isRunning()
  log()
}
}
package "lib/switch/include/libavcodec/codec.h" as F9 {
class "AVCodec" as T9_0 {
  name
  long_name
  type
  id
  capabilities
  max_lowres
  supported_framerates
  pix_fmts
}
}
package "lib/switch/include/libavcodec/avcodec.h" as F10 {
class "AVCodecContext" as T10_0 {
  av_class
  log_level_offset
  codec_type
  codec
  codec_id
  codec_tag
  priv_data
  internal
}
class "AVCodecParserContext" as T10_1 {
  priv_data
  parser
  frame_offset
  cur_offset
  next_frame_offset
  pict_type
  repeat_pict
  pts
}
}
package "lib/switch/include/libavcodec/codec_desc.h" as F11 {
class "AVCodecDescriptor" as T11_0 {
  id
  type
  name
  long_name
  props
  NULL
  mime_types
  profiles
}
}
package "lib/switch/include/libavutil/dovi_meta.h" as F12 {
class "AVDOVIColorMetadata" as T12_0 {
  dm_metadata_id
  scene_refresh_flag
  ycc_to_rgb_matrix
  ycc_to_rgb_offset
  rgb_to_lms_matrix
  signal_eotf
  signal_eotf_param0
  signal_eotf_param1
}
class "AVDOVIDataMapping" as T12_1 {
  vdr_rpu_id
  mapping_color_space
  mapping_chroma_format_idc
  curves
  nlq_method_idc
  num_x_partitions
  num_y_partitions
  nlq
}
class "AVDOVIDecoderConfigurationRecord" as T12_2 {
  dv_version_major
  dv_version_minor
  dv_profile
  dv_level
  rpu_present_flag
  el_present_flag
  bl_present_flag
  dv_bl_signal_compatibility_id
}
class "AVDOVIDmData" as T12_3 {
  level
  l1
  l2
  l3
  l4
  l5
  l6
  l8
}
class "AVDOVIDmLevel1" as T12_4 {
  min_pq
  max_pq
  avg_pq
  target_max_pq
  trim_slope
  trim_offset
  trim_power
  trim_chroma_weight
}
class "AVDOVIDmLevel10" as T12_5 {
  target_display_index
  target_max_pq
  target_min_pq
  target_primary_index
  target_display_primaries
  content_type
  whitepoint
  reference_mode_flag
}
class "AVDOVIDmLevel11" as T12_6 {
  content_type
  whitepoint
  reference_mode_flag
  sharpness
  noise_reduction
  mpeg_noise_reduction
  frame_rate_conversion
  brightness
}
class "AVDOVIDmLevel2" as T12_7 {
  target_max_pq
  trim_slope
  trim_offset
  trim_power
  trim_chroma_weight
  trim_saturation_gain
  ms_weight
  min_pq_offset
}
class "AVDOVIDmLevel254" as T12_8 {
  dm_mode
  dm_version_index
  dm_run_mode
  dm_run_version
  dm_debug
  level
  l1
  l2
}
class "AVDOVIDmLevel255" as T12_9 {
  dm_run_mode
  dm_run_version
  dm_debug
  level
  l1
  l2
  l3
  l4
}
}
}
@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
node "Docker Compose" as H {
  node "artemis-switch-build" as N0 <<container>>
}
database "Active Record" as DB0
N0 --> DB0
cloud "Console network stack (libnx/…" as E0
N0 ..> E0
cloud "WebSocket" as E1
N0 ..> E1
@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
title Feature and Integration CI
start
fork
  partition "Consolidated portable integra…" {
    :Checkout;
    :Validate localization JSON syntax;
    :Validate Artemis English/French translation…;
    :Validate release/CD contract;
    :Validate isolated VPN build contract;
    :Configure unit suite;
    :Build unit suite;
    :Run unit suite;
  }
fork again
  partition "Release source package contra…" {
    :Checkout repository and submodules;
    :Build dry-run source packages;
    :Inspect source packages;
  }
fork again
  partition "ASan + UBSan integration" {
    :Checkout;
    :Configure;
    :Build;
    :Test;
  }
fork again
  partition "Artemis CI summary" {
    :Require all integration jobs;
  }
end fork
stop
@enduml