X-Git-Url: https://git.carlh.net/gitweb/?p=dcpomatic.git;a=blobdiff_plain;f=doc%2Fdesign%2Fchange_during_play.tex;fp=doc%2Fdesign%2Fchange_during_play.tex;h=28451e961c9015cf4e000177654ba216dcaa3378;hp=0000000000000000000000000000000000000000;hb=67c604d3fa2391b98ea436e2c6412f1c83a98f77;hpb=6c7489e5d778d3e71065d88a094a7383ba2c117d

diff --git a/doc/design/change_during_play.tex b/doc/design/change_during_play.tex
new file mode 100644
index 000000000..28451e961
--- /dev/null
+++ b/doc/design/change_during_play.tex
@@ -0,0 +1,23 @@
+\documentclass{article}
+\begin{document}
+
+If the data which the player relies on changes, the player must \texttt{setup\_pieces()} before it \texttt{pass()}es otherwise it may crash.
+
+I think there are two approaches to this:
+
+\begin{enumerate}
+
+\item Playlist signals that it is going to change; player and
+butler respond by suspending themselves (so they don't touch the `bad'
+playlist), playlist signals when the change has been made and
+\texttt{setup\_pieces()} has happened.  Player and butler resume.
+
+\item There is some RCU system so that changes to the playlist happen in a copy
+which is made into the `current' version at a convenient time to the
+player/butler.  This seems a bit tricky because the player's output also
+depends on the state of \texttt{Film}, so it seems that the copy would need to
+include the film's state (and possibly other bits).
+
+\end{enumerate}
+
+\end{document}