APPENDIX 5 – X-Pert Playout and X-Pert List Examples

Example 1.Volume Normalization:

                    Suppose that you have enabled volume normalization and you have set the Referent Zero Level to -23 dbFS. Suppose further, that you have no metadata for the input file, and that the Volume Level at the output is above the referent level. Then, when you play the file, there will be no normalization, as there is no metadata file.

If you set metadata for your input file, the Volume at the output will be kept to the Referent Level, and it will be the same during the entire playout of the file.

Example 2.No Language Descriptions:

                    Suppose that you have PCM to PCM audio with [8] PCM Stereo audio stream at the output with languages, set to Undetermined in the Language field. However, suppose further, that the number of input channels is [16], so it is equal to the number of output channels, and that there is no metadata defined for the input audio stream file. Thus, your Mixed Audio Channel Settings Form will look like this:

                    When you play the input file, the input audio streams will be sequentially mapped to the output streams.

Example 3.Remapping Strategy with Defined Languages:
          Suppose that you have PCM to PCM audio with [7] PCM Stereo audio streams at the output and an input file with [16] channels, so the number of output channels is less than the number of input channels. However, you have defined languages for your output and an input file with language metadata, like this:

Output

Input

Channel 1-2      ->     French

Channel 3-4      ->     Bulgarian

Channel 5-6      ->     German

Channel 11-12   ->     Bulgarian

Channel 13-14   ->    Spanish

Stream 1 (1-2)     ->     German

Stream 2 (3-4)     ->     No language

Stream 3 (5-6)     ->     Bulgarian

Stream 4 (7-8)     ->     French

Stream 5 (9-10)    ->    Russian

Stream 6 (11-12)  ->    No language

Stream 7 (13-14)  ->    No language

Stream 8 (15-16)  ->    No language

Result after input file is played

French goes to French -> Stream 4 to 1-2

 

Bulgarian to the 2 Bulgarian streams ->  Stream 3 to 3-4 AND to 11-12

 

German to German -> Stream 1 to 5-6

 

Spanish has no matching input stream, so it gets the 1st in order without a defined language

Stream 2 to 13-14

 

Undetermined output gets the available non-mapped input with language -> Stream 5 to 7-8

 

All other unassigned streams will be mapped in sequential order:

 Stream 6 to 9-10

 Stream 7 to 15-16

 Stream 8 is discarded

Example 4.Remapping Strategy with no Language Description at the Input:
          Suppose that you have have PCM to PCM audio with [7] PCM Stereo audio streams at the output and an input file with [16] channels, so the number of output channels is less than the number of input channels. Suppose further that the output languages are defined in the same way as in Example 3 above, but the input file has no languages defined.

          As a result, when you play the input file, the input streams will be mapped to the output streams in sequential order, regardless of the language definitions for the output channels.

Example 5.Remapping Strategy with no Language Description at the Output:
          Suppose that you have have PCM to PCM audio with [7] PCM Stereo audio streams at the output and an input file with [16] channels, so the number of output channels is less than the number of input channels. Suppose further that the output languages are undetermined and the input file has the same set of languages, as the one in Example 3 above.

          As a result, when you play the input file, the input streams will be mapped to the output streams in sequential order, regardless of the language definitions of the input channels.

Example 6.No Language Descriptions and Disabled Mapping:
          Suppose that you have no defined languages for both the output and the input audio, and your mapping is disabled. Suppose further, that the number of input audio streams is [3], and the number of output audio streams is [8], all of which are Stereo. Thus, the input channels are less than the output channels.
          
          The result after you play the input file will be that your input audio streams will go to the first three output audio streams in sequential order and the other five audio output streams will play silence.

Example 7.Input Language Descriptions and Disabled Mapping
          Suppose that you have defined [8] Stereo output streams with Undetermined languages and [3] input streams, of which only the third has a defined language, which is English.
          Suppose further, that your mapping is disabled. Since the input stream with English assigned has a higher priority than the streams with no language specified, when you play the input file, the 3rd stream of the input file will go to the 1st stream of the output. The other two streams of the input will go to streams 2 and 3 of the output in sequential order.  The remaining 5 audio output streams will play silence.

