Skip to content

Commit eba4145

Browse files
committed
docs: update readme - HDR/HLG feature highlights [skip ci]
1 parent 6f893f3 commit eba4145

5 files changed

Lines changed: 115 additions & 5 deletions

File tree

README.de.md

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,35 @@ Ein Fork basierend auf LizardByte/Sunshine, bietet vollständige Dokumentationsu
1919
**Sunshine-Foundation** ist ein selbst gehosteter Game-Stream-Host für Moonlight. Diese Fork-Version hat erhebliche Verbesserungen gegenüber dem ursprünglichen Sunshine vorgenommen und konzentriert sich darauf, das Spiel-Streaming-Erlebnis für verschiedene Streaming-Endgeräte und Windows-Hosts zu verbessern:
2020

2121
### 🌟 Kernfunktionen
22-
- **HDR-freundliche Unterstützung** - Optimierte HDR-Verarbeitungspipeline für ein echtes HDR-Game-Streaming-Erlebnis
22+
- **Vollständige HDR-Pipeline-Unterstützung** - Dualformat HDR10 (PQ) + HLG Kodierung mit adaptiven Metadaten für eine breitere Geräteabdeckung
2323
- **Virtuelle Anzeige** - Integriertes virtuelles Display-Management, ermöglicht das Erstellen und Verwalten virtueller Displays ohne zusätzliche Software
2424
- **Entferntes Mikrofon** - Unterstützt das Empfangen von Client-Mikrofonen und bietet hochwertige Sprachdurchleitung
2525
- **Erweiterte Systemsteuerung** - Intuitive Web-Oberfläche zur Konfiguration mit Echtzeit-Überwachung und Verwaltung
2626
- **Niedrige Latenzübertragung** - Optimierte Encoder-Verarbeitung unter Nutzung der neuesten Hardware-Fähigkeiten
2727
- **Intelligente Paarung** - Intelligentes Management von Profilen für gepaarte Geräte
2828

