/// <summary>
/// Releases unmanaged and - optionally - managed resources.
/// </summary>
/// <param name="alsoManaged"><c>true</c> to release both managed and unmanaged resources; <c>false</c> to release only unmanaged resources.</param>
private void Dispose(bool alsoManaged)
{
if (IsDisposed)
{
return;
}
if (alsoManaged)
{
// free managed resources
Commands.Close();
if (Container != null)
{
Container.Dispose();
Container = null;
}
if (UIPropertyUpdateTimer != null)
{
UIPropertyUpdateTimer.Stop();
UIPropertyUpdateTimer.IsEnabled = false;
UIPropertyUpdateTimer = null;
}
PacketReadingCycle.Dispose();
FrameDecodingCycle.Dispose();
BlockRenderingCycle.Dispose();
SeekingDone.Dispose();
DelayLock.Dispose();
}
IsDisposed = true;
}
/// <summary>
/// Releases unmanaged and - optionally - managed resources.
/// Please not that this call is non-blocking/asynchronous.
/// </summary>
/// <param name="alsoManaged"><c>true</c> to release both managed and unmanaged resources; <c>false</c> to release only unmanaged resources.</param>
private void Dispose(bool alsoManaged)
{
if (IsDisposed)
{
return;
}
// Run the close command immediately
if (BeginSynchronousCommand() == false)
{
return;
}
// Dispose the wait handle: No more command accepted from this point forward.
SynchronousCommandDone.Dispose();
try
{
var closeCommand = new CloseCommand(Commands);
closeCommand.RunSynchronously();
}
catch { throw; }
finally
{
IsDisposed = true;
}
// Dispose the container
Container?.Dispose();
Container = null;
// Dispose the RTC
Clock.Dispose();
// Dispose the Wait Event objects as they are
// backed by unmanaged code
PacketReadingCycle.Dispose();
FrameDecodingCycle.Dispose();
BlockRenderingCycle.Dispose();
SeekingDone.Dispose();
MediaChangingDone.Dispose();
}
/// <summary>
/// Performs a seek operation to the specified position.
/// </summary>
/// <param name="position">The position.</param>
private void Seek(TimeSpan position)
{
SeekingDone.Wait();
var startTime = DateTime.UtcNow;
var resumeClock = Clock.IsRunning;
Clock.Pause();
SeekingDone.Reset();
PacketReadingCycle.Wait();
FrameDecodingCycle.Wait();
BlockRenderingCycle.Wait();
// Clear Blocks and frames, reset the render times
foreach (var t in Container.Components.MediaTypes)
{
Frames[t].Clear();
Blocks[t].Clear();
LastRenderTime[t] = TimeSpan.MinValue;
}
// Populate frame with after-seek operation
var frames = Container.Seek(position);
foreach (var frame in frames)
{
Frames[frame.MediaType].Push(frame);
}
// Resume the clock if it was running before the seek operation
OnPropertyChanged(nameof(Position));
if (resumeClock)
{
Clock.Play();
}
Container.Log(MediaLogMessageType.Debug,
$"SEEK D: Elapsed: {startTime.DebugElapsedUtc()}");
RequestedSeekPosition = null;
SeekingDone.Set();
}
/// <summary>
/// Initializes the media block buffers and
/// starts packet reader, frame decoder, and block rendering workers.
/// </summary>
internal void StartWorkers()
{
// Initialize the block buffers
foreach (var t in Container.Components.MediaTypes)
{
Blocks[t] = new MediaBlockBuffer(Constants.MaxBlocks[t], t);
Renderers[t] = Platform.CreateRenderer(t, this);
InvalidateRenderer(t);
}
// Create the renderer for the preloaded subs
if (PreloadedSubtitles != null)
{
Renderers[PreloadedSubtitles.MediaType] = Platform.CreateRenderer(PreloadedSubtitles.MediaType, this);
InvalidateRenderer(PreloadedSubtitles.MediaType);
}
Clock.SpeedRatio = Constants.Controller.DefaultSpeedRatio;
Commands.IsStopWorkersPending = false;
// Set the initial state of the task cycles.
BlockRenderingCycle.Complete();
FrameDecodingCycle.Begin();
PacketReadingCycle.Begin();
// Create the thread runners
PacketReadingTask = new Thread(RunPacketReadingWorker)
{
IsBackground = true, Name = nameof(PacketReadingTask), Priority = ThreadPriority.Normal
};
FrameDecodingTask = new Thread(RunFrameDecodingWorker)
{
IsBackground = true, Name = nameof(FrameDecodingTask), Priority = ThreadPriority.AboveNormal
};
// Fire up the threads
PacketReadingTask.Start();
FrameDecodingTask.Start();
StartBlockRenderingWorker();
}
/// <inheritdoc />
public void Dispose()
{
if (m_IsDisposed == true)
{
return;
}
m_IsDisposed.Value = true;
// Dispose of commands. This closes the
// Media automatically and signals an exit
// This also causes the Container to get disposed.
Commands.Dispose();
// Reset the RTC
ResetPosition();
// Dispose the Wait Event objects as they are
// backed by unmanaged code
PacketReadingCycle.Dispose();
FrameDecodingCycle.Dispose();
BlockRenderingCycle.Dispose();
BufferChangedEvent.Dispose();
}
/// <summary>
/// Continually decodes the available packet buffer to have as
/// many frames as possible in each frame queue and
/// up to the MaxFrames on each component
/// </summary>
internal void RunFrameDecodingWorker()
{
#region Worker State Setup
// The delay provider prevents 100% core usage
var delay = new DelayProvider();
// State variables
var decodedFrameCount = 0;
var wallClock = TimeSpan.Zero;
var rangePercent = 0d;
var isInRange = false;
var playAfterSeek = false;
// Holds the main media type
var main = Container.Components.Main.MediaType;
// Holds the auxiliary media types
var auxs = Container.Components.MediaTypes.ExcludeMediaType(main);
// Holds all components
var all = Container.Components.MediaTypes.DeepCopy();
var isBuffering = false;
var resumeClock = false;
var hasPendingSeeks = false;
MediaComponent comp = null;
MediaBlockBuffer blocks = null;
#endregion
#region Worker Loop
try
{
while (IsTaskCancellationPending == false)
{
#region 1. Setup the Decoding Cycle
// Singal a Seek starting operation
hasPendingSeeks = Commands.PendingCountOf(MediaCommandType.Seek) > 0;
if (State.IsSeeking == false && hasPendingSeeks)
{
playAfterSeek = State.IsPlaying;
State.IsSeeking = true;
SendOnSeekingStarted();
}
// Execute the following command at the beginning of the cycle
Commands.ProcessNext();
// Wait for a seek operation to complete (if any)
// and initiate a frame decoding cycle.
SeekingDone.Wait();
// Set initial state
wallClock = WallClock;
decodedFrameCount = 0;
// Signal a Seek ending operation
// TOD: Maybe this should go on the block rendering worker?
hasPendingSeeks = Commands.PendingCountOf(MediaCommandType.Seek) > 0;
if (State.IsSeeking && hasPendingSeeks == false)
{
// Detect a end of seek cycle and update to the final position
wallClock = SnapToFramePosition(WallClock);
Clock.Update(wallClock);
State.UpdatePosition(wallClock);
// Call the seek method on all renderers
foreach (var kvp in Renderers)
{
LastRenderTime[kvp.Key] = TimeSpan.MinValue;
kvp.Value.Seek();
}
SendOnSeekingEnded();
State.IsSeeking = false;
if (playAfterSeek)
{
Clock.Play();
State.UpdateMediaState(PlaybackStatus.Play);
}
else
{
State.UpdateMediaState(PlaybackStatus.Pause);
}
}
else if (State.IsSeeking == false)
{
// Notify position changes
State.UpdatePosition(wallClock);
}
// Initiate the frame docding cycle
FrameDecodingCycle.Begin();
#endregion
#region 2. Main Component Decoding
// Capture component and blocks for easier readability
comp = Container.Components[main];
blocks = Blocks[main];
// Handle the main component decoding; Start by checking we have some packets
while (comp.PacketBufferCount <= 0 && CanReadMorePackets && ShouldReadMorePackets)
{
PacketReadingCycle.Wait(Constants.Interval.LowPriority);
}
if (comp.PacketBufferCount > 0)
{
// Detect if we are in range for the main component
isInRange = blocks.IsInRange(wallClock);
if (isInRange == false)
{
// Signal the start of a sync-buffering scenario
HasDecoderSeeked = true;
isBuffering = true;
resumeClock = Clock.IsRunning;
Clock.Pause();
Log(MediaLogMessageType.Debug, $"SYNC-BUFFER: Started.");
// Read some frames and try to get a valid range
do
{
// Try to get more packets by waiting for read cycles.
if (CanReadMorePackets && comp.PacketBufferCount <= 0)
{
PacketReadingCycle.Wait();
}
// Decode some frames and check if we are in reange now
decodedFrameCount += AddBlocks(main);
isInRange = blocks.IsInRange(wallClock);
// Break the cycle if we are in range
if (isInRange || CanReadMorePackets == false)
{
break;
}
}while (decodedFrameCount <= 0 && blocks.IsFull == false);
// Unfortunately at this point we will need to adjust the clock after creating the frames.
// to ensure tha mian component is within the clock range if the decoded
// frames are not with range. This is normal while buffering though.
if (isInRange == false)
{
// Update the wall clock to the most appropriate available block.
if (blocks.Count > 0)
{
wallClock = blocks[wallClock].StartTime;
}
else
{
resumeClock = false; // Hard stop the clock.
}
// Update the clock to what the main component range mandates
Clock.Update(wallClock);
// Call seek to invalidate renderer
LastRenderTime[main] = TimeSpan.MinValue;
Renderers[main].Seek();
// Try to recover the regular loop
isInRange = true;
while (CanReadMorePackets && comp.PacketBufferCount <= 0)
{
PacketReadingCycle.Wait();
}
}
}
if (isInRange)
{
// Check if we need more blocks for the current components
rangePercent = blocks.GetRangePercent(wallClock);
// Read as much as we can for this cycle.
while (comp.PacketBufferCount > 0)
{
rangePercent = blocks.GetRangePercent(wallClock);
if (blocks.IsFull == false || (blocks.IsFull && rangePercent > 0.75d && rangePercent < 1d))
{
decodedFrameCount += AddBlocks(main);
}
else
{
break;
}
}
}
}
#endregion
#region 3. Auxiliary Component Decoding
foreach (var t in auxs)
{
if (State.IsSeeking)
{
continue;
}
// Capture the current block buffer and component
// for easier readability
comp = Container.Components[t];
blocks = Blocks[t];
isInRange = blocks.IsInRange(wallClock);
// Invalidate the renderer if we don't have the block.
if (isInRange == false)
{
LastRenderTime[t] = TimeSpan.MinValue;
Renderers[t].Seek();
}
// wait for component to get there if we only have furutre blocks
// in auxiliary component.
if (blocks.Count > 0 && blocks.RangeStartTime > wallClock)
{
continue;
}
// Try to catch up with the wall clock
while (blocks.Count == 0 || blocks.RangeEndTime <= wallClock)
{
// Wait for packets if we don't have enough packets
if (CanReadMorePackets && comp.PacketBufferCount <= 0)
{
PacketReadingCycle.Wait();
}
if (comp.PacketBufferCount <= 0)
{
break;
}
else
{
decodedFrameCount += AddBlocks(t);
}
}
isInRange = blocks.IsInRange(wallClock);
// Move to the next component if we don't meet a regular conditions
if (isInRange == false || isBuffering || comp.PacketBufferCount <= 0)
{
continue;
}
// Read as much as we can for this cycle.
while (comp.PacketBufferCount > 0)
{
rangePercent = blocks.GetRangePercent(wallClock);
if (blocks.IsFull == false || (blocks.IsFull && rangePercent > 0.75d && rangePercent < 1d))
{
decodedFrameCount += AddBlocks(t);
}
else
{
break;
}
}
}
#endregion
#region 4. Detect End of Media
// Detect end of block rendering
// TODO: Maybe this detection should be performed on the BlockRendering worker?
if (isBuffering == false &&
State.IsSeeking == false &&
CanReadMoreFramesOf(main) == false &&
Blocks[main].IndexOf(wallClock) == Blocks[main].Count - 1)
{
if (State.HasMediaEnded == false)
{
// Rendered all and nothing else to read
Clock.Pause();
if (State.NaturalDuration != null && State.NaturalDuration != TimeSpan.MinValue)
{
wallClock = State.NaturalDuration.Value;
}
else
{
wallClock = Blocks[main].RangeEndTime;
}
Clock.Update(wallClock);
State.HasMediaEnded = true;
State.UpdateMediaState(PlaybackStatus.Stop, wallClock);
SendOnMediaEnded();
}
}
else
{
State.HasMediaEnded = false;
}
#endregion
#region 6. Finish the Cycle
// complete buffering notifications
if (isBuffering)
{
// Reset the buffering flag
isBuffering = false;
// Resume the clock if it was playing
if (resumeClock)
{
Clock.Play();
}
// log some message
Log(
MediaLogMessageType.Debug,
$"SYNC-BUFFER: Finished. Clock set to {wallClock.Format()}");
}
// Complete the frame decoding cycle
FrameDecodingCycle.Complete();
// After a seek operation, always reset the has seeked flag.
HasDecoderSeeked = false;
// If not already set, guess the 1-second buffer length
State.GuessBufferingProperties();
// Give it a break if there was nothing to decode.
// We probably need to wait for some more input
if (decodedFrameCount <= 0 && Commands.PendingCount <= 0)
{
delay.WaitOne();
}
#endregion
}
}
catch (ThreadAbortException) { /* swallow */ }
catch { if (!IsDisposed)
{
throw;
}
}
finally
{
// Always exit notifying the cycle is done.
FrameDecodingCycle.Complete();
delay.Dispose();
}
#endregion
}
/// <summary>
/// Starts the block rendering worker.
/// </summary>
private void StartBlockRenderingWorker()
{
if (BlockRenderingWorkerExit != null)
{
return;
}
BlockRenderingWorkerExit = WaitEventFactory.Create(isCompleted: false, useSlim: true);
// Holds the main media type
var main = Container.Components.MainMediaType;
// Holds all components
var all = Renderers.Keys.ToArray();
// Holds a snapshot of the current block to render
var currentBlock = new MediaTypeDictionary <MediaBlock>();
// Keeps track of how many blocks were rendered in the cycle.
var renderedBlockCount = new MediaTypeDictionary <int>();
// wait for main component blocks or EOF or cancellation pending
while (CanReadMoreFramesOf(main) && Blocks[main].Count <= 0)
{
FrameDecodingCycle.Wait(Constants.Interval.LowPriority);
}
// Set the initial clock position
var wallClock = ChangePosition(Blocks[main].RangeStartTime);
// Wait for renderers to be ready
foreach (var t in all)
{
Renderers[t]?.WaitForReadyState();
}
// The Render timer is responsible for sending frames to renders
BlockRenderingWorker = new Timer((s) =>
{
#region Detect Exit/Skip Conditions
if (Commands.IsStopWorkersPending || BlockRenderingWorkerExit.IsCompleted || IsDisposed)
{
BlockRenderingWorkerExit?.Complete();
return;
}
// Skip the cycle if it's already running
if (BlockRenderingCycle.IsInProgress)
{
Log(MediaLogMessageType.Trace, $"SKIP: {nameof(BlockRenderingWorker)} already in a cycle. {WallClock}");
return;
}
#endregion
#region Run the Rendering Cycle
try
{
#region 1. Control and Capture
// Wait for the seek op to finish before we capture blocks
Commands.WaitForActiveSeekCommand();
// Signal the start of a block rendering cycle
BlockRenderingCycle.Begin();
// Skip the cycle if we are running a priority command
if (Commands.IsExecutingDirectCommand)
{
return;
}
// Updatete Status Properties
main = Container.Components.MainMediaType;
all = Renderers.Keys.ToArray();
// Reset the rendered count to 0
foreach (var t in all)
{
renderedBlockCount[t] = 0;
}
#endregion
#region 2. Handle Block Rendering
// capture the wall clock for this cycle
wallClock = WallClock;
// Capture the blocks to render
foreach (var t in all)
{
// Get the audio, video, or subtitle block to render
currentBlock[t] = (t == MediaType.Subtitle && PreloadedSubtitles != null) ?
PreloadedSubtitles[wallClock] :
currentBlock[t] = Blocks[t][wallClock];
}
// Render each of the Media Types if it is time to do so.
foreach (var t in all)
{
// Skip rendering for nulls
if (currentBlock[t] == null || currentBlock[t].IsDisposed)
{
continue;
}
// Render by forced signal (TimeSpan.MinValue) or because simply it is time to do so
if (LastRenderTime[t] == TimeSpan.MinValue || currentBlock[t].StartTime != LastRenderTime[t])
{
renderedBlockCount[t] += SendBlockToRenderer(currentBlock[t], wallClock, main);
}
}
#endregion
#region 3. Finalize the Rendering Cycle
// Call the update method on all renderers so they receive what the new wall clock is.
foreach (var t in all)
{
Renderers[t]?.Update(wallClock);
}
#endregion
}
catch { throw; }
finally
{
// Update the Position
if (IsWorkerInterruptRequested == false && IsSyncBuffering == false)
{
State.UpdatePosition(Clock.IsRunning ? wallClock : Clock.Position);
}
// Always exit notifying the cycle is done.
BlockRenderingCycle.Complete();
}
#endregion
},
this, // the state argument passed on to the ticker
0,
Convert.ToInt32(Constants.Interval.HighPriority.TotalMilliseconds));
}
/// <summary>
/// Continually decodes the available packet buffer to have as
/// many frames as possible in each frame queue and
/// up to the MaxFrames on each component
/// </summary>
internal void RunFrameDecodingWorker()
{
// TODO: Don't use State properties in workers as they are only for
// TODO: Check the use of wall clock. Maybe it's be more consistent
// to use a single atomic wallclock value per cycle. Check other workers as well.
// state notification purposes.
// State variables
var wasSyncBuffering = false;
var delay = new DelayProvider(); // The delay provider prevents 100% core usage
var decodedFrameCount = 0;
var rangePercent = 0d;
var main = Container.Components.MainMediaType; // Holds the main media type
var resumeSyncBufferingClock = false;
MediaBlockBuffer blocks = null;
try
{
while (Commands.IsStopWorkersPending == false)
{
#region Setup the Decoding Cycle
// Determine what to do on a priority command
if (Commands.IsExecutingDirectCommand)
{
if (Commands.IsClosing)
{
break;
}
if (Commands.IsChanging)
{
Commands.WaitForDirectCommand();
}
}
// Execute the following command at the beginning of the cycle
if (IsSyncBuffering == false)
{
Commands.ExecuteNextQueuedCommand();
}
// Signal a Seek starting operation and set the initial state
FrameDecodingCycle.Begin();
// Update state properties -- this must be after processing commanmds as
// a direct command might have changed the components
main = Container.Components.MainMediaType;
decodedFrameCount = 0;
#endregion
// The 2-part logic blocks detect a sync-buffering scenario
// and then decodes the necessary frames.
if (State.HasMediaEnded == false && IsWorkerInterruptRequested == false)
{
#region Sync-Buffering
// Capture the blocks for easier readability
blocks = Blocks[main];
// If we are not then we need to begin sync-buffering
if (wasSyncBuffering == false && blocks.IsInRange(WallClock) == false)
{
// Signal the start of a sync-buffering scenario
IsSyncBuffering = true;
wasSyncBuffering = true;
resumeSyncBufferingClock = Clock.IsRunning;
Clock.Pause();
State.UpdateMediaState(PlaybackStatus.Manual);
Log(MediaLogMessageType.Debug, $"SYNC-BUFFER: Started.");
}
#endregion
#region Component Decoding
// We need to add blocks if the wall clock is over 75%
// for each of the components so that we have some buffer.
foreach (var t in Container.Components.MediaTypes)
{
if (IsWorkerInterruptRequested)
{
break;
}
// Capture a reference to the blocks and the current Range Percent
const double rangePercentThreshold = 0.75d;
blocks = Blocks[t];
rangePercent = blocks.GetRangePercent(WallClock);
// Read as much as we can for this cycle but always within range.
while (blocks.IsFull == false || rangePercent > rangePercentThreshold)
{
// Stop decoding under sync-buffering conditions
if (IsSyncBuffering && blocks.IsFull)
{
break;
}
if (IsWorkerInterruptRequested || AddNextBlock(t) == false)
{
break;
}
decodedFrameCount += 1;
rangePercent = blocks.GetRangePercent(WallClock);
// Determine break conditions to save CPU time
if (IsSyncBuffering == false &&
rangePercent > 0 &&
rangePercent <= rangePercentThreshold &&
blocks.IsFull == false &&
blocks.CapacityPercent >= 0.25d &&
blocks.IsInRange(WallClock))
{
break;
}
}
}
// Give it a break if we are still buffering packets
if (IsSyncBuffering)
{
delay.WaitOne();
FrameDecodingCycle.Complete();
continue;
}
#endregion
}
#region Finish the Cycle
// Detect End of Media Scenarios
DetectEndOfMedia(decodedFrameCount, main);
// Resume sync-buffering clock
if (wasSyncBuffering && IsSyncBuffering == false)
{
// Sync-buffering blocks
blocks = Blocks[main];
// Unfortunately at this point we will need to adjust the clock after creating the frames.
// to ensure tha mian component is within the clock range if the decoded
// frames are not with range. This is normal while buffering though.
if (blocks.IsInRange(WallClock) == false)
{
// Update the wall clock to the most appropriate available block.
if (blocks.Count > 0)
{
ChangePosition(blocks[WallClock].StartTime);
}
else
{
resumeSyncBufferingClock = false; // Hard stop the clock.
}
}
// log some message and resume the clock if it was playing
Log(MediaLogMessageType.Debug, $"SYNC-BUFFER: Finished. Clock set to {WallClock.Format()}");
if (resumeSyncBufferingClock && State.HasMediaEnded == false)
{
ResumePlayback();
}
wasSyncBuffering = false;
resumeSyncBufferingClock = false;
}
// Provide updates to decoding stats
State.UpdateDecodingBitrate(
Blocks.Values.Sum(b => b.IsInRange(WallClock) ? b.RangeBitrate : 0));
// Complete the frame decoding cycle
FrameDecodingCycle.Complete();
// Give it a break if there was nothing to decode.
DelayDecoder(delay, decodedFrameCount);
#endregion
}
}
catch { throw; }
finally
{
// Reset decoding stats
State.UpdateDecodingBitrate(0);
// Always exit notifying the cycle is done.
FrameDecodingCycle.Complete();
delay.Dispose();
}
}
/// <summary>
/// Starts the block rendering worker.
/// </summary>
private void StartBlockRenderingWorker()
{
if (HasBlockRenderingWorkerExited != null)
{
return;
}
HasBlockRenderingWorkerExited = new ManualResetEvent(false);
// Synchronized access to parts of the run cycle
var isRunningRenderingCycle = false;
// Holds the main media type
var main = Container.Components.Main.MediaType;
// Holds the auxiliary media types
var auxs = Container.Components.MediaTypes.ExcludeMediaType(main);
// Holds all components
var all = Container.Components.MediaTypes.DeepCopy();
// Holds a snapshot of the current block to render
var currentBlock = new MediaTypeDictionary <MediaBlock>();
// Keeps track of how many blocks were rendered in the cycle.
var renderedBlockCount = new MediaTypeDictionary <int>();
// reset render times for all components
foreach (var t in all)
{
LastRenderTime[t] = TimeSpan.MinValue;
}
// Ensure packet reading is running
PacketReadingCycle.WaitOne();
// wait for main component blocks or EOF or cancellation pending
while (CanReadMoreFramesOf(main) && Blocks[main].Count <= 0)
{
FrameDecodingCycle.WaitOne();
}
// Set the initial clock position
// TODO: maybe update media start time offset to this Minimum, initial Start Time intead of relying on contained meta?
Clock.Update(Blocks[main].RangeStartTime); // .GetMinStartTime()
var wallClock = WallClock;
// Wait for renderers to be ready
foreach (var t in all)
{
Renderers[t]?.WaitForReadyState();
}
// The Render timer is responsible for sending frames to renders
BlockRenderingWorker = new Timer((s) =>
{
#region Detect a Timer Stop
if (IsTaskCancellationPending || HasBlockRenderingWorkerExited.IsSet() || IsDisposed)
{
HasBlockRenderingWorkerExited.Set();
return;
}
#endregion
#region Run the Rendering Cycle
// Updatete Status Properties
State.UpdateBufferingProperties();
// Don't run the cycle if it's already running
if (isRunningRenderingCycle)
{
// TODO: Maybe Log a frame skip here?
return;
}
try
{
#region 1. Control and Capture
// Flag the current rendering cycle
isRunningRenderingCycle = true;
// Reset the rendered count to 0
foreach (var t in all)
{
renderedBlockCount[t] = 0;
}
// Capture current clock position for the rest of this cycle
BlockRenderingCycle.Reset();
#endregion
#region 2. Handle Block Rendering
// Wait for the seek op to finish before we capture blocks
if (HasDecoderSeeked)
{
SeekingDone.WaitOne();
}
// capture the wall clock for this cycle
wallClock = WallClock;
// Capture the blocks to render
foreach (var t in all)
{
currentBlock[t] = Blocks[t][wallClock];
}
// Render each of the Media Types if it is time to do so.
foreach (var t in all)
{
// Skip rendering for nulls
if (currentBlock[t] == null)
{
continue;
}
// Render by forced signal (TimeSpan.MinValue)
if (LastRenderTime[t] == TimeSpan.MinValue)
{
renderedBlockCount[t] += SendBlockToRenderer(currentBlock[t], wallClock);
continue;
}
// Render because we simply have not rendered
if (currentBlock[t].StartTime != LastRenderTime[t])
{
renderedBlockCount[t] += SendBlockToRenderer(currentBlock[t], wallClock);
continue;
}
}
#endregion
#region 6. Finalize the Rendering Cycle
// Call the update method on all renderers so they receive what the new wall clock is.
foreach (var t in all)
{
Renderers[t]?.Update(wallClock);
}
#endregion
}
catch (ThreadAbortException) { /* swallow */ }
catch { if (!IsDisposed)
{
throw;
}
}
finally
{
// Always exit notifying the cycle is done.
BlockRenderingCycle.Set();
isRunningRenderingCycle = false;
}
#endregion
},
this, // the state argument passed on to the ticker
0,
(int)Constants.Interval.HighPriority.TotalMilliseconds);
}
/// <summary>
/// Starts the block rendering worker.
/// </summary>
private void StartBlockRenderingWorker()
{
if (BlockRenderingWorkerExit != null)
{
return;
}
BlockRenderingWorkerExit = WaitEventFactory.Create(isCompleted: false, useSlim: true);
// Synchronized access to parts of the run cycle
var isRunningRenderingCycle = false;
// Holds the main media type
var main = Container.Components.Main.MediaType;
// Holds all components
var all = Renderers.Keys.ToArray();
// Holds a snapshot of the current block to render
var currentBlock = new MediaTypeDictionary <MediaBlock>();
// Keeps track of how many blocks were rendered in the cycle.
var renderedBlockCount = new MediaTypeDictionary <int>();
// reset render times for all components
foreach (var t in all)
{
LastRenderTime[t] = TimeSpan.MinValue;
}
// Ensure packet reading is running
PacketReadingCycle.Wait();
// wait for main component blocks or EOF or cancellation pending
while (CanReadMoreFramesOf(main) && Blocks[main].Count <= 0)
{
FrameDecodingCycle.Wait();
}
// Set the initial clock position
Clock.Update(Blocks[main].RangeStartTime);
var wallClock = WallClock;
// Wait for renderers to be ready
foreach (var t in all)
{
Renderers[t]?.WaitForReadyState();
}
// The Render timer is responsible for sending frames to renders
BlockRenderingWorker = new Timer((s) =>
{
#region Detect a Timer Stop
if (IsTaskCancellationPending || BlockRenderingWorkerExit.IsCompleted || IsDisposed)
{
BlockRenderingWorkerExit.Complete();
return;
}
#endregion
#region Run the Rendering Cycle
// Updatete Status Properties
State.UpdateBufferingProperties();
// Don't run the cycle if it's already running
if (isRunningRenderingCycle)
{
Log(MediaLogMessageType.Trace, $"SKIP: {nameof(BlockRenderingWorker)} alredy in a cycle. {WallClock}");
return;
}
try
{
#region 1. Control and Capture
// Flag the current rendering cycle
isRunningRenderingCycle = true;
// Reset the rendered count to 0
foreach (var t in all)
{
renderedBlockCount[t] = 0;
}
// Capture current clock position for the rest of this cycle
BlockRenderingCycle.Begin();
#endregion
#region 2. Handle Block Rendering
// Wait for the seek op to finish before we capture blocks
if (HasDecoderSeeked)
{
SeekingDone.Wait();
}
// capture the wall clock for this cycle
wallClock = WallClock;
// Capture the blocks to render
foreach (var t in all)
{
if (t == MediaType.Subtitle && PreloadedSubtitles != null)
{
// Get the preloaded, cached subtitle block
currentBlock[t] = PreloadedSubtitles[wallClock];
}
else
{
// Get the regular audio, video, or sub block
currentBlock[t] = Blocks[t][wallClock];
}
}
// Render each of the Media Types if it is time to do so.
foreach (var t in all)
{
// Skip rendering for nulls
if (currentBlock[t] == null)
{
continue;
}
// Render by forced signal (TimeSpan.MinValue) or because simply it is time to do so
if (LastRenderTime[t] == TimeSpan.MinValue || currentBlock[t].StartTime != LastRenderTime[t])
{
renderedBlockCount[t] += SendBlockToRenderer(currentBlock[t], wallClock);
continue;
}
}
#endregion
#region 6. Finalize the Rendering Cycle
// Call the update method on all renderers so they receive what the new wall clock is.
foreach (var t in all)
{
Renderers[t]?.Update(wallClock);
}
#endregion
}
catch (ThreadAbortException) { /* swallow */ }
catch { if (!IsDisposed)
{
throw;
}
}
finally
{
// Always exit notifying the cycle is done.
BlockRenderingCycle.Complete();
isRunningRenderingCycle = false;
}
#endregion
},
this, // the state argument passed on to the ticker
0,
Convert.ToInt32(Constants.Interval.HighPriority.TotalMilliseconds));
}
/// <summary>
/// Continuously converts frmes and places them on the corresponding
/// block buffer. This task is responsible for keeping track of the clock
/// and calling the render methods appropriate for the current clock position.
/// </summary>
internal void RunBlockRenderingWorker()
{
try
{
#region 0. Initialize Running State
// Holds the main media type
var main = Container.Components.Main.MediaType;
// Holds the auxiliary media types
var auxs = Container.Components.MediaTypes.Where(t => t != main).ToArray();
// Holds all components
var all = Container.Components.MediaTypes.ToArray();
// Holds a snapshot of the current block to render
var currentBlock = new MediaTypeDictionary <MediaBlock>();
// Keeps track of how many blocks were rendered in the cycle.
var renderedBlockCount = 0;
// reset render times for all components
foreach (var t in all)
{
LastRenderTime[t] = TimeSpan.MinValue;
}
// Ensure the other workers are running
PacketReadingCycle?.WaitOne();
FrameDecodingCycle?.WaitOne();
// Set the initial clock position
Clock.Position = Blocks[main].RangeStartTime;
var wallClock = Clock.Position;
// Wait for renderers to be ready
foreach (var t in all)
{
Renderers[t]?.WaitForReadyState();
}
#endregion
while (IsTaskCancellationPending == false)
{
#region 1. Control and Capture
// Reset the rendered count to 0
renderedBlockCount = 0;
// Capture current clock position for the rest of this cycle
BlockRenderingCycle?.Reset();
// capture the wall clock for this cycle
wallClock = Clock.Position;
#endregion
#region 2. Handle Block Rendering
// Capture the blocks to render
foreach (var t in all)
{
currentBlock[t] = HasDecoderSeeked ? null : Blocks[t][wallClock];
}
// Render each of the Media Types if it is time to do so.
foreach (var t in all)
{
// Skip rendering for nulls
if (currentBlock[t] == null)
{
continue;
}
// Render by forced signal (TimeSpan.MinValue)
if (LastRenderTime[t] == TimeSpan.MinValue)
{
renderedBlockCount += SendBlockToRenderer(currentBlock[t], wallClock);
continue;
}
// Render because we simply have not rendered
if (currentBlock[t].StartTime != LastRenderTime[t])
{
renderedBlockCount += SendBlockToRenderer(currentBlock[t], wallClock);
continue;
}
}
#endregion
#region 6. Finalize the Rendering Cycle
// Signal the rendering cycle was set.
BlockRenderingCycle?.Set();
// Call the update method on all renderers so they receive what the new wall clock is.
foreach (var t in all)
{
Renderers[t]?.Update(wallClock);
}
// Delay the thread for a bit if we have no more stuff to process
if (IsSeeking == false && renderedBlockCount <= 0 && Commands.PendingCount <= 0)
{
Task.Delay(1).GetAwaiter().GetResult();
}
#endregion
}
}
catch (ThreadAbortException)
{
}
finally
{
// Always exit notifying the cycle is done.
BlockRenderingCycle?.Set();
}
}
/// <summary>
/// Continually decodes the available packet buffer to have as
/// many frames as possible in each frame queue and
/// up to the MaxFrames on each component
/// </summary>
internal void RunFrameDecodingWorker()
{
try
{
// State variables
var decodedFrameCount = 0;
var wallClock = TimeSpan.Zero;
var rangePercent = 0d;
var isInRange = false;
// Holds the main media type
var main = Container.Components.Main.MediaType;
// Holds the auxiliary media types
var auxs = Container.Components.MediaTypes.Where(x => x != main).ToArray();
// Holds all components
var all = Container.Components.MediaTypes.ToArray();
var isBuffering = false;
var resumeClock = false;
var hasPendingSeeks = false;
MediaComponent comp = null;
MediaBlockBuffer blocks = null;
while (IsTaskCancellationPending == false)
{
#region 1. Setup the Decoding Cycle
// Singal a Seek starting operation
hasPendingSeeks = Commands.PendingCountOf(MediaCommandType.Seek) > 0;
if (IsSeeking == false && hasPendingSeeks)
{
IsSeeking = true;
RaiseSeekingStartedEvent();
}
// Execute the following command at the beginning of the cycle
Commands.ProcessNext();
// Signal a Seek ending operation
hasPendingSeeks = Commands.PendingCountOf(MediaCommandType.Seek) > 0;
if (IsSeeking == true && hasPendingSeeks == false)
{
SnapVideoPosition(Clock.Position);
IsSeeking = false;
// Call the seek method on all renderers
foreach (var kvp in Renderers)
{
kvp.Value.Seek();
}
RaiseSeekingEndedEvent();
}
// Wait for a seek operation to complete (if any)
// and initiate a frame decoding cycle.
SeekingDone?.WaitOne();
// Initiate the frame docding cycle
FrameDecodingCycle?.Reset();
// Set initial state
wallClock = Clock.Position;
decodedFrameCount = 0;
#endregion
#region 2. Main Component Decoding
// Capture component and blocks for easier readability
comp = Container.Components[main];
blocks = Blocks[main];
// Handle the main component decoding; Start by checking we have some packets
if (comp.PacketBufferCount > 0)
{
// Detect if we are in range for the main component
isInRange = blocks.IsInRange(wallClock);
if (isInRange == false)
{
// Signal the start of a sync-buffering scenario
HasDecoderSeeked = true;
isBuffering = true;
resumeClock = Clock.IsRunning;
Clock.Pause();
Logger.Log(MediaLogMessageType.Debug, $"SYNC-BUFFER: Started.");
// Read some frames and try to get a valid range
do
{
// Try to get more packets by waiting for read cycles.
if (CanReadMorePackets && comp.PacketBufferCount <= 0)
{
PacketReadingCycle?.WaitOne();
}
// Decode some frames and check if we are in reange now
decodedFrameCount += AddBlocks(main);
isInRange = blocks.IsInRange(wallClock);
// Break the cycle if we are in range
if (isInRange || CanReadMorePackets == false)
{
break;
}
}while (decodedFrameCount <= 0 && blocks.IsFull == false);
// Unfortunately at this point we will need to adjust the clock after creating the frames.
// to ensure tha mian component is within the clock range if the decoded
// frames are not with range. This is normal while buffering though.
if (isInRange == false)
{
// Update the wall clock to the most appropriate available block.
if (blocks.Count > 0)
{
wallClock = blocks[wallClock].StartTime;
}
else
{
resumeClock = false; // Hard stop the clock.
}
// Update the clock to what the main component range mandates
Clock.Position = wallClock;
// Call seek to invalidate renderer
Renderers[main].Seek();
}
}
else
{
// Check if we need more blocks for the current components
rangePercent = blocks.GetRangePercent(wallClock);
// Read as many blocks as we possibly can
while (comp.PacketBufferCount > 0 &&
((rangePercent > 0.75d && blocks.IsFull) || blocks.IsFull == false))
{
decodedFrameCount += AddBlocks(main);
rangePercent = blocks.GetRangePercent(wallClock);
}
}
}
#endregion
#region 3. Auxiliary Component Decoding
foreach (var t in auxs)
{
if (IsSeeking)
{
continue;
}
// Capture the current block buffer and component
// for easier readability
comp = Container.Components[t];
blocks = Blocks[t];
isInRange = blocks.IsInRange(wallClock);
// Invalidate the renderer if we don't have the block.
if (isInRange == false)
{
Renderers[t].Seek();
}
// wait for component to get there if we only have furutre blocks
// in auxiliary component.
if (blocks.Count > 0 && blocks.RangeStartTime > wallClock)
{
continue;
}
// Try to catch up with the wall clock
while (blocks.Count == 0 || blocks.RangeEndTime <= wallClock)
{
// Wait for packets if we don't have enough packets
if (CanReadMorePackets && comp.PacketBufferCount <= 0)
{
PacketReadingCycle?.WaitOne();
}
if (comp.PacketBufferCount <= 0)
{
break;
}
else
{
decodedFrameCount += AddBlocks(t);
}
}
isInRange = blocks.IsInRange(wallClock);
// Move to the next component if we don't meet a regular conditions
if (isInRange == false || isBuffering || comp.PacketBufferCount <= 0)
{
continue;
}
// Read as much as we can for this cycle.
while (comp.PacketBufferCount > 0)
{
rangePercent = blocks.GetRangePercent(wallClock);
if (blocks.IsFull == false || (blocks.IsFull && rangePercent > 0.75d && rangePercent < 1d))
{
decodedFrameCount += AddBlocks(t);
}
else
{
break;
}
}
}
#endregion
#region 4. Detect End of Media
// Detect end of block rendering
if (isBuffering == false &&
IsSeeking == false &&
CanReadMoreFramesOf(main) == false &&
Blocks[main].IndexOf(wallClock) == Blocks[main].Count - 1)
{
if (HasMediaEnded == false)
{
// Rendered all and nothing else to read
Clock.Pause();
Clock.Position = NaturalDuration.HasTimeSpan ?
NaturalDuration.TimeSpan : Blocks[main].RangeEndTime;
wallClock = Clock.Position;
HasMediaEnded = true;
MediaState = MediaState.Pause;
RaiseMediaEndedEvent();
}
}
else
{
HasMediaEnded = false;
}
#endregion
#region 6. Finish the Cycle
// complete buffering notifications
if (isBuffering)
{
// Reset the buffering flag
isBuffering = false;
// Resume the clock if it was playing
if (resumeClock)
{
Clock.Play();
}
// log some message
Logger.Log(
MediaLogMessageType.Debug,
$"SYNC-BUFFER: Finished. Clock set to {wallClock.Format()}");
}
// Complete the frame decoding cycle
FrameDecodingCycle?.Set();
// After a seek operation, always reset the has seeked flag.
HasDecoderSeeked = false;
// Give it a break if there was nothing to decode.
// We probably need to wait for some more input
if (decodedFrameCount <= 0 && Commands.PendingCount <= 0)
{
Task.Delay(1).GetAwaiter().GetResult();
}
#endregion
}
}
catch (ThreadAbortException)
{
}
finally
{
// Always exit notifying the cycle is done.
FrameDecodingCycle?.Set();
}
}
public async Task CloseAsync()
{
Container?.Log(MediaLogMessageType.Debug, $"{nameof(CloseAsync)}: Entered");
Clock.Pause();
IsTaskCancellationPending = true;
// Wait for cycles to complete.
await Task.Run(() =>
{
while (!BlockRenderingCycle.Wait(1))
{
}
while (!FrameDecodingCycle.Wait(1))
{
}
while (!PacketReadingCycle.Wait(1))
{
}
});
BlockRenderingTask?.Join();
FrameDecodingTask?.Join();
PacketReadingTask?.Join();
BlockRenderingTask = null;
FrameDecodingTask = null;
PacketReadingTask = null;
foreach (var renderer in Renderers.Values)
{
renderer.Close();
}
Renderers.Clear();
// Reset the clock
Clock.Reset();
Container?.Log(MediaLogMessageType.Debug, $"{nameof(CloseAsync)}: Completed");
// Dispose the container
if (Container != null)
{
Container.Dispose();
Container = null;
}
// Dispose the Blocks for all components
foreach (var kvp in Blocks)
{
kvp.Value.Dispose();
}
Blocks.Clear();
// Dispose the Frames for all components
foreach (var kvp in Frames)
{
kvp.Value.Dispose();
}
Frames.Clear();
// Clear the render times
LastRenderTime.Clear();
// Update notification properties
UpdateMediaProperties();
MediaState = MediaState.Close;
}
/// <summary>
/// Opens the specified media Asynchronously
/// </summary>
/// <param name="uri">The URI.</param>
/// <returns></returns>
private async Task OpenAsync(Uri uri)
{
try
{
await Task.Run(() =>
{
var mediaUrl = uri.IsFile ? uri.LocalPath : uri.ToString();
Container = new MediaContainer(mediaUrl);
RaiseMediaOpeningEvent();
Container.Log(MediaLogMessageType.Debug, $"{nameof(OpenAsync)}: Entered");
Container.Initialize();
});
foreach (var t in Container.Components.MediaTypes)
{
Blocks[t] = new MediaBlockBuffer(MaxBlocks[t], t);
Frames[t] = new MediaFrameQueue();
LastRenderTime[t] = TimeSpan.MinValue;
Renderers[t] = CreateRenderer(t);
}
IsTaskCancellationPending = false;
BlockRenderingCycle.Set();
FrameDecodingCycle.Set();
PacketReadingCycle.Set();
PacketReadingTask = new Thread(RunPacketReadingWorker)
{
IsBackground = true
};
FrameDecodingTask = new Thread(RunFrameDecodingWorker)
{
IsBackground = true
};
BlockRenderingTask = new Thread(RunBlockRenderingWorker)
{
IsBackground = true
};
PacketReadingTask.Start();
FrameDecodingTask.Start();
BlockRenderingTask.Start();
RaiseMediaOpenedEvent();
if (LoadedBehavior == MediaState.Play)
{
Play();
}
}
catch (Exception ex)
{
RaiseMediaFailedEvent(ex);
}
finally
{
UpdateMediaProperties();
Container.Log(MediaLogMessageType.Debug, $"{nameof(OpenAsync)}: Completed");
}
}
/// <summary>
/// Continually decodes the available packet buffer to have as
/// many frames as possible in each frame queue and
/// up to the MaxFrames on each component
/// </summary>
internal void RunFrameDecodingWorker()
{
#region Worker State Setup
// The delay provider prevents 100% core usage
var delay = new DelayProvider();
// State variables
var decodedFrameCount = 0;
var wallClock = TimeSpan.Zero;
var rangePercent = 0d;
var isInRange = false;
// Holds the main media type
var main = Container.Components.Main.MediaType;
// Holds the auxiliary media types
var auxs = Container.Components.MediaTypes.Except(main);
// State properties
var isBuffering = false;
var resumeClock = false;
MediaComponent comp = null;
MediaBlockBuffer blocks = null;
#endregion
#region Worker Loop
try
{
while (Commands.IsStopWorkersPending == false)
{
#region 1. Setup the Decoding Cycle
// Determine what to do on a priority command
if (Commands.IsExecutingDirectCommand)
{
if (Commands.IsClosing)
{
break;
}
if (Commands.IsChanging)
{
Commands.WaitForDirectCommand();
}
}
// Update state properties -- this must be after processing commanmds as
// a direct command might have changed the components
main = Container.Components.Main.MediaType;
auxs = Container.Components.MediaTypes.Except(main);
// Execute the following command at the beginning of the cycle
Commands.ExecuteNextQueuedCommand();
// Signal a Seek starting operation
FrameDecodingCycle.Begin();
// Set initial state
wallClock = WallClock;
decodedFrameCount = 0;
#endregion
if (State.HasMediaEnded == false)
{
#region 2. Main Component Decoding
// Capture component and blocks for easier readability
// comp is current component, blocks is the block collection for the component
comp = Container.Components[main];
blocks = Blocks[main];
// Detect if we are in range for the main component
isInRange = blocks.IsInRange(wallClock);
if (isInRange == false)
{
// Signal the start of a sync-buffering scenario
isBuffering = true;
State.SignalBufferingStarted();
resumeClock = Clock.IsRunning;
Clock.Pause();
Log(MediaLogMessageType.Debug, $"SYNC-BUFFER: Started.");
// Read some frames and try to get a valid range
do
{
// Try to get more packets by waiting for read cycles.
WaitForPackets(comp, 1);
// Decode some frames and check if we are in reange now
if (AddNextBlock(main) == false)
{
break;
}
decodedFrameCount += 1;
isInRange = blocks.IsInRange(wallClock);
// Break the cycle if we are in range
if (isInRange || CanReadMorePackets == false || ShouldReadMorePackets == false)
{
break;
}
}while (blocks.IsFull == false);
// Unfortunately at this point we will need to adjust the clock after creating the frames.
// to ensure tha mian component is within the clock range if the decoded
// frames are not with range. This is normal while buffering though.
if (isInRange == false)
{
// Update the wall clock to the most appropriate available block.
if (blocks.Count > 0)
{
wallClock = blocks[wallClock].StartTime;
}
else
{
resumeClock = false; // Hard stop the clock.
}
// Update the clock to what the main component range mandates
Clock.Update(wallClock);
// Force renderer invalidation
InvalidateRenderer(main);
// Try to recover the regular loop
isInRange = true;
}
}
if (isInRange)
{
// Check if we need more blocks for the current components
rangePercent = blocks.GetRangePercent(wallClock);
// Read as much as we can for this cycle but always within range.
while (blocks.IsFull == false || (blocks.IsFull && rangePercent > 0.75d && rangePercent < 1d))
{
if (AddNextBlock(main) == false)
{
break;
}
decodedFrameCount += 1;
rangePercent = blocks.GetRangePercent(wallClock);
continue;
}
}
#endregion
#region 3. Auxiliary Component Decoding
foreach (var t in auxs)
{
if (State.IsSeeking)
{
continue;
}
// Capture the current block buffer and component
// for easier readability
comp = Container.Components[t];
blocks = Blocks[t];
isInRange = blocks.IsInRange(wallClock);
// wait for component to get there if we only have furutre blocks
// in auxiliary component.
if (blocks.Count > 0 && blocks.RangeStartTime > wallClock)
{
continue;
}
// We need the other components to catch up with the main
while (blocks.Count == 0 || blocks.RangeEndTime <= wallClock ||
(Blocks[main].Count > 0 && blocks.RangeEndTime < Blocks[main].RangeEndTime))
{
// give up if we never received frames for the expected component
if (AddNextBlock(t) == false)
{
break;
}
}
// Check if we are finally within range
isInRange = blocks.IsInRange(wallClock);
// Invalidate the renderer if we don't have the block.
if (isInRange == false)
{
InvalidateRenderer(t);
}
// Move to the next component if we don't meet a regular conditions
if (isInRange == false || isBuffering)
{
continue;
}
// Decode as much as we can off the packet buffer for this cycle.
rangePercent = blocks.GetRangePercent(wallClock);
while (blocks.IsFull == false || (blocks.IsFull && rangePercent > 0.75d && rangePercent < 1d))
{
if (AddNextBlock(t) == false)
{
break;
}
rangePercent = blocks.GetRangePercent(wallClock);
}
}
#endregion
}
#region 4. Detect End of Media
// Detect end of block rendering
// TODO: Maybe this detection should be performed on the BlockRendering worker?
if (isBuffering == false &&
decodedFrameCount <= 0 &&
State.IsSeeking == false &&
CanReadMoreFramesOf(main) == false &&
Blocks[main].IndexOf(wallClock) == Blocks[main].Count - 1)
{
if (State.HasMediaEnded == false)
{
// Rendered all and nothing else to read
Clock.Pause();
wallClock = Blocks[main].RangeEndTime;
Clock.Update(wallClock);
if (State.NaturalDuration != null &&
State.NaturalDuration != TimeSpan.MinValue &&
State.NaturalDuration < wallClock)
{
Log(MediaLogMessageType.Warning,
$"{nameof(State.HasMediaEnded)} conditions met at {wallClock.Format()} but " +
$"{nameof(State.NaturalDuration)} reports {State.NaturalDuration.Value.Format()}");
}
State.UpdateMediaEnded(true);
State.UpdateMediaState(PlaybackStatus.Stop, wallClock);
SendOnMediaEnded();
}
}
else
{
State.UpdateMediaEnded(false);
}
#endregion
#region 6. Finish the Cycle
// complete buffering notifications
if (isBuffering)
{
// Always reset the buffering flag
isBuffering = false;
// Resume the clock if it was playing
if (resumeClock)
{
Clock.Play();
}
// log some message
Log(MediaLogMessageType.Debug, $"SYNC-BUFFER: Finished. Clock set to {wallClock.Format()}");
}
// If not already set, guess the 1-second buffer length
State.GuessBufferingProperties();
// Complete the frame decoding cycle
FrameDecodingCycle.Complete();
// Give it a break if there was nothing to decode.
// We probably need to wait for some more input
if (Commands.IsStopWorkersPending == false &&
decodedFrameCount <= 0 &&
Commands.HasQueuedCommands == false)
{
delay.WaitOne();
}
#endregion
}
}
catch { throw; }
finally
{
// Always exit notifying the cycle is done.
FrameDecodingCycle.Complete();
delay.Dispose();
}
#endregion
}
/// <summary>
/// Starts the block rendering worker.
/// </summary>
private void StartBlockRenderingWorker()
{
if (HasBlockRenderingWorkerExited != null)
{
return;
}
HasBlockRenderingWorkerExited = new ManualResetEvent(false);
// Synchronized access to parts of the run cycle
var isRunningPropertyUpdates = false;
var isRunningRenderingCycle = false;
// Holds the main media type
var main = Container.Components.Main.MediaType;
// Holds the auxiliary media types
var auxs = Container.Components.MediaTypes.ExcludeMediaType(main);
// Holds all components
var all = Container.Components.MediaTypes.DeepCopy();
// Holds a snapshot of the current block to render
var currentBlock = new MediaTypeDictionary <MediaBlock>();
// Keeps track of how many blocks were rendered in the cycle.
var renderedBlockCount = new MediaTypeDictionary <int>();
// reset render times for all components
foreach (var t in all)
{
LastRenderTime[t] = TimeSpan.MinValue;
}
// Ensure the other workers are running
PacketReadingCycle.WaitOne();
FrameDecodingCycle.WaitOne();
// Set the initial clock position
Clock.Position = Blocks[main].RangeStartTime;
var wallClock = Clock.Position;
// Wait for renderers to be ready
foreach (var t in all)
{
Renderers[t]?.WaitForReadyState();
}
// The Property update timer is responsible for timely updates to properties outside of the worker threads
BlockRenderingWorker = new Timer((s) =>
{
#region Detect a Timer Stop
if (IsTaskCancellationPending || HasBlockRenderingWorkerExited.IsSet() || m_IsDisposing.Value)
{
HasBlockRenderingWorkerExited.Set();
return;
}
#endregion
#region Run the property Updates
if (isRunningPropertyUpdates == false)
{
isRunningPropertyUpdates = true;
try
{
UpdatePosition(IsOpen ? Clock?.Position ?? TimeSpan.Zero : TimeSpan.Zero);
UpdateBufferingProperties();
}
catch (Exception ex)
{
Log(MediaLogMessageType.Error, $"{nameof(BlockRenderingWorker)} callabck failed. {ex.GetType()}: {ex.Message}");
}
finally
{
isRunningPropertyUpdates = false;
}
}
#endregion
#region Run the Rendering Cycle
// Don't run the cycle if it's already running
if (isRunningRenderingCycle)
{
// TODO: Log a frame skip
return;
}
try
{
#region 1. Control and Capture
// Flag the current rendering cycle
isRunningRenderingCycle = true;
// Reset the rendered count to 0
foreach (var t in all)
{
renderedBlockCount[t] = 0;
}
// Capture current clock position for the rest of this cycle
BlockRenderingCycle.Reset();
// capture the wall clock for this cycle
wallClock = Clock.Position;
#endregion
#region 2. Handle Block Rendering
// Wait for the seek op to finish before we capture blocks
if (HasDecoderSeeked)
{
SeekingDone.WaitOne();
}
// Capture the blocks to render
foreach (var t in all)
{
currentBlock[t] = Blocks[t][wallClock];
}
// Render each of the Media Types if it is time to do so.
foreach (var t in all)
{
// Skip rendering for nulls
if (currentBlock[t] == null)
{
continue;
}
// Render by forced signal (TimeSpan.MinValue)
if (LastRenderTime[t] == TimeSpan.MinValue)
{
renderedBlockCount[t] += SendBlockToRenderer(currentBlock[t], wallClock);
continue;
}
// Render because we simply have not rendered
if (currentBlock[t].StartTime != LastRenderTime[t])
{
renderedBlockCount[t] += SendBlockToRenderer(currentBlock[t], wallClock);
continue;
}
}
#endregion
#region 6. Finalize the Rendering Cycle
// Call the update method on all renderers so they receive what the new wall clock is.
foreach (var t in all)
{
Renderers[t]?.Update(wallClock);
}
#endregion
}
catch (ThreadAbortException) { }
catch { throw; }
finally
{
// Always exit notifying the cycle is done.
BlockRenderingCycle.Set();
isRunningRenderingCycle = false;
}
#endregion
},
this, // the state argument passed on to the ticker
0,
(int)Constants.Interval.HighPriority.TotalMilliseconds);
}