Example 8.Output Language Descriptions and Disabled Mapping:
          Suppose that you have an output with [8] Stereo streams, the 4th of which has English assigned, and you have an input file with [3] streams, all of which have Undetermined language metadata.
          Suppose further, that your mapping is disabled. Since the output stream with language assigned has a higher priority than the streams with no language specified, when you play the input file, the 1st input stream will go to the 4th output stream, and the other two input streams will be mapped sequentially to the 1st and 2nd output streams. The remaining 5 output streams will play silence.

Example 9.No Language Descriptions and Enabled Mapping:
          Suppose that you have [8] Stereo output streams and [3] input streams, all of which have Undetermined language metadata. Suppose further, that your mapping is enabled. When you play the file, the input audio streams will go sequentially to the first three output audio streams in the order they are defined.
          
          Furthermore, the audio of the 1st output stream (in English) will also go to the remaining 5 output audio streams, for which there is no input audio.

Example 10. Input Language Descriptions and Enabled Mapping:
          Suppose that you have an input file with [3] streams, the third of which is set to English, and the other two are Undetermined. Suppose further, that your output has [8] Stereo streams, and that your mapping is enabled.
          
Since the input stream with language assigned has a higher priority than the streams with no language specified, when you play the file, the 3rd input stream will go to the 1st output stream, and the other two input streams will go to the 2nd and 3rd output streams in sequential order. Furthermore, the audio of the 1st output stream (in English) will be copied to the remaining 5 output audio streams, for which there is no input audio.

Example 11. Output Language Descriptions and Enabled Mapping:
          Suppose that you have an input file with [3] streams, all of which have Undetermined language metadata. Suppose further, that you have defined [8] Stereo output streams , the 4th of which has English assigned, and that your mapping is enabled.
          
          Thus, when you play the file, 1st input stream will go to the 4th output stream, since it has a defined language and has a higher priority than the other streams. The other two input streams will go to the 1st and 2nd output streams in sequential order, and the audio of the 1st output stream (2nd input stream) will go to the remaining 5 output audio streams, for which there is no input audio.

Example 12.  Down Convert 5.1 to 2.0 with no Language Descriptions:
          Suppose that your input file has the following audio streams:
Stream 1 - 5.1
Stream 2 - 2.0
Stream 3 - 5.1
          Suppose further that none of the above streams have languages assigned, and that there are [8] PCM Stereo streams, defined at the output, which also have no languages assigned.
          When you play the file, the 2nd input stream will go to the 1st output stream with no language, and the 1st and the 3rd input streams will go correspondingly to the 2nd and 3rd output streams. The rest of the output streams will either play silence, or will duplicate the 1st output channel, depending on your registry configurations.
NOTE: If you want to make a special registry configuration, related to Example 12, please, contact X-Pert Support team for further assistance on chat button https://x-pert.tv/support/, via e-mail at support@x-pert.tv or phone +359 8 77 66 33 51.

Example 13.Down Convert 5.1 to 2.0 with Language Descriptions:
          Suppose that you have the same input file, as the one in Example 12 above but it has English assigned for Stream [3]. Suppose further, that the output has [8] PCM Stereo streams and English is assigned to the 3rd and the 4th.
          When you play the file, the 3rd input Stream (in English) will be down converted to Stereo 2.0, and will go to the 2nd output. Stream 2 from the input will go to the 1st output stream, and the 1st input stream will be down converted to Stereo 2.0, and will go to the 3rd output stream.

Example 14. Down Convert 5.1 to 2.0 with a Different Count of Language Descriptions:
          Suppose that you have the following input:
Stream 1 - 5.1 -> no language
Stream 2 - 2.0 -> English
Stream 3 - 5.1 -> English
          Suppose further that your output has [8] PCM Stereo 2.0 streams with English assigned to the 2nd output stream. Since input Stream 2 matches output stream 2 both by language and by type, it will go to it. Input Stream 3, which is in English, has a higher priority than the input stream with no language. Thus, it will be down converted to Stereo 2.0 and will go to the 1st output stream without a language assigned.
          Finally, Stream 1 from the input will also be down converted to Stereo 2.0, and it will go to the 3rd output stream.