29+
### 🎬 Vollständige HDR-Pipeline-Architektur
30+
31+
**Dual-Format HDR-Kodierung: HDR10 (PQ) + HLG Parallelunterstützung**
32+
33+
Herkömmliche Streaming-Lösungen unterstützen nur HDR10 (PQ) mit absoluter Luminanzzuordnung, was erfordert, dass das Client-Display die EOTF-Parameter und Spitzenhelligkeit der Quelle genau reproduziert. Wenn die Fähigkeiten des Empfangsgeräts unzureichend sind oder die Helligkeitsparameter nicht übereinstimmen, treten Tone-Mapping-Artefakte wie abgeschnittene Schatten und überbelichtete Lichter auf.
34+
35+
Foundation Sunshine führt HLG-Unterstützung (Hybrid Log-Gamma, ITU-R BT.2100) auf der Kodierungsebene ein. Dieser Standard verwendet eine relative Luminanzzuordnung mit folgenden technischen Vorteilen:
36+
- **Szenenreferenzierte Luminanzanpassung**: HLG verwendet eine relative Luminanzkurve, die es dem Display ermöglicht, automatisch Tone Mapping basierend auf seiner eigenen Spitzenhelligkeit durchzuführen — die Erhaltung von Schattendetails auf Geräten mit niedriger Helligkeit ist PQ deutlich überlegen
37+
- **Sanfter Highlight-Roll-Off**: Die hybride Log-Gamma-Transferfunktion von HLG bietet einen graduellen Roll-Off in Highlight-Bereichen und vermeidet die Banding-Artefakte, die durch hartes Clipping bei PQ verursacht werden
38+
- **Native SDR-Abwärtskompatibilität**: HLG-Signale können von SDR-Displays direkt als Standard-BT.709-Inhalt dekodiert werden, ohne zusätzliches Tone Mapping
39+
40+
**Einzelbild-Luminanzanalyse und adaptive Metadatengenerierung**
41+
42+
Die Kodierungspipeline integriert ein Echtzeit-Luminanzanalysemodul auf der GPU-Seite, das über Compute Shader für jedes Einzelbild folgende Operationen ausführt:
43+
- **MaxFALL / MaxCLL Einzelbild-Berechnung**: Echtzeit-Berechnung des maximalen Inhaltslichtpegels (MaxCLL) und des maximalen durchschnittlichen Bildlichtpegels (MaxFALL) auf Einzelbildebene, dynamisch in HEVC/AV1 SEI/OBU-Metadaten injiziert
44+
- **Robuste Ausreißerfilterung**: Perzentilbasierte Abschneidestrategie zur Eliminierung extremer Luminanzpixel (z.B. Spiegelreflexionen), um zu verhindern, dass isolierte Leuchtpunkte die globale Luminanzreferenz anheben und zu einer allgemeinen Bildverdunkelung führen
45+
- **Interframe-Exponentialglättung**: EMA-Filterung (Exponentieller gleitender Durchschnitt) auf Luminanzstatistiken über aufeinanderfolgende Frames, zur Beseitigung von Helligkeitsflimmern durch abrupte Metadatenänderungen bei Szenenwechseln
46+
47+
**Vollständige HDR-Metadaten-Durchleitung**
48+
49+
Unterstützt die vollständige Durchleitung von statischen HDR10-Metadaten (Mastering Display Info + Content Light Level), dynamischen HDR Vivid-Metadaten und HLG-Transfercharakteristik-Kennungen. Dies stellt sicher, dass die von NVENC / AMF / QSV-Encodern ausgegebenen Bitstreams vollständige Farbvolumen- und Luminanzinformationen gemäß der CTA-861-Spezifikation enthalten, sodass Client-Decoder die HDR-Absicht der Quelle präzise reproduzieren können.
50+
2951
### 🖥️ Integriertes virtuelles Display (Erfordert Win10 22H2 oder neuer)
3052
- Dynamische Erstellung und Entfernung virtueller Displays
3153
- Unterstützung für benutzerdefinierte Auflösungen und Bildwiederholraten

README.en.md

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,35 @@ A fork based on LizardByte/Sunshine, providing comprehensive documentation suppo
1919
**Sunshine-Foundation** is a self-hosted game stream host for Moonlight. This forked version introduces significant improvements over the original Sunshine, focusing on enhancing the game streaming experience for various streaming terminal devices connected to a Windows host:
2020

2121
### 🌟 Core Features
22-
- **HDR-Friendly Support** - Optimized HDR processing pipeline for a true HDR game streaming experience
22+
- **Full HDR Pipeline Support** - Dual-format HDR10 (PQ) + HLG encoding with adaptive metadata, covering a wider range of endpoint devices
2323
- **Virtual Display** - Built-in virtual display management, allowing creation and management of virtual displays without additional software
2424
- **Remote Microphone** - Supports receiving client microphones, providing high-quality voice passthrough
2525
- **Advanced Control Panel** - Intuitive web control interface with real-time monitoring and configuration management
2626
- **Low-Latency Transmission** - Optimized encoding processing leveraging the latest hardware capabilities
2727
- **Smart Pairing** - Intelligent management of pairing devices with corresponding profiles
2828

