no way to compare when less than two revisions

Differences

This shows you the differences between two versions of the page.

@@ Line 1: / Line 1: @@
+====== Displaying persistent data with the Join subscriber ======
+----
+The Join subscriber lets you display data over a long time without affecting the buffer rotation.
+For example, if you want to display a background image with an animation on top, none of the buffers which contain both animation chunks and image chunks can be reused until the image is no longer displayed.
+The Join subscriber lets you copy and return a buffer and circumvent the usual use and return mechanism.
+**Note:** You can also work with the SCEL subscriber or Text subscriber. They allow for a stream header flag that copies a specified chunk out of the stream buffer. See the //Attic// folder for more information.
+===== Displaying a background image =====
+Displaying a background image with the Join subscriber involves the following basic steps:
+  * Create a chunk file using the Chunkify tool. For the example, use a type of IMAG and MEMTYPE_ANY (the default).
+  * Weave the stream, using the chunk file as one of its elements.
+  * Create and specify a message port at which to receive the specified Join elements. ''<nowiki>MsgPort = InitiJoinPort (joinContextPTR, &MsgPort, `IMAG')</nowiki>''
+  * To render and release the image, call ''<nowiki>GetJoinElement()</nowiki>''and ''<nowiki>ReleaseJoinElement()</nowiki>''.

3DO Development Repo