Example 15.Up Convert 2.0 to 5.1 with no Language Descriptions:
          Suppose that you have the following output and input with no languages assigned:

Output

Input

Stream 1 (Channels 1 – 6) – 5.1

Stream 2 (Channels 7 – 12) – 5.1

Stream 3 (Channels 13 – 14) – 2.0

Stream 4 (Channels 15 – 16) – 2.0

Stream 1 - 2.0

Stream 2 - 5.1

Stream 3 - 2.0


          When you play the file, you will have the following result:
Input Stream 2 will go to the 1st output stream (Channels 1 – 6)
Input Stream 1 will go to the 3rd output stream (Channels 13-14)
Input Stream 3 will go to the 4th output stream (Channels 15-16)
The remaining 2nd output stream (Channels 7 – 12) will either play silence, or it will duplicate the 1st output stream (Channels 1 – 6).
NOTE: If you want to add a special configuration, related to the example above, please contact X-Pert Support team for further assistance on chat button https://x-pert.tv/support/, via e-mail at support@x-pert.tv or phone +359 8 77 66 33 51.

Example 16.Up Convert 2.0 to 5.1 with Language Descriptions:
Suppose that you have the following output and input:

Output

Input

Stream 1 (Channels 1 – 6) – 5.1 -> no language

Stream 2 (Channels 7 – 12) – 5.1 ->  English

Stream 3 (Channels 13 – 14) – 2.0 -> no language

Stream 4 (Channels 15 – 16) – 2.0 -> no language

Stream 1 - 2.0 -> no language

Stream 2 - 5.1 -> no language

Stream 3 - 2.0 -> English

          When you play the file, you will have the following result:
Input Stream 3 will be up converted to Stereo 5.1 and will go to Output Stream 2 (Channels 7 – 12)
Input Stream 1 will go to Output Stream 3 (Channels 13 – 14)
Input Stream 3 will go to Output Stream 4 (channels 15 – 16)
The remaining Output Stream 1 (Channels 1 – 6) will play silence.

Example 17. Creating a Regular Playlist:
Open X-Pert Playout and go to File -> New Playlist. Notice that X-Pert List is opened. In X-Pert List go to Settings –> Modules –> X-Pert Playout -> Output and double-click on the output plugin that matches the one, set for X-Pert Playout. Save your settings and notice that the X-Pert List output is configured according to the X-Pert Playout output plugin setup.
The next step is to add items to the playlist by drag-n-dropping. Select a media folder, containing the files you want to play and place them in the playlist area of the X-Pert List main window. Save your playlist from File –> Save with your desired name. Close X-Pert List.

Example 18. Creating a Daily Playlist:
Press the Create New Playlist   button in X-Pert Playout. Notice that X-Pert List is opened. Add your desired media files via drag-n-dropping them from the respective folder to the playlist grid. Go to File –> Save daily playlist. The Daily Playlist dialog will open. Set your start time and select the folder, where the daily playlist will be saved. Notice that the name of the playlist is created automatically. Press Save and verify that the specified folder contains a file with the name displayed in the Save Daily Playlist form.

Example 19. Load a Playlist Manually:
Open X-Pert Playout and go to File –> Load Playlist. Select the playlist, already created in example  Creating a Regular Playlist above and press Open. Verify that the properties of the items in the playlist, i.e., duration, type, and metadata are correct. Select the Playlist tab from the multi-purpose zone and double-click on a playlist from the list.
Start a new playlist by pressing the Create New Playlist  button in X-Pert Playout or via the <Ctrl + N> key combination. Notice that X-Pert List is opened. There go to Settings –> Modules –> X-Pert Playout ->Output and double-click on NONE. Save your settings.
Add your desired media files via drag-n-dropping them in the playlist grid, save your playlist and close X-Pert List. Notice that all the files in the playlist have a duration of [00:00:00:00], the items are marked in red and the Type column contains the text [Unsupported media].
Go to X-Pert Playout and click on the Load Playlist from File  button. Open the playlist that you have just saved in X-Pert List. The newly loaded files will have a duration of [00:00:00:00]. Go to Settings –> General –> check Auto update duration of marked files. Set the time for auto update to 1 minute and save your settings. Select some of the items in the playlist, right-click and select Auto update. The auto update symbol will appear in the first column of the selected items. In about a minute the duration of the selected files for auto update will change and become greater than [00:00:00:00].