29+
### 🎬 Full HDR Pipeline Architecture
30+
31+
**Dual-Format HDR Encoding: HDR10 (PQ) + HLG Parallel Support**
32+
33+
Conventional streaming solutions only support HDR10 (PQ) absolute luminance mapping, which requires the client display to precisely match the source EOTF parameters and peak brightness. When the receiving device has insufficient capabilities or mismatched brightness parameters, tone mapping artifacts such as crushed blacks and clipped highlights occur.
34+
35+
Foundation Sunshine introduces HLG (Hybrid Log-Gamma, ITU-R BT.2100) support at the encoding layer. This standard employs relative luminance mapping with the following technical advantages:
36+
- **Scene-Referred Luminance Adaptation**: HLG uses a relative luminance curve, allowing the display to automatically perform tone mapping based on its own peak brightness — shadow detail retention on low-brightness devices is significantly superior to PQ
37+
- **Smooth Highlight Roll-Off**: HLG's hybrid log-gamma transfer function provides gradual roll-off in highlight regions, avoiding the banding artifacts caused by PQ's hard clipping
38+
- **Native SDR Backward Compatibility**: HLG signals can be directly decoded by SDR displays as standard BT.709 content without additional tone mapping
39+
40+
**Per-Frame Luminance Analysis and Adaptive Metadata Generation**
41+
42+
The encoding pipeline integrates a real-time luminance analysis module on the GPU side, executing the following via Compute Shaders on each frame:
43+
- **Per-Frame MaxFALL / MaxCLL Computation**: Real-time calculation of frame-level Maximum Content Light Level (MaxCLL) and Maximum Frame-Average Light Level (MaxFALL), dynamically injected into HEVC/AV1 SEI/OBU metadata
44+
- **Robust Outlier Filtering**: Percentile-based truncation strategy to discard extreme luminance pixels (e.g., specular highlights), preventing isolated bright spots from inflating the global luminance reference and causing overall image dimming
45+
- **Inter-Frame Exponential Smoothing**: EMA (Exponential Moving Average) filtering applied to luminance statistics across consecutive frames, eliminating brightness flicker caused by abrupt metadata changes during scene transitions
46+
47+
**Complete HDR Metadata Passthrough**
48+
49+
Supports full passthrough of HDR10 static metadata (Mastering Display Info + Content Light Level), HDR Vivid dynamic metadata, and HLG transfer characteristic identifiers, ensuring that bitstreams output by NVENC / AMF / QSV encoders carry complete color volume and luminance information compliant with the CTA-861 specification, enabling client decoders to accurately reproduce the source HDR intent.
50+
2951
### 🖥️ Virtual Display Integration (Requires Windows 10 22H2 or newer)
3052
- Dynamic virtual display creation and destruction
3153
- Custom resolution and refresh rate support

