Updates to v3.6 (FlyleafLib) / v1.2 (FlyleafME)

SuRGeoNix · SuRGeoNix · commit a7ffeec25df4 · 2022-11-09T15:05:20.000+02:00
Introduces FlyleafHost a new DPI aware, hardware accelerated Direct3D Surface (WPF VideoView's replacement and Flyleaf's for Winforms)
 * Early and fast initialization of handles and renderer which will also resolve several issues
 * Adds Attach / Detach functionality
 * Self Drag Move also on attach mode (within the host's owner bounds)
 * Drag &amp; Drop Swap between FlyleafHosts (Shift + Drag)
 * Custom non-borders resizable windows both on attach and detach mode (can keep input's ratio)
 * Adds Z-order surfaces support
 * Resolves several issues when the host's rectangle was clipped
 * Adds support for WPF Windows to the Renderer in addition to WinForms UserControl
 * Resolves several issues with DPI
 * Better UI performance overall (including swaps and switching between Normal / Full Screen)

Introduces FlyleafME, a WPF Media Element Control (Flyleaf replacement)
 * Code clean-up and styles / templates to allow easier override and customization
 * Updated with the new FlyleafHost (old ViewView) and gains better performance with more functionality
 * Adds Activity Timeout on Settings
 * Adds Rotation to Popup menu
 * Fixes several issues with DPI
 * Fixes issues with Activity / Idle Mode
 * Fixes an issue to respect Subtitles FontStyle
 * Updates FlyleafLib

Player
 * Adds Rotation Support (Shift + Wheel)
 * Fixes a UI threading issue that it could cause Player.Initialization to crash
 * Fixes Activity / Idle Mode issues
 * General code clean-up and performance improvements

Breaking Changes
 * VideoView has been renamed to FlyleafHost
 * Flyleaf (WPF Control) has been renamed to FlyleafME (Media Element) and does not require a FlyleafHost as it was required previously with the VideoView (it derives from it)
 * Player.IsFullScreen, Config.Player.ActivityTimeout, Config.Player.MouseBindings and Config.Player.KeyBindings.(Enabled/FlyleafWindow) has been transferred to FlyleafHost
 * Player.ActivityMode has been removed (its the same as ActivityTimeout=0) however Player.Activity.IsEnabled can be used to temporary turn it on/off
 * Player.Swap has been removed as you can now set directly the Players to FlyleafHosts
diff --git a/FlyleafLib.Controls.WPF/FlyleafLib.Controls.WPF.csproj b/FlyleafLib.Controls.WPF/FlyleafLib.Controls.WPF.csproj
@@ -4,18 +4,28 @@
     <TargetFrameworks>net6.0-windows;net5.0-windows;net472</TargetFrameworks>
 	<UseWindowsForms>true</UseWindowsForms>
     <UseWPF>true</UseWPF>
-    <Version>1.2-pre3</Version>
+    <Version>1.2</Version>
     <Authors>SuRGeoNix</Authors>
     <Copyright>SuRGeoNix © 2022</Copyright>
     <PackageLicenseExpression>LGPL-3.0-or-later</PackageLicenseExpression>
     <PackageProjectUrl>https://github.com/SuRGeoNix/Flyleaf</PackageProjectUrl>
     <PackageIcon>Flyleaf.png</PackageIcon>
     <PackageIconUrl />
-    <PackageTags>flyleaf flyleaflib video audio media player element control</PackageTags>
-    <Description>WPF Media Player Control/Element (based on FlyleafLib)</Description>
+    <PackageTags>flyleaf flyleaflib flyleafme video audio wpf media player element control</PackageTags>
+    <Description>FlyleafME: A WPF Media Element Control (based on FlyleafLib)</Description>
     <PackageReleaseNotes>
-		* Adds Rotation to popup menu
-		* Updates FlyleafLib
+		Introduces FlyleafME WPF Media Element Control (Flyleaf replacement)
+		    * Code clean-up and styles / templates to allow easier override and customization
+		    * Updated with the new FlyleafHost (old ViewView) and gains better performance with more functionality
+		    * Adds Activity Timeout on Settings
+		    * Adds Rotation to Popup menu
+		    * Fixes several issues with DPI
+		    * Fixes issues with Activity / Idle Mode
+		    * Fixes an issue to respect Subtitles FontStyle
+		    * Updates FlyleafLib
+
+		Breaking Changes
+		    * Flyleaf (WPF Control) has been renamed to FlyleafME (Media Element) and does not require a FlyleafHost as it was required previously with the VideoView (it derives from it)
 	</PackageReleaseNotes>
   </PropertyGroup>
 
diff --git a/FlyleafLib/FlyleafLib.csproj b/FlyleafLib/FlyleafLib.csproj
@@ -8,7 +8,7 @@
 	<PackageIconUrl />
 	<RepositoryUrl></RepositoryUrl>
 	<Description>Media Player .NET Library for WPF/WinForms (based on FFmpeg/DirectX)</Description>
-	<Version>3.6-pre3</Version>
+	<Version>3.6</Version>
 	<Authors>SuRGeoNix</Authors>
 	<Copyright>SuRGeoNix © 2022</Copyright>
 	<PackageLicenseExpression>LGPL-3.0-or-later</PackageLicenseExpression>
@@ -17,10 +17,29 @@
 	<IncludeSymbols>true</IncludeSymbols>
     <SymbolPackageFormat>snupkg</SymbolPackageFormat>
     <PackageReleaseNotes>
-		* Player: Adds Rotation support
-		* Player.Commands: Adds RotationSet
-		* Renderer: Fixes an issue after Player.Stop
-		* WPF.FlyleafHost: Fixes issues with Designer, Activity, Resize and Window States
+		Introduces FlyleafHost a new DPI aware, hardware accelerated Direct3D Surface (WPF VideoView's replacement and Flyleaf's for Winforms)
+			* Early and fast initialization of handles and renderer which will also resolve several issues
+			* Adds Attach / Detach functionality
+			* Self Drag Move also on attach mode (within the host's owner bounds)
+			* Drag &amp; Drop Swap between FlyleafHosts (Shift + Drag)
+			* Custom non-borders resizable windows both on attach and detach mode (can keep input's ratio)
+			* Adds Z-order surfaces support
+			* Resolves several issues when the host's rectangle was clipped
+			* Adds support for WPF Windows to the Renderer in addition to WinForms UserControl
+			* Resolves several issues with DPI
+			* Better UI performance overall (including swaps and switching between Normal / Full Screen)
+			
+		Player
+			* Adds Rotation Support (Shift + Wheel)
+			* Fixes a UI threading issue that it could cause Player.Initialization to crash
+			* Fixes Activity / Idle mode issues
+			* General code clean-up and performance improvements
+			
+		Breaking Changes
+			* VideoView has been renamed to FlyleafHost
+			* Player.IsFullScreen, Config.Player.ActivityTimeout, Config.Player.MouseBindings and Config.Player.KeyBindings.(Enabled/FlyleafWindow) has been transferred to FlyleafHost
+			* Player.ActivityMode has been removed (its the same as ActivityTimeout=0) however Player.Activity.IsEnabled can be used to temporary turn it on/off
+			* Player.Swap has been removed as you can now set directly the Players to FlyleafHosts
 	</PackageReleaseNotes>
   </PropertyGroup>
 
diff --git a/README.md b/README.md
@@ -1,4 +1,4 @@
-# *Flyleaf v3.6*: Media Player .NET Library for WPF / WinForms (based on FFmpeg/DirectX)
+﻿# *Flyleaf v3.6*: Media Player .NET Library for WPF / WinForms (based on FFmpeg/DirectX)
 
 ![alt text](Images/Flyleafv3.6.png)
 
@@ -11,43 +11,35 @@
 
 # [Overview]
 
-**Play Everything** <sub>(Audio, Videos, Images, Playlists over any Protocol)</sub>
+✅ **Play Everything** <sub>(Audio, Videos, Images, Playlists over any Protocol)</sub>
 
 - *Extends FFmpeg's support for protocols and formats with additional plugins <sub>(YoutubeDL, TorrentBitSwarm)</sub>*
 - *Supports custom I/O stream inputs to extend formats support even further if required*
 	
-**Play it Smoothly** <sub>(Even with high resolutions 4K / HDR)</sub>
+✅ **Play it Smoothly** <sub>(Even with high resolutions 4K / HDR)</sub>
 
 - *Coded from scratch to gain the best possible performance with FFmpeg & DirectX using video acceleration and custom pixel shaders*
 - *Threading implementation with efficient cancellation which allows fast open, play, pause, stop, seek and stream switching*
 	
-**Develop it Easy**
+✅ **Develop it Easy**
 
 - *Provides a DPI aware, hardware accelerated Direct3D Surface (FlyleafHost) which can be hosted as normal control to your application and easily develop above it your own transparent overlay content*
 - *All the implementation uses UI notifications (PropertyChanged / ObservableCollection etc.) so you can use it as a ViewModel directly*    
 - *For WPF provides a Control (FlyleafME) with all the basic UI sub-controls (Bar, Settings, Popup menu) and can be customized with style / control template overrides*
 
 # [Features]
 
+### **FFmpeg**
+- *HLS Live Seeking* <sub>Might the 1st FFmpeg player which does that</sub>
+- *Pached for [HLS issue](https://patchwork.ffmpeg.org/project/ffmpeg/list/?series=1018)* <sub>Use recommended FFmpeg libraries which can be found on GitHub releases</sub>
+- *Supports both FFmpeg v4 and v5* <sub>Even if the library uses FFmpeg.Autogen v4, it supports and you can use v5 **in your application**</sub>
+
 ### **Playback**
 - *Open / Play / Pause / Stop*
 - *Speed / Reverse / Zero-Low Latency*
 - *Seek Backward / Forward (Short / Large Step)*
 - *Seek to Time / Seek to Frame / Seek to Chapter / Frame Stepping*
 
-### **Audio**
-- *Enable / Disable*
-- *Device Preference*
-- *Add / Remove Delay (Short / Large Step)*
-- *Volume (Up / Down / Mute)*
-- *Languages support* <sub>System's default languages as priorities for audio streams</sub>
-
-### **Subtitles**
-- *Enable / Disable*
-- *Add / Remove Delay (Short / Large Step)*
-- *Advanced Character Detection and Convert to UTF-8* <sub>SubtitlesConverter plugin</sub>
-- *Languages support* <sub>System's default languages as priorities for subtitles streams</sub>
-
 ### **Video**
 - *Enable / Disable*
 - *Device Preference*
@@ -62,6 +54,19 @@
 - *VSync*
 - *Zero-Copy*
 
+### **Audio**
+- *Enable / Disable*
+- *Device Preference*
+- *Add / Remove Delay (Short / Large Step)*
+- *Volume (Up / Down / Mute)*
+- *Languages support* <sub>System's default languages as priorities for audio streams</sub>
+
+### **Subtitles**
+- *Enable / Disable*
+- *Add / Remove Delay (Short / Large Step)*
+- *Advanced Character Detection and Convert to UTF-8* <sub>SubtitlesConverter plugin</sub>
+- *Languages support* <sub>System's default languages as priorities for subtitles streams</sub>
+
 ### **UI Control (FlyleafHost)**<sub>WPF / WinForms (Partialy)</sub>
 - *Attach / Detach*
 - *Activity / Idle Mode*
@@ -85,13 +90,9 @@
 - *TorrentBitSwarm* <sub>Play a media from torrent without the need to download it completely</sub>
 - *YoutubeDL* <sub>Play web media that are not accessible directly with HTTP(s)</sub>
 
-### **FFmpeg**
-- *HLS Live Seeking* <sub>Might the 1st FFmpeg player which does that</sub>
-- *Pached for [HLS issue](https://patchwork.ffmpeg.org/project/ffmpeg/list/?series=1018)* <sub>Use recommended FFmpeg libraries which can be found on the releases</sub>
-- *Supports both FFmpeg v4 and v5* <sub>Even if the library uses FFmpeg.Autogen v4, it supports and you can use v5 **in your application**</sub>
-
 ### Misc.
-- *Mouse & Key Bindings* <sub>All the implementation supports customizable mouse & key bindings which can be assigned to embedded or custom actions (find defaults [here](https://github.com/SuRGeoNix/Flyleaf/wiki/Player-(Key-&-Mouse-Bindings)))</sub>
+- *Mouse & Key Bindings* <sub>All the implementation supports customizable mouse & key bindings which can be assigned to an embedded or a custom actions (find defaults [here](https://github.com/SuRGeoNix/Flyleaf/wiki/Player-(Key-&-Mouse-Bindings)))</sub>
+- *Audio Player* <sub>Can be used as an audio player only without the need of UI Control</sub>
 - *Downloader / Remuxer* <sub>The library can be used also for downloading & remuxing</sub>
 - *Extractor* <sub>The library can be used also for extracting video frames (supports also by X frames Step)</sub>
 