Example 20. Automatically Load a New Playlist on StartUp:
Open X-Pert Playout and go to Settings –> StartUp. Verify that the New radio button is selected and save your settings. Restart X-Pert Playout and notice that when you restart X-Pert Playout an empty playlist will be displayed.

Example 21.Automatically Load the Last Used Playlist:
Open X-Pert Playout and load a playlist. Go to Settings –> Startup, select the Last used radio button and place a check in the Auto start playback after playlist loading box. Save your settings and restart X-Pert Playout. Notice that the last used playlist is loaded and the playout starts immediately.

Example 22. Trigger the Open Playlist Dialog at Startup:
Open X-Pert Playout and go to Settings –> Startup. Select the Open dialog radio button and save your settings. Restart X-Pert Playout and notice that the open playlist dialog appears automatically upon startup. Select your desired playlist and press Open.

Example 23. Automatically Load an Existing Daily Playlist on StartUp:

          Open X-Pert Playout and create several daily playlists (as shown in Example Creating a Daily Playlist above). Create one playlist for the current day, which starts 5 minutes after the current time, one for the next day, and one for the previous day. Save your playlists in the default folder, suggested by X-Pert Playout / X-Pert List. Go to X-Pert Playout -> Settings –> StartUp and select the Daily playlist folder radio button. Verify that the Reload playlist immediately option is selected. Save your settings and restart X-Pert Playout. Notice that the daily playlist for the current day is loaded and the playout starts when the start time occurs.

Example 24. Automatically Load an Existing Daily Playlist on StartUp:
                    Open X-Pert Playout and create two different daily playlists for the current day. Set the start time of the first one to be 5 minutes after the current time and that for the second one to be 10 minutes after current time. Go to X-Pert Playout Settings –> Startup and in the field next to the Daily playlist folder option fill in the folder path, where your daily playlist are saved. Save your settings and restart X-Pert Playout. Notice that the daily playlist with start time closer to the current time (i.e., the one set for 5 minutes after the current time) is loaded and the playout starts when the start time occurs.

Example 25. No Current Daily Playlist is Available:
                    Open X-Pert Playout and move all daily playlists for the day to a different folder. Then load a 24-hour playlist and save it as a daily playlist with a date, corresponding to 1 week before the current date and a start time of [00:00:01:00]. In X-Pert Playout Settings –> Startup dialog verify that none of the boxes from the If there is no current daily playlists field is checked. Restart X-Pert Playout and notice that no playlist is loaded. Revisit X-Pert Playout Settings –> Startup dialog and check the Try to load last daily playlist for same weekday box and save your settings. Restart X-Pert Playout and notice that the playlist, saved for last week is loaded.
                    Another way to load the latter daily playlist automatically is to check the Try to load past daily playlist from last box and enter 10 days in the spin-box in X-Pert Playout Settings –> Startup dialog. However, if you enter less than 7 days in this spin-box, the daily playlist that is 1 week old will not be played automatically.

Example 26. Reload a Regular Playlist on File Change in X-Pert Playout:
                    Let us assume that you are using two X-Pert Playout instances, AB#1 and AB#2 and that the second instance is set to MPO output plugin.
Assume further that AB #1 has the following configurations in Settings –> Startup dialog:

The New radio button is selected in the StartUp playlist field.

The Reload playlist on file change box is checked and the Reload daily playlist without playing box it is NOT checked in the Reload playlist options field.

The Reload playlist immediately radio button is selected in the When reload playlist field.
                    Imagine that we load the same regular playlist in both X-Pert Playout instances and start their playout. If we delete the currently played clip in AB#2 and save the playlist, in AB#1 the playlist will be reloaded without the deleted clip and the playout will start from the beginning of the playlist.
Furthermore, imagine that we insert a few media files after the currently played clip in AB#2 and save the modified playlist. As a result, the playlist in AB#1 will be reloaded, and the playout will continue with the next clip.