README.fr.md

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,35 @@ Fork basé sur LizardByte/Sunshine, offrant une documentation complète [Lire la
1919
**Sunshine-Foundation** est un hôte de streaming de jeu auto-hébergé pour Moonlight. Cette version forkée apporte des améliorations significatives par rapport à Sunshine original, en se concentrant sur l'amélioration de l'expérience de streaming de jeu entre divers appareils terminaux et l'hôte Windows :
2020

2121
### 🌟 Fonctionnalités principales
22-
- **Support convivial HDR** - Pipeline de traitement HDR optimisé pour une véritable expérience de streaming de jeux HDR
22+
- **Support HDR Full Pipeline** - Double encodage HDR10 (PQ) + HLG avec métadonnées adaptatives, couvrant un plus large éventail d'appareils
2323
- **Écran virtuel** - Gestion intégrée des écrans virtuels, permettant de créer et gérer des écrans virtuels sans logiciel supplémentaire
2424
- **Microphone distant** - Prise en charge de la réception du microphone client, offrant une fonction de transmission vocale de haute qualité
2525
- **Panneau de contrôle avancé** - Interface de contrôle Web intuitive avec surveillance en temps réel et gestion de configuration
2626
- **Transmission à faible latence** - Traitement de codage optimisé exploitant les dernières capacités matérielles
2727
- **Appairage intelligent** - Gestion intelligente des profils correspondants aux appareils appairés
2828

29+
### 🎬 Architecture complète du pipeline HDR
30+
31+
**Double format d'encodage HDR : HDR10 (PQ) + HLG en parallèle**
32+
33+
Les solutions de streaming conventionnelles ne prennent en charge que le HDR10 (PQ) avec mappage de luminance absolue, ce qui exige que l'écran client reproduise précisément les paramètres EOTF et la luminosité maximale de la source. Lorsque les capacités de l'appareil récepteur sont insuffisantes ou que les paramètres de luminosité ne correspondent pas, des artefacts de tone mapping apparaissent, tels que la perte de détails dans les ombres et l'écrêtage des hautes lumières.
34+
35+
Foundation Sunshine introduit la prise en charge du HLG (Hybrid Log-Gamma, ITU-R BT.2100) au niveau de l'encodage. Ce standard utilise un mappage de luminance relatif avec les avantages techniques suivants :
36+
- **Adaptation de luminance référencée à la scène** : Le HLG utilise une courbe de luminance relative, permettant à l'écran d'effectuer automatiquement le tone mapping en fonction de sa propre luminosité maximale — la préservation des détails d'ombre sur les appareils à faible luminosité est significativement supérieure au PQ
37+
- **Roll-off progressif des hautes lumières** : La fonction de transfert log-gamma hybride du HLG fournit un roll-off graduel dans les zones de haute luminosité, évitant les artefacts de banding causés par l'écrêtage dur du PQ
38+
- **Compatibilité ascendante native SDR** : Les signaux HLG peuvent être directement décodés par les écrans SDR comme du contenu standard BT.709 sans traitement de tone mapping supplémentaire
39+
40+
**Analyse de luminance image par image et génération adaptative de métadonnées**
41+
42+
Le pipeline d'encodage intègre un module d'analyse de luminance en temps réel côté GPU, exécutant via des Compute Shaders sur chaque image :
43+
- **Calcul MaxFALL / MaxCLL par image** : Calcul en temps réel du niveau de lumière maximal du contenu (MaxCLL) et du niveau de lumière moyen maximal par image (MaxFALL), injectés dynamiquement dans les métadonnées HEVC/AV1 SEI/OBU
44+
- **Filtrage robuste des valeurs aberrantes** : Stratégie de troncature par percentile pour éliminer les pixels de luminance extrême (ex. réflexions spéculaires), empêchant les points lumineux isolés d'élever la référence de luminance globale et de provoquer un assombrissement global de l'image
45+
- **Lissage exponentiel inter-images** : Filtrage EMA (Moyenne Mobile Exponentielle) appliqué aux statistiques de luminance sur les images consécutives, éliminant le scintillement de luminosité causé par les changements brusques de métadonnées lors des transitions de scène
46+
47+
**Transmission complète des métadonnées HDR**
48+
49+
Prise en charge de la transmission complète des métadonnées statiques HDR10 (Mastering Display Info + Content Light Level), des métadonnées dynamiques HDR Vivid et des identifiants de caractéristiques de transfert HLG, garantissant que les flux de bits produits par les encodeurs NVENC / AMF / QSV transportent des informations complètes de volume colorimétrique et de luminance conformes à la spécification CTA-861, permettant aux décodeurs clients de reproduire fidèlement l'intention HDR de la source.
50+
2951
### 🖥️ Intégration d'écran virtuel (nécessite Windows 10 22H2 ou plus récent)
3052
- Création et destruction dynamique d'écrans virtuels
3153
- Prise en charge des résolutions et taux de rafraîchissement personnalisés

README.ja.md

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,35 @@ LizardByte/Sunshineをベースにしたフォークで、完全なドキュメ
1919
**Sunshine-Foundation** はMoonlight用のセルフホスト型ゲームストリームホストです。このフォークバージョンはオリジナルのSunshineに基づき、様々なストリーミング端末とWindowsホスト間のゲームストリーミング体験を向上させることに重点を置いた大幅な改良が加えられています:
2020

2121
### 🌟 コア機能
22-
- **HDRフレンドリーサポート** - 最適化されたHDR処理パイプラインにより、真のHDRゲームストリーミング体験を提供
22+
- **HDR フルパイプラインサポート** - HDR10 (PQ) + HLG デュアルフォーマットエンコーディングとアダプティブメタデータにより、幅広い端末デバイスをカバー
2323
- **仮想ディスプレイ** - 内蔵の仮想ディスプレイ管理により、追加ソフトウェアなしで仮想ディスプレイの作成と管理が可能
2424
- **リモートマイク** - クライアントマイクの受信をサポートし、高音質の音声パススルー機能を提供
2525
- **高度なコントロールパネル** - 直感的なWebコントロールインターフェースで、リアルタイム監視と設定管理を提供
2626
- **低遅延伝送** - 最新のハードウェア能力を活用した最適化されたエンコード処理
2727
- **インテリジェントペアリング** - ペアリングデバイスの対応プロファイルをインテリジェントに管理
2828

29+
### 🎬 HDR フルパイプライン技術アーキテクチャ
30+
31+
**デュアルフォーマット HDR エンコーディング:HDR10 (PQ) + HLG 並列サポート**
32+
33+
従来のストリーミングソリューションは HDR10 (PQ) の絶対輝度マッピングのみをサポートしており、クライアントディスプレイがソース側の EOTF パラメータとピーク輝度を正確に再現することが求められます。受信デバイスの能力が不十分な場合やパラメータが一致しない場合、暗部ディテールの消失やハイライトクリッピングなどのトーンマッピングアーティファクトが発生します。
34+
35+
Foundation Sunshine はエンコーディング層に HLG(Hybrid Log-Gamma、ITU-R BT.2100)サポートを追加しました。この規格は相対輝度マッピングを採用し、以下の技術的優位性を備えています:
36+
- **シーン参照型輝度適応**:HLG は相対輝度カーブに基づいており、ディスプレイ側が自身のピーク輝度に基づいて自動的にトーンマッピングを実行 — 低輝度デバイスでの暗部ディテール保持は PQ を大幅に上回る
37+
- **ハイライト領域のスムーズなロールオフ**:HLG のハイブリッド対数ガンマ伝達関数は高輝度領域で漸進的なロールオフを提供し、PQ のハードクリッピングによるバンディングアーティファクトを回避
38+
- **ネイティブ SDR 後方互換性**:HLG 信号は SDR ディスプレイで標準 BT.709 コンテンツとして直接デコード可能。追加のトーンマッピング処理は不要
39+
40+
**フレームごとの輝度分析とアダプティブメタデータ生成**
41+
42+
エンコーディングパイプラインは GPU 側にリアルタイム輝度分析モジュールを統合し、Compute Shader を介して各フレームに対して以下を実行します:
43+
- **MaxFALL / MaxCLL フレーム単位計算**:フレームレベルの最大コンテンツ輝度(MaxCLL)とフレーム平均輝度(MaxFALL)をリアルタイムで計算し、HEVC/AV1 SEI/OBU メタデータに動的に注入
44+
- **ロバストな外れ値フィルタリング**:パーセンタイルベースの切断戦略により極端な輝度ピクセル(例:鏡面反射ハイライト)を除去。孤立した高輝度点がグローバル輝度参照を引き上げ、画面全体が暗くなることを防止
45+
- **フレーム間指数平滑化**:連続フレームの輝度統計値に EMA(指数移動平均)フィルタリングを適用し、シーン遷移時のメタデータ急変による輝度フリッカーを解消
46+
47+
**完全な HDR メタデータパススルー**
48+
49+
HDR10 静的メタデータ(Mastering Display Info + Content Light Level)、HDR Vivid ダイナミックメタデータ、および HLG 伝送特性識別子の完全なパススルーをサポートし、NVENC / AMF / QSV エンコーダが出力するビットストリームが CTA-861 仕様に準拠した完全な色域・輝度情報を含むことを保証します。これにより、クライアントデコーダがソース側の HDR インテントを正確に再現できます。
50+
2951
### 🖥️ 仮想ディスプレイ統合 (win10 22H2 以降のシステムが必要)
3052
- 動的な仮想ディスプレイの作成と破棄
3153
- カスタム解像度とリフレッシュレートのサポート

0 commit comments

Comments
 (0)