Example 27.  Reload a Regular Playlist on File Change in X-Pert List:
                    Let us assume that you are using X-Pert Playout together with X-Pert List. Assume further that you start X-Pert List, load the playlist currently played in X-Pert Playout, delete a few items before the currently played clip, and save the playlist. As a result, the playlist will be reloaded in X-Pert Playout, and the playout will continue with the next clip.
Now imagine that the Wait for playing clip end radio button is selected following in X-Pert Playout -> Settings –> Startup and that you reset the playlist with the Reset  button and press Play in X-Pert Playout. Furthermore, assume that you modify the playlist in X-Pert List and save it while X-Pert Playout is playing. As a result, the playlist in X-Pert Playout will be reloaded after the end of the currently playing clip and the playout will continue from the next clip.
                    Finally, suppose that you delete the currently playing clip in X-Pert List and save the playlist. As a result, the playlist in X-Pert Playout will be reloaded after the end of the currently playing clip, and the playout will start from the beginning of the playlist.

Example 28. Reload a Daily Playlist Immediately on File Change in X-Pert List:
                    Open X-Pert Playout and create a daily playlist with start time a few minutes later than the current time. Go to Settings –> Startup and select the Daily playlist folder radio button. Verify that the Reload on file change option is checked and select the Reload playlist immediately radio button. Set the Pre-cache new playlist to 30 minutes before start, save your settings, and restart X-Pert Playout. The playout of the daily playlist should start when its start time occurs. When this happens, open X-Pert List, insert a few media files after the currently played clip, and delete a few others with start time after the currently played clip. Save your playlist and notice that the daily playlist in X-Pert Playout is reloaded and the playout is resumed according to the current time.

Example 29.Reload a Daily Playlist on File Change in X-Pert List While a New Playlist is Pre-cached:
                    Open X-Pert Playout and create a daily playlist with start time a few minutes later than the current time. Go to Settings –> Startup and select the Daily playlist folder radio button. Verify that the Reload on file change option is checked and select the Reload playlist immediately radio button. Set the Pre-cache new playlist to 30 minutes before start, save your settings, and restart X-Pert Playout. Open the log view and monitor it until a message in LogView like this appears: [17:10:22:000 - Precaching playlist: D:\playlists\*.ply 17:10:22:129 - Playlist D:\playlists\*.ply is cached and ready for cue].
                    Next, open X-Pert List, modify the currently playing daily playlist and save it. Notice that the changed playlist is NOT reloaded and a warning message is displayed.

Example 30. Reload a Daily Playlist on File Change in X-Pert List Without Playing it:
                    Open X-Pert Playout and go to Settings –> Startup. Check the Reload daily playlist without playing it box, save your settings and restart X-Pert Playout. Next, open X-Pert List, modify the playlist and save it. Notice that in X-Pert Playout the playlist is reloaded and the playout is stopped.

Example 31.Reload a Daily Playlist on File Change in X-Pert List Using the Wait for Playing Clip End Option:
                    Open X-Pert Playout and create a daily playlist with start time equal to a few minutes after the current time. While the playout is stopped, go to Settings –> Startup and select the Wait for playing clip end radio button. Save your settings and restart X-Pert Playout. Next, open X-Pert List, modify and save the same playlist by deleting and / or adding items. Notice that in X-Pert Playout the playlist is reloaded after the end of the currently played clip and the playout is resumed according to the current time.

Example 32. Overlapping Between Daily Playlists:
                    Suppose that you have two daily playlists in X-Pert Playout, set for the current day. Furthermore, suppose that in X-Pert Playout -> Settings –> Startup dialog the Daily playlist folder radio button, as well as the Reload playlist immediately radio buttons are selected.
                    Now let us assume that an overlapping exists between the current and the new playlist. In other words, the first playlist is with short duration and a start time a few minutes after the current time, and the second playlist is with start time that overlaps the first one. Start playing the first daily playlist and notice how when the start time of the second playlist occurs the currently played clip is trimmed and the second playlist is immediately loaded and played.

Example 33.Gap Between Daily Playlists:
                    Suppose that you have two daily playlists in X-Pert Playout, set for the current day, of which the first one starts a few minutes after the current time, and the second one starts a few minutes after the end of the first one. Furthermore, suppose that in X-Pert Playout Settings –> Startup dialog the Daily playlist folder radio button, as well as the Reload playlist immediately radio buttons are selected.
                    Now let us assume that there exists a gap between the current and the new daily playlist and the Fill gap between playlists box is checked in X-Pert Playout -> Settings –> Startup dialog. Start the playout in X-Pert Playout and notice that after the end of the first playlist the corresponding auto-fill clip is played, and the playout of the second playlists begins when its start time occurs.
Note that if the Fill gap between playlists box is not checked and you perform the playout, described above, when the first playlist ends, the X-Pert Playout playout will be stopped and the new playlist will be in Cue mode.

Example 34.Wait for Playing Clip End Option:
                    Open X-Pert Playout and go to Settings –> Startup. Select the Wait for playing clip end radio button and save your settings. Suppose that you have two overlapping daily playlists, as in Overlapping Between Daily Playlists above. Open X-Pert Playout and go to Settings –> Startup.
                    As a result, when you start the playout and the time for starting the second playlist occurs, the currently playing clip from the first daily playlist is played until the end ant all following clips are removed.
                    Suppose further that you have the above setting but you have defined a Daily Playlist Tolerance in X-Pert Playout Settings –> Startup. Thus, when the start time of the second playlist occurs two things might happen:
If the start time of the second playlist is closer to the current clip end time, i.e., the time difference is shorter or equal to the tolerance, defined in the Startup-> Settings, the start time of the second playlist will be updated by adding the time difference.
If, however, the start time of the second playlist is closer to the current clip start time, i.e., the time difference is lower or equal to the tolerance, defined in the Startup ->Settings, the start time of the next clip will be updated by subtracting the time difference and the overlapping clip will be removed.
Furthermore, if the above tolerance subtractions are not enough to compensate for the time difference, the clip trimming will be taken into account.

Example 35. Wait for Playing Clip End Option with Allow Clip Trimming:
                    Open X-Pert Playout and go to Settings –> Startup. Select the Wait for playing clip end radio button, check the Allow Clip Trimming box and save your settings. Suppose that you have two overlapping daily playlists, as in Overlapping Between Daily Playlists example above and that you have defined a Daily playlist loading tolerance.
                    Suppose further that when you start the playout and the time for starting the second playlist approaches it appears so that the end time of the currently playing clip is closer to the end time of the first clip from the second playlist. In other words, the end time of the first clip of the second playlists occurs sooner than the end of the currently playing clip. Now let us assume that the Daily playlist loading tolerance appears to be greater or equal to the above time difference. As a result, when you restart X-Pert Playout, the start time of the second clip in the new playlist will be updated by subtracting the time difference and the overlapping and the initial clip of the second playlist will be removed.

Example 36. Wait for Playing Clip End Option with Offset the Whole Playlist:
Open X-Pert Playout and go to Settings –> Startup. Select the Wait for playing clip end radio button, check the Allow Clip Trimming box and save your settings. Suppose that you have two overlapping daily playlists, as in Overlapping Between Daily Playlists. Suppose further that you have set a value for the Daily playlist loading tolerance and that the delay of the new playlist is within this value.
                    As a result, when you start the playout and the start time of the second playlist approaches, the new playlist will be moved with the time difference between the two playlists.

Example 37. Wait for Playing Clip End Option with no Clip Trimming, nor Offset:

                    Open X-Pert Playout and go to Settings –> Startup. Select the Wait for playing clip end radio button. Suppose that you have two overlapping daily playlists, as in Overlapping Between Daily Playlists. Suppose further that you have set a value for the Daily playlist loading tolerance, which is less than the difference between the playlists.
                    As a result, when you start the playout and the start time of the second playlist approaches, the overlapping clip from the new playlist will be removed and the gap between the current clip end and the start time of the next clip in the playlist will be filled with an auto-fill clip if the Fill gap between playlists option is checked. Otherwise, the playout of the second playlist will be Cued.